Introduce TrackablePointer.totalDistance

docs/api/trackable-pointer.md

 
 `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
 
 
 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

             // 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;
 
 
             // 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

     /** 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;