@woosh/meep-engine 3.44.0 → 3.46.0

package/src/engine/sound/sopra/legacy/SoundTrack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundTrack.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/legacy/SoundTrack.js"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH;IA6PI,uCAMC;IAjQD;;;OAGG;IACH,KAFU,SAAO,IAAI,CAEV;IAEX;;;;OAIG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,SAFU,SAAO,IAAI,CAER;IAEb;;OAEG;IACH,QAFU,MAAM,CAEL;IAGX;;;OAGG;IACH,OAFU,MAAM,GAAC,eAAe,CAEV;IAEtB;;;;OAIG;IACH,eAHW,UAAU,UAmCpB;IAED;;;;OAIG;IACH,cAHW,MAAM,oBAAkB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,oBAAkB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,oBAAkB,SACxB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,oBAAkB,GACtB,OAAO,CAInB;IAUD;;;OAGG;IACH,qBAEC;IAdD;;;OAGG;IACH,oBAEC;IAkBD;;;OAGG;IACH,wBAEC;IAdD;;;OAGG;IACH,uBAEC;IAkBD;;;OAGG;IACH,+BAEC;IAdD;;;OAGG;IACH,8BAEC;IAUD;;;OAGG;IACH,YAFW,UAAU,QAOpB;IAED;;;;OAIG;IACH,cAHW,UAAU,GACR,OAAO,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CASjB;IAED;;;OAGG;IACH,SAFY,UAAU,CAQrB;IAED;;;;;;;;;MAWC;IAED;;;;;;;;;aA6BC;CAUJ;gCA/Q+B,sBAAsB"}
+{"version":3,"file":"SoundTrack.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/legacy/SoundTrack.js"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH;IA+PI,uCAMC;IAnQD;;;OAGG;IACH,KAFU,SAAO,IAAI,CAEV;IAEX;;;;OAIG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,SAFU,SAAO,IAAI,CAER;IAEb;;OAEG;IACH,QAFU,MAAM,CAEL;IAGX;;;OAGG;IACH,OAFU,MAAM,GAAC,eAAe,CAEV;IAEtB;;;;OAIG;IACH,eAHW,UAAU,UAmCpB;IAED;;;;OAIG;IACH,cAHW,MAAM,oBAAkB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,oBAAkB,GACtB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,oBAAkB,SACxB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,oBAAkB,GACtB,OAAO,CAInB;IAUD;;;OAGG;IACH,qBAEC;IAdD;;;OAGG;IACH,oBAEC;IAkBD;;;OAGG;IACH,wBAEC;IAdD;;;OAGG;IACH,uBAEC;IAkBD;;;OAGG;IACH,+BAEC;IAdD;;;OAGG;IACH,8BAEC;IAUD;;;OAGG;IACH,YAFW,UAAU,QAOpB;IAED;;;;OAIG;IACH,cAHW,UAAU,GACR,OAAO,CAQnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAWjB;IAED;;;OAGG;IACH,SAFY,UAAU,CAQrB;IAED;;;;;;;;;MAWC;IAED;;;;;;;;;aA6BC;CAUJ;gCAjR+B,sBAAsB"}

package/src/engine/sound/sopra/legacy/SoundTrack.js

@@ -1,278 +1,281 @@
-import { assert } from "../../../../core/assert.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
-import { computeHashFloat } from "../../../../core/primitives/numbers/computeHashFloat.js";
-import { number_compare_ascending } from "../../../../core/primitives/numbers/number_compare_ascending.js";
-import { compareStrings } from "../../../../core/primitives/strings/compareStrings.js";
-import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
-import { SoundTrackFlags } from "./SoundTrackFlags.js";
-
-const DEFAULT_FLAGS = SoundTrackFlags.StartWhenReady;
-
-/**
- * @deprecated Frozen legacy reader — one track of a legacy {@link SoundEmitter}. Data only: it has no
- * runtime behaviour and nothing plays it. It exists so that saves written before the native audio path
- * still deserialize, and so {@link convertLegacySoundComponents} can turn what they carry into an
- * authored sopra event. Do not author new content with it.
- */
-export class SoundTrack {
-
-    /**
-     *
-     * @type {String|null}
-     */
-    url = null;
-
-    /**
-     * Playback cursor in seconds, as it was written. Never restored into playback — the legacy runtime
-     * always started a loaded track from zero — so the converter drops it.
-     * @type {number}
-     */
-    time = 0;
-
-    /**
-     * @deprecated Not used
-     * @type {String|null}
-     */
-    channel = "";
-
-    /**
-     * @type {number}
-     */
-    volume = 1;
-
-
-    /**
-     *
-     * @type {number|SoundTrackFlags}
-     */
-    flags = DEFAULT_FLAGS;
-
-    /**
-     *
-     * @param {SoundTrack} other
-     * @returns number
-     */
-    compare(other) {
-        const url = compareStrings(this.url, other.url);
-
-        if (url !== 0) {
-            return url;
-        }
-
-        const time = number_compare_ascending(this.time, other.time);
-
-        if (time !== 0) {
-            return time;
-        }
-
-        const channel = compareStrings(this.channel, other.channel);
-
-        if (channel !== 0) {
-            return channel;
-        }
-
-        const volume = number_compare_ascending(this.volume, other.volume);
-
-        if (volume !== 0) {
-            return volume;
-        }
-
-        const flags = number_compare_ascending(this.flags, other.flags);
-
-        if (flags !== 0) {
-            return flags;
-        }
-
-        return 0;
-    }
-
-    /**
-     *
-     * @param {number|SoundEmitterFlags} flag
-     * @returns {void}
-     */
-    setFlag(flag) {
-        this.flags |= flag;
-    }
-
-    /**
-     *
-     * @param {number|SoundEmitterFlags} flag
-     * @returns {void}
-     */
-    clearFlag(flag) {
-        this.flags &= ~flag;
-    }
-
-    /**
-     *
-     * @param {number|SoundEmitterFlags} flag
-     * @param {boolean} value
-     */
-    writeFlag(flag, value) {
-        if (value) {
-            this.setFlag(flag);
-        } else {
-            this.clearFlag(flag);
-        }
-    }
-
-    /**
-     *
-     * @param {number|SoundEmitterFlags} flag
-     * @returns {boolean}
-     */
-    getFlag(flag) {
-        return (this.flags & flag) === flag;
-    }
-
-    /**
-     * @deprecated
-     * @return {boolean}
-     */
-    get loop() {
-        return this.getFlag(SoundTrackFlags.Loop);
-    }
-
-    /**
-     * @deprecated
-     * @param {boolean} v
-     */
-    set loop(v) {
-        this.writeFlag(SoundTrackFlags.Loop, v);
-    }
-
-    /**
-     * @deprecated
-     * @return {boolean}
-     */
-    get playing() {
-        return this.getFlag(SoundTrackFlags.Playing);
-    }
-
-    /**
-     * @deprecated
-     * @param {boolean} v
-     */
-    set playing(v) {
-        this.writeFlag(SoundTrackFlags.Playing, v);
-    }
-
-    /**
-     * @deprecated
-     * @return {boolean}
-     */
-    get startWhenReady() {
-        return this.getFlag(SoundTrackFlags.StartWhenReady);
-    }
-
-    /**
-     * @deprecated
-     * @param {boolean} v
-     */
-    set startWhenReady(v) {
-        this.writeFlag(SoundTrackFlags.StartWhenReady, v);
-    }
-
-    /**
-     *
-     * @param {SoundTrack} other
-     */
-    copy(other) {
-        this.url = other.url;
-        this.time = other.time;
-        this.volume = other.volume;
-        this.flags = other.flags;
-    }
-
-    /**
-     *
-     * @param {SoundTrack} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        return this.url === other.url
-            && this.time === other.time
-            && this.volume === other.volume
-            && this.flags === other.flags
-            ;
-    }
-
-    /**
-     *
-     * @return {number}
-     */
-    hash() {
-        return combine_hash(
-            computeStringHash(this.url),
-            computeHashFloat(this.time),
-            computeHashFloat(this.volume),
-            this.flags
-        );
-    }
-
-    /**
-     *
-     * @return {SoundTrack}
-     */
-    clone() {
-        const r = new SoundTrack();
-
-        r.copy(this);
-
-        return r;
-    }
-
-    toJSON() {
-        return {
-            url: this.url,
-            loop: this.getFlag(SoundTrackFlags.Loop),
-            time: this.time,
-            volume: this.volume,
-            playing: this.getFlag(SoundTrackFlags.Playing),
-            startWhenReady: this.getFlag(SoundTrackFlags.StartWhenReady),
-            usingAssetAlias: this.getFlag(SoundTrackFlags.UsingAliasURL),
-            synchronized: this.getFlag(SoundTrackFlags.Synchronized)
-        };
-    }
-
-    fromJSON(
-        {
-            url,
-            loop = false,
-            time = 0,
-            volume = 1,
-            playing = false,
-            startWhenReady = true,
-            usingAssetAlias = false,
-            synchronized = false
-        }
-    ) {
-        assert.isString(url, 'url');
-
-        this.url = url;
-
-        this.writeFlag(SoundTrackFlags.Loop, loop);
-
-        this.writeFlag(SoundTrackFlags.UsingAliasURL, usingAssetAlias);
-
-        this.time = time;
-
-        this.volume = volume;
-
-        this.writeFlag(SoundTrackFlags.Playing, playing);
-
-        this.writeFlag(SoundTrackFlags.StartWhenReady, startWhenReady);
-
-        this.writeFlag(SoundTrackFlags.Synchronized, synchronized);
-    }
-
-    static fromJSON(json) {
-        const track = new SoundTrack();
-
-        track.fromJSON(json);
-
-        return track;
-    }
-
-}
+import { assert } from "../../../../core/assert.js";
+import { hash_mix2 } from "../../../../core/math/hash/hash_mix2.js";
+import { hash_mix3 } from "../../../../core/math/hash/hash_mix3.js";
+import { computeHashFloat } from "../../../../core/primitives/numbers/computeHashFloat.js";
+import { number_compare_ascending } from "../../../../core/primitives/numbers/number_compare_ascending.js";
+import { compareStrings } from "../../../../core/primitives/strings/compareStrings.js";
+import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
+import { SoundTrackFlags } from "./SoundTrackFlags.js";
+
+const DEFAULT_FLAGS = SoundTrackFlags.StartWhenReady;
+
+/**
+ * @deprecated Frozen legacy reader — one track of a legacy {@link SoundEmitter}. Data only: it has no
+ * runtime behaviour and nothing plays it. It exists so that saves written before the native audio path
+ * still deserialize, and so {@link convertLegacySoundComponents} can turn what they carry into an
+ * authored sopra event. Do not author new content with it.
+ */
+export class SoundTrack {
+
+    /**
+     *
+     * @type {String|null}
+     */
+    url = null;
+
+    /**
+     * Playback cursor in seconds, as it was written. Never restored into playback — the legacy runtime
+     * always started a loaded track from zero — so the converter drops it.
+     * @type {number}
+     */
+    time = 0;
+
+    /**
+     * @deprecated Not used
+     * @type {String|null}
+     */
+    channel = "";
+
+    /**
+     * @type {number}
+     */
+    volume = 1;
+
+
+    /**
+     *
+     * @type {number|SoundTrackFlags}
+     */
+    flags = DEFAULT_FLAGS;
+
+    /**
+     *
+     * @param {SoundTrack} other
+     * @returns number
+     */
+    compare(other) {
+        const url = compareStrings(this.url, other.url);
+
+        if (url !== 0) {
+            return url;
+        }
+
+        const time = number_compare_ascending(this.time, other.time);
+
+        if (time !== 0) {
+            return time;
+        }
+
+        const channel = compareStrings(this.channel, other.channel);
+
+        if (channel !== 0) {
+            return channel;
+        }
+
+        const volume = number_compare_ascending(this.volume, other.volume);
+
+        if (volume !== 0) {
+            return volume;
+        }
+
+        const flags = number_compare_ascending(this.flags, other.flags);
+
+        if (flags !== 0) {
+            return flags;
+        }
+
+        return 0;
+    }
+
+    /**
+     *
+     * @param {number|SoundEmitterFlags} flag
+     * @returns {void}
+     */
+    setFlag(flag) {
+        this.flags |= flag;
+    }
+
+    /**
+     *
+     * @param {number|SoundEmitterFlags} flag
+     * @returns {void}
+     */
+    clearFlag(flag) {
+        this.flags &= ~flag;
+    }
+
+    /**
+     *
+     * @param {number|SoundEmitterFlags} flag
+     * @param {boolean} value
+     */
+    writeFlag(flag, value) {
+        if (value) {
+            this.setFlag(flag);
+        } else {
+            this.clearFlag(flag);
+        }
+    }
+
+    /**
+     *
+     * @param {number|SoundEmitterFlags} flag
+     * @returns {boolean}
+     */
+    getFlag(flag) {
+        return (this.flags & flag) === flag;
+    }
+
+    /**
+     * @deprecated
+     * @return {boolean}
+     */
+    get loop() {
+        return this.getFlag(SoundTrackFlags.Loop);
+    }
+
+    /**
+     * @deprecated
+     * @param {boolean} v
+     */
+    set loop(v) {
+        this.writeFlag(SoundTrackFlags.Loop, v);
+    }
+
+    /**
+     * @deprecated
+     * @return {boolean}
+     */
+    get playing() {
+        return this.getFlag(SoundTrackFlags.Playing);
+    }
+
+    /**
+     * @deprecated
+     * @param {boolean} v
+     */
+    set playing(v) {
+        this.writeFlag(SoundTrackFlags.Playing, v);
+    }
+
+    /**
+     * @deprecated
+     * @return {boolean}
+     */
+    get startWhenReady() {
+        return this.getFlag(SoundTrackFlags.StartWhenReady);
+    }
+
+    /**
+     * @deprecated
+     * @param {boolean} v
+     */
+    set startWhenReady(v) {
+        this.writeFlag(SoundTrackFlags.StartWhenReady, v);
+    }
+
+    /**
+     *
+     * @param {SoundTrack} other
+     */
+    copy(other) {
+        this.url = other.url;
+        this.time = other.time;
+        this.volume = other.volume;
+        this.flags = other.flags;
+    }
+
+    /**
+     *
+     * @param {SoundTrack} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.url === other.url
+            && this.time === other.time
+            && this.volume === other.volume
+            && this.flags === other.flags
+            ;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    hash() {
+        return hash_mix2(
+            hash_mix3(
+                computeStringHash(this.url),
+                computeHashFloat(this.time),
+                computeHashFloat(this.volume)
+            ),
+            this.flags
+        );
+    }
+
+    /**
+     *
+     * @return {SoundTrack}
+     */
+    clone() {
+        const r = new SoundTrack();
+
+        r.copy(this);
+
+        return r;
+    }
+
+    toJSON() {
+        return {
+            url: this.url,
+            loop: this.getFlag(SoundTrackFlags.Loop),
+            time: this.time,
+            volume: this.volume,
+            playing: this.getFlag(SoundTrackFlags.Playing),
+            startWhenReady: this.getFlag(SoundTrackFlags.StartWhenReady),
+            usingAssetAlias: this.getFlag(SoundTrackFlags.UsingAliasURL),
+            synchronized: this.getFlag(SoundTrackFlags.Synchronized)
+        };
+    }
+
+    fromJSON(
+        {
+            url,
+            loop = false,
+            time = 0,
+            volume = 1,
+            playing = false,
+            startWhenReady = true,
+            usingAssetAlias = false,
+            synchronized = false
+        }
+    ) {
+        assert.isString(url, 'url');
+
+        this.url = url;
+
+        this.writeFlag(SoundTrackFlags.Loop, loop);
+
+        this.writeFlag(SoundTrackFlags.UsingAliasURL, usingAssetAlias);
+
+        this.time = time;
+
+        this.volume = volume;
+
+        this.writeFlag(SoundTrackFlags.Playing, playing);
+
+        this.writeFlag(SoundTrackFlags.StartWhenReady, startWhenReady);
+
+        this.writeFlag(SoundTrackFlags.Synchronized, synchronized);
+    }
+
+    static fromJSON(json) {
+        const track = new SoundTrack();
+
+        track.fromJSON(json);
+
+        return track;
+    }
+
+}