@babylonjs/core 7.51.3 → 7.52.0

package/AudioV2/abstractAudio/subNodes/stereoAudioSubNode.d.ts

@@ -0,0 +1,19 @@
+import type { Nullable } from "../../../types";
+import type { AudioEngineV2 } from "../../abstractAudio/audioEngineV2";
+import { _AbstractAudioSubNode } from "../../abstractAudio/subNodes/abstractAudioSubNode";
+import type { IStereoAudioOptions } from "../../abstractAudio/subProperties/abstractStereoAudio";
+import { _StereoAudioDefaults } from "../../abstractAudio/subProperties/abstractStereoAudio";
+import type { _AbstractAudioSubGraph } from "./abstractAudioSubGraph";
+/** @internal */
+export declare abstract class _StereoAudioSubNode extends _AbstractAudioSubNode {
+    protected constructor(engine: AudioEngineV2);
+    abstract pan: number;
+    /** @internal */
+    setOptions(options: Partial<IStereoAudioOptions>): void;
+}
+/** @internal */
+export declare function _GetStereoAudioSubNode(subGraph: _AbstractAudioSubGraph): Nullable<_StereoAudioSubNode>;
+/** @internal */
+export declare function _GetStereoAudioProperty<K extends keyof typeof _StereoAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K): (typeof _StereoAudioDefaults)[K];
+/** @internal */
+export declare function _SetStereoAudioProperty<K extends keyof typeof _StereoAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K, value: _StereoAudioSubNode[K]): void;

package/AudioV2/abstractAudio/subNodes/stereoAudioSubNode.js

@@ -0,0 +1,27 @@
+import { _AbstractAudioSubNode } from "../../abstractAudio/subNodes/abstractAudioSubNode.js";
+import { _StereoAudioDefaults } from "../../abstractAudio/subProperties/abstractStereoAudio.js";
+/** @internal */
+export class _StereoAudioSubNode extends _AbstractAudioSubNode {
+    constructor(engine) {
+        super("Stereo" /* AudioSubNode.STEREO */, engine);
+    }
+    /** @internal */
+    setOptions(options) {
+        this.pan = options.stereoPan ?? _StereoAudioDefaults.pan;
+    }
+}
+/** @internal */
+export function _GetStereoAudioSubNode(subGraph) {
+    return subGraph.getSubNode("Stereo" /* AudioSubNode.STEREO */);
+}
+/** @internal */
+export function _GetStereoAudioProperty(subGraph, property) {
+    return _GetStereoAudioSubNode(subGraph)?.[property] ?? _StereoAudioDefaults[property];
+}
+/** @internal */
+export function _SetStereoAudioProperty(subGraph, property, value) {
+    subGraph.callOnSubNode("Stereo" /* AudioSubNode.STEREO */, (node) => {
+        node[property] = value;
+    });
+}
+//# sourceMappingURL=stereoAudioSubNode.js.map

package/AudioV2/abstractAudio/subNodes/stereoAudioSubNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stereoAudioSubNode.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subNodes/stereoAudioSubNode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAG1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAG7F,gBAAgB;AAChB,MAAM,OAAgB,mBAAoB,SAAQ,qBAAqB;IACnE,YAAsB,MAAqB;QACvC,KAAK,qCAAsB,MAAM,CAAC,CAAC;IACvC,CAAC;IAID,gBAAgB;IACT,UAAU,CAAC,OAAqC;QACnD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,oBAAoB,CAAC,GAAG,CAAC;IAC7D,CAAC;CACJ;AAED,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CAAC,QAAgC;IACnE,OAAO,QAAQ,CAAC,UAAU,oCAA0C,CAAC;AACzE,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,uBAAuB,CAA8C,QAAgC,EAAE,QAAW;IAC9H,OAAO,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AAC1F,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,uBAAuB,CAA8C,QAAgC,EAAE,QAAW,EAAE,KAA6B;IAC7J,QAAQ,CAAC,aAAa,qCAA2C,CAAC,IAAI,EAAE,EAAE;QACtE,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["import type { Nullable } from \"../../../types\";\nimport type { AudioEngineV2 } from \"../../abstractAudio/audioEngineV2\";\nimport { _AbstractAudioSubNode } from \"../../abstractAudio/subNodes/abstractAudioSubNode\";\nimport { AudioSubNode } from \"../../abstractAudio/subNodes/audioSubNode\";\nimport type { IStereoAudioOptions } from \"../../abstractAudio/subProperties/abstractStereoAudio\";\nimport { _StereoAudioDefaults } from \"../../abstractAudio/subProperties/abstractStereoAudio\";\nimport type { _AbstractAudioSubGraph } from \"./abstractAudioSubGraph\";\n\n/** @internal */\nexport abstract class _StereoAudioSubNode extends _AbstractAudioSubNode {\n    protected constructor(engine: AudioEngineV2) {\n        super(AudioSubNode.STEREO, engine);\n    }\n\n    abstract pan: number;\n\n    /** @internal */\n    public setOptions(options: Partial<IStereoAudioOptions>): void {\n        this.pan = options.stereoPan ?? _StereoAudioDefaults.pan;\n    }\n}\n\n/** @internal */\nexport function _GetStereoAudioSubNode(subGraph: _AbstractAudioSubGraph): Nullable<_StereoAudioSubNode> {\n    return subGraph.getSubNode<_StereoAudioSubNode>(AudioSubNode.STEREO);\n}\n\n/** @internal */\nexport function _GetStereoAudioProperty<K extends keyof typeof _StereoAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K): (typeof _StereoAudioDefaults)[K] {\n    return _GetStereoAudioSubNode(subGraph)?.[property] ?? _StereoAudioDefaults[property];\n}\n\n/** @internal */\nexport function _SetStereoAudioProperty<K extends keyof typeof _StereoAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K, value: _StereoAudioSubNode[K]): void {\n    subGraph.callOnSubNode<_StereoAudioSubNode>(AudioSubNode.STEREO, (node) => {\n        node[property] = value;\n    });\n}\n"]}

