arx-convert 5.17.0 → 6.1.0

package/README.md

@@ -26,7 +26,7 @@ the inputfile and --output parameters can be omitted and then the code can be us
 
 `cat <inputfile> | arx-convert --from=<format> --to=<format> > <outputfile>`
 
-the format parameter can be one of the following arx formats: `dlf`, `llf`, `fts`
+the format parameter can be one of the following arx formats: `dlf`, `llf`, `fts` or `amb`
 
 work in progress formats: `ftl` and `tea`
 

package/dist/amb/AMB.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+import { Buffer } from 'node:buffer';
+import { ArxTrack } from './Track';
+export type ArxAMB = {
+    tracks: ArxTrack[];
+};
+export declare class AMB {
+    static load(decompressedFile: Buffer): ArxAMB;
+    static save(json: ArxAMB): Buffer;
+}

package/dist/amb/AMB.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AMB = void 0;
+const node_buffer_1 = require("node:buffer");
+const BinaryIO_1 = require("../common/BinaryIO");
+const helpers_1 = require("../common/helpers");
+const AmbHeader_1 = require("./AmbHeader");
+const Track_1 = require("./Track");
+class AMB {
+    static load(decompressedFile) {
+        const file = new BinaryIO_1.BinaryIO(decompressedFile);
+        const { numberOfTracks, isNewerVersion } = AmbHeader_1.AmbHeader.readFrom(file);
+        const data = {
+            tracks: (0, helpers_1.times)(() => Track_1.Track.readFrom(file, isNewerVersion), numberOfTracks),
+        };
+        return data;
+    }
+    static save(json) {
+        const header = AmbHeader_1.AmbHeader.accumulateFrom(json);
+        const tracks = node_buffer_1.Buffer.concat(json.tracks.map(Track_1.Track.accumulateFrom));
+        return node_buffer_1.Buffer.concat([header, tracks]);
+    }
+}
+exports.AMB = AMB;
+//# sourceMappingURL=AMB.js.map

package/dist/amb/AMB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AMB.js","sourceRoot":"","sources":["../../src/amb/AMB.ts"],"names":[],"mappings":";;;AAAA,6CAAoC;AACpC,+CAA2C;AAC3C,6CAAuC;AACvC,8CAA0C;AAC1C,sCAA4C;AAM5C,MAAa,GAAG;IACd,MAAM,CAAC,IAAI,CAAC,gBAAwB;QAClC,MAAM,IAAI,GAAG,IAAI,mBAAQ,CAAC,gBAAgB,CAAC,CAAA;QAE3C,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,qBAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEnE,MAAM,IAAI,GAAW;YACnB,MAAM,EAAE,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,aAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,CAAC;SAC1E,CAAA;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,MAAM,MAAM,GAAG,qBAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,oBAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAK,CAAC,cAAc,CAAC,CAAC,CAAA;QAEnE,OAAO,oBAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACxC,CAAC;CACF;AAnBD,kBAmBC"}

package/dist/amb/AmbHeader.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+import { BinaryIO } from '../common/BinaryIO';
+import { ArxAMB } from './AMB';
+export type ArxAmbHeader = {
+    isNewerVersion: boolean;
+    numberOfTracks: number;
+};
+export declare class AmbHeader {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L627
+     */
+    static readFrom(binary: BinaryIO): ArxAmbHeader;
+    static accumulateFrom(json: ArxAMB): Buffer;
+    static sizeOf(): number;
+}

