@carbonenginejs/runtime-resource 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/NOTICE +29 -29
- package/README.md +67 -548
- package/dist/CjsMotherLode.js +1271 -1271
- package/dist/CjsResMan.js +3005 -3005
- package/dist/CjsResManQueue.js +214 -214
- package/dist/CjsResource.js +566 -566
- package/dist/CjsResourceSource.js +59 -59
- package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
- package/dist/format/CjsBlueReader.js +269 -269
- package/dist/format/CjsFormat.js +192 -192
- package/dist/format/CjsReader.js +18 -18
- package/dist/format/CjsResourceProbe.js +277 -277
- package/dist/format/payloadContract.js +173 -173
- package/dist/formats/black/CjsBlackFormat.js +278 -278
- package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
- package/dist/formats/black/core/CjsBlackReader.js +639 -639
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
- package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackEnums.js +6 -6
- package/dist/formats/black/core/blackSchema.js +3 -3
- package/dist/formats/black/core/blackVersion.js +22 -22
- package/dist/formats/black/core/helpers.js +182 -182
- package/dist/formats/black/core/schema.js +4 -4
- package/dist/formats/black/index.js +2 -2
- package/dist/formats/bnk/CjsBnkFormat.js +125 -125
- package/dist/formats/bnk/core/graph.js +140 -140
- package/dist/formats/bnk/core/helpers.js +409 -409
- package/dist/formats/bnk/core/musicNodes.js +489 -489
- package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
- package/dist/formats/bnk/index.js +2 -2
- package/dist/formats/cmf/CjsCmfFormat.js +497 -497
- package/dist/formats/cmf/core/binary.js +118 -118
- package/dist/formats/cmf/core/buffers.js +233 -233
- package/dist/formats/cmf/core/constants.js +47 -47
- package/dist/formats/cmf/core/gr2Anim.js +453 -453
- package/dist/formats/cmf/core/helpers.js +287 -287
- package/dist/formats/cmf/core/pack.js +276 -276
- package/dist/formats/cmf/core/schema.js +364 -364
- package/dist/formats/cmf/core/shared.js +268 -268
- package/dist/formats/cmf/core/writer.js +517 -517
- package/dist/formats/cmf/index.js +2 -2
- package/dist/formats/dds/CjsDdsFormat.js +193 -193
- package/dist/formats/dds/core/bc6h.js +288 -288
- package/dist/formats/dds/core/bc7.js +251 -251
- package/dist/formats/dds/core/helpers.js +815 -815
- package/dist/formats/dds/index.js +2 -2
- package/dist/formats/fbx/CjsFbxFormat.js +266 -266
- package/dist/formats/fbx/core/helpers.js +3901 -3901
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +87 -87
- package/dist/formats/flac/core/helpers.js +295 -295
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +87 -87
- package/dist/formats/gif/core/helpers.js +360 -360
- package/dist/formats/gif/index.js +2 -2
- package/dist/formats/gltf/CjsGltfFormat.js +290 -290
- package/dist/formats/gltf/core/helpers.js +292 -292
- package/dist/formats/gltf/core/json.js +79 -79
- package/dist/formats/gltf/core/parser.js +666 -666
- package/dist/formats/gltf/core/targets.js +163 -163
- package/dist/formats/gltf/index.js +2 -2
- package/dist/formats/gr2/CjsGr2Format.js +46 -0
- package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
- package/dist/formats/gr2/core/bitknit2.js +280 -0
- package/dist/formats/gr2/core/bitknit2.js.map +1 -0
- package/dist/formats/gr2/core/curves.js +1047 -0
- package/dist/formats/gr2/core/curves.js.map +1 -0
- package/dist/formats/gr2/core/gsf.js +72 -0
- package/dist/formats/gr2/core/gsf.js.map +1 -0
- package/dist/formats/gr2/core/helpers.js +332 -0
- package/dist/formats/gr2/core/helpers.js.map +1 -0
- package/dist/formats/gr2/core/json.js +622 -0
- package/dist/formats/gr2/core/json.js.map +1 -0
- package/dist/formats/gr2/core/oodle1.js +388 -0
- package/dist/formats/gr2/core/oodle1.js.map +1 -0
- package/dist/formats/gr2/core/reader.js +617 -0
- package/dist/formats/gr2/core/reader.js.map +1 -0
- package/dist/formats/gr2/core/tangents.js +48 -0
- package/dist/formats/gr2/core/tangents.js.map +1 -0
- package/dist/formats/gr2/core/targets.js +351 -0
- package/dist/formats/gr2/core/targets.js.map +1 -0
- package/dist/formats/gr2/index.js +3 -0
- package/dist/formats/gr2/index.js.map +1 -0
- package/dist/formats/index.js +30 -23
- package/dist/formats/index.js.map +1 -1
- package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
- package/dist/formats/jpeg/core/helpers.js +350 -350
- package/dist/formats/jpeg/core/jpeg.js +377 -377
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +192 -192
- package/dist/formats/mp3/core/helpers.js +338 -338
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +191 -191
- package/dist/formats/mp4/core/helpers.js +449 -449
- package/dist/formats/mp4/index.js +2 -2
- package/dist/formats/obj/CjsObjFormat.js +253 -253
- package/dist/formats/obj/core/helpers.js +573 -573
- package/dist/formats/obj/core/json.js +64 -64
- package/dist/formats/obj/core/parser.js +321 -321
- package/dist/formats/obj/index.js +2 -2
- package/dist/formats/ogg/CjsOggFormat.js +88 -88
- package/dist/formats/ogg/core/helpers.js +387 -387
- package/dist/formats/ogg/core/imdct.js +178 -178
- package/dist/formats/ogg/core/vorbis.js +999 -999
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/png/CjsPngFormat.js +195 -195
- package/dist/formats/png/core/helpers.js +583 -583
- package/dist/formats/png/index.js +2 -2
- package/dist/formats/red/CjsRedFormat.js +261 -261
- package/dist/formats/red/core/CjsRedReader.js +194 -194
- package/dist/formats/red/core/blackDefinitions.js +3 -3
- package/dist/formats/red/core/helpers.js +139 -139
- package/dist/formats/red/core/redGraph.js +68 -68
- package/dist/formats/red/core/schema.js +4 -4
- package/dist/formats/red/index.js +2 -2
- package/dist/formats/stl/CjsStlFormat.js +365 -365
- package/dist/formats/stl/core/helpers.js +261 -261
- package/dist/formats/stl/core/json.js +51 -51
- package/dist/formats/stl/core/stl.js +629 -629
- package/dist/formats/stl/core/targets.js +163 -163
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +192 -192
- package/dist/formats/tga/core/helpers.js +446 -446
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +192 -192
- package/dist/formats/wav/core/helpers.js +328 -328
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +191 -191
- package/dist/formats/webm/core/helpers.js +537 -537
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +86 -86
- package/dist/formats/webp/core/helpers.js +214 -214
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +241 -241
- package/dist/formats/wem/core/bitStream.js +259 -259
- package/dist/formats/wem/core/codebookLibrary.js +164 -164
- package/dist/formats/wem/core/helpers.js +417 -417
- package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
- package/dist/formats/wem/core/ptadpcm.js +77 -77
- package/dist/formats/wem/core/resolve.js +121 -121
- package/dist/formats/wem/core/wemToOgg.js +485 -485
- package/dist/formats/wem/index.js +2 -2
- package/dist/formats/yaml/CjsYamlFormat.js +83 -83
- package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
- package/dist/formats/yaml/core/helpers.js +160 -160
- package/dist/formats/yaml/index.js +2 -2
- package/dist/index.js +49 -48
- package/dist/index.js.map +1 -1
- package/dist/resourcePath.js +18 -18
- package/dist/resourceStates.js +9 -9
- package/dist/resources/AudioGeometryResData.js +47 -47
- package/dist/resources/GStateBindingCallbackData.js +31 -31
- package/dist/resources/MeshDecalData.js +37 -37
- package/dist/resources/MeshDecalLodData.js +34 -34
- package/dist/resources/Tr2EffectRes.js +71 -71
- package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
- package/dist/resources/Tr2GrannyStateRes.js +44 -44
- package/dist/resources/Tr2ImageRes.js +114 -114
- package/dist/resources/Tr2LightProfileRes.js +40 -40
- package/dist/resources/Tr2MaterialArea.js +34 -34
- package/dist/resources/Tr2MaterialMesh.js +31 -31
- package/dist/resources/Tr2MaterialRes.js +34 -34
- package/dist/resources/Tr2ShaderPermutation.js +43 -43
- package/dist/resources/Tr2TextureLodManager.js +80 -80
- package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
- package/dist/resources/Tr2TexturePackChannel.js +37 -37
- package/dist/resources/Tr2TexturePipeline.js +52 -52
- package/dist/resources/Tr2TexturePipelineParams.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
- package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
- package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
- package/dist/resources/TriGeometryRes.js +239 -239
- package/dist/resources/TriGeometryResAreaData.js +59 -59
- package/dist/resources/TriGeometryResJointData.js +38 -38
- package/dist/resources/TriGeometryResLodData.js +88 -88
- package/dist/resources/TriGeometryResMeshData.js +63 -63
- package/dist/resources/TriGeometryResSkeletonData.js +34 -34
- package/dist/resources/TriGrannyRes.js +43 -43
- package/dist/resources/TriJointBinding.js +38 -38
- package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
- package/dist/resources/TriRtGeometryConstants.js +88 -88
- package/dist/resources/TriTextureRes.js +304 -304
- package/dist/resources/enums.js +18 -18
- package/dist/resources/resourceBoundary.js +47 -47
- package/dist/resources/texturePipelineBehavior.js +308 -308
- package/dist/texture/CjsTextureArrayRes.js +406 -406
- package/dist/texture/CjsTextureParameterProxy.js +133 -133
- package/docs/README.md +69 -0
- package/docs/architecture.md +86 -0
- package/docs/concepts/resource-lifecycle.md +217 -0
- package/docs/formats/README.md +104 -0
- package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
- package/docs/formats/stl.md +37 -0
- package/docs/formats/wwise.md +44 -0
- package/docs/reference/events.md +92 -0
- package/docs/reference/motherlode-cache.md +244 -0
- package/docs/reference/queues.md +102 -0
- package/docs/reference/reload.md +107 -0
- package/docs/reference/texture-arrays.md +113 -0
- package/docs/reference/texture-pipeline.md +53 -0
- package/docs/roadmap.md +104 -0
- package/format-notices/black/LICENSE +21 -21
- package/format-notices/black/NOTICE +47 -47
- package/format-notices/bnk/LICENSE +21 -21
- package/format-notices/bnk/NOTICE +20 -20
- package/format-notices/cmf/LICENSE +21 -21
- package/format-notices/cmf/NOTICE +36 -36
- package/format-notices/dds/LICENSE +21 -21
- package/format-notices/dds/NOTICE +14 -14
- package/format-notices/fbx/LICENSE +21 -21
- package/format-notices/fbx/NOTICE +14 -14
- package/format-notices/flac/LICENSE +21 -21
- package/format-notices/flac/NOTICE +14 -14
- package/format-notices/gif/LICENSE +21 -21
- package/format-notices/gif/NOTICE +14 -14
- package/format-notices/gltf/LICENSE +21 -21
- package/format-notices/gltf/NOTICE +27 -27
- package/format-notices/gr2/LICENSE +21 -0
- package/format-notices/gr2/NOTICE +60 -0
- package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
- package/format-notices/jpeg/LICENSE +21 -21
- package/format-notices/jpeg/NOTICE +14 -14
- package/format-notices/mp3/LICENSE +21 -21
- package/format-notices/mp3/NOTICE +14 -14
- package/format-notices/mp4/LICENSE +21 -21
- package/format-notices/mp4/NOTICE +14 -14
- package/format-notices/obj/LICENSE +21 -21
- package/format-notices/obj/NOTICE +26 -26
- package/format-notices/ogg/LICENSE +21 -21
- package/format-notices/ogg/NOTICE +28 -28
- package/format-notices/png/LICENSE +21 -21
- package/format-notices/png/NOTICE +14 -14
- package/format-notices/red/LICENSE +21 -21
- package/format-notices/red/NOTICE +31 -31
- package/format-notices/stl/LICENSE +21 -21
- package/format-notices/stl/NOTICE +21 -21
- package/format-notices/tga/LICENSE +21 -21
- package/format-notices/tga/NOTICE +14 -14
- package/format-notices/wav/LICENSE +21 -21
- package/format-notices/wav/NOTICE +14 -14
- package/format-notices/webm/LICENSE +21 -21
- package/format-notices/webm/NOTICE +14 -14
- package/format-notices/webp/LICENSE +21 -21
- package/format-notices/webp/NOTICE +14 -14
- package/format-notices/wem/LICENSE +57 -57
- package/format-notices/wem/NOTICE +33 -33
- package/format-notices/yaml/LICENSE +21 -21
- package/format-notices/yaml/NOTICE +44 -44
- package/package.json +52 -51
- package/resource-lifecycle.md +0 -679
|
@@ -1,387 +1,387 @@
|
|
|
1
|
-
import { decodeVorbis } from './vorbis.js';
|
|
2
|
-
|
|
3
|
-
const OUTPUT_RAW = "raw";
|
|
4
|
-
const OUTPUT_JSON = "json";
|
|
5
|
-
const OUTPUT_PCM = "pcm";
|
|
6
|
-
const OUTPUT_AUDIO = "audio";
|
|
7
|
-
const DEFAULT_VALUES = Object.freeze({
|
|
8
|
-
emit: OUTPUT_RAW,
|
|
9
|
-
inputType: "ogg",
|
|
10
|
-
source: ""
|
|
11
|
-
});
|
|
12
|
-
function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsOggFormat") {
|
|
13
|
-
if (!options || typeof options !== "object" || Array.isArray(options)) {
|
|
14
|
-
throw new TypeError(`${readerName}: options must be an object`);
|
|
15
|
-
}
|
|
16
|
-
const allowed = new Set(["emit", "inputType", "source"]);
|
|
17
|
-
for (const key of Object.keys(options)) {
|
|
18
|
-
if (!allowed.has(key)) throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
|
|
19
|
-
}
|
|
20
|
-
const values = {
|
|
21
|
-
...DEFAULT_VALUES,
|
|
22
|
-
...(base || {}),
|
|
23
|
-
...options
|
|
24
|
-
};
|
|
25
|
-
if (![OUTPUT_RAW, OUTPUT_JSON, "oggJson", "audio", "pcm"].includes(values.emit)) {
|
|
26
|
-
throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(values.emit)}`);
|
|
27
|
-
}
|
|
28
|
-
return values;
|
|
29
|
-
}
|
|
30
|
-
function toBytes(input) {
|
|
31
|
-
if (input instanceof Uint8Array) return input;
|
|
32
|
-
if (input instanceof ArrayBuffer) return new Uint8Array(input);
|
|
33
|
-
if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
|
|
34
|
-
throw new TypeError("OGG input must be Uint8Array, ArrayBuffer, or a view");
|
|
35
|
-
}
|
|
36
|
-
function isOGG(bytes) {
|
|
37
|
-
return bytes.byteLength >= 4 && ascii(bytes, 0, 4) === "OggS";
|
|
38
|
-
}
|
|
39
|
-
function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "ogg") {
|
|
40
|
-
const bytes = toBytes(input);
|
|
41
|
-
if (!isOGG(bytes)) throw new TypeError("CjsOggFormat: input is not an Ogg container");
|
|
42
|
-
const metadata = inspectOgg(bytes);
|
|
43
|
-
if (expectedType && metadata.sourceFormat !== expectedType) {
|
|
44
|
-
throw new TypeError(`CjsOggFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
|
|
45
|
-
}
|
|
46
|
-
return {
|
|
47
|
-
...metadata,
|
|
48
|
-
byteLength: bytes.byteLength,
|
|
49
|
-
source: values.source || "buffer"
|
|
50
|
-
};
|
|
51
|
-
}
|
|
52
|
-
function isSupportedWithValues(input, values = DEFAULT_VALUES) {
|
|
53
|
-
try {
|
|
54
|
-
const metadata = inspectWithValues(input, values);
|
|
55
|
-
const mimeType = getOggMimeType(metadata);
|
|
56
|
-
const variants = [{
|
|
57
|
-
kind: "raw",
|
|
58
|
-
payloadType: "raw",
|
|
59
|
-
codec: "ogg",
|
|
60
|
-
mimeType,
|
|
61
|
-
supported: true,
|
|
62
|
-
containerOnly: true,
|
|
63
|
-
isDecoded: false,
|
|
64
|
-
pcmDecodeSupported: false,
|
|
65
|
-
frameDecodeSupported: false
|
|
66
|
-
}, {
|
|
67
|
-
kind: "pcm",
|
|
68
|
-
payloadType: "pcm",
|
|
69
|
-
codec: metadata.codec === "vorbis" ? "float32" : "pcm",
|
|
70
|
-
supported: metadata.codec === "vorbis",
|
|
71
|
-
reason: metadata.codec === "vorbis" ? "" : "Only Ogg Vorbis PCM decode is implemented."
|
|
72
|
-
}];
|
|
73
|
-
if (metadata.mediaType === "video") {
|
|
74
|
-
variants.push({
|
|
75
|
-
kind: "decoded",
|
|
76
|
-
payloadType: "video-frame",
|
|
77
|
-
codec: "frames",
|
|
78
|
-
supported: false,
|
|
79
|
-
reason: "OGG Theora frame decode is not implemented yet."
|
|
80
|
-
});
|
|
81
|
-
}
|
|
82
|
-
const pcmSupported = metadata.codec === "vorbis";
|
|
83
|
-
return {
|
|
84
|
-
format: "ogg",
|
|
85
|
-
source: values.source || "buffer",
|
|
86
|
-
supported: "partial",
|
|
87
|
-
confidence: 1,
|
|
88
|
-
preferred: pcmSupported ? "pcm" : metadata.sourceFormat ? "ogg" : "",
|
|
89
|
-
reason: pcmSupported ? "Ogg Vorbis recognized; PCM decode is supported." : "Ogg pages and codec headers are recognized; raw Ogg passthrough is available.",
|
|
90
|
-
metadata,
|
|
91
|
-
variants,
|
|
92
|
-
warnings: [],
|
|
93
|
-
errors: []
|
|
94
|
-
};
|
|
95
|
-
} catch (error) {
|
|
96
|
-
return {
|
|
97
|
-
format: "ogg",
|
|
98
|
-
source: values.source || "buffer",
|
|
99
|
-
supported: "none",
|
|
100
|
-
confidence: 0,
|
|
101
|
-
preferred: "",
|
|
102
|
-
reason: error.message,
|
|
103
|
-
metadata: null,
|
|
104
|
-
variants: [],
|
|
105
|
-
warnings: [],
|
|
106
|
-
errors: [error.message]
|
|
107
|
-
};
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
function readWithValues(input, values = DEFAULT_VALUES) {
|
|
111
|
-
const bytes = toBytes(input);
|
|
112
|
-
const metadata = inspectWithValues(bytes, values);
|
|
113
|
-
if (values.emit === OUTPUT_RAW) {
|
|
114
|
-
return {
|
|
115
|
-
payloadType: "raw",
|
|
116
|
-
sourceFormat: "ogg",
|
|
117
|
-
mimeType: getOggMimeType(metadata),
|
|
118
|
-
containerOnly: true,
|
|
119
|
-
isDecoded: false,
|
|
120
|
-
pcmDecodeSupported: false,
|
|
121
|
-
frameDecodeSupported: false,
|
|
122
|
-
metadata,
|
|
123
|
-
bytes
|
|
124
|
-
};
|
|
125
|
-
}
|
|
126
|
-
if (values.emit === OUTPUT_JSON || values.emit === "oggJson") return metadata;
|
|
127
|
-
if (values.emit === OUTPUT_PCM || values.emit === OUTPUT_AUDIO) {
|
|
128
|
-
if (metadata.codec !== "vorbis") {
|
|
129
|
-
const error = new Error(`ogg: PCM decode supports Vorbis only (found ${metadata.codec})`);
|
|
130
|
-
error.code = "CJS_FORMAT_OUTPUT_NOT_SUPPORTED";
|
|
131
|
-
throw error;
|
|
132
|
-
}
|
|
133
|
-
const decoded = decodeVorbis(bytes);
|
|
134
|
-
const data = new Float32Array(decoded.sampleCount * decoded.channels);
|
|
135
|
-
for (let channel = 0; channel < decoded.channels; channel++) {
|
|
136
|
-
const samples = decoded.channelData[channel];
|
|
137
|
-
for (let i = 0; i < decoded.sampleCount; i++) {
|
|
138
|
-
data[i * decoded.channels + channel] = samples[i];
|
|
139
|
-
}
|
|
140
|
-
}
|
|
141
|
-
return {
|
|
142
|
-
payloadType: values.emit === OUTPUT_AUDIO ? OUTPUT_AUDIO : OUTPUT_PCM,
|
|
143
|
-
sourceFormat: "ogg",
|
|
144
|
-
codec: "vorbis",
|
|
145
|
-
containerOnly: false,
|
|
146
|
-
isDecoded: true,
|
|
147
|
-
pcmDecodeSupported: true,
|
|
148
|
-
audioFormat: "float32",
|
|
149
|
-
sampleFormat: "float32",
|
|
150
|
-
sampleRate: decoded.sampleRate,
|
|
151
|
-
channels: decoded.channels,
|
|
152
|
-
interleaving: "interleaved",
|
|
153
|
-
frameCount: decoded.sampleCount,
|
|
154
|
-
durationSeconds: decoded.sampleRate ? decoded.sampleCount / decoded.sampleRate : 0,
|
|
155
|
-
vendor: decoded.vendor,
|
|
156
|
-
comments: decoded.comments,
|
|
157
|
-
loop: decoded.loop,
|
|
158
|
-
channelData: decoded.channelData,
|
|
159
|
-
metadata,
|
|
160
|
-
data
|
|
161
|
-
};
|
|
162
|
-
}
|
|
163
|
-
const error = new Error(`ogg: emit "${values.emit}" is not implemented yet`);
|
|
164
|
-
error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
|
|
165
|
-
throw error;
|
|
166
|
-
}
|
|
167
|
-
function toJsonValue(value) {
|
|
168
|
-
if (value instanceof Uint8Array) return {
|
|
169
|
-
byteLength: value.byteLength
|
|
170
|
-
};
|
|
171
|
-
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
172
|
-
if (value && typeof value === "object") {
|
|
173
|
-
const output = {};
|
|
174
|
-
for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
|
|
175
|
-
return output;
|
|
176
|
-
}
|
|
177
|
-
return value;
|
|
178
|
-
}
|
|
179
|
-
function getOggMimeType(metadata) {
|
|
180
|
-
if (metadata.mediaType === "video") return "video/ogg";
|
|
181
|
-
if (metadata.mediaType === "audio") return "audio/ogg";
|
|
182
|
-
return "application/ogg";
|
|
183
|
-
}
|
|
184
|
-
function inspectOgg(bytes) {
|
|
185
|
-
const streams = new Map();
|
|
186
|
-
let offset = 0;
|
|
187
|
-
let pageCount = 0;
|
|
188
|
-
while (offset + 27 <= bytes.byteLength) {
|
|
189
|
-
if (ascii(bytes, offset, 4) !== "OggS") throw new Error(`ogg: invalid page at byte ${offset}`);
|
|
190
|
-
const version = bytes[offset + 4];
|
|
191
|
-
if (version !== 0) throw new Error(`ogg: unsupported stream version ${version}`);
|
|
192
|
-
const headerType = bytes[offset + 5];
|
|
193
|
-
if (headerType & 0xf8) throw new Error(`ogg: reserved header flags at byte ${offset}`);
|
|
194
|
-
const granulePosition = readU64LE(bytes, offset + 6);
|
|
195
|
-
const serial = readU32LE(bytes, offset + 14);
|
|
196
|
-
const sequence = readU32LE(bytes, offset + 18);
|
|
197
|
-
const segmentCount = bytes[offset + 26];
|
|
198
|
-
const tableOffset = offset + 27;
|
|
199
|
-
const payloadOffset = tableOffset + segmentCount;
|
|
200
|
-
if (payloadOffset > bytes.byteLength) throw new Error("ogg: truncated segment table");
|
|
201
|
-
let payloadLength = 0;
|
|
202
|
-
for (let i = 0; i < segmentCount; i++) payloadLength += bytes[tableOffset + i];
|
|
203
|
-
if (payloadOffset + payloadLength > bytes.byteLength) throw new Error("ogg: truncated page payload");
|
|
204
|
-
const pageLength = 27 + segmentCount + payloadLength;
|
|
205
|
-
const expectedChecksum = readU32LE(bytes, offset + 22);
|
|
206
|
-
if (computeOggCrc(bytes, offset, pageLength) !== expectedChecksum) {
|
|
207
|
-
throw new Error(`ogg: page checksum mismatch at byte ${offset}`);
|
|
208
|
-
}
|
|
209
|
-
const stream = streams.get(serial) || {
|
|
210
|
-
serial,
|
|
211
|
-
pages: 0,
|
|
212
|
-
firstPacket: [],
|
|
213
|
-
packetBytes: 0,
|
|
214
|
-
firstPacketComplete: false,
|
|
215
|
-
packetOpen: false,
|
|
216
|
-
codec: "",
|
|
217
|
-
mediaType: "unknown",
|
|
218
|
-
payloadBytes: 0
|
|
219
|
-
};
|
|
220
|
-
const continued = !!(headerType & 0x01);
|
|
221
|
-
if (stream.pages === 0 && !(headerType & 0x02)) throw new Error(`ogg: first page of stream ${serial} is missing BOS`);
|
|
222
|
-
if (stream.pages === 0 && continued) throw new Error(`ogg: first page of stream ${serial} is marked continued`);
|
|
223
|
-
if (stream.eosSeen) throw new Error(`ogg: page follows EOS for stream ${serial}`);
|
|
224
|
-
if (stream.pages > 0 && continued !== stream.packetOpen) {
|
|
225
|
-
throw new Error(`ogg: continued-page state mismatch for stream ${serial}`);
|
|
226
|
-
}
|
|
227
|
-
if (headerType & 0x02 && stream.pages !== 0) throw new Error(`ogg: BOS page is not first for stream ${serial}`);
|
|
228
|
-
if (stream.lastSequence !== undefined && sequence !== stream.lastSequence + 1) {
|
|
229
|
-
throw new Error(`ogg: page sequence mismatch for stream ${serial}`);
|
|
230
|
-
}
|
|
231
|
-
if (stream.pages === 0) {
|
|
232
|
-
stream.firstSequence = sequence;
|
|
233
|
-
stream.firstGranulePosition = granulePosition;
|
|
234
|
-
stream.bos = !!(headerType & 0x02);
|
|
235
|
-
}
|
|
236
|
-
stream.pages++;
|
|
237
|
-
stream.payloadBytes += payloadLength;
|
|
238
|
-
collectFirstPacket(stream, bytes, payloadOffset, tableOffset, segmentCount);
|
|
239
|
-
if (headerType & 0x04 && stream.packetOpen) throw new Error(`ogg: EOS page leaves a packet continued for stream ${serial}`);
|
|
240
|
-
stream.lastGranulePosition = granulePosition;
|
|
241
|
-
stream.granulePosition = granulePosition;
|
|
242
|
-
stream.lastSequence = sequence;
|
|
243
|
-
stream.eos = !!(headerType & 0x04);
|
|
244
|
-
stream.eosSeen = stream.eos;
|
|
245
|
-
streams.set(serial, stream);
|
|
246
|
-
pageCount++;
|
|
247
|
-
offset = payloadOffset + payloadLength;
|
|
248
|
-
}
|
|
249
|
-
if (offset !== bytes.byteLength) throw new Error(`ogg: truncated trailing page at byte ${offset}`);
|
|
250
|
-
if (!pageCount) throw new Error("ogg: no pages found");
|
|
251
|
-
const tracks = Array.from(streams.values()).map(stream => decodeCodec(stream));
|
|
252
|
-
const primary = tracks.find(track => track.mediaType !== "unknown") || tracks[0];
|
|
253
|
-
return {
|
|
254
|
-
payloadType: primary?.mediaType === "video" ? "video" : primary?.mediaType === "audio" ? "audio" : "container",
|
|
255
|
-
mediaTypes: tracks.map(track => track.mediaType),
|
|
256
|
-
sourceFormat: "ogg",
|
|
257
|
-
pageCount,
|
|
258
|
-
streamCount: tracks.length,
|
|
259
|
-
codec: primary?.codec || "ogg",
|
|
260
|
-
mediaType: primary?.mediaType || "unknown",
|
|
261
|
-
tracks
|
|
262
|
-
};
|
|
263
|
-
}
|
|
264
|
-
function computeOggCrc(bytes, offset, length) {
|
|
265
|
-
let crc = 0;
|
|
266
|
-
for (let i = 0; i < length; i++) {
|
|
267
|
-
const relative = i;
|
|
268
|
-
const value = relative >= 22 && relative < 26 ? 0 : bytes[offset + relative];
|
|
269
|
-
crc ^= value << 24;
|
|
270
|
-
for (let bit = 0; bit < 8; bit++) {
|
|
271
|
-
crc = crc & 0x80000000 ? crc << 1 ^ 0x04c11db7 : crc << 1;
|
|
272
|
-
}
|
|
273
|
-
}
|
|
274
|
-
return crc >>> 0;
|
|
275
|
-
}
|
|
276
|
-
function collectFirstPacket(stream, bytes, payloadOffset, tableOffset, segmentCount) {
|
|
277
|
-
let cursor = payloadOffset;
|
|
278
|
-
let lastLength = 0;
|
|
279
|
-
for (let i = 0; i < segmentCount; i++) {
|
|
280
|
-
const length = bytes[tableOffset + i];
|
|
281
|
-
if (!stream.firstPacketComplete && stream.packetBytes < 64) {
|
|
282
|
-
const copyLength = Math.min(length, 64 - stream.packetBytes);
|
|
283
|
-
stream.firstPacket.push(...bytes.subarray(cursor, cursor + copyLength));
|
|
284
|
-
stream.packetBytes += copyLength;
|
|
285
|
-
}
|
|
286
|
-
cursor += length;
|
|
287
|
-
lastLength = length;
|
|
288
|
-
if (length < 255) {
|
|
289
|
-
if (!stream.firstPacketComplete) stream.firstPacketComplete = true;
|
|
290
|
-
}
|
|
291
|
-
}
|
|
292
|
-
stream.packetOpen = segmentCount > 0 && lastLength === 255;
|
|
293
|
-
}
|
|
294
|
-
function decodeCodec(stream) {
|
|
295
|
-
const packet = Uint8Array.from(stream.firstPacket);
|
|
296
|
-
if (matches(packet, [1, 0x76, 0x6f, 0x72, 0x62, 0x69, 0x73])) {
|
|
297
|
-
if (packet.length < 30) throw new Error(`ogg: truncated Vorbis identification header for stream ${stream.serial}`);
|
|
298
|
-
if (readU32LE(packet, 7) !== 0 || !packet[11] || !readU32LE(packet, 12)) {
|
|
299
|
-
throw new Error(`ogg: invalid Vorbis identification header for stream ${stream.serial}`);
|
|
300
|
-
}
|
|
301
|
-
stream.codec = "vorbis";
|
|
302
|
-
stream.mediaType = "audio";
|
|
303
|
-
stream.channels = packet[11] || 0;
|
|
304
|
-
stream.sampleRate = readU32LE(packet, 12);
|
|
305
|
-
stream.bitrateMaximum = readS32LE(packet, 16);
|
|
306
|
-
stream.bitrateNominal = readS32LE(packet, 20);
|
|
307
|
-
stream.bitrateMinimum = readS32LE(packet, 24);
|
|
308
|
-
addAudioTiming(stream, 0);
|
|
309
|
-
} else if (matches(packet, [0x4f, 0x70, 0x75, 0x73, 0x48, 0x65, 0x61, 0x64])) {
|
|
310
|
-
if (packet.length < 19 || packet[8] !== 1 || !packet[9] || packet[18] && packet.length < 21 + packet[9]) {
|
|
311
|
-
throw new Error(`ogg: invalid OpusHead packet for stream ${stream.serial}`);
|
|
312
|
-
}
|
|
313
|
-
stream.codec = "opus";
|
|
314
|
-
stream.mediaType = "audio";
|
|
315
|
-
stream.channels = packet[9] || 0;
|
|
316
|
-
stream.preSkip = readU16LE(packet, 10);
|
|
317
|
-
stream.inputSampleRate = readU32LE(packet, 12);
|
|
318
|
-
stream.sampleRate = 48000;
|
|
319
|
-
stream.outputGain = readS16LE(packet, 16);
|
|
320
|
-
stream.mappingFamily = packet[18] || 0;
|
|
321
|
-
addAudioTiming(stream, stream.preSkip);
|
|
322
|
-
} else if (matches(packet, [0x80, 0x74, 0x68, 0x65, 0x6f, 0x72, 0x61])) {
|
|
323
|
-
if (packet.length < 42) throw new Error(`ogg: truncated Theora identification header for stream ${stream.serial}`);
|
|
324
|
-
stream.codec = "theora";
|
|
325
|
-
stream.mediaType = "video";
|
|
326
|
-
stream.frameWidth = readU16BE(packet, 10) * 16;
|
|
327
|
-
stream.frameHeight = readU16BE(packet, 12) * 16;
|
|
328
|
-
stream.width = readU24BE(packet, 14);
|
|
329
|
-
stream.height = readU24BE(packet, 17);
|
|
330
|
-
stream.frameRateNumerator = readU32BE(packet, 22);
|
|
331
|
-
stream.frameRateDenominator = readU32BE(packet, 26);
|
|
332
|
-
stream.frameRate = stream.frameRateDenominator ? stream.frameRateNumerator / stream.frameRateDenominator : 0;
|
|
333
|
-
stream.pixelAspectNumerator = readU24BE(packet, 30);
|
|
334
|
-
stream.pixelAspectDenominator = readU24BE(packet, 33);
|
|
335
|
-
stream.pixelAspectRatio = stream.pixelAspectDenominator ? stream.pixelAspectNumerator / stream.pixelAspectDenominator : 0;
|
|
336
|
-
stream.colorSpace = packet[36] || 0;
|
|
337
|
-
}
|
|
338
|
-
delete stream.firstPacket;
|
|
339
|
-
delete stream.packetBytes;
|
|
340
|
-
delete stream.firstPacketComplete;
|
|
341
|
-
delete stream.packetOpen;
|
|
342
|
-
return stream;
|
|
343
|
-
}
|
|
344
|
-
function addAudioTiming(stream, preSkip) {
|
|
345
|
-
stream.granulePosition = stream.lastGranulePosition;
|
|
346
|
-
const granule = typeof stream.lastGranulePosition === "number" ? stream.lastGranulePosition : typeof stream.lastGranulePosition === "string" && /^\d+$/u.test(stream.lastGranulePosition) ? Number(stream.lastGranulePosition) : null;
|
|
347
|
-
if (granule === null || !Number.isSafeInteger(granule)) return;
|
|
348
|
-
stream.durationSamples = Math.max(0, granule - preSkip);
|
|
349
|
-
stream.durationSeconds = stream.sampleRate ? stream.durationSamples / stream.sampleRate : 0;
|
|
350
|
-
}
|
|
351
|
-
function matches(bytes, signature) {
|
|
352
|
-
return signature.every((value, index) => bytes[index] === value);
|
|
353
|
-
}
|
|
354
|
-
function ascii(bytes, offset, length) {
|
|
355
|
-
return String.fromCharCode(...bytes.subarray(offset, offset + length));
|
|
356
|
-
}
|
|
357
|
-
function readU16LE(bytes, offset) {
|
|
358
|
-
return (bytes[offset] || 0) | (bytes[offset + 1] || 0) << 8;
|
|
359
|
-
}
|
|
360
|
-
function readU16BE(bytes, offset) {
|
|
361
|
-
return (bytes[offset] || 0) << 8 | (bytes[offset + 1] || 0);
|
|
362
|
-
}
|
|
363
|
-
function readU24BE(bytes, offset) {
|
|
364
|
-
return (bytes[offset] || 0) * 0x10000 + ((bytes[offset + 1] || 0) << 8) + (bytes[offset + 2] || 0);
|
|
365
|
-
}
|
|
366
|
-
function readS16LE(bytes, offset) {
|
|
367
|
-
const value = readU16LE(bytes, offset);
|
|
368
|
-
return value & 0x8000 ? value - 0x10000 : value;
|
|
369
|
-
}
|
|
370
|
-
function readU32LE(bytes, offset) {
|
|
371
|
-
return ((bytes[offset] || 0) | (bytes[offset + 1] || 0) << 8 | (bytes[offset + 2] || 0) << 16 | (bytes[offset + 3] || 0) * 0x1000000) >>> 0;
|
|
372
|
-
}
|
|
373
|
-
function readU32BE(bytes, offset) {
|
|
374
|
-
return (bytes[offset] || 0) * 0x1000000 + ((bytes[offset + 1] || 0) << 16) + ((bytes[offset + 2] || 0) << 8) + (bytes[offset + 3] || 0) >>> 0;
|
|
375
|
-
}
|
|
376
|
-
function readS32LE(bytes, offset) {
|
|
377
|
-
return readU32LE(bytes, offset) | 0;
|
|
378
|
-
}
|
|
379
|
-
function readU64LE(bytes, offset) {
|
|
380
|
-
let value = 0n;
|
|
381
|
-
for (let i = 7; i >= 0; i--) value = value << 8n | BigInt(bytes[offset + i] || 0);
|
|
382
|
-
if (value === 0xffffffffffffffffn) return null;
|
|
383
|
-
return value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : value.toString();
|
|
384
|
-
}
|
|
385
|
-
|
|
386
|
-
export { DEFAULT_VALUES, OUTPUT_AUDIO, OUTPUT_JSON, OUTPUT_PCM, OUTPUT_RAW, inspectWithValues, isOGG, isSupportedWithValues, normalizeValues, readWithValues, toBytes, toJsonValue };
|
|
387
|
-
//# sourceMappingURL=helpers.js.map
|
|
1
|
+
import { decodeVorbis } from './vorbis.js';
|
|
2
|
+
|
|
3
|
+
const OUTPUT_RAW = "raw";
|
|
4
|
+
const OUTPUT_JSON = "json";
|
|
5
|
+
const OUTPUT_PCM = "pcm";
|
|
6
|
+
const OUTPUT_AUDIO = "audio";
|
|
7
|
+
const DEFAULT_VALUES = Object.freeze({
|
|
8
|
+
emit: OUTPUT_RAW,
|
|
9
|
+
inputType: "ogg",
|
|
10
|
+
source: ""
|
|
11
|
+
});
|
|
12
|
+
function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsOggFormat") {
|
|
13
|
+
if (!options || typeof options !== "object" || Array.isArray(options)) {
|
|
14
|
+
throw new TypeError(`${readerName}: options must be an object`);
|
|
15
|
+
}
|
|
16
|
+
const allowed = new Set(["emit", "inputType", "source"]);
|
|
17
|
+
for (const key of Object.keys(options)) {
|
|
18
|
+
if (!allowed.has(key)) throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
|
|
19
|
+
}
|
|
20
|
+
const values = {
|
|
21
|
+
...DEFAULT_VALUES,
|
|
22
|
+
...(base || {}),
|
|
23
|
+
...options
|
|
24
|
+
};
|
|
25
|
+
if (![OUTPUT_RAW, OUTPUT_JSON, "oggJson", "audio", "pcm"].includes(values.emit)) {
|
|
26
|
+
throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(values.emit)}`);
|
|
27
|
+
}
|
|
28
|
+
return values;
|
|
29
|
+
}
|
|
30
|
+
function toBytes(input) {
|
|
31
|
+
if (input instanceof Uint8Array) return input;
|
|
32
|
+
if (input instanceof ArrayBuffer) return new Uint8Array(input);
|
|
33
|
+
if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
|
|
34
|
+
throw new TypeError("OGG input must be Uint8Array, ArrayBuffer, or a view");
|
|
35
|
+
}
|
|
36
|
+
function isOGG(bytes) {
|
|
37
|
+
return bytes.byteLength >= 4 && ascii(bytes, 0, 4) === "OggS";
|
|
38
|
+
}
|
|
39
|
+
function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "ogg") {
|
|
40
|
+
const bytes = toBytes(input);
|
|
41
|
+
if (!isOGG(bytes)) throw new TypeError("CjsOggFormat: input is not an Ogg container");
|
|
42
|
+
const metadata = inspectOgg(bytes);
|
|
43
|
+
if (expectedType && metadata.sourceFormat !== expectedType) {
|
|
44
|
+
throw new TypeError(`CjsOggFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
|
|
45
|
+
}
|
|
46
|
+
return {
|
|
47
|
+
...metadata,
|
|
48
|
+
byteLength: bytes.byteLength,
|
|
49
|
+
source: values.source || "buffer"
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
function isSupportedWithValues(input, values = DEFAULT_VALUES) {
|
|
53
|
+
try {
|
|
54
|
+
const metadata = inspectWithValues(input, values);
|
|
55
|
+
const mimeType = getOggMimeType(metadata);
|
|
56
|
+
const variants = [{
|
|
57
|
+
kind: "raw",
|
|
58
|
+
payloadType: "raw",
|
|
59
|
+
codec: "ogg",
|
|
60
|
+
mimeType,
|
|
61
|
+
supported: true,
|
|
62
|
+
containerOnly: true,
|
|
63
|
+
isDecoded: false,
|
|
64
|
+
pcmDecodeSupported: false,
|
|
65
|
+
frameDecodeSupported: false
|
|
66
|
+
}, {
|
|
67
|
+
kind: "pcm",
|
|
68
|
+
payloadType: "pcm",
|
|
69
|
+
codec: metadata.codec === "vorbis" ? "float32" : "pcm",
|
|
70
|
+
supported: metadata.codec === "vorbis",
|
|
71
|
+
reason: metadata.codec === "vorbis" ? "" : "Only Ogg Vorbis PCM decode is implemented."
|
|
72
|
+
}];
|
|
73
|
+
if (metadata.mediaType === "video") {
|
|
74
|
+
variants.push({
|
|
75
|
+
kind: "decoded",
|
|
76
|
+
payloadType: "video-frame",
|
|
77
|
+
codec: "frames",
|
|
78
|
+
supported: false,
|
|
79
|
+
reason: "OGG Theora frame decode is not implemented yet."
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
const pcmSupported = metadata.codec === "vorbis";
|
|
83
|
+
return {
|
|
84
|
+
format: "ogg",
|
|
85
|
+
source: values.source || "buffer",
|
|
86
|
+
supported: "partial",
|
|
87
|
+
confidence: 1,
|
|
88
|
+
preferred: pcmSupported ? "pcm" : metadata.sourceFormat ? "ogg" : "",
|
|
89
|
+
reason: pcmSupported ? "Ogg Vorbis recognized; PCM decode is supported." : "Ogg pages and codec headers are recognized; raw Ogg passthrough is available.",
|
|
90
|
+
metadata,
|
|
91
|
+
variants,
|
|
92
|
+
warnings: [],
|
|
93
|
+
errors: []
|
|
94
|
+
};
|
|
95
|
+
} catch (error) {
|
|
96
|
+
return {
|
|
97
|
+
format: "ogg",
|
|
98
|
+
source: values.source || "buffer",
|
|
99
|
+
supported: "none",
|
|
100
|
+
confidence: 0,
|
|
101
|
+
preferred: "",
|
|
102
|
+
reason: error.message,
|
|
103
|
+
metadata: null,
|
|
104
|
+
variants: [],
|
|
105
|
+
warnings: [],
|
|
106
|
+
errors: [error.message]
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
function readWithValues(input, values = DEFAULT_VALUES) {
|
|
111
|
+
const bytes = toBytes(input);
|
|
112
|
+
const metadata = inspectWithValues(bytes, values);
|
|
113
|
+
if (values.emit === OUTPUT_RAW) {
|
|
114
|
+
return {
|
|
115
|
+
payloadType: "raw",
|
|
116
|
+
sourceFormat: "ogg",
|
|
117
|
+
mimeType: getOggMimeType(metadata),
|
|
118
|
+
containerOnly: true,
|
|
119
|
+
isDecoded: false,
|
|
120
|
+
pcmDecodeSupported: false,
|
|
121
|
+
frameDecodeSupported: false,
|
|
122
|
+
metadata,
|
|
123
|
+
bytes
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
if (values.emit === OUTPUT_JSON || values.emit === "oggJson") return metadata;
|
|
127
|
+
if (values.emit === OUTPUT_PCM || values.emit === OUTPUT_AUDIO) {
|
|
128
|
+
if (metadata.codec !== "vorbis") {
|
|
129
|
+
const error = new Error(`ogg: PCM decode supports Vorbis only (found ${metadata.codec})`);
|
|
130
|
+
error.code = "CJS_FORMAT_OUTPUT_NOT_SUPPORTED";
|
|
131
|
+
throw error;
|
|
132
|
+
}
|
|
133
|
+
const decoded = decodeVorbis(bytes);
|
|
134
|
+
const data = new Float32Array(decoded.sampleCount * decoded.channels);
|
|
135
|
+
for (let channel = 0; channel < decoded.channels; channel++) {
|
|
136
|
+
const samples = decoded.channelData[channel];
|
|
137
|
+
for (let i = 0; i < decoded.sampleCount; i++) {
|
|
138
|
+
data[i * decoded.channels + channel] = samples[i];
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
return {
|
|
142
|
+
payloadType: values.emit === OUTPUT_AUDIO ? OUTPUT_AUDIO : OUTPUT_PCM,
|
|
143
|
+
sourceFormat: "ogg",
|
|
144
|
+
codec: "vorbis",
|
|
145
|
+
containerOnly: false,
|
|
146
|
+
isDecoded: true,
|
|
147
|
+
pcmDecodeSupported: true,
|
|
148
|
+
audioFormat: "float32",
|
|
149
|
+
sampleFormat: "float32",
|
|
150
|
+
sampleRate: decoded.sampleRate,
|
|
151
|
+
channels: decoded.channels,
|
|
152
|
+
interleaving: "interleaved",
|
|
153
|
+
frameCount: decoded.sampleCount,
|
|
154
|
+
durationSeconds: decoded.sampleRate ? decoded.sampleCount / decoded.sampleRate : 0,
|
|
155
|
+
vendor: decoded.vendor,
|
|
156
|
+
comments: decoded.comments,
|
|
157
|
+
loop: decoded.loop,
|
|
158
|
+
channelData: decoded.channelData,
|
|
159
|
+
metadata,
|
|
160
|
+
data
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
const error = new Error(`ogg: emit "${values.emit}" is not implemented yet`);
|
|
164
|
+
error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
|
|
165
|
+
throw error;
|
|
166
|
+
}
|
|
167
|
+
function toJsonValue(value) {
|
|
168
|
+
if (value instanceof Uint8Array) return {
|
|
169
|
+
byteLength: value.byteLength
|
|
170
|
+
};
|
|
171
|
+
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
172
|
+
if (value && typeof value === "object") {
|
|
173
|
+
const output = {};
|
|
174
|
+
for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
|
|
175
|
+
return output;
|
|
176
|
+
}
|
|
177
|
+
return value;
|
|
178
|
+
}
|
|
179
|
+
function getOggMimeType(metadata) {
|
|
180
|
+
if (metadata.mediaType === "video") return "video/ogg";
|
|
181
|
+
if (metadata.mediaType === "audio") return "audio/ogg";
|
|
182
|
+
return "application/ogg";
|
|
183
|
+
}
|
|
184
|
+
function inspectOgg(bytes) {
|
|
185
|
+
const streams = new Map();
|
|
186
|
+
let offset = 0;
|
|
187
|
+
let pageCount = 0;
|
|
188
|
+
while (offset + 27 <= bytes.byteLength) {
|
|
189
|
+
if (ascii(bytes, offset, 4) !== "OggS") throw new Error(`ogg: invalid page at byte ${offset}`);
|
|
190
|
+
const version = bytes[offset + 4];
|
|
191
|
+
if (version !== 0) throw new Error(`ogg: unsupported stream version ${version}`);
|
|
192
|
+
const headerType = bytes[offset + 5];
|
|
193
|
+
if (headerType & 0xf8) throw new Error(`ogg: reserved header flags at byte ${offset}`);
|
|
194
|
+
const granulePosition = readU64LE(bytes, offset + 6);
|
|
195
|
+
const serial = readU32LE(bytes, offset + 14);
|
|
196
|
+
const sequence = readU32LE(bytes, offset + 18);
|
|
197
|
+
const segmentCount = bytes[offset + 26];
|
|
198
|
+
const tableOffset = offset + 27;
|
|
199
|
+
const payloadOffset = tableOffset + segmentCount;
|
|
200
|
+
if (payloadOffset > bytes.byteLength) throw new Error("ogg: truncated segment table");
|
|
201
|
+
let payloadLength = 0;
|
|
202
|
+
for (let i = 0; i < segmentCount; i++) payloadLength += bytes[tableOffset + i];
|
|
203
|
+
if (payloadOffset + payloadLength > bytes.byteLength) throw new Error("ogg: truncated page payload");
|
|
204
|
+
const pageLength = 27 + segmentCount + payloadLength;
|
|
205
|
+
const expectedChecksum = readU32LE(bytes, offset + 22);
|
|
206
|
+
if (computeOggCrc(bytes, offset, pageLength) !== expectedChecksum) {
|
|
207
|
+
throw new Error(`ogg: page checksum mismatch at byte ${offset}`);
|
|
208
|
+
}
|
|
209
|
+
const stream = streams.get(serial) || {
|
|
210
|
+
serial,
|
|
211
|
+
pages: 0,
|
|
212
|
+
firstPacket: [],
|
|
213
|
+
packetBytes: 0,
|
|
214
|
+
firstPacketComplete: false,
|
|
215
|
+
packetOpen: false,
|
|
216
|
+
codec: "",
|
|
217
|
+
mediaType: "unknown",
|
|
218
|
+
payloadBytes: 0
|
|
219
|
+
};
|
|
220
|
+
const continued = !!(headerType & 0x01);
|
|
221
|
+
if (stream.pages === 0 && !(headerType & 0x02)) throw new Error(`ogg: first page of stream ${serial} is missing BOS`);
|
|
222
|
+
if (stream.pages === 0 && continued) throw new Error(`ogg: first page of stream ${serial} is marked continued`);
|
|
223
|
+
if (stream.eosSeen) throw new Error(`ogg: page follows EOS for stream ${serial}`);
|
|
224
|
+
if (stream.pages > 0 && continued !== stream.packetOpen) {
|
|
225
|
+
throw new Error(`ogg: continued-page state mismatch for stream ${serial}`);
|
|
226
|
+
}
|
|
227
|
+
if (headerType & 0x02 && stream.pages !== 0) throw new Error(`ogg: BOS page is not first for stream ${serial}`);
|
|
228
|
+
if (stream.lastSequence !== undefined && sequence !== stream.lastSequence + 1) {
|
|
229
|
+
throw new Error(`ogg: page sequence mismatch for stream ${serial}`);
|
|
230
|
+
}
|
|
231
|
+
if (stream.pages === 0) {
|
|
232
|
+
stream.firstSequence = sequence;
|
|
233
|
+
stream.firstGranulePosition = granulePosition;
|
|
234
|
+
stream.bos = !!(headerType & 0x02);
|
|
235
|
+
}
|
|
236
|
+
stream.pages++;
|
|
237
|
+
stream.payloadBytes += payloadLength;
|
|
238
|
+
collectFirstPacket(stream, bytes, payloadOffset, tableOffset, segmentCount);
|
|
239
|
+
if (headerType & 0x04 && stream.packetOpen) throw new Error(`ogg: EOS page leaves a packet continued for stream ${serial}`);
|
|
240
|
+
stream.lastGranulePosition = granulePosition;
|
|
241
|
+
stream.granulePosition = granulePosition;
|
|
242
|
+
stream.lastSequence = sequence;
|
|
243
|
+
stream.eos = !!(headerType & 0x04);
|
|
244
|
+
stream.eosSeen = stream.eos;
|
|
245
|
+
streams.set(serial, stream);
|
|
246
|
+
pageCount++;
|
|
247
|
+
offset = payloadOffset + payloadLength;
|
|
248
|
+
}
|
|
249
|
+
if (offset !== bytes.byteLength) throw new Error(`ogg: truncated trailing page at byte ${offset}`);
|
|
250
|
+
if (!pageCount) throw new Error("ogg: no pages found");
|
|
251
|
+
const tracks = Array.from(streams.values()).map(stream => decodeCodec(stream));
|
|
252
|
+
const primary = tracks.find(track => track.mediaType !== "unknown") || tracks[0];
|
|
253
|
+
return {
|
|
254
|
+
payloadType: primary?.mediaType === "video" ? "video" : primary?.mediaType === "audio" ? "audio" : "container",
|
|
255
|
+
mediaTypes: tracks.map(track => track.mediaType),
|
|
256
|
+
sourceFormat: "ogg",
|
|
257
|
+
pageCount,
|
|
258
|
+
streamCount: tracks.length,
|
|
259
|
+
codec: primary?.codec || "ogg",
|
|
260
|
+
mediaType: primary?.mediaType || "unknown",
|
|
261
|
+
tracks
|
|
262
|
+
};
|
|
263
|
+
}
|
|
264
|
+
function computeOggCrc(bytes, offset, length) {
|
|
265
|
+
let crc = 0;
|
|
266
|
+
for (let i = 0; i < length; i++) {
|
|
267
|
+
const relative = i;
|
|
268
|
+
const value = relative >= 22 && relative < 26 ? 0 : bytes[offset + relative];
|
|
269
|
+
crc ^= value << 24;
|
|
270
|
+
for (let bit = 0; bit < 8; bit++) {
|
|
271
|
+
crc = crc & 0x80000000 ? crc << 1 ^ 0x04c11db7 : crc << 1;
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
return crc >>> 0;
|
|
275
|
+
}
|
|
276
|
+
function collectFirstPacket(stream, bytes, payloadOffset, tableOffset, segmentCount) {
|
|
277
|
+
let cursor = payloadOffset;
|
|
278
|
+
let lastLength = 0;
|
|
279
|
+
for (let i = 0; i < segmentCount; i++) {
|
|
280
|
+
const length = bytes[tableOffset + i];
|
|
281
|
+
if (!stream.firstPacketComplete && stream.packetBytes < 64) {
|
|
282
|
+
const copyLength = Math.min(length, 64 - stream.packetBytes);
|
|
283
|
+
stream.firstPacket.push(...bytes.subarray(cursor, cursor + copyLength));
|
|
284
|
+
stream.packetBytes += copyLength;
|
|
285
|
+
}
|
|
286
|
+
cursor += length;
|
|
287
|
+
lastLength = length;
|
|
288
|
+
if (length < 255) {
|
|
289
|
+
if (!stream.firstPacketComplete) stream.firstPacketComplete = true;
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
stream.packetOpen = segmentCount > 0 && lastLength === 255;
|
|
293
|
+
}
|
|
294
|
+
function decodeCodec(stream) {
|
|
295
|
+
const packet = Uint8Array.from(stream.firstPacket);
|
|
296
|
+
if (matches(packet, [1, 0x76, 0x6f, 0x72, 0x62, 0x69, 0x73])) {
|
|
297
|
+
if (packet.length < 30) throw new Error(`ogg: truncated Vorbis identification header for stream ${stream.serial}`);
|
|
298
|
+
if (readU32LE(packet, 7) !== 0 || !packet[11] || !readU32LE(packet, 12)) {
|
|
299
|
+
throw new Error(`ogg: invalid Vorbis identification header for stream ${stream.serial}`);
|
|
300
|
+
}
|
|
301
|
+
stream.codec = "vorbis";
|
|
302
|
+
stream.mediaType = "audio";
|
|
303
|
+
stream.channels = packet[11] || 0;
|
|
304
|
+
stream.sampleRate = readU32LE(packet, 12);
|
|
305
|
+
stream.bitrateMaximum = readS32LE(packet, 16);
|
|
306
|
+
stream.bitrateNominal = readS32LE(packet, 20);
|
|
307
|
+
stream.bitrateMinimum = readS32LE(packet, 24);
|
|
308
|
+
addAudioTiming(stream, 0);
|
|
309
|
+
} else if (matches(packet, [0x4f, 0x70, 0x75, 0x73, 0x48, 0x65, 0x61, 0x64])) {
|
|
310
|
+
if (packet.length < 19 || packet[8] !== 1 || !packet[9] || packet[18] && packet.length < 21 + packet[9]) {
|
|
311
|
+
throw new Error(`ogg: invalid OpusHead packet for stream ${stream.serial}`);
|
|
312
|
+
}
|
|
313
|
+
stream.codec = "opus";
|
|
314
|
+
stream.mediaType = "audio";
|
|
315
|
+
stream.channels = packet[9] || 0;
|
|
316
|
+
stream.preSkip = readU16LE(packet, 10);
|
|
317
|
+
stream.inputSampleRate = readU32LE(packet, 12);
|
|
318
|
+
stream.sampleRate = 48000;
|
|
319
|
+
stream.outputGain = readS16LE(packet, 16);
|
|
320
|
+
stream.mappingFamily = packet[18] || 0;
|
|
321
|
+
addAudioTiming(stream, stream.preSkip);
|
|
322
|
+
} else if (matches(packet, [0x80, 0x74, 0x68, 0x65, 0x6f, 0x72, 0x61])) {
|
|
323
|
+
if (packet.length < 42) throw new Error(`ogg: truncated Theora identification header for stream ${stream.serial}`);
|
|
324
|
+
stream.codec = "theora";
|
|
325
|
+
stream.mediaType = "video";
|
|
326
|
+
stream.frameWidth = readU16BE(packet, 10) * 16;
|
|
327
|
+
stream.frameHeight = readU16BE(packet, 12) * 16;
|
|
328
|
+
stream.width = readU24BE(packet, 14);
|
|
329
|
+
stream.height = readU24BE(packet, 17);
|
|
330
|
+
stream.frameRateNumerator = readU32BE(packet, 22);
|
|
331
|
+
stream.frameRateDenominator = readU32BE(packet, 26);
|
|
332
|
+
stream.frameRate = stream.frameRateDenominator ? stream.frameRateNumerator / stream.frameRateDenominator : 0;
|
|
333
|
+
stream.pixelAspectNumerator = readU24BE(packet, 30);
|
|
334
|
+
stream.pixelAspectDenominator = readU24BE(packet, 33);
|
|
335
|
+
stream.pixelAspectRatio = stream.pixelAspectDenominator ? stream.pixelAspectNumerator / stream.pixelAspectDenominator : 0;
|
|
336
|
+
stream.colorSpace = packet[36] || 0;
|
|
337
|
+
}
|
|
338
|
+
delete stream.firstPacket;
|
|
339
|
+
delete stream.packetBytes;
|
|
340
|
+
delete stream.firstPacketComplete;
|
|
341
|
+
delete stream.packetOpen;
|
|
342
|
+
return stream;
|
|
343
|
+
}
|
|
344
|
+
function addAudioTiming(stream, preSkip) {
|
|
345
|
+
stream.granulePosition = stream.lastGranulePosition;
|
|
346
|
+
const granule = typeof stream.lastGranulePosition === "number" ? stream.lastGranulePosition : typeof stream.lastGranulePosition === "string" && /^\d+$/u.test(stream.lastGranulePosition) ? Number(stream.lastGranulePosition) : null;
|
|
347
|
+
if (granule === null || !Number.isSafeInteger(granule)) return;
|
|
348
|
+
stream.durationSamples = Math.max(0, granule - preSkip);
|
|
349
|
+
stream.durationSeconds = stream.sampleRate ? stream.durationSamples / stream.sampleRate : 0;
|
|
350
|
+
}
|
|
351
|
+
function matches(bytes, signature) {
|
|
352
|
+
return signature.every((value, index) => bytes[index] === value);
|
|
353
|
+
}
|
|
354
|
+
function ascii(bytes, offset, length) {
|
|
355
|
+
return String.fromCharCode(...bytes.subarray(offset, offset + length));
|
|
356
|
+
}
|
|
357
|
+
function readU16LE(bytes, offset) {
|
|
358
|
+
return (bytes[offset] || 0) | (bytes[offset + 1] || 0) << 8;
|
|
359
|
+
}
|
|
360
|
+
function readU16BE(bytes, offset) {
|
|
361
|
+
return (bytes[offset] || 0) << 8 | (bytes[offset + 1] || 0);
|
|
362
|
+
}
|
|
363
|
+
function readU24BE(bytes, offset) {
|
|
364
|
+
return (bytes[offset] || 0) * 0x10000 + ((bytes[offset + 1] || 0) << 8) + (bytes[offset + 2] || 0);
|
|
365
|
+
}
|
|
366
|
+
function readS16LE(bytes, offset) {
|
|
367
|
+
const value = readU16LE(bytes, offset);
|
|
368
|
+
return value & 0x8000 ? value - 0x10000 : value;
|
|
369
|
+
}
|
|
370
|
+
function readU32LE(bytes, offset) {
|
|
371
|
+
return ((bytes[offset] || 0) | (bytes[offset + 1] || 0) << 8 | (bytes[offset + 2] || 0) << 16 | (bytes[offset + 3] || 0) * 0x1000000) >>> 0;
|
|
372
|
+
}
|
|
373
|
+
function readU32BE(bytes, offset) {
|
|
374
|
+
return (bytes[offset] || 0) * 0x1000000 + ((bytes[offset + 1] || 0) << 16) + ((bytes[offset + 2] || 0) << 8) + (bytes[offset + 3] || 0) >>> 0;
|
|
375
|
+
}
|
|
376
|
+
function readS32LE(bytes, offset) {
|
|
377
|
+
return readU32LE(bytes, offset) | 0;
|
|
378
|
+
}
|
|
379
|
+
function readU64LE(bytes, offset) {
|
|
380
|
+
let value = 0n;
|
|
381
|
+
for (let i = 7; i >= 0; i--) value = value << 8n | BigInt(bytes[offset + i] || 0);
|
|
382
|
+
if (value === 0xffffffffffffffffn) return null;
|
|
383
|
+
return value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : value.toString();
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
export { DEFAULT_VALUES, OUTPUT_AUDIO, OUTPUT_JSON, OUTPUT_PCM, OUTPUT_RAW, inspectWithValues, isOGG, isSupportedWithValues, normalizeValues, readWithValues, toBytes, toJsonValue };
|
|
387
|
+
//# sourceMappingURL=helpers.js.map
|