package/AudioV2/abstractAudio/subNodes/volumeAudioSubNode.d.ts

@@ -0,0 +1,28 @@
+import type { Nullable } from "../../../types";
+import type { AudioEngineV2 } from "../audioEngineV2";
+import { _AbstractAudioSubNode } from "../subNodes/abstractAudioSubNode";
+import type { _AbstractAudioSubGraph } from "./abstractAudioSubGraph";
+/** @internal */
+export declare const _VolumeAudioDefaults: {
+    readonly volume: number;
+};
+/**
+ * Volume options.
+ */
+export interface IVolumeAudioOptions {
+    /**
+     * The volume/gain. Defaults to 1.
+     */
+    volume: number;
+}
+/** @internal */
+export declare abstract class _VolumeAudioSubNode extends _AbstractAudioSubNode {
+    protected constructor(engine: AudioEngineV2);
+    abstract volume: number;
+    /** @internal */
+    setOptions(options: Partial<IVolumeAudioOptions>): void;
+}
+/** @internal */
+export declare function _GetVolumeAudioSubNode(subGraph: _AbstractAudioSubGraph): Nullable<_VolumeAudioSubNode>;
+/** @internal */
+export declare function _GetVolumeAudioProperty<K extends keyof typeof _VolumeAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K): (typeof _VolumeAudioDefaults)[K];

package/AudioV2/abstractAudio/subNodes/volumeAudioSubNode.js

@@ -0,0 +1,24 @@
+import { _AbstractAudioSubNode } from "../subNodes/abstractAudioSubNode.js";
+/** @internal */
+export const _VolumeAudioDefaults = {
+    volume: 1,
+};
+/** @internal */
+export class _VolumeAudioSubNode extends _AbstractAudioSubNode {
+    constructor(engine) {
+        super("Volume" /* AudioSubNode.VOLUME */, engine);
+    }
+    /** @internal */
+    setOptions(options) {
+        this.volume = options.volume ?? _VolumeAudioDefaults.volume;
+    }
+}
+/** @internal */
+export function _GetVolumeAudioSubNode(subGraph) {
+    return subGraph.getSubNode("Volume" /* AudioSubNode.VOLUME */);
+}
+/** @internal */
+export function _GetVolumeAudioProperty(subGraph, property) {
+    return _GetVolumeAudioSubNode(subGraph)?.[property] ?? _VolumeAudioDefaults[property];
+}
+//# sourceMappingURL=volumeAudioSubNode.js.map

package/AudioV2/abstractAudio/subNodes/volumeAudioSubNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumeAudioSubNode.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subNodes/volumeAudioSubNode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,gBAAgB;AAChB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,MAAM,EAAE,CAAW;CACb,CAAC;AAYX,gBAAgB;AAChB,MAAM,OAAgB,mBAAoB,SAAQ,qBAAqB;IACnE,YAAsB,MAAqB;QACvC,KAAK,qCAAsB,MAAM,CAAC,CAAC;IACvC,CAAC;IAID,gBAAgB;IACT,UAAU,CAAC,OAAqC;QACnD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC;IAChE,CAAC;CACJ;AAED,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CAAC,QAAgC;IACnE,OAAO,QAAQ,CAAC,UAAU,oCAA0C,CAAC;AACzE,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,uBAAuB,CAA8C,QAAgC,EAAE,QAAW;IAC9H,OAAO,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AAC1F,CAAC","sourcesContent":["import type { Nullable } from \"../../../types\";\nimport type { AudioEngineV2 } from \"../audioEngineV2\";\nimport { _AbstractAudioSubNode } from \"../subNodes/abstractAudioSubNode\";\nimport { AudioSubNode } from \"../subNodes/audioSubNode\";\nimport type { _AbstractAudioSubGraph } from \"./abstractAudioSubGraph\";\n\n/** @internal */\nexport const _VolumeAudioDefaults = {\n    volume: 1 as number,\n} as const;\n\n/**\n * Volume options.\n */\nexport interface IVolumeAudioOptions {\n    /**\n     * The volume/gain. Defaults to 1.\n     */\n    volume: number;\n}\n\n/** @internal */\nexport abstract class _VolumeAudioSubNode extends _AbstractAudioSubNode {\n    protected constructor(engine: AudioEngineV2) {\n        super(AudioSubNode.VOLUME, engine);\n    }\n\n    public abstract volume: number;\n\n    /** @internal */\n    public setOptions(options: Partial<IVolumeAudioOptions>): void {\n        this.volume = options.volume ?? _VolumeAudioDefaults.volume;\n    }\n}\n\n/** @internal */\nexport function _GetVolumeAudioSubNode(subGraph: _AbstractAudioSubGraph): Nullable<_VolumeAudioSubNode> {\n    return subGraph.getSubNode<_VolumeAudioSubNode>(AudioSubNode.VOLUME);\n}\n\n/** @internal */\nexport function _GetVolumeAudioProperty<K extends keyof typeof _VolumeAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K): (typeof _VolumeAudioDefaults)[K] {\n    return _GetVolumeAudioSubNode(subGraph)?.[property] ?? _VolumeAudioDefaults[property];\n}\n"]}

package/AudioV2/abstractAudio/subProperties/abstractSpatialAudio.d.ts