package/dist/amb/AmbHeader.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmbHeader = void 0;
+const BinaryIO_1 = require("../common/BinaryIO");
+const constants_1 = require("./constants");
+class AmbHeader {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L627
+     */
+    static readFrom(binary) {
+        binary.readString(4); // identifier - always "GAMB"
+        const version = binary.readUint32();
+        return {
+            isNewerVersion: version >= constants_1.VERSION_1002,
+            numberOfTracks: binary.readUint32(),
+        };
+    }
+    static accumulateFrom(json) {
+        const buffer = Buffer.alloc(AmbHeader.sizeOf());
+        const binary = new BinaryIO_1.BinaryIO(buffer);
+        binary.writeString('GAMB', 4);
+        binary.writeInt32(constants_1.VERSION_1003);
+        binary.writeInt32(json.tracks.length);
+        return buffer;
+    }
+    static sizeOf() {
+        return BinaryIO_1.BinaryIO.sizeOfString(4) + BinaryIO_1.BinaryIO.sizeOfInt32() * 2;
+    }
+}
+exports.AmbHeader = AmbHeader;
+//# sourceMappingURL=AmbHeader.js.map

package/dist/amb/AmbHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmbHeader.js","sourceRoot":"","sources":["../../src/amb/AmbHeader.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C,8CAA2D;AAO3D,MAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAgB;QAC9B,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA,CAAC,6BAA6B;QAElD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QAEnC,OAAO;YACL,cAAc,EAAE,OAAO,IAAI,wBAAY;YACvC,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE;SACpC,CAAA;IACH,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,IAAY;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,IAAI,mBAAQ,CAAC,MAAM,CAAC,CAAA;QAEnC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,UAAU,CAAC,wBAAY,CAAC,CAAA;QAC/B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAErC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,mBAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,mBAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAC9D,CAAC;CACF;AA7BD,8BA6BC"}

package/dist/amb/Key.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="node" />
+import { BinaryIO } from '../common/BinaryIO';
+import { ArxSetting } from './Setting';
+/**
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L168
+ */
+export type ArxKey = {
+    flags: number;
+    /** milliseconds */
+    start: number;
+    loop: number;
+    /** milliseconds */
+    delayMin: number;
+    /** milliseconds */
+    delayMax: number;
+    volume: ArxSetting;
+    pitch: ArxSetting;
+    pan: ArxSetting;
+    x: ArxSetting;
+    y: ArxSetting;
+    z: ArxSetting;
+};
+export declare class Key {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L187
+     */
+    static readFrom(binary: BinaryIO): ArxKey;
+    static accumulateFrom(key: ArxKey): Buffer;
+    static sizeOf(): number;
+}

package/dist/amb/Key.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Key = void 0;
+const BinaryIO_1 = require("../common/BinaryIO");
+const Setting_1 = require("./Setting");
+class Key {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L187
+     */
+    static readFrom(binary) {
+        return {
+            flags: binary.readUint32(),
+            start: binary.readUint32(),
+            loop: binary.readUint32() + 1,
+            delayMin: binary.readUint32(),
+            delayMax: binary.readUint32(),
+            volume: Setting_1.Setting.readFrom(binary),
+            pitch: Setting_1.Setting.readFrom(binary),
+            pan: Setting_1.Setting.readFrom(binary),
+            x: Setting_1.Setting.readFrom(binary),
+            y: Setting_1.Setting.readFrom(binary),
+            z: Setting_1.Setting.readFrom(binary),
+        };
+    }
+    static accumulateFrom(key) {
+        const buffer = Buffer.alloc(Key.sizeOf());
+        const binary = new BinaryIO_1.BinaryIO(buffer);
+        binary.writeUint32(key.flags);
+        binary.writeUint32(key.start);
+        binary.writeUint32(key.loop - 1);
+        binary.writeUint32(key.delayMin);
+        binary.writeUint32(key.delayMax);
+        binary.writeBuffer(Setting_1.Setting.accumulateFrom(key.volume));
+        binary.writeBuffer(Setting_1.Setting.accumulateFrom(key.pitch));
+        binary.writeBuffer(Setting_1.Setting.accumulateFrom(key.pan));
+        binary.writeBuffer(Setting_1.Setting.accumulateFrom(key.x));
+        binary.writeBuffer(Setting_1.Setting.accumulateFrom(key.y));
+        binary.writeBuffer(Setting_1.Setting.accumulateFrom(key.z));
+        return buffer;
+    }
+    static sizeOf() {
+        return BinaryIO_1.BinaryIO.sizeOfInt32() * 5 + Setting_1.Setting.sizeOf() * 6;
+    }
+}
+exports.Key = Key;
+//# sourceMappingURL=Key.js.map

