@woosh/meep-engine 2.154.0 → 2.156.0

package/src/engine/sound/ecs/audio/SpatialAudioIndex.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Spatial broadphase for 3D audio emitters (P5.1, cull-only).
+ *
+ * Holds a dynamic BVH whose leaves are each emitter's AUDIBLE region — an axis-aligned box of
+ * half-extent `event.distanceMax` centred on the emitter. So "which emitters can possibly be heard
+ * from point P" is one O(log n + k) BVH point-query instead of an O(n) scan over every emitter. This
+ * is the registered/dormant tier: a registered emitter is a record plus one BVH leaf — no
+ * `EventInstance`, no WebAudio nodes, no per-frame work. Promoting in-range emitters to live instances
+ * (voice slots, stealing, fades) is layered on top later; this class only answers the cull.
+ *
+ * Leaf bounds track the emitter REACTIVELY: each leaf subscribes to its position's `onChanged`, so a
+ * still emitter costs nothing per frame and a moving one refits only when it actually moves. (meep is
+ * fully dynamic — there is no static/dynamic distinction and no per-tick refit loop.)
+ *
+ * The cull is conservative: the leaf is a cube of half-extent `distanceMax`, so its corners admit a
+ * few emitters whose true (spherical) distance slightly exceeds `distanceMax`. That is correct
+ * broadphase behaviour — the exact distance test belongs to the narrowphase (the live instance).
+ */
+export class SpatialAudioIndex {
+    /**
+     * @returns {number} number of registered emitters
+     */
+    get size(): number;
+    /**
+     * @param {number} entity
+     * @returns {boolean}
+     */
+    has(entity: number): boolean;
+    /**
+     * Register an emitter: insert a BVH leaf sized to its audible region and start tracking its
+     * position. The entity id is the leaf's user data (so queries return entity ids).
+     *
+     * @param {number} entity non-negative integer id
+     * @param {EventDescription} event read for `distanceMax` (and retained for later promotion)
+     * @param {Vector3} position shared position vector — its `onChanged` drives leaf refits
+     */
+    add(entity: number, event: EventDescription, position: Vector3): void;
+    /**
+     * Unregister an emitter: stop tracking its position and drop its BVH leaf. No-op for an unknown
+     * entity.
+     * @param {number} entity
+     */
+    remove(entity: number): void;
+    /**
+     * Write the entity ids whose audible region contains `listenerPosition` into `out` (starting at
+     * `out_offset`) and return how many — every emitter that can possibly be heard from there (a
+     * conservative superset; see the class note), in unspecified order. Allocation-free: `out` is a
+     * caller-owned reusable buffer, grown as needed (never shrunk), so only `out[out_offset .. out_offset
+     * + count)` is meaningful — entries elsewhere may be stale from a prior query and must be ignored.
+     *
+     * @param {number[]} out caller-owned result buffer, reused across calls (grows, never shrinks)
+     * @param {number} out_offset index in `out` to start writing at
+     * @param {Vector3} listenerPosition
+     * @returns {number} number of matches written to `out`
+     */
+    queryAudible(out: number[], out_offset: number, listenerPosition: Vector3): number;
+    #private;
+}
+//# sourceMappingURL=SpatialAudioIndex.d.ts.map

package/src/engine/sound/ecs/audio/SpatialAudioIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialAudioIndex.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/ecs/audio/SpatialAudioIndex.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAyBI;;OAEG;IACH,mBAEC;IAED;;;OAGG;IACH,YAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;OAOG;IACH,YAJW,MAAM,oDAoBhB;IAED;;;;OAIG;IACH,eAFW,MAAM,QAahB;IAcD;;;;;;;;;;;OAWG;IACH,kBALW,MAAM,EAAE,cACR,MAAM,8BAEJ,MAAM,CASlB;;CACJ"}

package/src/engine/sound/ecs/audio/SpatialAudioIndex.js