@@ -0,0 +1,187 @@
+import { Quaternion, Vector3 } from "../../../Maths/math.vector";
+export declare const _SpatialAudioDefaults: {
+    readonly coneInnerAngle: number;
+    readonly coneOuterAngle: number;
+    readonly coneOuterVolume: number;
+    readonly distanceModel: DistanceModelType;
+    readonly maxDistance: number;
+    readonly panningModel: PanningModelType;
+    readonly position: Vector3;
+    readonly referenceDistance: number;
+    readonly rolloffFactor: number;
+    readonly rotation: Vector3;
+    readonly rotationQuaternion: Quaternion;
+};
+/**
+ * Options for spatial audio.
+ */
+export interface ISpatialAudioOptions {
+    /**
+     * Whether to automatically update the spatial properties of the audio node. Defaults to `true`.
+     */
+    spatialAutoUpdate: boolean;
+    /**
+     * The spatial cone inner angle, in radians. Defaults to 2π.
+     * - When the listener is inside the cone inner angle, the volume is at its maximum.
+     */
+    spatialConeInnerAngle: number;
+    /**
+     * The spatial cone outer angle, in radians. Defaults to 2π.
+     * - When the listener is between the the cone inner and outer angles, the volume fades to its minimum as the listener approaches the outer angle.
+     * - When the listener is outside the cone outer angle, the volume is at its minimum.
+     */
+    spatialConeOuterAngle: number;
+    /**
+     * The amount of volume reduction outside the {@link spatialConeOuterAngle}. Defaults to 0.
+     */
+    spatialConeOuterVolume: number;
+    /**
+     * The algorithm to use to reduce the volume of the audio source as it moves away from the listener. Defaults to "inverse".
+     *
+     * Possible values are:
+     * - `"linear"`: The volume is reduced linearly as the source moves away from the listener.
+     * - `"inverse"`: The volume is reduced inversely as the source moves away from the listener.
+     * - `"exponential"`: The volume is reduced exponentially as the source moves away from the listener.
+     *
+     * @see {@link spatialMaxDistance}
+     * @see {@link spatialReferenceDistance}
+     * @see {@link spatialRolloffFactor}
+     */
+    spatialDistanceModel: "linear" | "inverse" | "exponential";
+    /**
+     * Enable spatial audio. Defaults to false.
+     *
+     * When set to `true`, the audio node's spatial properties will be initialized on creation and there will be no
+     * delay when setting the first spatial value.
+     *
+     * When not specified, or set to `false`, the audio node's spatial properties will not be initialized on creation
+     * and there will be a small delay when setting the first spatial value.
+     *
+     * - This option is ignored if any other spatial options are set.
+     */
+    spatialEnabled: boolean;
+    /**
+     * The maximum distance between the audio source and the listener, after which the volume is not reduced any further. Defaults to 10000.
+     * - This value is used only when the {@link spatialDistanceModel} is set to `"linear"`.
+     * @see {@link spatialDistanceModel}
+     */
+    spatialMaxDistance: number;
+    /**
+     * The spatial panning model. Defaults to "equalpower".
+     * - "equalpower" requires less CPU than "HRTF" but is less realistic for listeners with headphones or speakers close to the ears.
+     * - "HRTF" requires more CPU but is more realistic for listeners with headphones or speakers close to the ears.
+     *
+     * Possible values are:
+     * - `"equalpower"`: Represents the equal-power panning algorithm, generally regarded as simple and efficient.
+     * - `"HRTF"`:Renders a stereo output of higher quality than `"equalpower"` — it uses a convolution with measured impulse responses from human subjects.
+     */
+    spatialPanningModel: "equalpower" | "HRTF";
+    /**
+     * The spatial position. Defaults to (0, 0, 0).
+     */
+    spatialPosition: Vector3;
+    /**
+     * The distance for reducing volume as the audio source moves away from the listener – i.e. the distance the volume reduction starts at. Defaults to 1.
+     * - This value is used by all distance models.
+     * @see {@link spatialDistanceModel}
+     */
+    spatialReferenceDistance: number;
+    /**
+     * How quickly the volume is reduced as the source moves away from the listener. Defaults to 1.
+     * - This value is used by all distance models.
+     * @see {@link spatialDistanceModel}
+     */
+    spatialRolloffFactor: number;
+    /**
+     * The spatial rotation, as Euler angles. Defaults to (0, 0, 0).
+     */
+    spatialRotation: Vector3;
+    /**
+     * The spatial rotation, as a quaternion. Defaults to (0, 0, 0, 1).
+     */
+    spatialRotationQuaternion: Quaternion;
+}
+/**
+ * @param options The spatial audio options to check.
+ * @returns `true` if spatial audio options are defined, otherwise `false`.
+ */
+export declare function _HasSpatialAudioOptions(options: Partial<ISpatialAudioOptions>): boolean;
+/**
+ * Abstract class representing the `spatial` audio property on a sound or audio bus.
+ *
+ * @see {@link AudioEngineV2.listener}
+ */
+export declare abstract class AbstractSpatialAudio {
+    /**
+     * The spatial cone inner angle, in radians. Defaults to 2π.
+     * - When the listener is inside the cone inner angle, the volume is at its maximum.
+     */
+    abstract coneInnerAngle: number;
+    /**
+     * The spatial cone outer angle, in radians. Defaults to 2π.
+     * - When the listener is between the the cone inner and outer angles, the volume fades to its minimum as the listener approaches the outer angle.
+     * - When the listener is outside the cone outer angle, the volume is at its minimum.
+     */
+    abstract coneOuterAngle: number;
+    /**
+     * The amount of volume reduction outside the {@link coneOuterAngle}. Defaults to 0.
+     */
+    abstract coneOuterVolume: number;
+    /**
+     * The algorithm to use to reduce the volume of the audio source as it moves away from the listener. Defaults to "inverse".
+     *
+     * Possible values are:
+     * - `"linear"`: The volume is reduced linearly as the source moves away from the listener.
+     * - `"inverse"`: The volume is reduced inversely as the source moves away from the listener.
+     * - `"exponential"`: The volume is reduced exponentially as the source moves away from the listener.
+     *
+     * @see {@link spatialMaxDistance}
+     * @see {@link spatialReferenceDistance}
+     * @see {@link spatialRolloffFactor}
+     */
+    abstract distanceModel: "linear" | "inverse" | "exponential";
+    /**
+     * The maximum distance between the audio source and the listener, after which the volume is not reduced any further. Defaults to 10000.
+     * - This value is used only when the {@link distanceModel} is set to `"linear"`.
+     * @see {@link distanceModel}
+     */
+    abstract maxDistance: number;
+    /**
+     * The spatial panning model. Defaults to "equalpower".
+     * - "equalpower" requires less CPU than "HRTF" but is less realistic for listeners with headphones or speakers close to the ears.
+     * - "HRTF" requires more CPU but is more realistic for listeners with headphones or speakers close to the ears.
+     *
+     * Possible values are:
+     * - `"equalpower"`: Represents the equal-power panning algorithm, generally regarded as simple and efficient.
+     * - `"HRTF"`:Renders a stereo output of higher quality than `"equalpower"` — it uses a convolution with measured impulse responses from human subjects.
+     */
+    abstract panningModel: "equalpower" | "HRTF";
+    /**
+     * The spatial position. Defaults to (0, 0, 0).
+     */
+    abstract position: Vector3;
+    /**
+     * The distance for reducing volume as the audio source moves away from the listener – i.e. the distance the volume reduction starts at. Defaults to 1.
+     * - This value is used by all distance models.
+     * @see {@link distanceModel}
+     */
+    abstract referenceDistance: number;
+    /**
+     * How quickly the volume is reduced as the source moves away from the listener. Defaults to 1.
+     * - This value is used by all distance models.
+     * @see {@link distanceModel}
+     */
+    abstract rolloffFactor: number;
+    /**
+     * The spatial rotation. Defaults to (0, 0, 0).
+     */
+    abstract rotation: Vector3;
+    /**
+     * The spatial rotation quaternion. Defaults to (0, 0, 0, 1).
+     */
+    abstract rotationQuaternion: Quaternion;
+    /**
+     * Updates the position and rotation properties.
+     */
+    abstract update(): void;
+}