package/dist/amb/Key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Key.js","sourceRoot":"","sources":["../../src/amb/Key.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAC3C,0CAAkD;AAsBlD,MAAa,GAAG;IACd;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAgB;QAC9B,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;YAC1B,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;YAC1B,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC;YAC7B,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;YAC7B,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;YAE7B,MAAM,EAAE,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAChC,KAAK,EAAE,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC/B,GAAG,EAAE,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7B,CAAC,EAAE,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3B,CAAC,EAAE,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3B,CAAC,EAAE,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;SAC5B,CAAA;IACH,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,GAAW;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,IAAI,mBAAQ,CAAC,MAAM,CAAC,CAAA;QAEnC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC7B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC7B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAChC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAEhC,MAAM,CAAC,WAAW,CAAC,iBAAO,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,WAAW,CAAC,iBAAO,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;QACrD,MAAM,CAAC,WAAW,CAAC,iBAAO,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,WAAW,CAAC,iBAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACjD,MAAM,CAAC,WAAW,CAAC,iBAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACjD,MAAM,CAAC,WAAW,CAAC,iBAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAEjD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,mBAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,iBAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1D,CAAC;CACF;AA5CD,kBA4CC"}

package/dist/amb/Setting.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="node" />
+import { BinaryIO } from '../common/BinaryIO';
+/**
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L84
+ */
+export declare enum ArxSettingFlag {
+    None = 0,
+    Random = 1,
+    Interpolate = 2
+}
+/**
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L90
+ */
+export type ArxSetting = {
+    min: number;
+    max: number;
+    /** milliseconds */
+    interval: number;
+    flags: ArxSettingFlag;
+};
+export declare class Setting {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L107
+     */
+    static readFrom(binary: BinaryIO): ArxSetting;
+    static accumulateFrom(setting: ArxSetting): Buffer;
+    static sizeOf(): number;
+}

package/dist/amb/Setting.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Setting = exports.ArxSettingFlag = void 0;
+const BinaryIO_1 = require("../common/BinaryIO");
+/**
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L84
+ */
+var ArxSettingFlag;
+(function (ArxSettingFlag) {
+    ArxSettingFlag[ArxSettingFlag["None"] = 0] = "None";
+    ArxSettingFlag[ArxSettingFlag["Random"] = 1] = "Random";
+    ArxSettingFlag[ArxSettingFlag["Interpolate"] = 2] = "Interpolate";
+})(ArxSettingFlag = exports.ArxSettingFlag || (exports.ArxSettingFlag = {}));
+class Setting {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L107
+     */
+    static readFrom(binary) {
+        return {
+            min: binary.readFloat32(),
+            max: binary.readFloat32(),
+            interval: binary.readUint32(),
+            flags: binary.readUint32(),
+        };
+    }
+    static accumulateFrom(setting) {
+        const buffer = Buffer.alloc(Setting.sizeOf());
+        const binary = new BinaryIO_1.BinaryIO(buffer);
+        binary.writeFloat32(setting.min);
+        binary.writeFloat32(setting.max);
+        binary.writeUint32(setting.interval);
+        binary.writeUint32(setting.flags);
+        return buffer;
+    }
+    static sizeOf() {
+        return BinaryIO_1.BinaryIO.sizeOfFloat32() * 2 + BinaryIO_1.BinaryIO.sizeOfInt32() * 2;
+    }
+}
+exports.Setting = Setting;
+//# sourceMappingURL=Setting.js.map

package/dist/amb/Setting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Setting.js","sourceRoot":"","sources":["../../src/amb/Setting.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C;;GAEG;AACH,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,mDAAQ,CAAA;IACR,uDAAe,CAAA;IACf,iEAAoB,CAAA;AACtB,CAAC,EAJW,cAAc,GAAd,sBAAc,KAAd,sBAAc,QAIzB;AAaD,MAAa,OAAO;IAClB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAgB;QAC9B,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE;YACzB,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE;YACzB,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;YAC7B,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;SAC3B,CAAA;IACH,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAmB;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,IAAI,mBAAQ,CAAC,MAAM,CAAC,CAAA;QAEnC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACpC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAEjC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,mBAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,mBAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAClE,CAAC;CACF;AA5BD,0BA4BC"}