@@ -0,0 +1,140 @@
+import { BVH } from "../../../../core/bvh2/bvh3/BVH.js";
+import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
+import { BVHQueryIntersectsSphere } from "../../../../core/bvh2/bvh3/query/BVHQueryIntersectsSphere.js";
+import { bvh_query_user_data_generic } from "../../../../core/bvh2/bvh3/query/bvh_query_user_data_generic.js";
+
+/**
+ * Spatial broadphase for 3D audio emitters (P5.1, cull-only).
+ *
+ * Holds a dynamic BVH whose leaves are each emitter's AUDIBLE region — an axis-aligned box of
+ * half-extent `event.distanceMax` centred on the emitter. So "which emitters can possibly be heard
+ * from point P" is one O(log n + k) BVH point-query instead of an O(n) scan over every emitter. This
+ * is the registered/dormant tier: a registered emitter is a record plus one BVH leaf — no
+ * `EventInstance`, no WebAudio nodes, no per-frame work. Promoting in-range emitters to live instances
+ * (voice slots, stealing, fades) is layered on top later; this class only answers the cull.
+ *
+ * Leaf bounds track the emitter REACTIVELY: each leaf subscribes to its position's `onChanged`, so a
+ * still emitter costs nothing per frame and a moving one refits only when it actually moves. (meep is
+ * fully dynamic — there is no static/dynamic distinction and no per-tick refit loop.)
+ *
+ * The cull is conservative: the leaf is a cube of half-extent `distanceMax`, so its corners admit a
+ * few emitters whose true (spherical) distance slightly exceeds `distanceMax`. That is correct
+ * broadphase behaviour — the exact distance test belongs to the narrowphase (the live instance).
+ */
+export class SpatialAudioIndex {
+
+    /**
+     * @type {BVH}
+     */
+    #bvh = new BVH();
+
+    /**
+     * entity id -> { entity, event, position, bvhClient, onMove }
+     * @type {Map<number, {entity:number, event:EventDescription, position:Vector3, bvhClient:BvhClient, onMove:function}>}
+     */
+    #records = new Map();
+
+    /**
+     * Reused point-query. The sphere `[x, y, z, radius]` is mutated in place each query; radius stays 0,
+     * so the test is "listener point inside the leaf AABB".
+     * @type {number[]}
+     */
+    #querySphere = [0, 0, 0, 0];
+
+    /**
+     * @type {BVHQueryIntersectsSphere}
+     */
+    #query = BVHQueryIntersectsSphere.from(this.#querySphere);
+
+    /**
+     * @returns {number} number of registered emitters
+     */
+    get size() {
+        return this.#records.size;
+    }
+
+    /**
+     * @param {number} entity
+     * @returns {boolean}
+     */
+    has(entity) {
+        return this.#records.has(entity);
+    }
+
+    /**
+     * Register an emitter: insert a BVH leaf sized to its audible region and start tracking its
+     * position. The entity id is the leaf's user data (so queries return entity ids).
+     *
+     * @param {number} entity non-negative integer id
+     * @param {EventDescription} event read for `distanceMax` (and retained for later promotion)
+     * @param {Vector3} position shared position vector — its `onChanged` drives leaf refits
+     */
+    add(entity, event, position) {
+        if (this.#records.has(entity)) {
+            throw new Error(`SpatialAudioIndex: entity ${entity} already registered`);
+        }
+
+        const bvhClient = new BvhClient();
+
+        const record = { entity, event, position, bvhClient, onMove: null };
+
+        this.#writeBounds(record);          // size the leaf AABB before linking (resize no-ops the write pre-link)
+        bvhClient.link(this.#bvh, entity);  // user_data = entity id
+
+        record.onMove = () => this.#writeBounds(record);
+        position.onChanged.add(record.onMove);
+
+        this.#records.set(entity, record);
+    }
+
+    /**
+     * Unregister an emitter: stop tracking its position and drop its BVH leaf. No-op for an unknown
+     * entity.
+     * @param {number} entity
+     */
+    remove(entity) {
+        const record = this.#records.get(entity);
+
+        if (record === undefined) {
+            return;
+        }
+
+        record.position.onChanged.remove(record.onMove);
+        record.bvhClient.unlink();
+
+        this.#records.delete(entity);
+    }
+
+    /**
+     * Refit a record's leaf to `position ± distanceMax`. Called once at registration and again
+     * (reactively) whenever the position changes.
+     * @param {{event:EventDescription, position:Vector3, bvhClient:BvhClient}} record
+     */
+    #writeBounds(record) {
+        const p = record.position;
+        const d = record.event.distanceMax;
+
+        record.bvhClient.resize(p.x - d, p.y - d, p.z - d, p.x + d, p.y + d, p.z + d);
+    }
+
+    /**
+     * Write the entity ids whose audible region contains `listenerPosition` into `out` (starting at
+     * `out_offset`) and return how many — every emitter that can possibly be heard from there (a
+     * conservative superset; see the class note), in unspecified order. Allocation-free: `out` is a
+     * caller-owned reusable buffer, grown as needed (never shrunk), so only `out[out_offset .. out_offset
+     * + count)` is meaningful — entries elsewhere may be stale from a prior query and must be ignored.
+     *
+     * @param {number[]} out caller-owned result buffer, reused across calls (grows, never shrinks)
+     * @param {number} out_offset index in `out` to start writing at
+     * @param {Vector3} listenerPosition
+     * @returns {number} number of matches written to `out`
+     */
+    queryAudible(out, out_offset, listenerPosition) {
+        this.#querySphere[0] = listenerPosition.x;
+        this.#querySphere[1] = listenerPosition.y;
+        this.#querySphere[2] = listenerPosition.z;
+        // radius stays 0 -> point-in-AABB
+
+        return bvh_query_user_data_generic(out, out_offset, this.#bvh, this.#bvh.root, this.#query);
+    }
+}

package/src/engine/sound/ecs/emitter/SoundEmitter.d.ts

@@ -1,4 +1,7 @@
 /**
+ * @deprecated Legacy sound component — superseded by the native {@link AudioEmitter}, which owns a
+ * sopra `EventDescription` directly. Retained as a deprecate-and-plumb compat reader (it still routes
+ * through sopra via {@link SoundEmitterSystem}); prefer `AudioEmitter` for new content.
  * @class
  */
 export class SoundEmitter {
@@ -30,12 +33,6 @@ export class SoundEmitter {
      * @private
      */
     private __distanceMax;
-    /**
-     * @deprecated
-     * @type {number}
-     * @private
-     */
-    private __distanceRolloff;
     /**
      * TODO add to binary serialization
      * @type {SoundPanningModelType}
@@ -51,38 +48,22 @@ export class SoundEmitter {
      * @type {number|SoundEmitterFlags}
      */
     flags: number | SoundEmitterFlags;
-    /**
-     * @readonly
-     */
-    readonly nodes: {
-        /**
-         * @type {GainNode}
-         */
-        volume: GainNode;
-        /**
-         * @type {PannerNode}
-         */
-        panner: PannerNode;
-        /**
-         * @type {GainNode}
-         */
-        attenuation: GainNode;
-        /**
-         * One of the other nodes, depending on the configuration
-         * @type {AudioNode}
-         */
-        endpoint: AudioNode;
-    };
     /**
      *
      * @type {Vector1}
      */
     volume: Vector1;
     /**
-     * @readonly
-     * @type {BvhClient}
+     * Back-reference to the per-entity sopra translation record (set on link by
+     * {@link SoundEmitterComponentContext}). Used by the deprecated fade/stop helpers to reach the
+     * live sopra instances.
+     * @type {SoundEmitterComponentContext|null}
+     */
+    __soundRuntime: SoundEmitterComponentContext | null;
+    /**
+     * @deprecated sopra owns the audio graph — the emitter no longer holds WebAudio nodes.
      */
-    readonly bvh: BvhClient;
+    get nodes(): void;
     /**
      *
      * @param {SoundEmitter} other
@@ -123,10 +104,6 @@ export class SoundEmitter {
      * @return {boolean}
      */
     get isPositioned(): boolean;
-    /**
-     * @return {AudioNode}
-     */
-    getTargetNode(): AudioNode;
     /**
      * @returns {boolean}
      * @param {SoundEmitter} other
@@ -137,16 +114,6 @@ export class SoundEmitter {
      * @return {number}
      */
     hash(): number;
-    /**
-     *
-     * @param {AudioContext} ctx
-     */
-    buildNodes(ctx: AudioContext): void;
-    /**
-     * @private
-     * @param {number} distance
-     */
-    private writeAttenuationVolume;
     /**
      * @param {number} v
      */
@@ -166,28 +133,13 @@ export class SoundEmitter {
      */
     get distanceMax(): number;
     /**
-     * @deprecated
-     * @param {number} v
-     */
-    set distanceRolloff(arg: number);
-    /**
-     * @deprecated
-     * @returns {number}
-     */
-    get distanceRolloff(): number;
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
+     * @deprecated plumbs into sopra — fades every playing track out and stops it.
+     * @param {number} [duration] fade duration in seconds
      */
-    updatePosition(x: number, y: number, z: number): void;
+    fadeOutAllTracks(duration?: number): void;
     /**
-     *
-     * @param {number} [duration] fade duration in seconds
-     * @param startAfter
+     * @deprecated plumbs into sopra — stops every playing track on this emitter.
      */
-    fadeOutAllTracks(duration?: number, startAfter?: number): void;
     stopAllTracks(): void;
     toJSON(): {
         isPositioned: boolean;
@@ -211,5 +163,4 @@ import { SoundPanningModelType } from "./SoundPanningModelType.js";
 import { SoundAttenuationFunction } from "./SoundAttenuationFunction.js";
 import { SoundEmitterFlags } from "./SoundEmitterFlags.js";
 import Vector1 from "../../../../core/geom/Vector1.js";
-import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
 //# sourceMappingURL=SoundEmitter.d.ts.map

package/src/engine/sound/ecs/emitter/SoundEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundEmitter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/ecs/emitter/SoundEmitter.js"],"names":[],"mappings":"AA2BA;;GAEG;AACH;IA4hBI;;;;OAIG;IACH,4BAFa,YAAY,CAQxB;IApiBD;;;OAGG;IACH,iBAFU,KAAK,UAAU,CAAC,CAEN;IAEpB;;;OAGG;IACH,SAFU,gCAA4B,IAAI,CAEhB;IAE1B;;;;OAIG;IACH,sBAAkB;IAElB;;;;OAIG;IACH,sBAAsB;IAEtB;;;;OAIG;IACH,0BAAsB;IAEtB;;;OAGG;IACH,cAFU,qBAAqB,CAEW;IAE1C;;;OAGG;IACH,aAFU,wBAAwB,GAAC,MAAM,CAEI;IAE7C;;;OAGG;IACH,OAFU,MAAM,GAAC,iBAAiB,CAExB;IAEV;;OAEG;IACH;QACI;;WAEG;gBADO,QAAQ;QAGlB;;WAEG;gBADO,UAAU;QAGpB;;WAEG;qBADO,QAAQ;QAGlB;;;WAGG;kBADO,SAAS;MAGrB;IAEF;;;OAGG;IACH,QAFU,OAAO,CAEO;IAExB;;;OAGG;IACH,cAFU,SAAS,CAEG;IAkBtB;;;;OAIG;IACH,eAHW,YAAY,OAqDtB;IAGD;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,SACxB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,OAAO,CAInB;IAGD;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,4BAEC;IAED;;OAEG;IACH,iBAFY,SAAS,CAIpB;IAED;;;OAGG;IACH,cAFW,YAAY,GADV,OAAO,CAWnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAWjB;IAED;;;OAGG;IACH,gBAFW,YAAY,QAqDtB;IAED;;;OAGG;IACH,+BA6BC;IAUD;;OAEG;IACH,6BAEC;IAbD;;;OAGG;IACH,0BAEC;IAiBD;;OAEG;IACH,6BAEC;IAbD;;;OAGG;IACH,0BAEC;IAkBD;;;OAGG;IACH,iCAQC;IApBD;;;OAGG;IACH,8BAEC;IAgBD;;;;;OAKG;IACH,kBAJW,MAAM,KACN,MAAM,KACN,MAAM,QAyBhB;IAED;;;;OAIG;IACH,4BAHW,MAAM,6BAahB;IAED,sBASC;IAED;;;;;;;;;;MAYC;IAED,0BA+DC;CAeJ;;;;iBApkBgB,0CAA0C;2BAkBhC,iBAAiB;sCADN,4BAA4B;yCAFzB,+BAA+B;kCACtC,wBAAwB;oBAdtC,kCAAkC;0BAJ5B,yCAAyC"}
+{"version":3,"file":"SoundEmitter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/ecs/emitter/SoundEmitter.js"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH;IAqVI;;;;OAIG;IACH,4BAFa,YAAY,CAQxB;IA7VD;;;OAGG;IACH,iBAFU,KAAK,UAAU,CAAC,CAEN;IAEpB;;;OAGG;IACH,SAFU,gCAA4B,IAAI,CAEhB;IAE1B;;;;OAIG;IACH,sBAAkB;IAElB;;;;OAIG;IACH,sBAAsB;IAEtB;;;OAGG;IACH,cAFU,qBAAqB,CAEW;IAE1C;;;OAGG;IACH,aAFU,wBAAwB,GAAC,MAAM,CAEI;IAE7C;;;OAGG;IACH,OAFU,MAAM,GAAC,iBAAiB,CAExB;IAEV;;;OAGG;IACH,QAFU,OAAO,CAEO;IAExB;;;;;OAKG;IACH,gBAFU,+BAA6B,IAAI,CAErB;IAEtB;;OAEG;IACH,kBAEC;IAED;;;;OAIG;IACH,eAHW,YAAY,OAqDtB;IAGD;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,iBAAiB,SACxB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,iBAAiB,GACtB,OAAO,CAInB;IAGD;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,4BAEC;IAED;;;OAGG;IACH,cAFW,YAAY,GADV,OAAO,CAWnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAWjB;IAUD;;OAEG;IACH,6BAEC;IAbD;;;OAGG;IACH,0BAEC;IAiBD;;OAEG;IACH,6BAEC;IAbD;;;OAGG;IACH,0BAEC;IASD;;;OAGG;IACH,4BAFW,MAAM,QAMhB;IAED;;OAEG;IACH,sBAIC;IAED;;;;;;;;;;MAYC;IAED,0BA+DC;CAeJ;;;;iBAxXgB,0CAA0C;2BAUhC,iBAAiB;sCADN,4BAA4B;yCAFzB,+BAA+B;kCACtC,wBAAwB;oBAPtC,kCAAkC"}

package/src/engine/sound/ecs/emitter/SoundEmitter.js

@@ -1,15 +1,6 @@
-import { BvhClient } from "../../../../core/bvh2/bvh3/BvhClient.js";
 import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
 import List from '../../../../core/collection/list/List.js';
-import { aabb3_array_compute_from_sphere } from "../../../../core/geom/3d/aabb/aabb3_array_compute_from_sphere.js";
 import Vector1 from "../../../../core/geom/Vector1.js";
-import {
-    interpolate_irradiance_linear
-} from "../../../../core/math/physics/irradiance/interpolate_irradiance_linear.js";
-import {
-    interpolate_irradiance_lograrithmic
-} from "../../../../core/math/physics/irradiance/interpolate_irradiance_lograrithmic.js";
-import { interpolate_irradiance_smith } from "../../../../core/math/physics/irradiance/interpolate_irradiance_smith.js";
 import { objectKeyByValue } from "../../../../core/model/object/objectKeyByValue.js";
 import { computeHashFloat } from "../../../../core/primitives/numbers/computeHashFloat.js";
 import { number_compare_ascending } from "../../../../core/primitives/numbers/number_compare_ascending.js";
@@ -26,6 +17,9 @@ const DEFAULT_DISTANCE_MAX = 10000;
 const DEFAULT_CHANNEL = null;
 
 /**
+ * @deprecated Legacy sound component — superseded by the native {@link AudioEmitter}, which owns a
+ * sopra `EventDescription` directly. Retained as a deprecate-and-plumb compat reader (it still routes
+ * through sopra via {@link SoundEmitterSystem}); prefer `AudioEmitter` for new content.
  * @class
  */
 export class SoundEmitter {
@@ -57,13 +51,6 @@ export class SoundEmitter {
      */
     __distanceMax = 10000;
 
-    /**
-     * @deprecated
-     * @type {number}
-     * @private
-     */
-    __distanceRolloff = 1;
-
     /**
      * TODO add to binary serialization
      * @type {SoundPanningModelType}
@@ -82,29 +69,6 @@ export class SoundEmitter {
      */
     flags = 0;
 
-    /**
-     * @readonly
-     */
-    nodes = {
-        /**
-         * @type {GainNode}
-         */
-        volume: null,
-        /**
-         * @type {PannerNode}
-         */
-        panner: null,
-        /**
-         * @type {GainNode}
-         */
-        attenuation: null,
-        /**
-         * One of the other nodes, depending on the configuration
-         * @type {AudioNode}
-         */
-        endpoint: null
-    };
-
     /**
      *
      * @type {Vector1}
@@ -112,25 +76,18 @@ export class SoundEmitter {
     volume = new Vector1(1);
 
     /**
-     * @readonly
-     * @type {BvhClient}
+     * Back-reference to the per-entity sopra translation record (set on link by
+     * {@link SoundEmitterComponentContext}). Used by the deprecated fade/stop helpers to reach the
+     * live sopra instances.
+     * @type {SoundEmitterComponentContext|null}
      */
-    bvh = new BvhClient();
+    __soundRuntime = null;
 
     /**
-     *
-     * @constructor
+     * @deprecated sopra owns the audio graph — the emitter no longer holds WebAudio nodes.
      */
-    constructor() {
-
-        this.volume.onChanged.add((value) => {
-            const volume_node = this.nodes.volume;
-
-            if (volume_node !== null) {
-                volume_node.gain.setValueAtTime(value, 0);
-            }
-        });
-
+    get nodes() {
+        throw new Error("SoundEmitter.nodes is deprecated — sopra owns the audio graph");
     }
 
     /**
@@ -248,13 +205,6 @@ export class SoundEmitter {
         return this.getFlag(SoundEmitterFlags.Spatialization);
     }
 
-    /**
-     * @return {AudioNode}
-     */
-    getTargetNode() {
-        return this.nodes.endpoint;
-    }
-
     /**
      * @returns {boolean}
      * @param {SoundEmitter} other
@@ -284,98 +234,6 @@ export class SoundEmitter {
         );
     }
 
-    /**
-     *
-     * @param {AudioContext} ctx
-     */
-    buildNodes(ctx) {
-        const nodes = this.nodes;
-
-        nodes.volume = ctx.createGain();
-
-        if (this.getFlag(SoundEmitterFlags.Attenuation)) {
-            nodes.attenuation = ctx.createGain();
-        }
-
-        if (this.getFlag(SoundEmitterFlags.Spatialization)) {
-            nodes.panner = ctx.createPanner();
-
-
-            //
-            if (this.panningModel === SoundPanningModelType.HRTF) {
-                nodes.panner.panningModel = 'HRTF';
-            } else if (this.panningModel === SoundPanningModelType.EqualPower) {
-                nodes.panner.panningModel = 'equalpower';
-            } else {
-                console.error('Invalid value of panning model type:', this.panningModel);
-
-                nodes.panner.panningModel = 'equalpower';
-            }
-
-            // we set up distance model in the most efficient way, since we are ignoring it anyway and use custom distance model via a GainNode instead
-            nodes.panner.distanceModel = 'linear';
-            nodes.panner.rolloffFactor = 0;
-            nodes.panner.refDistance = this.distanceMin;
-            nodes.panner.maxDistance = this.distanceMax;
-
-        }
-
-        //do wiring
-        if (this.getFlag(SoundEmitterFlags.Attenuation | SoundEmitterFlags.Spatialization)) {
-            nodes.attenuation.connect(nodes.panner);
-            nodes.volume.connect(nodes.attenuation);
-
-            nodes.endpoint = nodes.panner;
-        } else if (this.getFlag(SoundEmitterFlags.Spatialization)) {
-            nodes.volume.connect(nodes.panner);
-
-            nodes.endpoint = nodes.panner;
-        } else if (this.getFlag(SoundEmitterFlags.Attenuation)) {
-            nodes.volume.connect(nodes.attenuation);
-
-            nodes.endpoint = nodes.attenuation;
-        } else {
-            nodes.endpoint = nodes.volume;
-        }
-
-        nodes.volume.gain.setValueAtTime(this.volume.getValue(), 0);
-    }
-
-    /**
-     * @private
-     * @param {number} distance
-     */
-    writeAttenuationVolume(distance) {
-
-        let volume;
-
-        const attenuation = this.attenuation;
-
-        const distance_min = this.__distanceMin;
-        const distance_max = this.__distanceMax;
-
-        if (attenuation === SoundAttenuationFunction.Linear) {
-            volume = interpolate_irradiance_linear(distance, distance_min, distance_max);
-        } else if (attenuation === SoundAttenuationFunction.Logarithmic) {
-            volume = interpolate_irradiance_lograrithmic(distance, distance_min, distance_max);
-        } else if (attenuation === SoundAttenuationFunction.Smith) {
-            volume = interpolate_irradiance_smith(distance, distance_min, distance_max);
-        } else {
-            //unsupported function, don't attenuate
-            volume = 1;
-        }
-
-        /**
-         *
-         * @type {GainNode}
-         */
-        const pv = this.nodes.attenuation;
-
-        if (pv !== null) {
-            pv.gain.setValueAtTime(volume, 0);
-        }
-    }
-
     /**
      *
      * @returns {number}
@@ -406,85 +264,22 @@ export class SoundEmitter {
         this.__distanceMax = v;
     }
 
-
     /**
-     * @deprecated
-     * @returns {number}
-     */
-    get distanceRolloff() {
-        return this.__distanceRolloff;
-    }
-
-    /**
-     * @deprecated
-     * @param {number} v
-     */
-    set distanceRolloff(v) {
-        this.__distanceRolloff = v;
-
-        const panner = this.nodes.panner;
-
-        if (panner !== null) {
-            panner.rolloffFactor = v;
-        }
-    }
-
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
+     * @deprecated plumbs into sopra — fades every playing track out and stops it.
+     * @param {number} [duration] fade duration in seconds
      */
-    updatePosition(x, y, z) {
-        if (this.getFlag(SoundEmitterFlags.Spatialization)) {
-            //update position of the panner node
-            const nodes = this.nodes;
-
-            /**
-             *
-             * @type {PannerNode}
-             */
-            const panner = nodes.panner;
-
-            if (panner !== null) {
-                panner.setPosition(x, y, z);
-            }
+    fadeOutAllTracks(duration = 1) {
+        if (this.__soundRuntime !== null) {
+            this.__soundRuntime.fadeOutAll(duration);
         }
-
-        const distanceMax = this.distanceMax;
-
-        const bounds = this.bvh.bounds;
-
-        aabb3_array_compute_from_sphere(bounds, 0, x, y, z, distanceMax);
-
-        this.bvh.write_bounds();
     }
 
     /**
-     *
-     * @param {number} [duration] fade duration in seconds
-     * @param startAfter
+     * @deprecated plumbs into sopra — stops every playing track on this emitter.
      */
-    fadeOutAllTracks(duration = 1, startAfter = 0) {
-
-        const tracks = this.tracks;
-        const n = tracks.length;
-
-        for (let i = 0; i < n; i++) {
-            const soundTrack = tracks.get(i);
-
-            soundTrack.setVolumeOverTime(0, duration, startAfter);
-        }
-    }
-
     stopAllTracks() {
-        const tracks = this.tracks;
-        const n = tracks.length;
-
-        for (let i = 0; i < n; i++) {
-            const soundTrack = tracks.get(i);
-
-            soundTrack.playing = false;
+        if (this.__soundRuntime !== null) {
+            this.__soundRuntime.stopAll();
         }
     }