Introduce TrackablePointer.totalDistance

docs/api/trackable-pointer.md

@@ -50,7 +50,7 @@ The difference between the position of the pointer in this and in the previous f
 
 `pointer.velocity: Vector2, read-only`
 
-The current velocity of the pointer, given in normalized units per second. You can get the speed of motion by calculating the [magnitude](vector2.md#length) of this vector.
+The current velocity of the pointer, given in normalized units per second. You can get the current speed of motion by calculating the [magnitude](vector2.md#length) of this vector.
 
 ### elapsedTime
 
@@ -58,6 +58,12 @@ The current velocity of the pointer, given in normalized units per second. You c
 
 The elapsed time, in seconds, since the tracking of this pointer began.
 
+### totalDistance
+
+`pointer.totalDistance: number, read-only`
+
+How much this pointer has moved, in normalized units, since its tracking began. You can get the average speed of motion by calculating the ratio `totalDistance / elapsedTime`.
+
 ### isPrimary
 
 `pointer.isPrimary: boolean, read-only`

src/trackers/pointer-tracker/pointer-tracker.ts

@@ -304,6 +304,9 @@ export class PointerTracker implements Tracker
             // determine the elapsed time since the tracking began
             const elapsedTime = previous ? previous.elapsedTime + deltaTime : 0;
 
+            // determine how much this pointer has moved since its tracking began
+            const totalDistance = previous ? previous.totalDistance + deltaPosition.length() : 0;
+
             // determine whether or not this is the primary pointer for this type
             const isPrimary = event.isPrimary;
 
@@ -312,7 +315,7 @@ export class PointerTracker implements Tracker
 
             // we create new trackable instances on each frame;
             // these will be exported and consumed by the user
-            this._newPointers.set(id, { id, phase, position, deltaPosition, initialPosition, velocity, elapsedTime, isPrimary, kind });
+            this._newPointers.set(id, { id, phase, position, deltaPosition, initialPosition, velocity, elapsedTime, totalDistance, isPrimary, kind });
 
         }
 

src/trackers/pointer-tracker/trackable-pointer.ts

@@ -59,6 +59,9 @@ export interface TrackablePointer extends Trackable
     /** elapsed time, in seconds, since the tracking of this pointer began */
     readonly elapsedTime: number;
 
+    /** how much this pointer has moved, in normalized units, since its tracking began */
+    readonly totalDistance: number;
+
     /** whether or not this is the primary pointer for this type */
     readonly isPrimary: boolean;