package/AudioV2/abstractAudio/subProperties/abstractSpatialAudio.js

@@ -0,0 +1,41 @@
+import { Quaternion, Vector3 } from "../../../Maths/math.vector.js";
+export const _SpatialAudioDefaults = {
+    coneInnerAngle: 6.28318530718,
+    coneOuterAngle: 6.28318530718,
+    coneOuterVolume: 0,
+    distanceModel: "inverse",
+    maxDistance: 10000,
+    panningModel: "equalpower",
+    position: Vector3.Zero(),
+    referenceDistance: 1,
+    rolloffFactor: 1,
+    rotation: Vector3.Zero(),
+    rotationQuaternion: new Quaternion(),
+};
+/**
+ * @param options The spatial audio options to check.
+ * @returns `true` if spatial audio options are defined, otherwise `false`.
+ */
+export function _HasSpatialAudioOptions(options) {
+    return (options.spatialEnabled ||
+        options.spatialAutoUpdate !== undefined ||
+        options.spatialConeInnerAngle !== undefined ||
+        options.spatialConeOuterAngle !== undefined ||
+        options.spatialConeOuterVolume !== undefined ||
+        options.spatialDistanceModel !== undefined ||
+        options.spatialMaxDistance !== undefined ||
+        options.spatialPanningModel !== undefined ||
+        options.spatialPosition !== undefined ||
+        options.spatialReferenceDistance !== undefined ||
+        options.spatialRolloffFactor !== undefined ||
+        options.spatialRotation !== undefined ||
+        options.spatialRotationQuaternion !== undefined);
+}
+/**
+ * Abstract class representing the `spatial` audio property on a sound or audio bus.
+ *
+ * @see {@link AudioEngineV2.listener}
+ */
+export class AbstractSpatialAudio {
+}
+//# sourceMappingURL=abstractSpatialAudio.js.map

