@babylonjs/core 8.36.1 → 8.37.1

package/AudioV2/webAudio/components/webAudioParameterComponent.d.ts

@@ -3,9 +3,6 @@ import type { IAudioParameterRampOptions } from "../../audioParameter.js";
 import type { _WebAudioEngine } from "../webAudioEngine.js";
 /** @internal */
 export declare class _WebAudioParameterComponent {
-    private _deferredRampOptions;
-    private _deferredTargetValue;
-    private _isObservingUpdates;
     private _rampEndTime;
     private _engine;
     private _param;
@@ -24,22 +21,7 @@ export declare class _WebAudioParameterComponent {
     /**
      * Sets the target value of the audio parameter with an optional ramping duration and shape.
      *
-     * If a ramp is close to finishing, it will wait for the ramp to finish before setting the new value; otherwise it
-     * will throw an error because of a bug in Firefox that prevents active ramps from being cancelled with
-     * `cancelScheduledValues`. See https://bugzilla.mozilla.org/show_bug.cgi?id=1752775. Other browsers do not have
-     * this issue, but we throw an error in all browsers to ensure consistent behavior.
-     *
-     * There are other similar WebAudio APIs for ramping parameters, (e.g. `linearRampToValueAtTime` and
-     * `exponentialRampToValueAtTime`) but they don't work in Firefox and Meta Quest Chrome.
-     *
-     * It may be better in the long run to implement our own ramping logic with a WASM audio worklet instead of using
-     * `setValueCurveAtTime`. Another alternative is to use `setValueAtTime` wtih a custom shape, but that will
-     * probably be a performance hit to maintain quality at audio rates.
-     *
      * @internal
      */
     setTargetValue(value: number, options?: Nullable<Partial<IAudioParameterRampOptions>>): void;
-    private _deferRamp;
-    private _applyDeferredRamp;
-    private _clearDeferredRamp;
 }

package/AudioV2/webAudio/components/webAudioParameterComponent.js

@@ -1,16 +1,4 @@
 import { _GetAudioParamCurveValues } from "../../audioUtils.js";
-/**
- * Maximum time in seconds to wait for an active ramp to finish before starting a new ramp.
- *
- * New ramps will throw an error if the active ramp has more than this amount of time remaining.
- *
- * This is needed because short ramps are used to avoid pops and clicks when setting audio parameters, and we
- * don't want to throw an error if a short ramp is active.
- *
- * This constant is set to 11 milliseconds, which is short enough to avoid perceptual differences in most cases, but
- * long enough to allow for short ramps to be completed in a reasonable time frame.
- */
-const MaxWaitTime = 0.011;
 /**
  * Minimum duration in seconds for a ramp to be considered valid.
  *
@@ -22,18 +10,7 @@ const MinRampDuration = 0.000001;
 export class _WebAudioParameterComponent {
     /** @internal */
     constructor(engine, param) {
-        this._deferredRampOptions = {
-            duration: 0,
-            shape: "linear" /* AudioParameterRampShape.Linear */,
-        };
-        this._deferredTargetValue = -1;
-        this._isObservingUpdates = false;
         this._rampEndTime = 0;
-        this._applyDeferredRamp = () => {
-            if (0 < this._deferredRampOptions.duration && this._rampEndTime < this._engine.currentTime) {
-                this.setTargetValue(this._deferredTargetValue, this._deferredRampOptions);
-            }
-        };
         this._engine = engine;
         this._param = param;
         this._targetValue = param.value;
@@ -55,68 +32,31 @@ export class _WebAudioParameterComponent {
     }
     /** @internal */
     dispose() {
-        this._clearDeferredRamp();
         this._param = null;
         this._engine = null;
     }
     /**
      * Sets the target value of the audio parameter with an optional ramping duration and shape.
      *
-     * If a ramp is close to finishing, it will wait for the ramp to finish before setting the new value; otherwise it
-     * will throw an error because of a bug in Firefox that prevents active ramps from being cancelled with
-     * `cancelScheduledValues`. See https://bugzilla.mozilla.org/show_bug.cgi?id=1752775. Other browsers do not have
-     * this issue, but we throw an error in all browsers to ensure consistent behavior.
-     *
-     * There are other similar WebAudio APIs for ramping parameters, (e.g. `linearRampToValueAtTime` and
-     * `exponentialRampToValueAtTime`) but they don't work in Firefox and Meta Quest Chrome.
-     *
-     * It may be better in the long run to implement our own ramping logic with a WASM audio worklet instead of using
-     * `setValueCurveAtTime`. Another alternative is to use `setValueAtTime` wtih a custom shape, but that will
-     * probably be a performance hit to maintain quality at audio rates.
-     *
      * @internal
      */
     setTargetValue(value, options = null) {
-        if (this._targetValue === value) {
-            return;
-        }
         const shape = typeof options?.shape === "string" ? options.shape : "linear" /* AudioParameterRampShape.Linear */;
-        let duration = typeof options?.duration === "number" ? Math.max(options.duration, this._engine.parameterRampDuration) : this._engine.parameterRampDuration;
         const startTime = this._engine.currentTime;
-        if (startTime < this._rampEndTime) {
-            const timeLeft = this._rampEndTime - startTime;
-            if (MaxWaitTime < timeLeft) {
-                throw new Error("Audio parameter not set. Wait for current ramp to finish.");
-            }
-            else {
-                this._deferRamp(value, duration, shape);
-                return;
-            }
+        if (shape === "none" /* AudioParameterRampShape.None */) {
+            this._param.cancelScheduledValues(startTime);
+            this._param.value = this._targetValue = value;
+            this._rampEndTime = startTime;
+            return;
         }
+        let duration = typeof options?.duration === "number" ? Math.max(options.duration, this._engine.parameterRampDuration) : this._engine.parameterRampDuration;
         if ((duration = Math.max(this._engine.parameterRampDuration, duration)) < MinRampDuration) {
             this._param.setValueAtTime((this._targetValue = value), startTime);
             return;
         }
         this._param.cancelScheduledValues(startTime);
-        this._param.setValueCurveAtTime(_GetAudioParamCurveValues(shape, this._targetValue, (this._targetValue = value)), startTime, duration);
-        this._clearDeferredRamp();
+        this._param.setValueCurveAtTime(_GetAudioParamCurveValues(shape, this._param.value, (this._targetValue = value)), startTime, duration);
         this._rampEndTime = startTime + duration;
     }
-    _deferRamp(value, duration, shape) {
-        this._deferredRampOptions.duration = duration;
-        this._deferredRampOptions.shape = shape;
-        this._deferredTargetValue = value;
-        if (!this._isObservingUpdates) {
-            this._engine._addUpdateObserver(this._applyDeferredRamp);
-            this._isObservingUpdates = true;
-        }
-    }
-    _clearDeferredRamp() {
-        this._deferredRampOptions.duration = 0;
-        if (this._isObservingUpdates) {
-            this._engine._removeUpdateObserver(this._applyDeferredRamp);
-            this._isObservingUpdates = false;
-        }
-    }
 }
 //# sourceMappingURL=webAudioParameterComponent.js.map

package/AudioV2/webAudio/components/webAudioParameterComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"webAudioParameterComponent.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/webAudio/components/webAudioParameterComponent.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"../../../types\";\nimport type { IAudioParameterRampOptions } from \"../../audioParameter\";\nimport { AudioParameterRampShape } from \"../../audioParameter\";\nimport { _GetAudioParamCurveValues } from \"../../audioUtils\";\nimport type { _WebAudioEngine } from \"../webAudioEngine\";\n\n/**\n * Maximum time in seconds to wait for an active ramp to finish before starting a new ramp.\n *\n * New ramps will throw an error if the active ramp has more than this amount of time remaining.\n *\n * This is needed because short ramps are used to avoid pops and clicks when setting audio parameters, and we\n * don't want to throw an error if a short ramp is active.\n *\n * This constant is set to 11 milliseconds, which is short enough to avoid perceptual differences in most cases, but\n * long enough to allow for short ramps to be completed in a reasonable time frame.\n */\nconst MaxWaitTime = 0.011;\n\n/**\n * Minimum duration in seconds for a ramp to be considered valid.\n *\n * If the duration is less than this value, the value will be set immediately instead of being ramped smoothly since\n * there is no perceptual difference for such short durations, so a ramp is not needed.\n */\nconst MinRampDuration = 0.000001;\n\n/** @internal */\nexport class _WebAudioParameterComponent {\n    private _deferredRampOptions = {\n        duration: 0,\n        shape: AudioParameterRampShape.Linear,\n    };\n    private _deferredTargetValue = -1;\n    private _isObservingUpdates = false;\n    private _rampEndTime: number = 0;\n    private _engine: _WebAudioEngine;\n    private _param: AudioParam;\n    private _targetValue: number;\n\n    /** @internal */\n    constructor(engine: _WebAudioEngine, param: AudioParam) {\n        this._engine = engine;\n        this._param = param;\n        this._targetValue = param.value;\n    }\n\n    /** @internal */\n    public get isRamping(): boolean {\n        return this._engine.currentTime < this._rampEndTime;\n    }\n\n    /** @internal */\n    public get targetValue(): number {\n        return this._targetValue;\n    }\n\n    public set targetValue(value: number) {\n        this.setTargetValue(value);\n    }\n\n    /** @internal */\n    public get value(): number {\n        return this._param.value;\n    }\n\n    /** @internal */\n    public dispose(): void {\n        this._clearDeferredRamp();\n\n        this._param = null!;\n        this._engine = null!;\n    }\n\n    /**\n     * Sets the target value of the audio parameter with an optional ramping duration and shape.\n     *\n     * If a ramp is close to finishing, it will wait for the ramp to finish before setting the new value; otherwise it\n     * will throw an error because of a bug in Firefox that prevents active ramps from being cancelled with\n     * `cancelScheduledValues`. See https://bugzilla.mozilla.org/show_bug.cgi?id=1752775. Other browsers do not have\n     * this issue, but we throw an error in all browsers to ensure consistent behavior.\n     *\n     * There are other similar WebAudio APIs for ramping parameters, (e.g. `linearRampToValueAtTime` and\n     * `exponentialRampToValueAtTime`) but they don't work in Firefox and Meta Quest Chrome.\n     *\n     * It may be better in the long run to implement our own ramping logic with a WASM audio worklet instead of using\n     * `setValueCurveAtTime`. Another alternative is to use `setValueAtTime` wtih a custom shape, but that will\n     * probably be a performance hit to maintain quality at audio rates.\n     *\n     * @internal\n     */\n    public setTargetValue(value: number, options: Nullable<Partial<IAudioParameterRampOptions>> = null): void {\n        if (this._targetValue === value) {\n            return;\n        }\n\n        const shape = typeof options?.shape === \"string\" ? options.shape : AudioParameterRampShape.Linear;\n\n        let duration = typeof options?.duration === \"number\" ? Math.max(options.duration, this._engine.parameterRampDuration) : this._engine.parameterRampDuration;\n        const startTime = this._engine.currentTime;\n\n        if (startTime < this._rampEndTime) {\n            const timeLeft = this._rampEndTime - startTime;\n\n            if (MaxWaitTime < timeLeft) {\n                throw new Error(\"Audio parameter not set. Wait for current ramp to finish.\");\n            } else {\n                this._deferRamp(value, duration, shape);\n                return;\n            }\n        }\n\n        if ((duration = Math.max(this._engine.parameterRampDuration, duration)) < MinRampDuration) {\n            this._param.setValueAtTime((this._targetValue = value), startTime);\n            return;\n        }\n\n        this._param.cancelScheduledValues(startTime);\n        this._param.setValueCurveAtTime(_GetAudioParamCurveValues(shape, this._targetValue, (this._targetValue = value)), startTime, duration);\n\n        this._clearDeferredRamp();\n\n        this._rampEndTime = startTime + duration;\n    }\n\n    private _deferRamp(value: number, duration: number, shape: AudioParameterRampShape): void {\n        this._deferredRampOptions.duration = duration;\n        this._deferredRampOptions.shape = shape;\n        this._deferredTargetValue = value;\n\n        if (!this._isObservingUpdates) {\n            this._engine._addUpdateObserver(this._applyDeferredRamp);\n            this._isObservingUpdates = true;\n        }\n    }\n\n    private _applyDeferredRamp = () => {\n        if (0 < this._deferredRampOptions.duration && this._rampEndTime < this._engine.currentTime) {\n            this.setTargetValue(this._deferredTargetValue, this._deferredRampOptions);\n        }\n    };\n\n    private _clearDeferredRamp(): void {\n        this._deferredRampOptions.duration = 0;\n\n        if (this._isObservingUpdates) {\n            this._engine._removeUpdateObserver(this._applyDeferredRamp);\n            this._isObservingUpdates = false;\n        }\n    }\n}\n"]}
+{"version":3,"file":"webAudioParameterComponent.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/webAudio/components/webAudioParameterComponent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG7D;;;;;GAKG;AACH,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEjC,gBAAgB;AAChB,MAAM,OAAO,2BAA2B;IAMpC,gBAAgB;IAChB,YAAY,MAAuB,EAAE,KAAiB;QAN9C,iBAAY,GAAW,CAAC,CAAC;QAO7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,gBAAgB;IAChB,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;IACxD,CAAC;IAED,gBAAgB;IAChB,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,IAAW,WAAW,CAAC,KAAa;QAChC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,gBAAgB;IAChB,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,gBAAgB;IACT,OAAO;QACV,IAAI,CAAC,MAAM,GAAG,IAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAK,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,cAAc,CAAC,KAAa,EAAE,UAAyD,IAAI;QAC9F,MAAM,KAAK,GAAG,OAAO,OAAO,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,8CAA+B,CAAC;QAElG,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAE3C,IAAI,KAAK,8CAAiC,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC9C,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,OAAO;QACX,CAAC;QAED,IAAI,QAAQ,GAAG,OAAO,OAAO,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC;QAE3J,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC,GAAG,eAAe,EAAE,CAAC;YACxF,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;YACnE,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEvI,IAAI,CAAC,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC7C,CAAC;CACJ","sourcesContent":["import type { Nullable } from \"../../../types\";\nimport type { IAudioParameterRampOptions } from \"../../audioParameter\";\nimport { AudioParameterRampShape } from \"../../audioParameter\";\nimport { _GetAudioParamCurveValues } from \"../../audioUtils\";\nimport type { _WebAudioEngine } from \"../webAudioEngine\";\n\n/**\n * Minimum duration in seconds for a ramp to be considered valid.\n *\n * If the duration is less than this value, the value will be set immediately instead of being ramped smoothly since\n * there is no perceptual difference for such short durations, so a ramp is not needed.\n */\nconst MinRampDuration = 0.000001;\n\n/** @internal */\nexport class _WebAudioParameterComponent {\n    private _rampEndTime: number = 0;\n    private _engine: _WebAudioEngine;\n    private _param: AudioParam;\n    private _targetValue: number;\n\n    /** @internal */\n    constructor(engine: _WebAudioEngine, param: AudioParam) {\n        this._engine = engine;\n        this._param = param;\n        this._targetValue = param.value;\n    }\n\n    /** @internal */\n    public get isRamping(): boolean {\n        return this._engine.currentTime < this._rampEndTime;\n    }\n\n    /** @internal */\n    public get targetValue(): number {\n        return this._targetValue;\n    }\n\n    public set targetValue(value: number) {\n        this.setTargetValue(value);\n    }\n\n    /** @internal */\n    public get value(): number {\n        return this._param.value;\n    }\n\n    /** @internal */\n    public dispose(): void {\n        this._param = null!;\n        this._engine = null!;\n    }\n\n    /**\n     * Sets the target value of the audio parameter with an optional ramping duration and shape.\n     *\n     * @internal\n     */\n    public setTargetValue(value: number, options: Nullable<Partial<IAudioParameterRampOptions>> = null): void {\n        const shape = typeof options?.shape === \"string\" ? options.shape : AudioParameterRampShape.Linear;\n\n        const startTime = this._engine.currentTime;\n\n        if (shape === AudioParameterRampShape.None) {\n            this._param.cancelScheduledValues(startTime);\n            this._param.value = this._targetValue = value;\n            this._rampEndTime = startTime;\n            return;\n        }\n\n        let duration = typeof options?.duration === \"number\" ? Math.max(options.duration, this._engine.parameterRampDuration) : this._engine.parameterRampDuration;\n\n        if ((duration = Math.max(this._engine.parameterRampDuration, duration)) < MinRampDuration) {\n            this._param.setValueAtTime((this._targetValue = value), startTime);\n            return;\n        }\n\n        this._param.cancelScheduledValues(startTime);\n        this._param.setValueCurveAtTime(_GetAudioParamCurveValues(shape, this._param.value, (this._targetValue = value)), startTime, duration);\n\n        this._rampEndTime = startTime + duration;\n    }\n}\n"]}

