paper.js/src/tool/Tool.js

Tool = ToolHandler.extend({
	beans: true,

	initialize: function(handlers, doc) {
		this.base(handlers);
		if (Paper.document)
			this.document = Paper.document;
	},
	
	setDocument: function(doc) {
		if (this._document)
			$(this._document.canvas).removeEvents();
		this._document = doc || Paper.document;
		var that = this, curPoint;
		var dragging = false;
		var events = {
			dragstart: function(e) {
				curPoint = new Point(e.offset);
				that.onHandleEvent('MOUSE_DOWN', curPoint, null, null);
				if (that.onMouseDown)
					that._document.redraw();
				if (that.eventInterval != -1)
					this.intervalId = setInterval(events.drag, that.eventInterval);
				dragging = true;
			},
			drag: function(e) {
				if (e) curPoint = new Point(e.offset);
				if (curPoint) {
					that.onHandleEvent('MOUSE_DRAG', curPoint, null, null);
					if (that.onMouseDrag)
						that._document.redraw();
				}
			},
			dragend: function(e) {
				curPoint = null;
				if (this.eventInterval != -1)
					clearInterval(this.intervalId);
				that.onHandleEvent('MOUSE_UP', new Point(e.offset), null, null);
				if (that.onMouseUp)
					that._document.redraw();
				dragging = false;
			},
			mousemove: function(e) {
				if(!dragging) {
					that.onHandleEvent('MOUSE_MOVE', new Point(e.offset), null, null);
					if (that.onMouseMove)
						that._document.redraw();
				}
			}
		};
		$(doc.canvas).addEvents(events);
	},
	
	/**
	 * The fixed time delay between each call to the {@link #onMouseDrag}
	 * event. Setting this to an interval means the {@link #onMouseDrag} event
	 * is called repeatedly after the initial {@link #onMouseDown} until the
	 * user releases the mouse.
	 * 
	 * Sample code:
	 * <code>
	 * // Fire the onMouseDrag event once a second,
	 * // while the mouse button is down
	 * tool.eventInterval = 1000;
	 * </code>
	 * 
	 * @return the interval time in milliseconds
	 */
	eventInterval: -1,
	
	getDocument: function() {
		return this._document;
	}
});