package/dist/amb/Track.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="node" />
+import { BinaryIO } from '../common/BinaryIO';
+import { ArxKey } from './Key';
+/**
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L230
+ */
+export declare enum ArxTrackFlags {
+    None = 0,
+    Position = 1,
+    Master = 4,
+    Paused = 16,
+    Prefetched = 32
+}
+export type ArxTrack = {
+    filename: string;
+    flags: ArxTrackFlags;
+    keys: ArxKey[];
+};
+export declare class Track {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L531
+     */
+    static readFrom(binary: BinaryIO, isNewerVersion: boolean): ArxTrack;
+    static accumulateFrom(track: ArxTrack): Buffer;
+    /**
+     * from: SFX\\AMBIANCE\\LOOP_GOBLIN_MAIN.WAV
+     *   to: loop_goblin_main.wav
+     *
+     * from: SFX\\AMBIANCE\\FX_ADDON\\SCREAM3.WAV
+     *   to: fx_addon/scream3.wav
+     */
+    static toRelativePath(filename: string): string;
+    /**
+     * from: loop_goblin_main.wav
+     *   to: sfx\\ambiance\\loop_goblin_main.wav
+     */
+    static toAbsolutePath(filename: string): string;
+    static sizeOf(track: ArxTrack): number;
+}