package/Behaviors/Cameras/interpolatingBehavior.d.ts

@@ -0,0 +1,58 @@
+import type { Behavior } from "../behavior.js";
+import { EasingFunction } from "../../Animations/easing.js";
+import type { Camera } from "../../Cameras/camera.js";
+import type { IColor3Like, IColor4Like, IMatrixLike, IQuaternionLike, IVector2Like, IVector3Like } from "../../Maths/math.like.js";
+export type AllowedAnimValue = number | IVector2Like | IVector3Like | IQuaternionLike | IMatrixLike | IColor3Like | IColor4Like | SizeLike | undefined;
+/**
+ * Animate camera property changes with an interpolation effect
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/behaviors/cameraBehaviors
+ */
+export declare class InterpolatingBehavior<C extends Camera = Camera> implements Behavior<C> {
+    /**
+     * Gets the name of the behavior.
+     */
+    get name(): string;
+    /**
+     * The easing function to use for interpolation
+     */
+    easingFunction: EasingFunction;
+    /**
+     * The easing mode (default is EASINGMODE_EASEINOUT)
+     */
+    easingMode: number;
+    /**
+     * Duration of the animation in milliseconds
+     */
+    transitionDuration: number;
+    private _attachedCamera;
+    private _animatables;
+    private _promiseResolve?;
+    /**
+     * Initializes the behavior
+     */
+    constructor();
+    /**
+     * Initializes the behavior
+     */
+    init(): void;
+    /**
+     * Attaches the behavior to a camera
+     * @param camera The camera to attach to
+     */
+    attach(camera: C): void;
+    /**
+     * Detaches the behavior from the camera
+     */
+    detach(): void;
+    get isInterpolating(): boolean;
+    /**
+     * Stops and removes all animations
+     */
+    stopAllAnimations(): void;
+    updateProperties<K extends keyof C>(properties: Map<K, AllowedAnimValue>): void;
+    animatePropertiesAsync<K extends keyof C>(properties: Map<K, AllowedAnimValue>, transitionDuration?: number, easingFn?: EasingFunction): Promise<void>;
+}
+export type SizeLike = {
+    width: number;
+    height: number;
+};

