Add reorientation component: face the direction of travel

src/component/ComponentName.ts

@@ -9,6 +9,7 @@ export type ComponentName =
     | "marker"
     | "pointer"
     | "popup"
+    | "reorientation"
     | "sequence"
     | "slider"
     | "spatial"

src/component/interfaces/ReorientationConfiguration.ts

@@ -0,0 +1,87 @@
+import { ComponentConfiguration } from "./ComponentConfiguration";
+
+/**
+ * Interface for configuration of the reorientation component.
+ *
+ * @interface
+ * @example
+ * ```js
+ * var viewer = new Viewer({
+ *     ...
+ *     component: {
+ *         reorientation: {
+ *             movingSpeedMps: 1,
+ *         },
+ *     },
+ *     ...
+ * });
+ * ```
+ */
+export interface ReorientationConfiguration extends ComponentConfiguration {
+    /**
+     * Number of images ahead in the sequence to precompute the
+     * reorientation for, so that a step lands on an already resolved
+     * bearing and the transition stays smooth.
+     *
+     * @default 3
+     */
+    prefetchAhead?: number;
+
+    /**
+     * Minimum GPS speed, in meters per second, above which travel is
+     * considered sustained motion and the GPS travel bearing is trusted.
+     *
+     * @default 1
+     */
+    movingSpeedMps?: number;
+
+    /**
+     * Below {@link movingSpeedMps}, a step is still accepted as motion
+     * (a slow turn rather than GPS noise) when the compass angle agrees
+     * with the travel bearing within {@link lowSpeedTurnMaxDeltaDeg} and
+     * the step is longer than this distance in meters.
+     *
+     * @default 2
+     */
+    lowSpeedTurnDistanceM?: number;
+
+    /**
+     * Maximum angle, in degrees, between compass angle and travel bearing
+     * for a low-speed step to be accepted as a genuine turn.
+     *
+     * @default 30
+     */
+    lowSpeedTurnMaxDeltaDeg?: number;
+
+    /**
+     * Maximum bearing change, in degrees, from the last confirmed moving
+     * bearing before a step is rejected as a GPS outlier and the previous
+     * bearing is held instead.
+     *
+     * @default 90
+     */
+    outlierMaxDeltaDeg?: number;
+
+    /**
+     * Number of preceding images to scan in cache for prior motion context.
+     *
+     * @default 5
+     */
+    previousContextWindow?: number;
+
+    /**
+     * Number of preceding images to scan when validating bearing continuity
+     * for a moving image.
+     *
+     * @default 10
+     */
+    movingHistoryWindow?: number;
+
+    /**
+     * Number of preceding images to scan for the last confirmed moving
+     * bearing when the current step is not itself moving.
+     *
+     * @default 100
+     */
+    fallbackHistoryWindow?: number;
+}