package/AudioV2/abstractAudio/subProperties/abstractSpatialAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSpatialAudio.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subProperties/abstractSpatialAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,cAAc,EAAE,aAAuB;IACvC,cAAc,EAAE,aAAuB;IACvC,eAAe,EAAE,CAAW;IAC5B,aAAa,EAAE,SAA8B;IAC7C,WAAW,EAAE,KAAe;IAC5B,YAAY,EAAE,YAAgC;IAC9C,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;IACxB,iBAAiB,EAAE,CAAW;IAC9B,aAAa,EAAE,CAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;IACxB,kBAAkB,EAAE,IAAI,UAAU,EAAE;CAC9B,CAAC;AA4FX;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAsC;IAC1E,OAAO,CACH,OAAO,CAAC,cAAc;QACtB,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACvC,OAAO,CAAC,qBAAqB,KAAK,SAAS;QAC3C,OAAO,CAAC,qBAAqB,KAAK,SAAS;QAC3C,OAAO,CAAC,sBAAsB,KAAK,SAAS;QAC5C,OAAO,CAAC,oBAAoB,KAAK,SAAS;QAC1C,OAAO,CAAC,kBAAkB,KAAK,SAAS;QACxC,OAAO,CAAC,mBAAmB,KAAK,SAAS;QACzC,OAAO,CAAC,eAAe,KAAK,SAAS;QACrC,OAAO,CAAC,wBAAwB,KAAK,SAAS;QAC9C,OAAO,CAAC,oBAAoB,KAAK,SAAS;QAC1C,OAAO,CAAC,eAAe,KAAK,SAAS;QACrC,OAAO,CAAC,yBAAyB,KAAK,SAAS,CAClD,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAgB,oBAAoB;CAoFzC","sourcesContent":["import { Quaternion, Vector3 } from \"../../../Maths/math.vector\";\n\nexport const _SpatialAudioDefaults = {\n    coneInnerAngle: 6.28318530718 as number,\n    coneOuterAngle: 6.28318530718 as number,\n    coneOuterVolume: 0 as number,\n    distanceModel: \"inverse\" as DistanceModelType,\n    maxDistance: 10000 as number,\n    panningModel: \"equalpower\" as PanningModelType,\n    position: Vector3.Zero(),\n    referenceDistance: 1 as number,\n    rolloffFactor: 1 as number,\n    rotation: Vector3.Zero(),\n    rotationQuaternion: new Quaternion(),\n} as const;\n\n/**\n * Options for spatial audio.\n */\nexport interface ISpatialAudioOptions {\n    /**\n     * Whether to automatically update the spatial properties of the audio node. Defaults to `true`.\n     */\n    spatialAutoUpdate: boolean;\n    /**\n     * The spatial cone inner angle, in radians. Defaults to 2π.\n     * - When the listener is inside the cone inner angle, the volume is at its maximum.\n     */\n    spatialConeInnerAngle: number;\n    /**\n     * The spatial cone outer angle, in radians. Defaults to 2π.\n     * - When the listener is between the the cone inner and outer angles, the volume fades to its minimum as the listener approaches the outer angle.\n     * - When the listener is outside the cone outer angle, the volume is at its minimum.\n     */\n    spatialConeOuterAngle: number;\n    /**\n     * The amount of volume reduction outside the {@link spatialConeOuterAngle}. Defaults to 0.\n     */\n    spatialConeOuterVolume: number;\n    /**\n     * The algorithm to use to reduce the volume of the audio source as it moves away from the listener. Defaults to \"inverse\".\n     *\n     * Possible values are:\n     * - `\"linear\"`: The volume is reduced linearly as the source moves away from the listener.\n     * - `\"inverse\"`: The volume is reduced inversely as the source moves away from the listener.\n     * - `\"exponential\"`: The volume is reduced exponentially as the source moves away from the listener.\n     *\n     * @see {@link spatialMaxDistance}\n     * @see {@link spatialReferenceDistance}\n     * @see {@link spatialRolloffFactor}\n     */\n    spatialDistanceModel: \"linear\" | \"inverse\" | \"exponential\";\n    /**\n     * Enable spatial audio. Defaults to false.\n     *\n     * When set to `true`, the audio node's spatial properties will be initialized on creation and there will be no\n     * delay when setting the first spatial value.\n     *\n     * When not specified, or set to `false`, the audio node's spatial properties will not be initialized on creation\n     * and there will be a small delay when setting the first spatial value.\n     *\n     * - This option is ignored if any other spatial options are set.\n     */\n    spatialEnabled: boolean;\n    /**\n     * The maximum distance between the audio source and the listener, after which the volume is not reduced any further. Defaults to 10000.\n     * - This value is used only when the {@link spatialDistanceModel} is set to `\"linear\"`.\n     * @see {@link spatialDistanceModel}\n     */\n    spatialMaxDistance: number;\n    /**\n     * The spatial panning model. Defaults to \"equalpower\".\n     * - \"equalpower\" requires less CPU than \"HRTF\" but is less realistic for listeners with headphones or speakers close to the ears.\n     * - \"HRTF\" requires more CPU but is more realistic for listeners with headphones or speakers close to the ears.\n     *\n     * Possible values are:\n     * - `\"equalpower\"`: Represents the equal-power panning algorithm, generally regarded as simple and efficient.\n     * - `\"HRTF\"`:Renders a stereo output of higher quality than `\"equalpower\"` — it uses a convolution with measured impulse responses from human subjects.\n     */\n    spatialPanningModel: \"equalpower\" | \"HRTF\";\n    /**\n     * The spatial position. Defaults to (0, 0, 0).\n     */\n    spatialPosition: Vector3;\n    /**\n     * The distance for reducing volume as the audio source moves away from the listener – i.e. the distance the volume reduction starts at. Defaults to 1.\n     * - This value is used by all distance models.\n     * @see {@link spatialDistanceModel}\n     */\n    spatialReferenceDistance: number;\n    /**\n     * How quickly the volume is reduced as the source moves away from the listener. Defaults to 1.\n     * - This value is used by all distance models.\n     * @see {@link spatialDistanceModel}\n     */\n    spatialRolloffFactor: number;\n    /**\n     * The spatial rotation, as Euler angles. Defaults to (0, 0, 0).\n     */\n    spatialRotation: Vector3;\n    /**\n     * The spatial rotation, as a quaternion. Defaults to (0, 0, 0, 1).\n     */\n    spatialRotationQuaternion: Quaternion;\n}\n\n/**\n * @param options The spatial audio options to check.\n * @returns `true` if spatial audio options are defined, otherwise `false`.\n */\nexport function _HasSpatialAudioOptions(options: Partial<ISpatialAudioOptions>): boolean {\n    return (\n        options.spatialEnabled ||\n        options.spatialAutoUpdate !== undefined ||\n        options.spatialConeInnerAngle !== undefined ||\n        options.spatialConeOuterAngle !== undefined ||\n        options.spatialConeOuterVolume !== undefined ||\n        options.spatialDistanceModel !== undefined ||\n        options.spatialMaxDistance !== undefined ||\n        options.spatialPanningModel !== undefined ||\n        options.spatialPosition !== undefined ||\n        options.spatialReferenceDistance !== undefined ||\n        options.spatialRolloffFactor !== undefined ||\n        options.spatialRotation !== undefined ||\n        options.spatialRotationQuaternion !== undefined\n    );\n}\n\n/**\n * Abstract class representing the `spatial` audio property on a sound or audio bus.\n *\n * @see {@link AudioEngineV2.listener}\n */\nexport abstract class AbstractSpatialAudio {\n    /**\n     * The spatial cone inner angle, in radians. Defaults to 2π.\n     * - When the listener is inside the cone inner angle, the volume is at its maximum.\n     */\n    public abstract coneInnerAngle: number;\n\n    /**\n     * The spatial cone outer angle, in radians. Defaults to 2π.\n     * - When the listener is between the the cone inner and outer angles, the volume fades to its minimum as the listener approaches the outer angle.\n     * - When the listener is outside the cone outer angle, the volume is at its minimum.\n     */\n    public abstract coneOuterAngle: number;\n\n    /**\n     * The amount of volume reduction outside the {@link coneOuterAngle}. Defaults to 0.\n     */\n    public abstract coneOuterVolume: number;\n\n    /**\n     * The algorithm to use to reduce the volume of the audio source as it moves away from the listener. Defaults to \"inverse\".\n     *\n     * Possible values are:\n     * - `\"linear\"`: The volume is reduced linearly as the source moves away from the listener.\n     * - `\"inverse\"`: The volume is reduced inversely as the source moves away from the listener.\n     * - `\"exponential\"`: The volume is reduced exponentially as the source moves away from the listener.\n     *\n     * @see {@link spatialMaxDistance}\n     * @see {@link spatialReferenceDistance}\n     * @see {@link spatialRolloffFactor}\n     */\n    public abstract distanceModel: \"linear\" | \"inverse\" | \"exponential\";\n\n    /**\n     * The maximum distance between the audio source and the listener, after which the volume is not reduced any further. Defaults to 10000.\n     * - This value is used only when the {@link distanceModel} is set to `\"linear\"`.\n     * @see {@link distanceModel}\n     */\n    public abstract maxDistance: number;\n\n    /**\n     * The spatial panning model. Defaults to \"equalpower\".\n     * - \"equalpower\" requires less CPU than \"HRTF\" but is less realistic for listeners with headphones or speakers close to the ears.\n     * - \"HRTF\" requires more CPU but is more realistic for listeners with headphones or speakers close to the ears.\n     *\n     * Possible values are:\n     * - `\"equalpower\"`: Represents the equal-power panning algorithm, generally regarded as simple and efficient.\n     * - `\"HRTF\"`:Renders a stereo output of higher quality than `\"equalpower\"` — it uses a convolution with measured impulse responses from human subjects.\n     */\n    public abstract panningModel: \"equalpower\" | \"HRTF\";\n\n    /**\n     * The spatial position. Defaults to (0, 0, 0).\n     */\n    public abstract position: Vector3;\n\n    /**\n     * The distance for reducing volume as the audio source moves away from the listener – i.e. the distance the volume reduction starts at. Defaults to 1.\n     * - This value is used by all distance models.\n     * @see {@link distanceModel}\n     */\n    public abstract referenceDistance: number;\n\n    /**\n     * How quickly the volume is reduced as the source moves away from the listener. Defaults to 1.\n     * - This value is used by all distance models.\n     * @see {@link distanceModel}\n     */\n    public abstract rolloffFactor: number;\n\n    /**\n     * The spatial rotation. Defaults to (0, 0, 0).\n     */\n    public abstract rotation: Vector3;\n\n    /**\n     * The spatial rotation quaternion. Defaults to (0, 0, 0, 1).\n     */\n    public abstract rotationQuaternion: Quaternion;\n\n    /**\n     * Updates the position and rotation properties.\n     */\n    public abstract update(): void;\n}\n"]}