package/Behaviors/Cameras/interpolatingBehavior.js

@@ -0,0 +1,157 @@
+import { CubicEase, EasingFunction } from "../../Animations/easing.js";
+import { Animation } from "../../Animations/animation.js";
+/**
+ * Animate camera property changes with an interpolation effect
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/behaviors/cameraBehaviors
+ */
+export class InterpolatingBehavior {
+    /**
+     * Gets the name of the behavior.
+     */
+    get name() {
+        return "Interpolating";
+    }
+    /**
+     * Initializes the behavior
+     */
+    constructor() {
+        /**
+         * The easing function to use for interpolation
+         */
+        this.easingFunction = new CubicEase();
+        /**
+         * The easing mode (default is EASINGMODE_EASEINOUT)
+         */
+        this.easingMode = EasingFunction.EASINGMODE_EASEINOUT;
+        /**
+         * Duration of the animation in milliseconds
+         */
+        this.transitionDuration = 450;
+        this._attachedCamera = null;
+        this._animatables = new Map();
+        this.easingFunction.setEasingMode(this.easingMode);
+    }
+    /**
+     * Initializes the behavior
+     */
+    init() {
+        // Nothing to do on init
+    }
+    /**
+     * Attaches the behavior to a camera
+     * @param camera The camera to attach to
+     */
+    attach(camera) {
+        this._attachedCamera = camera;
+    }
+    /**
+     * Detaches the behavior from the camera
+     */
+    detach() {
+        if (!this._attachedCamera) {
+            return;
+        }
+        this.stopAllAnimations();
+        this._attachedCamera = null;
+    }
+    get isInterpolating() {
+        return this._animatables.size > 0;
+    }
+    /**
+     * Stops and removes all animations
+     */
+    stopAllAnimations() {
+        if (this._attachedCamera) {
+            this._animatables.forEach((animatable) => animatable.stop());
+        }
+        this._animatables.clear();
+        this._promiseResolve?.();
+        this._promiseResolve = undefined;
+    }
+    updateProperties(properties) {
+        properties.forEach((value, key) => {
+            if (value !== undefined) {
+                const animatable = this._animatables.get(String(key));
+                animatable && (animatable.target = value);
+            }
+        });
+    }
+    async animatePropertiesAsync(properties, transitionDuration = this.transitionDuration, easingFn = this.easingFunction) {
+        const promise = new Promise((resolve) => {
+            this._promiseResolve = resolve;
+            this.stopAllAnimations();
+            if (!this._attachedCamera) {
+                this._promiseResolve = undefined;
+                return resolve();
+            }
+            const camera = this._attachedCamera;
+            const scene = camera.getScene();
+            const checkClear = (animation) => {
+                this._animatables.delete(animation);
+                if (this._animatables.size === 0) {
+                    this._promiseResolve = undefined;
+                    resolve();
+                }
+            };
+            properties.forEach((value, key) => {
+                if (value !== undefined) {
+                    const propertyName = String(key);
+                    const animation = Animation.CreateAnimation(propertyName, GetAnimationType(value), 60, easingFn);
+                    const animatable = Animation.TransitionTo(propertyName, value, camera, scene, 60, animation, transitionDuration, () => checkClear(propertyName));
+                    if (animatable) {
+                        this._animatables.set(propertyName, animatable);
+                    }
+                }
+            });
+        });
+        return await promise;
+    }
+}
+// Structural type-guards (no instanceof)
+function IsQuaternionLike(v) {
+    return v != null && typeof v.x === "number" && typeof v.y === "number" && typeof v.z === "number" && typeof v.w === "number";
+}
+function IsMatrixLike(v) {
+    return v != null && (Array.isArray(v.m) || typeof v.m === "object");
+}
+function IsVector3Like(v) {
+    return v != null && typeof v.x === "number" && typeof v.y === "number" && typeof v.z === "number";
+}
+function IsVector2Like(v) {
+    return v != null && typeof v.x === "number" && typeof v.y === "number";
+}
+function IsColor3Like(v) {
+    return v != null && typeof v.r === "number" && typeof v.g === "number" && typeof v.b === "number";
+}
+function IsColor4Like(v) {
+    return v != null && typeof v.r === "number" && typeof v.g === "number" && typeof v.b === "number" && typeof v.a === "number";
+}
+function IsSizeLike(v) {
+    return v != null && typeof v.width === "number" && typeof v.height === "number";
+}
+const GetAnimationType = (value) => {
+    if (IsQuaternionLike(value)) {
+        return Animation.ANIMATIONTYPE_QUATERNION;
+    }
+    if (IsMatrixLike(value)) {
+        return Animation.ANIMATIONTYPE_MATRIX;
+    }
+    if (IsVector3Like(value)) {
+        return Animation.ANIMATIONTYPE_VECTOR3;
+    }
+    if (IsVector2Like(value)) {
+        return Animation.ANIMATIONTYPE_VECTOR2;
+    }
+    if (IsColor3Like(value)) {
+        return Animation.ANIMATIONTYPE_COLOR3;
+    }
+    if (IsColor4Like(value)) {
+        return Animation.ANIMATIONTYPE_COLOR4;
+    }
+    if (IsSizeLike(value)) {
+        return Animation.ANIMATIONTYPE_SIZE;
+    }
+    // Fallback to float for numbers and unknown shapes
+    return Animation.ANIMATIONTYPE_FLOAT;
+};
+//# sourceMappingURL=interpolatingBehavior.js.map

