@meimu/mutracer 0.1.0 → 0.1.1

package/lib/util/fromTHREE.js

@@ -936,6 +936,24 @@ function convertScene(scene, options, store) {
         lights
     };
 }
+/** Inputs that can wake an idle OrbitControls instance, without inspecting its private inertia. */
+function orbitControlsState(camera, controls) {
+    if (!camera || !controls.getPolarAngle || !controls.getAzimuthalAngle)
+        return;
+    camera.parent?.updateWorldMatrix(true, false);
+    const state = [camera, controls.update, camera.parent, ...camera.position.toArray(), ...camera.quaternion.toArray(),
+        ...camera.scale.toArray(), ...camera.up.toArray(), camera.zoom, ...(camera.parent?.matrixWorld.elements ?? [])];
+    for (const [key, value] of Object.entries(controls)) {
+        if (key.startsWith('_'))
+            continue;
+        const vector = value;
+        if (vector?.isVector3)
+            state.push(key, ...vector.toArray());
+        else if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'string')
+            state.push(key, value);
+    }
+    return state;
+}
 /**
  * Keeps one MuTracer scene in sync with a Three.js scene, reusing unchanged objects.
  * Skinning/morph targets run on the CPU with per-source-mesh dynamic geometry.
@@ -955,7 +973,8 @@ export class THREESync extends Sync {
     _started = false;
     _cameraState = [];
     _lastUpdate;
-    _start = () => { this._started = true; this.setActive(true); };
+    _idleControlsState;
+    _start = () => { this._started = true; this._idleControlsState = undefined; this.setActive(true); };
     _end = () => { this._started = false; };
     /** Subscribes to controls without converting sources or modifying the engine. */
     constructor(engine, _options = {}) {
@@ -971,25 +990,53 @@ export class THREESync extends Sync {
         if (this._disposed)
             throw new Error('THREESync has been disposed');
         const now = performance.now(), controls = this._options.controls, sourceCamera = this._options.camera;
-        const dt = this._lastUpdate === undefined ? 0 : Math.min(.1, Math.max(0, (now - this._lastUpdate) / 1000));
+        const elapsed = this._lastUpdate === undefined ? 0 : Math.max(0, (now - this._lastUpdate) / 1000);
+        const dt = Math.min(.1, elapsed);
         this._lastUpdate = now;
         let moving = false, settled = false;
         if (controls && this._options.updateControls !== false) {
-            const position = sourceCamera?.position.clone(), zoom = sourceCamera?.zoom;
-            moving = !!controls.update(dt);
-            if (moving && !this._started && !controls.autoRotate && controls.enableDamping && position && sourceCamera && controls.target) {
-                const step = position.distanceTo(sourceCamera.position);
-                const zoomStep = Math.abs(Math.log(sourceCamera.zoom / zoom));
-                if (step < 5e-4 * sourceCamera.position.distanceTo(controls.target) && zoomStep < 5e-4) {
-                    controls.enableDamping = false;
-                    try {
-                        controls.update(0);
-                    }
-                    finally {
-                        controls.enableDamping = true;
+            const orbitInputs = orbitControlsState(sourceCamera, controls);
+            const idle = !this._started && !controls.autoRotate && orbitInputs && this._idleControlsState && snapshotsEqual(orbitInputs, this._idleControlsState);
+            if (!idle) {
+                this._idleControlsState = undefined;
+                const position = sourceCamera?.position.clone(), rotation = sourceCamera?.quaternion.clone(), zoom = sourceCamera?.zoom;
+                const target = controls.target?.clone(), damping = controls.dampingFactor;
+                const frameDamping = controls.enableDamping && damping !== undefined && damping >= 0 && damping <= 1
+                    ? 1 - Math.pow(1 - damping, elapsed * 60) : undefined;
+                if (frameDamping !== undefined)
+                    controls.dampingFactor = frameDamping;
+                try {
+                    moving = !!controls.update(dt);
+                }
+                finally {
+                    if (frameDamping !== undefined)
+                        controls.dampingFactor = damping;
+                }
+                if (!this._started && !controls.autoRotate && controls.enableDamping && position && sourceCamera && controls.target) {
+                    const referenceScale = frameDamping ? damping / frameDamping : 1;
+                    const step = position.distanceTo(sourceCamera.position) * referenceScale;
+                    const zoomStep = Math.abs(Math.log(sourceCamera.zoom / zoom)) * referenceScale;
+                    const poseChanged = step > 0 || sourceCamera.zoom !== zoom || !!(orbitInputs && (!rotation.equals(sourceCamera.quaternion) || !target.equals(controls.target)));
+                    // End the remaining inertia once its 60 Hz movement is imperceptible.
+                    // update() can return false before that tail has actually stopped.
+                    if ((moving || poseChanged) && step < 5e-4 * sourceCamera.position.distanceTo(controls.target) && zoomStep < 5e-4) {
+                        controls.enableDamping = false;
+                        try {
+                            controls.update(0);
+                        }
+                        finally {
+                            controls.enableDamping = true;
+                        }
+                        moving = false;
+                        settled = true;
                     }
-                    moving = false;
-                    settled = true;
+                    // Once stopped, no more spherical/cartesian round trips occur until
+                    // a gesture, source pose, parent transform or public control option changes.
+                    if (orbitInputs && (settled || (!moving && !poseChanged)))
+                        this._idleControlsState = orbitControlsState(sourceCamera, controls);
+                }
+                else if (orbitInputs && !this._started && !controls.autoRotate && !moving) {
+                    this._idleControlsState = orbitControlsState(sourceCamera, controls);
                 }
             }
         }
@@ -1025,6 +1072,7 @@ export class THREESync extends Sync {
         this._options.controls?.removeEventListener('start', this._start);
         this._options.controls?.removeEventListener('end', this._end);
         this._store = createConversionStore();
+        this._idleControlsState = undefined;
         this._disposed = true;
         super.dispose();
     }