Added Pointer.velocity and Pointer.angle as they're so common for gesture calculations.

Author: photonstorm

CHANGELOG.md

@@ -24,6 +24,8 @@
 * `Pointer.smoothFactor` is a float-value that allows you to automatically apply smoothing to the Pointer position as it moves. This is ideal when you want something smoothly tracking a pointer in a game, or are need a smooth drawing motion for an art package. The default value is zero, meaning disabled. Set to a small number, such as 0.2, to enable.
 * `Config.inputSmoothFactor` is a new property that allows you to set the smoothing factor for all Pointers the game creators. The default value is zero, which is disabled. Set in the game config as `input: { smoothFactor: value }`.
 * `InputManager.transformPointer` has a new boolean argument `wasMove`, which controls if the pointer is being transformed after a move or up/down event.
+* `Pointer.velocity` is a new Vector2 that contains the velocity of the Pointer, based on the previous and current position. This is updated whenever the Pointer moves, regardless of button states. If you find the velocity is too erratic, consider enabling the `smoothFactor`.
+* `Pointer.angle` is a new property that contains the angle of the Pointer, in radians, based on the previous and current position. This is updated whenever the Pointer moves, regardless of button states. If you find the angle is too erratic, consider enabling the `smoothFactor`.
 
 ### New Features
 

src/input/Pointer.js

@@ -120,6 +120,32 @@ var Pointer = new Class({
          */
         this.prevPosition = new Vector2();
 
+        /**
+         * The current velocity of the Pointer, based on its previous and current position.
+         * 
+         * This is updated whenever the Pointer moves, regardless of the state of any Pointer buttons.
+         * 
+         * If you are finding the velocity value too erratic, then consider enabling the `Pointer.smoothFactor`.
+         *
+         * @name Phaser.Input.Pointer#velocity
+         * @type {Phaser.Math.Vector2}
+         * @since 3.16.0
+         */
+        this.velocity = new Vector2();
+
+        /**
+         * The current angle the Pointer is moving, in radians, based on its previous and current position.
+         * 
+         * This is updated whenever the Pointer moves, regardless of the state of any Pointer buttons.
+         * 
+         * If you are finding the angle value too erratic, then consider enabling the `Pointer.smoothFactor`.
+         *
+         * @name Phaser.Input.Pointer#angle
+         * @type {number}
+         * @since 3.16.0
+         */
+        this.angle = new Vector2();
+
         /**
          * The smoothing factor to apply to the Pointer position.
          * 
@@ -502,6 +528,16 @@ var Pointer = new Class({
         //  Sets the local x/y properties
         this.manager.transformPointer(this, event.pageX, event.pageY, true);
 
+        var x1 = this.position.x;
+        var y1 = this.position.y;
+
+        var x2 = this.prevPosition.x;
+        var y2 = this.prevPosition.y;
+
+        this.velocity.x = x1 - x2;
+        this.velocity.y = y1 - y2;
+        this.angle = Math.atan2(y2 - y1, x2 - x1);
+
         if (this.manager.mouse.locked)
         {
             // Multiple DOM events may occur within one frame, but only one Phaser event will fire