package/Behaviors/Cameras/interpolatingBehavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolatingBehavior.js","sourceRoot":"","sources":["../../../../../dev/core/src/Behaviors/Cameras/interpolatingBehavior.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Behavior } from \"../behavior\";\r\nimport { CubicEase, EasingFunction } from \"../../Animations/easing\";\r\nimport type { Nullable } from \"../../types\";\r\nimport type { Animatable } from \"../../Animations/animatable.core\";\r\nimport { Animation } from \"../../Animations/animation\";\r\nimport type { Camera } from \"../../Cameras/camera\";\r\nimport type { IColor3Like, IColor4Like, IMatrixLike, IQuaternionLike, IVector2Like, IVector3Like } from \"../../Maths/math.like\";\r\n\r\nexport type AllowedAnimValue = number | IVector2Like | IVector3Like | IQuaternionLike | IMatrixLike | IColor3Like | IColor4Like | SizeLike | undefined;\r\n\r\n/**\r\n * Animate camera property changes with an interpolation effect\r\n * @see https://doc.babylonjs.com/features/featuresDeepDive/behaviors/cameraBehaviors\r\n */\r\nexport class InterpolatingBehavior<C extends Camera = Camera> implements Behavior<C> {\r\n    /**\r\n     * Gets the name of the behavior.\r\n     */\r\n    public get name(): string {\r\n        return \"Interpolating\";\r\n    }\r\n\r\n    /**\r\n     * The easing function to use for interpolation\r\n     */\r\n    public easingFunction: EasingFunction = new CubicEase();\r\n\r\n    /**\r\n     * The easing mode (default is EASINGMODE_EASEINOUT)\r\n     */\r\n    public easingMode = EasingFunction.EASINGMODE_EASEINOUT;\r\n\r\n    /**\r\n     * Duration of the animation in milliseconds\r\n     */\r\n    public transitionDuration = 450;\r\n\r\n    private _attachedCamera: Nullable<C> = null;\r\n    private _animatables: Map<string, Animatable> = new Map<string, Animatable>();\r\n    private _promiseResolve?: () => void;\r\n\r\n    /**\r\n     * Initializes the behavior\r\n     */\r\n    constructor() {\r\n        this.easingFunction.setEasingMode(this.easingMode);\r\n    }\r\n\r\n    /**\r\n     * Initializes the behavior\r\n     */\r\n    public init(): void {\r\n        // Nothing to do on init\r\n    }\r\n\r\n    /**\r\n     * Attaches the behavior to a camera\r\n     * @param camera The camera to attach to\r\n     */\r\n    public attach(camera: C): void {\r\n        this._attachedCamera = camera;\r\n    }\r\n\r\n    /**\r\n     * Detaches the behavior from the camera\r\n     */\r\n    public detach(): void {\r\n        if (!this._attachedCamera) {\r\n            return;\r\n        }\r\n\r\n        this.stopAllAnimations();\r\n        this._attachedCamera = null;\r\n    }\r\n\r\n    public get isInterpolating(): boolean {\r\n        return this._animatables.size > 0;\r\n    }\r\n\r\n    /**\r\n     * Stops and removes all animations\r\n     */\r\n    public stopAllAnimations(): void {\r\n        if (this._attachedCamera) {\r\n            this._animatables.forEach((animatable) => animatable.stop());\r\n        }\r\n        this._animatables.clear();\r\n        this._promiseResolve?.();\r\n        this._promiseResolve = undefined;\r\n    }\r\n\r\n    public updateProperties<K extends keyof C>(properties: Map<K, AllowedAnimValue>): void {\r\n        properties.forEach((value, key) => {\r\n            if (value !== undefined) {\r\n                const animatable = this._animatables.get(String(key));\r\n                animatable && (animatable.target = value as unknown as any);\r\n            }\r\n        });\r\n    }\r\n\r\n    public async animatePropertiesAsync<K extends keyof C>(\r\n        properties: Map<K, AllowedAnimValue>,\r\n        transitionDuration: number = this.transitionDuration,\r\n        easingFn: EasingFunction = this.easingFunction\r\n    ): Promise<void> {\r\n        const promise = new Promise<void>((resolve) => {\r\n            this._promiseResolve = resolve;\r\n            this.stopAllAnimations();\r\n            if (!this._attachedCamera) {\r\n                this._promiseResolve = undefined;\r\n                return resolve();\r\n            }\r\n            const camera = this._attachedCamera;\r\n            const scene = camera.getScene();\r\n\r\n            const checkClear = (animation: string) => {\r\n                this._animatables.delete(animation);\r\n                if (this._animatables.size === 0) {\r\n                    this._promiseResolve = undefined;\r\n                    resolve();\r\n                }\r\n            };\r\n\r\n            properties.forEach((value, key) => {\r\n                if (value !== undefined) {\r\n                    const propertyName = String(key);\r\n                    const animation = Animation.CreateAnimation(propertyName, GetAnimationType(value), 60, easingFn);\r\n                    const animatable = Animation.TransitionTo(propertyName, value, camera, scene, 60, animation, transitionDuration, () => checkClear(propertyName));\r\n                    if (animatable) {\r\n                        this._animatables.set(propertyName, animatable);\r\n                    }\r\n                }\r\n            });\r\n        });\r\n        return await promise;\r\n    }\r\n}\r\n\r\n// Structural type-guards (no instanceof)\r\nfunction IsQuaternionLike(v: any): v is IQuaternionLike {\r\n    return v != null && typeof v.x === \"number\" && typeof v.y === \"number\" && typeof v.z === \"number\" && typeof v.w === \"number\";\r\n}\r\n\r\nfunction IsMatrixLike(v: any): v is IMatrixLike {\r\n    return v != null && (Array.isArray((v as any).m) || typeof (v as any).m === \"object\");\r\n}\r\n\r\nfunction IsVector3Like(v: any): v is IVector3Like {\r\n    return v != null && typeof v.x === \"number\" && typeof v.y === \"number\" && typeof v.z === \"number\";\r\n}\r\n\r\nfunction IsVector2Like(v: any): v is IVector2Like {\r\n    return v != null && typeof v.x === \"number\" && typeof v.y === \"number\";\r\n}\r\n\r\nfunction IsColor3Like(v: any): v is IColor3Like {\r\n    return v != null && typeof v.r === \"number\" && typeof v.g === \"number\" && typeof v.b === \"number\";\r\n}\r\n\r\nfunction IsColor4Like(v: any): v is IColor4Like {\r\n    return v != null && typeof v.r === \"number\" && typeof v.g === \"number\" && typeof v.b === \"number\" && typeof v.a === \"number\";\r\n}\r\n\r\nexport type SizeLike = { width: number; height: number };\r\n\r\nfunction IsSizeLike(v: any): v is SizeLike {\r\n    return v != null && typeof v.width === \"number\" && typeof v.height === \"number\";\r\n}\r\n\r\nconst GetAnimationType = (value: AllowedAnimValue): number => {\r\n    if (IsQuaternionLike(value)) {\r\n        return Animation.ANIMATIONTYPE_QUATERNION;\r\n    }\r\n    if (IsMatrixLike(value)) {\r\n        return Animation.ANIMATIONTYPE_MATRIX;\r\n    }\r\n    if (IsVector3Like(value)) {\r\n        return Animation.ANIMATIONTYPE_VECTOR3;\r\n    }\r\n    if (IsVector2Like(value)) {\r\n        return Animation.ANIMATIONTYPE_VECTOR2;\r\n    }\r\n    if (IsColor3Like(value)) {\r\n        return Animation.ANIMATIONTYPE_COLOR3;\r\n    }\r\n    if (IsColor4Like(value)) {\r\n        return Animation.ANIMATIONTYPE_COLOR4;\r\n    }\r\n    if (IsSizeLike(value)) {\r\n        return Animation.ANIMATIONTYPE_SIZE;\r\n    }\r\n\r\n    // Fallback to float for numbers and unknown shapes\r\n    return Animation.ANIMATIONTYPE_FLOAT;\r\n};\r\n"]}