package/AudioV2/abstractAudio/subProperties/abstractSpatialAudioListener.d.ts

@@ -0,0 +1,59 @@
+import { Quaternion, Vector3 } from "../../../Maths/math.vector";
+export declare const _SpatialAudioListenerDefaults: {
+    readonly position: Vector3;
+    readonly rotation: Vector3;
+    readonly rotationQuaternion: Quaternion;
+};
+/**
+ * Options for spatial audio.
+ */
+export interface ISpatialAudioListenerOptions {
+    /**
+     * Whether to automatically update the position and rotation of the listener. Defaults to `true`.
+     */
+    listenerAutoUpdate: boolean;
+    /**
+     * Set to `true` to enable the listener. Defaults to `false`.
+     */
+    listenerEnabled: boolean;
+    /**
+     * The listener position. Defaults to (0, 0, 0).
+     */
+    listenerPosition: Vector3;
+    /**
+     * The listener rotation, as Euler angles. Defaults to (0, 0, 0).
+     */
+    listenerRotation: Vector3;
+    /**
+     * The listener rotation, as a quaternion. Defaults to (0, 0, 0, 1).
+     */
+    listenerRotationQuaternion: Quaternion;
+}
+/**
+ * @param options The spatial audio listener options to check.
+ * @returns `true` if spatial audio listener options are defined, otherwise `false`.
+ */
+export declare function _HasSpatialAudioListenerOptions(options: Partial<ISpatialAudioListenerOptions>): boolean;
+/**
+ * Abstract class representing the spatial audio `listener` property on an audio engine.
+ *
+ * @see {@link AudioEngineV2.listener}
+ */
+export declare abstract class AbstractSpatialAudioListener {
+    /**
+     * The listener position. Defaults to (0, 0, 0).
+     */
+    abstract position: Vector3;
+    /**
+     * The listener rotation, as Euler angles. Defaults to (0, 0, 0).
+     */
+    abstract rotation: Vector3;
+    /**
+     * The listener rotation, as a quaternion. Defaults to (0, 0, 0, 1).
+     */
+    abstract rotationQuaternion: Quaternion;
+    /**
+     * Updates the position and rotation properties.
+     */
+    abstract update(): void;
+}

