add extjs 6.0.1 sources

[extjs.git] / extjs / packages / core / src / event / gesture / Rotate.js

/**\r
 * A simple event recognizer which knows when you rotate.\r
 */\r
Ext.define('Ext.event.gesture.Rotate', {\r
    extend: 'Ext.event.gesture.MultiTouch',\r
\r
    priority: 700,\r
\r
    handledEvents: ['rotatestart', 'rotate', 'rotateend', 'rotatecancel'],\r
\r
    /**\r
     * @member Ext.dom.Element\r
     * @event rotatestart\r
     * Fired once when a rotation has started.\r
     * @param {Ext.event.Event} event The {@link Ext.event.Event} event encapsulating the DOM event.\r
     * @param {HTMLElement} node The target of the event.\r
     * @param {Object} options The options object passed to Ext.mixin.Observable.addListener.\r
     */\r
\r
    /**\r
     * @member Ext.dom.Element\r
     * @event rotate\r
     * Fires continuously when there is rotation (the touch must move for this to be fired).\r
     * When listening to this, ensure you know about the {@link Ext.event.Event#angle} and {@link Ext.event.Event#rotation}\r
     * properties in the `event` object.\r
     * @param {Ext.event.Event} event The {@link Ext.event.Event} event encapsulating the DOM event.\r
     * @param {HTMLElement} node The target of the event.\r
     * @param {Object} options The options object passed to Ext.mixin.Observable.addListener.\r
     */\r
\r
    /**\r
     * @member Ext.dom.Element\r
     * @event rotateend\r
     * Fires when a rotation event has ended.\r
     * @param {Ext.event.Event} event The {@link Ext.event.Event} event encapsulating the DOM event.\r
     * @param {HTMLElement} node The target of the event.\r
     * @param {Object} options The options object passed to Ext.mixin.Observable.addListener.\r
     */\r
\r
    /**\r
     * @property {Number} angle\r
     * The angle of the rotation.\r
     *\r
     * **This is only available when the event type is `rotate`**\r
     * @member Ext.event.Event\r
     */\r
\r
    /**\r
     * @property {Number} rotation\r
     * A amount of rotation, since the start of the event.\r
     *\r
     * **This is only available when the event type is `rotate`**\r
     * @member Ext.event.Event\r
     */\r
\r
    startAngle: 0,\r
\r
    lastTouches: null,\r
\r
    lastAngle: null,\r
\r
    onTouchMove: function(e) {\r
        if (!this.isTracking) {\r
            return;\r
        }\r
\r
        var touches = e.touches,\r
            lastAngle = this.lastAngle,\r
            firstPoint, secondPoint, angle, nextAngle, previousAngle, diff;\r
\r
        firstPoint = touches[0].point;\r
        secondPoint = touches[1].point;\r
\r
        angle = firstPoint.getAngleTo(secondPoint);\r
\r
        if (lastAngle !== null) {\r
            diff = Math.abs(lastAngle - angle);\r
            nextAngle = angle + 360;\r
            previousAngle = angle - 360;\r
\r
            if (Math.abs(nextAngle - lastAngle) < diff) {\r
                angle = nextAngle;\r
            }\r
            else if (Math.abs(previousAngle - lastAngle) < diff) {\r
                angle = previousAngle;\r
            }\r
        }\r
\r
        this.lastAngle = angle;\r
\r
        if (!this.isStarted) {\r
            this.isStarted = true;\r
\r
            this.startAngle = angle;\r
\r
            this.fire('rotatestart', e, {\r
                touches: touches,\r
                angle: angle,\r
                rotation: 0\r
            });\r
        }\r
        else {\r
            this.fire('rotate', e, {\r
                touches: touches,\r
                angle: angle,\r
                rotation: angle - this.startAngle\r
            });\r
        }\r
\r
        this.lastTouches = Ext.Array.clone(touches);\r
    },\r
\r
    fireEnd: function(e) {\r
        this.lastAngle = null;\r
        this.fire('rotateend', e);\r
    },\r
\r
    fireCancel: function(e) {\r
        this.lastAngle = null;\r
        this.fire('rotatecancel', e);\r
    },\r
\r
    reset: function() {\r
        var me = this;\r
\r
        me.lastTouches = me.lastAngle = me.startAngle = null;\r
\r
        this.callParent();\r
    }\r
}, function(Rotate) {\r
    var gestures = Ext.manifest.gestures;\r
    Rotate.instance = new Rotate(gestures && gestures.rotate);\r
});\r