package/Cameras/Inputs/arcRotateCameraPointersInput.d.ts

@@ -1,13 +1,13 @@
 import type { Nullable } from "../../types.js";
 import type { ArcRotateCamera } from "../../Cameras/arcRotateCamera.js";
-import { BaseCameraPointersInput } from "../../Cameras/Inputs/BaseCameraPointersInput.js";
+import { OrbitCameraPointersInput } from "../../Cameras/Inputs/orbitCameraPointersInput.js";
 import type { PointerTouch } from "../../Events/pointerEvents.js";
 import type { IPointerEvent } from "../../Events/deviceInputEvents.js";
 /**
  * Manage the pointers inputs to control an arc rotate camera.
  * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/customizingCameraInputs
  */
-export declare class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
+export declare class ArcRotateCameraPointersInput extends OrbitCameraPointersInput {
     /**
      * Defines the camera the input is attached to.
      */
@@ -53,42 +53,27 @@ export declare class ArcRotateCameraPointersInput extends BaseCameraPointersInpu
      * Overrides pinchDeltaPercentage and pinchPrecision.
      */
     useNaturalPinchZoom: boolean;
-    /**
-     * Defines whether zoom (2 fingers pinch) is enabled through multitouch
-     */
-    pinchZoom: boolean;
     /**
      * Defines the pointer panning sensibility or how fast is the camera moving.
      */
     panningSensibility: number;
-    /**
-     * Defines whether panning (2 fingers swipe) is enabled through multitouch.
-     */
-    multiTouchPanning: boolean;
-    /**
-     * Defines whether panning is enabled for both pan (2 fingers swipe) and
-     * zoom (pinch) through multitouch.
-     */
-    multiTouchPanAndZoom: boolean;
     /**
      * Revers pinch action direction.
      */
     pinchInwards: boolean;
     private _isPanClick;
-    private _twoFingerActivityCount;
-    private _isPinching;
     /**
      * Move camera from multi touch panning positions.
      * @param previousMultiTouchPanPosition
      * @param multiTouchPanPosition
      */
-    private _computeMultiTouchPanning;
+    protected _computeMultiTouchPanning(previousMultiTouchPanPosition: Nullable<PointerTouch>, multiTouchPanPosition: Nullable<PointerTouch>): void;
     /**
-     * Move camera from pinch zoom distances.
+     * Move camera from multitouch (pinch) zoom distances.
      * @param previousPinchSquaredDistance
      * @param pinchSquaredDistance
      */
-    private _computePinchZoom;
+    protected _computePinchZoom(previousPinchSquaredDistance: number, pinchSquaredDistance: number): void;
     /**
      * Called on pointer POINTERMOVE event if only a single touch is active.
      * @param point current touch point

package/Cameras/Inputs/arcRotateCameraPointersInput.js

@@ -1,12 +1,12 @@
 import { __decorate } from "../../tslib.es6.js";
 import { serialize } from "../../Misc/decorators.js";
 import { CameraInputTypes } from "../../Cameras/cameraInputsManager.js";
-import { BaseCameraPointersInput } from "../../Cameras/Inputs/BaseCameraPointersInput.js";
+import { OrbitCameraPointersInput } from "../../Cameras/Inputs/orbitCameraPointersInput.js";
 /**
  * Manage the pointers inputs to control an arc rotate camera.
  * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/customizingCameraInputs
  */
-export class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
+export class ArcRotateCameraPointersInput extends OrbitCameraPointersInput {
     constructor() {
         super(...arguments);
         /**
@@ -41,30 +41,15 @@ export class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
          * Overrides pinchDeltaPercentage and pinchPrecision.
          */
         this.useNaturalPinchZoom = false;
-        /**
-         * Defines whether zoom (2 fingers pinch) is enabled through multitouch
-         */
-        this.pinchZoom = true;
         /**
          * Defines the pointer panning sensibility or how fast is the camera moving.
          */
         this.panningSensibility = 1000.0;
-        /**
-         * Defines whether panning (2 fingers swipe) is enabled through multitouch.
-         */
-        this.multiTouchPanning = true;
-        /**
-         * Defines whether panning is enabled for both pan (2 fingers swipe) and
-         * zoom (pinch) through multitouch.
-         */
-        this.multiTouchPanAndZoom = true;
         /**
          * Revers pinch action direction.
          */
         this.pinchInwards = true;
         this._isPanClick = false;
-        this._twoFingerActivityCount = 0;
-        this._isPinching = false;
     }
     /**
      * Gets the class name of the current input.
@@ -87,7 +72,7 @@ export class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
         }
     }
     /**
-     * Move camera from pinch zoom distances.
+     * Move camera from multitouch (pinch) zoom distances.
      * @param previousPinchSquaredDistance
      * @param pinchSquaredDistance
      */
@@ -139,44 +124,9 @@ export class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
      * @param multiTouchPanPosition multi-touch position in current step
      */
     onMultiTouch(pointA, pointB, previousPinchSquaredDistance, pinchSquaredDistance, previousMultiTouchPanPosition, multiTouchPanPosition) {
-        if (previousPinchSquaredDistance === 0 && previousMultiTouchPanPosition === null) {
-            // First time this method is called for new pinch.
-            // Next time this is called there will be a
-            // previousPinchSquaredDistance and pinchSquaredDistance to compare.
-            return;
-        }
-        if (pinchSquaredDistance === 0 && multiTouchPanPosition === null) {
-            // Last time this method is called at the end of a pinch.
-            return;
-        }
-        // Zoom and panning enabled together
-        if (this.multiTouchPanAndZoom) {
-            this._computePinchZoom(previousPinchSquaredDistance, pinchSquaredDistance);
-            this._computeMultiTouchPanning(previousMultiTouchPanPosition, multiTouchPanPosition);
-            // Zoom and panning enabled but only one at a time
-        }
-        else if (this.multiTouchPanning && this.pinchZoom) {
-            this._twoFingerActivityCount++;
-            if (this._isPinching ||
-                (this._twoFingerActivityCount < 20 && Math.abs(Math.sqrt(pinchSquaredDistance) - Math.sqrt(previousPinchSquaredDistance)) > this.camera.pinchToPanMaxDistance)) {
-                // Since pinch has not been active long, assume we intend to zoom.
-                this._computePinchZoom(previousPinchSquaredDistance, pinchSquaredDistance);
-                // Since we are pinching, remain pinching on next iteration.
-                this._isPinching = true;
-            }
-            else {
-                // Pause between pinch starting and moving implies not a zoom event. Pan instead.
-                this._computeMultiTouchPanning(previousMultiTouchPanPosition, multiTouchPanPosition);
-            }
-            // Panning enabled, zoom disabled
-        }
-        else if (this.multiTouchPanning) {
-            this._computeMultiTouchPanning(previousMultiTouchPanPosition, multiTouchPanPosition);
-            // Zoom enabled, panning disabled
-        }
-        else if (this.pinchZoom) {
-            this._computePinchZoom(previousPinchSquaredDistance, pinchSquaredDistance);
-        }
+        this._shouldStartPinchZoom =
+            this._twoFingerActivityCount < 20 && Math.abs(Math.sqrt(pinchSquaredDistance) - Math.sqrt(previousPinchSquaredDistance)) > this.camera.pinchToPanMaxDistance;
+        super.onMultiTouch(pointA, pointB, previousPinchSquaredDistance, pinchSquaredDistance, previousMultiTouchPanPosition, multiTouchPanPosition);
     }
     /**
      * Called each time a new POINTERDOWN event occurs. Ie, for each button
@@ -185,6 +135,7 @@ export class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
      */
     onButtonDown(evt) {
         this._isPanClick = evt.button === this.camera._panningMouseButton;
+        super.onButtonDown(evt);
     }
     /**
      * Called each time a new POINTERUP event occurs. Ie, for each button
@@ -192,16 +143,14 @@ export class ArcRotateCameraPointersInput extends BaseCameraPointersInput {
      * @param _evt Defines the event to track
      */
     onButtonUp(_evt) {
-        this._twoFingerActivityCount = 0;
-        this._isPinching = false;
+        super.onButtonUp(_evt);
     }
     /**
      * Called when window becomes inactive.
      */
     onLostFocus() {
         this._isPanClick = false;
-        this._twoFingerActivityCount = 0;
-        this._isPinching = false;
+        super.onLostFocus();
     }
 }
 /**
@@ -226,17 +175,8 @@ __decorate([
 __decorate([
     serialize()
 ], ArcRotateCameraPointersInput.prototype, "useNaturalPinchZoom", void 0);
-__decorate([
-    serialize()
-], ArcRotateCameraPointersInput.prototype, "pinchZoom", void 0);
 __decorate([
     serialize()
 ], ArcRotateCameraPointersInput.prototype, "panningSensibility", void 0);
-__decorate([
-    serialize()
-], ArcRotateCameraPointersInput.prototype, "multiTouchPanning", void 0);
-__decorate([
-    serialize()
-], ArcRotateCameraPointersInput.prototype, "multiTouchPanAndZoom", void 0);
 CameraInputTypes["ArcRotateCameraPointersInput"] = ArcRotateCameraPointersInput;
 //# sourceMappingURL=arcRotateCameraPointersInput.js.map