package/AudioV2/abstractAudio/subProperties/abstractSpatialAudioListener.js

@@ -0,0 +1,21 @@
+import { Quaternion, Vector3 } from "../../../Maths/math.vector.js";
+export const _SpatialAudioListenerDefaults = {
+    position: Vector3.Zero(),
+    rotation: Vector3.Zero(),
+    rotationQuaternion: new Quaternion(),
+};
+/**
+ * @param options The spatial audio listener options to check.
+ * @returns `true` if spatial audio listener options are defined, otherwise `false`.
+ */
+export function _HasSpatialAudioListenerOptions(options) {
+    return options.listenerPosition !== undefined || options.listenerRotation !== undefined || options.listenerRotationQuaternion !== undefined;
+}
+/**
+ * Abstract class representing the spatial audio `listener` property on an audio engine.
+ *
+ * @see {@link AudioEngineV2.listener}
+ */
+export class AbstractSpatialAudioListener {
+}
+//# sourceMappingURL=abstractSpatialAudioListener.js.map

package/AudioV2/abstractAudio/subProperties/abstractSpatialAudioListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractSpatialAudioListener.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subProperties/abstractSpatialAudioListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,6BAA6B,GAAG;IACzC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;IACxB,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;IACxB,kBAAkB,EAAE,IAAI,UAAU,EAAE;CAC9B,CAAC;AA4BX;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAA8C;IAC1F,OAAO,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,CAAC,0BAA0B,KAAK,SAAS,CAAC;AAChJ,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAgB,4BAA4B;CAoBjD","sourcesContent":["import { Quaternion, Vector3 } from \"../../../Maths/math.vector\";\n\nexport const _SpatialAudioListenerDefaults = {\n    position: Vector3.Zero(),\n    rotation: Vector3.Zero(),\n    rotationQuaternion: new Quaternion(),\n} as const;\n\n/**\n * Options for spatial audio.\n */\nexport interface ISpatialAudioListenerOptions {\n    /**\n     * Whether to automatically update the position and rotation of the listener. Defaults to `true`.\n     */\n    listenerAutoUpdate: boolean;\n    /**\n     * Set to `true` to enable the listener. Defaults to `false`.\n     */\n    listenerEnabled: boolean;\n    /**\n     * The listener position. Defaults to (0, 0, 0).\n     */\n    listenerPosition: Vector3;\n    /**\n     * The listener rotation, as Euler angles. Defaults to (0, 0, 0).\n     */\n    listenerRotation: Vector3;\n    /**\n     * The listener rotation, as a quaternion. Defaults to (0, 0, 0, 1).\n     */\n    listenerRotationQuaternion: Quaternion;\n}\n\n/**\n * @param options The spatial audio listener options to check.\n * @returns `true` if spatial audio listener options are defined, otherwise `false`.\n */\nexport function _HasSpatialAudioListenerOptions(options: Partial<ISpatialAudioListenerOptions>): boolean {\n    return options.listenerPosition !== undefined || options.listenerRotation !== undefined || options.listenerRotationQuaternion !== undefined;\n}\n\n/**\n * Abstract class representing the spatial audio `listener` property on an audio engine.\n *\n * @see {@link AudioEngineV2.listener}\n */\nexport abstract class AbstractSpatialAudioListener {\n    /**\n     * The listener position. Defaults to (0, 0, 0).\n     */\n    public abstract position: Vector3;\n\n    /**\n     * The listener rotation, as Euler angles. Defaults to (0, 0, 0).\n     */\n    public abstract rotation: Vector3;\n\n    /**\n     * The listener rotation, as a quaternion. Defaults to (0, 0, 0, 1).\n     */\n    public abstract rotationQuaternion: Quaternion;\n\n    /**\n     * Updates the position and rotation properties.\n     */\n    public abstract update(): void;\n}\n"]}

package/AudioV2/abstractAudio/subProperties/abstractStereoAudio.d.ts

@@ -0,0 +1,38 @@
+export declare const _StereoAudioDefaults: {
+    readonly pan: number;
+};
+/** */
+export interface IStereoAudioOptions {
+    /**
+     * Enable stereo. Defaults to false.
+     *
+     * When set to `true`, the audio node's stereo properties will be initialized on creation and there will be no
+     * delay when setting the first stereo value.
+     *
+     * When not specified, or set to `false`, the audio node's stereo properties will not be initialized on creation
+     * and there will be a small delay when setting the first stereo value.
+     *
+     * - This option is ignored if any other stereo options are set.
+     */
+    stereoEnabled: boolean;
+    /**
+     * The stereo pan from -1 (left) to 1 (right). Defaults to 0.
+     */
+    stereoPan: number;
+}
+/**
+ * @param options The stereo audio options to check.
+ * @returns `true` if stereo audio options are defined, otherwise `false`.
+ */
+export declare function _HasStereoAudioOptions(options: Partial<IStereoAudioOptions>): boolean;
+/**
+ * Abstract class representing the `stereo` audio property on a sound or audio bus.
+ *
+ * @see {@link AudioEngineV2.listener}
+ */
+export declare abstract class AbstractStereoAudio {
+    /**
+     * The stereo pan from -1 (left) to 1 (right). Defaults to 0.
+     */
+    abstract pan: number;
+}