package/dist/amb/Track.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Track = exports.ArxTrackFlags = void 0;
+const BinaryIO_1 = require("../common/BinaryIO");
+const helpers_1 = require("../common/helpers");
+const Key_1 = require("./Key");
+/**
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L230
+ */
+var ArxTrackFlags;
+(function (ArxTrackFlags) {
+    ArxTrackFlags[ArxTrackFlags["None"] = 0] = "None";
+    ArxTrackFlags[ArxTrackFlags["Position"] = 1] = "Position";
+    // ? = 1 << 1,
+    ArxTrackFlags[ArxTrackFlags["Master"] = 4] = "Master";
+    // ? = 1 << 3,
+    ArxTrackFlags[ArxTrackFlags["Paused"] = 16] = "Paused";
+    ArxTrackFlags[ArxTrackFlags["Prefetched"] = 32] = "Prefetched";
+})(ArxTrackFlags = exports.ArxTrackFlags || (exports.ArxTrackFlags = {}));
+class Track {
+    /**
+     * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L531
+     */
+    static readFrom(binary, isNewerVersion) {
+        const filename = this.toRelativePath(binary.readString());
+        if (isNewerVersion) {
+            binary.readString(); // name - always ""
+        }
+        const flags = binary.readUint32();
+        const numberOfKeys = binary.readUint32();
+        const keys = (0, helpers_1.times)(() => Key_1.Key.readFrom(binary), numberOfKeys);
+        if (isNewerVersion) {
+            keys.reverse();
+        }
+        return {
+            filename,
+            flags,
+            keys,
+        };
+    }
+    static accumulateFrom(track) {
+        const buffer = Buffer.alloc(Track.sizeOf(track));
+        const binary = new BinaryIO_1.BinaryIO(buffer);
+        binary.writeString(this.toAbsolutePath(track.filename));
+        binary.writeString(''); // name
+        binary.writeUint32(track.flags);
+        binary.writeUint32(track.keys.length);
+        binary.writeBuffer(Buffer.concat(track.keys.reverse().map(Key_1.Key.accumulateFrom)));
+        return buffer;
+    }
+    /**
+     * from: SFX\\AMBIANCE\\LOOP_GOBLIN_MAIN.WAV
+     *   to: loop_goblin_main.wav
+     *
+     * from: SFX\\AMBIANCE\\FX_ADDON\\SCREAM3.WAV
+     *   to: fx_addon/scream3.wav
+     */
+    static toRelativePath(filename) {
+        return filename.toLowerCase().replace(/\\/g, '/').replace('sfx/ambiance/', '');
+    }
+    /**
+     * from: loop_goblin_main.wav
+     *   to: sfx\\ambiance\\loop_goblin_main.wav
+     */
+    static toAbsolutePath(filename) {
+        return 'sfx\\ambiance\\' + filename.toLowerCase().replace(/\//g, '\\');
+    }
+    static sizeOf(track) {
+        return (BinaryIO_1.BinaryIO.sizeOfNullTerminatedString(track.filename) +
+            BinaryIO_1.BinaryIO.sizeOfNullTerminatedString('') +
+            BinaryIO_1.BinaryIO.sizeOfUint32() * 2 +
+            Key_1.Key.sizeOf() * track.keys.length);
+    }
+}
+exports.Track = Track;
+//# sourceMappingURL=Track.js.map

package/dist/amb/Track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Track.js","sourceRoot":"","sources":["../../src/amb/Track.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAC3C,6CAAuC;AACvC,kCAAsC;AAEtC;;GAEG;AACH,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,iDAAQ,CAAA;IACR,yDAAiB,CAAA;IACjB,cAAc;IACd,qDAAe,CAAA;IACf,cAAc;IACd,sDAAe,CAAA;IACf,8DAAmB,CAAA;AACrB,CAAC,EARW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAQxB;AAQD,MAAa,KAAK;IAChB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAgB,EAAE,cAAuB;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;QAEzD,IAAI,cAAc,EAAE;YAClB,MAAM,CAAC,UAAU,EAAE,CAAA,CAAC,mBAAmB;SACxC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QACjC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QAExC,MAAM,IAAI,GAAG,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,SAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAA;QAC5D,IAAI,cAAc,EAAE;YAClB,IAAI,CAAC,OAAO,EAAE,CAAA;SACf;QAED,OAAO;YACL,QAAQ;YACR,KAAK;YACL,IAAI;SACL,CAAA;IACH,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,KAAe;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,IAAI,mBAAQ,CAAC,MAAM,CAAC,CAAA;QAEnC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA,CAAC,OAAO;QAC9B,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC/B,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACrC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,SAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;QAE/E,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,QAAgB;QACpC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;IAChF,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,QAAgB;QACpC,OAAO,iBAAiB,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAe;QAC3B,OAAO,CACL,mBAAQ,CAAC,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC;YACnD,mBAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;YACvC,mBAAQ,CAAC,YAAY,EAAE,GAAG,CAAC;YAC3B,SAAG,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CACjC,CAAA;IACH,CAAC;CACF;AAlED,sBAkEC"}

package/dist/amb/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 0x03 0x00 0x00 0x01
+ * used in sfx/ambience/ambient_blackthing.amb
+ *
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L78
+ */
+export declare const VERSION_1003 = 16777219;
+/**
+ * 0x02 0x00 0x00 0x01
+ * used in sfx/ambience/ambient_crypt_e.amb
+ *
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L77
+ */
+export declare const VERSION_1002 = 16777218;

package/dist/amb/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION_1002 = exports.VERSION_1003 = void 0;
+/**
+ * 0x03 0x00 0x00 0x01
+ * used in sfx/ambience/ambient_blackthing.amb
+ *
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L78
+ */
+exports.VERSION_1003 = 16777219;
+/**
+ * 0x02 0x00 0x00 0x01
+ * used in sfx/ambience/ambient_crypt_e.amb
+ *
+ * @see https://github.com/arx/ArxLibertatis/blob/1.2.1/src/audio/Ambiance.cpp#L77
+ */
+exports.VERSION_1002 = 16777218;
+// There exists an even older version: 16777218
+// 0x01 0x00 0x00 0x01
+// used in ambient_gob_intro.amb
+//# sourceMappingURL=constants.js.map

package/dist/amb/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/amb/constants.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,YAAY,GAAG,QAAQ,CAAA;AAEpC;;;;;GAKG;AACU,QAAA,YAAY,GAAG,QAAQ,CAAA;AAEpC,+CAA+C;AAC/C,sBAAsB;AACtB,gCAAgC"}

package/dist/bin/constants.d.ts

@@ -1,6 +1,6 @@
-export declare const SUPPORTED_ARX_FORMATS: readonly ["dlf", "fts", "llf", "ftl", "tea"];
+export declare const SUPPORTED_ARX_FORMATS: readonly ["dlf", "fts", "llf", "ftl", "tea", "amb"];
 export declare const SUPPORTED_DATA_FORMATS: readonly ["json", "yaml", "yml"];
-export declare const SUPPORTED_FORMATS: readonly ["dlf", "fts", "llf", "ftl", "tea", "json", "yaml", "yml"];
+export declare const SUPPORTED_FORMATS: readonly ["dlf", "fts", "llf", "ftl", "tea", "amb", "json", "yaml", "yml"];
 export type SupportedArxFormat = typeof SUPPORTED_ARX_FORMATS[number];
 export type SupportedDataFormat = typeof SUPPORTED_DATA_FORMATS[number];
 export type SupportedFormat = typeof SUPPORTED_FORMATS[number];

package/dist/bin/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SUPPORTED_FORMATS = exports.SUPPORTED_DATA_FORMATS = exports.SUPPORTED_ARX_FORMATS = void 0;
-exports.SUPPORTED_ARX_FORMATS = ['dlf', 'fts', 'llf', 'ftl', 'tea'];
+exports.SUPPORTED_ARX_FORMATS = ['dlf', 'fts', 'llf', 'ftl', 'tea', 'amb'];
 exports.SUPPORTED_DATA_FORMATS = ['json', 'yaml', 'yml'];
 exports.SUPPORTED_FORMATS = [...exports.SUPPORTED_ARX_FORMATS, ...exports.SUPPORTED_DATA_FORMATS];
 //# sourceMappingURL=constants.js.map

package/dist/bin/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/bin/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAA;AACpE,QAAA,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAA;AACzD,QAAA,iBAAiB,GAAG,CAAC,GAAG,6BAAqB,EAAE,GAAG,8BAAsB,CAAU,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/bin/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAA;AAC3E,QAAA,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAA;AACzD,QAAA,iBAAiB,GAAG,CAAC,GAAG,6BAAqB,EAAE,GAAG,8BAAsB,CAAU,CAAA"}

package/dist/bin/convert.js

@@ -112,6 +112,9 @@ const args = (0, minimist_lite_1.default)(process.argv.slice(2), {
         case 'tea':
             parsedIn = index_1.TEA.load(rawIn);
             break;
+        case 'amb':
+            parsedIn = index_1.AMB.load(rawIn);
+            break;
     }
     let rawOut;
     switch (args.to) {
@@ -137,8 +140,9 @@ const args = (0, minimist_lite_1.default)(process.argv.slice(2), {
         case 'tea':
             rawOut = index_1.TEA.save(parsedIn);
             break;
-        default:
-            rawOut = '';
+        case 'amb':
+            rawOut = index_1.AMB.save(parsedIn);
+            break;
     }
     (0, helpers_1.outputInChunks)(rawOut, output);
 }))();

package/dist/bin/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/bin/convert.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kEAAoC;AACpC,uCAWkB;AAClB,oCAAkD;AAYlD,MAAM,IAAI,GAAY,IAAA,uBAAQ,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACpD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAChC,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAChC,KAAK,EAAE;QACL,CAAC,EAAE,SAAS;KACb;CACF,CAAC,CAED;AAAA,CAAC,GAAS,EAAE;IACX,IAAI,IAAI,CAAC,OAAO,EAAE;QAChB,MAAM,OAAO,GAAG,MAAM,IAAA,2BAAiB,GAAE,CAAA;QACzC,OAAO,CAAC,GAAG,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAA;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;KAChB;IAED,IAAI,KAA4B,CAAA;IAChC,IAAI,MAA6B,CAAA;IACjC,IAAI;QACF,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,EAAE;YACxD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;SACvD;QACD,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,WAAW,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;YACpD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;SACrD;QAED,IAAI,CAAC,IAAA,uBAAa,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,aAAa,CAAC,CAAA;SAC3D;QACD,IAAI,CAAC,IAAA,uBAAa,EAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAA;SACvD;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,EAAE;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;SACxD;QAED,IAAI,IAAA,qBAAW,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAA,qBAAW,EAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAClD,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAA;SAC5G;QACD,IAAI,IAAA,sBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAA,sBAAY,EAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YACpD,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAA;SAC7G;QAED,KAAK,GAAG,MAAM,IAAA,wBAAc,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,GAAG,MAAM,IAAA,yBAAe,EAAC,IAAI,CAAC,MAAM,CAAC,CAAA;KAC5C;IAAC,OAAO,CAAU,EAAE;QACnB,MAAM,KAAK,GAAG,CAAU,CAAA;QACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;KAChB;IAED,MAAM,KAAK,GAAG,MAAM,IAAA,wBAAc,EAAC,KAAK,CAAC,CAAA;IACzC,IAAI,QAAQ,CAAA;IACZ,QAAQ,IAAI,CAAC,IAAI,EAAE;QACjB,KAAK,MAAM;YACT,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;YAC9C,MAAK;QACP,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT;gBACE,MAAM,IAAI,GAAG,wDAAa,MAAM,GAAC,CAAA;gBACjC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;aAC/C;YACD,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,WAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,WAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,WAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,WAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,WAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,MAAK;KACR;IAED,IAAI,MAAuB,CAAA;IAC3B,QAAQ,IAAI,CAAC,EAAE,EAAE;QACf,KAAK,MAAM;YACT,MAAM,GAAG,IAAA,uBAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC/C,MAAK;QACP,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,MAAM,GAAG,MAAM,IAAA,uBAAa,EAAC,QAAQ,CAAC,CAAA;YACtC,MAAK;QACP,KAAK,KAAK;YACR,MAAM,GAAG,WAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3B,MAAK;QACP,KAAK,KAAK;YACR,MAAM,GAAG,WAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3B,MAAK;QACP,KAAK,KAAK;YACR,MAAM,GAAG,WAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3B,MAAK;QACP,KAAK,KAAK;YACR,MAAM,GAAG,WAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3B,MAAK;QACP,KAAK,KAAK;YACR,MAAM,GAAG,WAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3B,MAAK;QACP;YACE,MAAM,GAAG,EAAE,CAAA;KACd;IAED,IAAA,wBAAc,EAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAChC,CAAC,CAAA,CAAC,EAAE,CAAA"}
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/bin/convert.ts"],"names":[],"mappings":"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"}

package/dist/bin/helpers.d.ts

@@ -10,8 +10,8 @@ export declare const stringifyJSON: (json: any, prettify?: boolean) => string;
 export declare const stringifyYAML: (json: any) => Promise<string>;
 export declare const evenAndRemainder: (divisor: number, n: number) => [number, number];
 export declare const outputInChunks: (buffer: string | Buffer, stream: NodeJS.WritableStream, chunkSize?: number) => void;
-export declare const isValidFormat: (arg: string) => arg is "dlf" | "fts" | "llf" | "ftl" | "tea" | "json" | "yaml" | "yml";
-export declare const isArxFormat: (arg: SupportedFormat) => arg is "dlf" | "fts" | "llf" | "ftl" | "tea";
+export declare const isValidFormat: (arg: string) => arg is "dlf" | "fts" | "llf" | "ftl" | "tea" | "amb" | "json" | "yaml" | "yml";
+export declare const isArxFormat: (arg: SupportedFormat) => arg is "dlf" | "fts" | "llf" | "ftl" | "tea" | "amb";
 export declare const isDataFormat: (arg: SupportedFormat) => arg is "json" | "yaml" | "yml";
 export declare const getInputStream: (filename?: string) => Promise<NodeJS.ReadableStream>;
 export declare const getOutputStream: (filename?: string) => Promise<NodeJS.WritableStream>;

package/dist/bin/helpers.js

@@ -67,7 +67,7 @@ const streamToBuffer = (input) => {
             chunks.push(chunk);
         });
         input.on('end', () => {
-            resolve(node_buffer_1.Buffer.concat(chunks));
+            resolve(node_buffer_1.Buffer.from(node_buffer_1.Buffer.concat(chunks), 0));
         });
         input.on('error', (e) => {
             reject(e);

package/dist/bin/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/bin/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/bin/helpers.ts"],"names":[],"mappings":"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"}

package/dist/common/BinaryIO.d.ts

@@ -1,8 +1,9 @@
 /// <reference types="node" />
+import { TRUNCATE_ZERO_BYTES, KEEP_ZERO_BYTES } from './constants';
 import { ArxQuaternion, ArxRotation, ArxVector3 } from './types';
 export declare class BinaryIO extends DataView {
     position: number;
-    constructor(buffer: ArrayBufferLike, byteOffset?: number, byteLength?: number);
+    constructor(buffer: Buffer, byteOffset?: number, byteLength?: number);
     readFloat32(): number;
     readFloat32Array(length: number): number[];
     readInt8(): number;
@@ -31,8 +32,8 @@ export declare class BinaryIO extends DataView {
     writeUint16Array(values: number[]): void;
     writeUint32(value: number): void;
     writeUint32Array(values: number[]): void;
-    readString(length?: number, truncateZeroBytes?: boolean): string;
-    writeString(str: string, length: number): void;
+    readString(length?: number, truncateZeroBytes?: typeof TRUNCATE_ZERO_BYTES | typeof KEEP_ZERO_BYTES): string;
+    writeString(str: string, length?: number): void;
     readVector3(): ArxVector3;
     readVector3Array(length: number): ArxVector3[];
     writeVector3({ x, y, z }: ArxVector3): void;
@@ -57,6 +58,7 @@ export declare class BinaryIO extends DataView {
     static sizeOfUint32(): 4;
     static sizeOfUint32Array(length: number): number;
     static sizeOfString(length: number): number;
+    static sizeOfNullTerminatedString(str: string): number;
     static sizeOfVector3(): number;
     static sizeOfVector3Array(length: number): number;
     static sizeOfRotation(): number;

package/dist/common/BinaryIO.js

@@ -5,7 +5,7 @@ const helpers_1 = require("./helpers");
 const constants_1 = require("./constants");
 class BinaryIO extends DataView {
     constructor(buffer, byteOffset, byteLength) {
-        super(buffer, byteOffset, byteLength);
+        super(buffer.buffer, byteOffset, byteLength);
         this.position = 0;
     }
     readFloat32() {
@@ -157,7 +157,14 @@ class BinaryIO extends DataView {
     }
     readString(length, truncateZeroBytes = constants_1.TRUNCATE_ZERO_BYTES) {
         const codes = [];
-        if (length !== undefined) {
+        if (length === undefined) {
+            let c = this.readUint8();
+            while (c !== 0) {
+                codes.push(c);
+                c = this.readUint8();
+            }
+        }
+        else {
             for (let i = 0; i < length; i++) {
                 const c = this.readUint8();
                 if (c !== 0 || truncateZeroBytes === constants_1.KEEP_ZERO_BYTES) {
@@ -165,13 +172,6 @@ class BinaryIO extends DataView {
                 }
             }
         }
-        else {
-            let c = this.readUint8();
-            while (c !== 0) {
-                codes.push(c);
-                c = this.readUint8();
-            }
-        }
         return (0, helpers_1.decodeText)(codes);
     }
     writeString(str, length) {
@@ -275,6 +275,9 @@ class BinaryIO extends DataView {
     static sizeOfString(length) {
         return length;
     }
+    static sizeOfNullTerminatedString(str) {
+        return str.length + 1;
+    }
     static sizeOfVector3() {
         return BinaryIO.sizeOfFloat32Array(3);
     }