package/AudioV2/abstractAudio/subProperties/abstractStereoAudio.js

@@ -0,0 +1,18 @@
+export const _StereoAudioDefaults = {
+    pan: 0,
+};
+/**
+ * @param options The stereo audio options to check.
+ * @returns `true` if stereo audio options are defined, otherwise `false`.
+ */
+export function _HasStereoAudioOptions(options) {
+    return options.stereoEnabled || options.stereoPan !== undefined;
+}
+/**
+ * Abstract class representing the `stereo` audio property on a sound or audio bus.
+ *
+ * @see {@link AudioEngineV2.listener}
+ */
+export class AbstractStereoAudio {
+}
+//# sourceMappingURL=abstractStereoAudio.js.map

package/AudioV2/abstractAudio/subProperties/abstractStereoAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractStereoAudio.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subProperties/abstractStereoAudio.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,GAAG,EAAE,CAAW;CACV,CAAC;AAsBX;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAqC;IACxE,OAAO,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAgB,mBAAmB;CAKxC","sourcesContent":["export const _StereoAudioDefaults = {\n    pan: 0 as number,\n} as const;\n\n/** */\nexport interface IStereoAudioOptions {\n    /**\n     * Enable stereo. Defaults to false.\n     *\n     * When set to `true`, the audio node's stereo properties will be initialized on creation and there will be no\n     * delay when setting the first stereo value.\n     *\n     * When not specified, or set to `false`, the audio node's stereo properties will not be initialized on creation\n     * and there will be a small delay when setting the first stereo value.\n     *\n     * - This option is ignored if any other stereo options are set.\n     */\n    stereoEnabled: boolean;\n    /**\n     * The stereo pan from -1 (left) to 1 (right). Defaults to 0.\n     */\n    stereoPan: number;\n}\n\n/**\n * @param options The stereo audio options to check.\n * @returns `true` if stereo audio options are defined, otherwise `false`.\n */\nexport function _HasStereoAudioOptions(options: Partial<IStereoAudioOptions>): boolean {\n    return options.stereoEnabled || options.stereoPan !== undefined;\n}\n\n/**\n * Abstract class representing the `stereo` audio property on a sound or audio bus.\n *\n * @see {@link AudioEngineV2.listener}\n */\nexport abstract class AbstractStereoAudio {\n    /**\n     * The stereo pan from -1 (left) to 1 (right). Defaults to 0.\n     */\n    public abstract pan: number;\n}\n"]}

package/AudioV2/abstractAudio/subProperties/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./abstractSpatialAudio";
+export * from "./abstractSpatialAudioListener";
+export * from "./abstractStereoAudio";

package/AudioV2/abstractAudio/subProperties/index.js

@@ -0,0 +1,4 @@
+export * from "./abstractSpatialAudio.js";
+export * from "./abstractSpatialAudioListener.js";
+export * from "./abstractStereoAudio.js";
+//# sourceMappingURL=index.js.map

package/AudioV2/abstractAudio/subProperties/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subProperties/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC","sourcesContent":["export * from \"./abstractSpatialAudio\";\nexport * from \"./abstractSpatialAudioListener\";\nexport * from \"./abstractStereoAudio\";\n"]}

package/AudioV2/abstractAudio/subProperties/spatialAudio.d.ts

@@ -0,0 +1,49 @@
+import type { Quaternion, Vector3 } from "../../../Maths/math.vector";
+import type { _AbstractAudioSubGraph } from "../subNodes/abstractAudioSubGraph";
+import { AbstractSpatialAudio } from "./abstractSpatialAudio";
+/** @internal */
+export declare class _SpatialAudio extends AbstractSpatialAudio {
+    private _position;
+    private _rotation;
+    private _rotationQuaternion;
+    private _subGraph;
+    /** @internal */
+    constructor(subGraph: _AbstractAudioSubGraph);
+    /** @internal */
+    get coneInnerAngle(): number;
+    set coneInnerAngle(value: number);
+    /** @internal */
+    get coneOuterAngle(): number;
+    set coneOuterAngle(value: number);
+    /** @internal */
+    get coneOuterVolume(): number;
+    set coneOuterVolume(value: number);
+    /** @internal */
+    get distanceModel(): DistanceModelType;
+    set distanceModel(value: DistanceModelType);
+    /** @internal */
+    get maxDistance(): number;
+    set maxDistance(value: number);
+    /** @internal */
+    get panningModel(): PanningModelType;
+    set panningModel(value: PanningModelType);
+    /** @internal */
+    get position(): Vector3;
+    set position(value: Vector3);
+    /** @internal */
+    get referenceDistance(): number;
+    set referenceDistance(value: number);
+    /** @internal */
+    get rolloffFactor(): number;
+    set rolloffFactor(value: number);
+    /** @internal */
+    get rotation(): Vector3;
+    set rotation(value: Vector3);
+    /** @internal */
+    get rotationQuaternion(): Quaternion;
+    set rotationQuaternion(value: Quaternion);
+    /** @internal */
+    update(): void;
+    private _updatePosition;
+    private _updateRotation;
+}