@carbonenginejs/runtime-resource 0.8.0 → 0.9.1
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 +31 -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 +68 -59
- package/dist/CjsResourceSource.js.map +1 -1
- package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
- package/dist/format/CjsBlueReader.js +269 -269
- package/dist/format/CjsFormat.js +197 -192
- package/dist/format/CjsFormat.js.map +1 -1
- 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 +157 -153
- package/dist/formats/black/core/CjsBlackBinaryReader.js.map +1 -1
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +387 -382
- package/dist/formats/black/core/CjsBlackPropertyReaders.js.map +1 -1
- package/dist/formats/black/core/CjsBlackReader.js +639 -639
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +437 -433
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js.map +1 -1
- package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -0
- package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js.map +1 -0
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackDefinitions.js.map +1 -1
- 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 +493 -489
- package/dist/formats/bnk/core/musicNodes.js.map +1 -1
- 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 +123 -118
- package/dist/formats/cmf/core/binary.js.map +1 -1
- 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 +200 -193
- package/dist/formats/dds/CjsDdsFormat.js.map +1 -1
- package/dist/formats/dds/core/bc6h.js +288 -288
- package/dist/formats/dds/core/bc7.js +256 -251
- package/dist/formats/dds/core/bc7.js.map +1 -1
- 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 +3911 -3901
- package/dist/formats/fbx/core/helpers.js.map +1 -1
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +93 -87
- package/dist/formats/flac/CjsFlacFormat.js.map +1 -1
- package/dist/formats/flac/core/helpers.js +295 -295
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +92 -87
- package/dist/formats/gif/CjsGifFormat.js.map +1 -1
- 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 +212 -206
- package/dist/formats/jpeg/CjsJpegFormat.js.map +1 -1
- package/dist/formats/jpeg/core/helpers.js +350 -350
- package/dist/formats/jpeg/core/jpeg.js +387 -377
- package/dist/formats/jpeg/core/jpeg.js.map +1 -1
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +197 -192
- package/dist/formats/mp3/CjsMp3Format.js.map +1 -1
- package/dist/formats/mp3/core/helpers.js +338 -338
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +197 -191
- package/dist/formats/mp4/CjsMp4Format.js.map +1 -1
- 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 +94 -88
- package/dist/formats/ogg/CjsOggFormat.js.map +1 -1
- 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 +1004 -999
- package/dist/formats/ogg/core/vorbis.js.map +1 -1
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/png/CjsPngFormat.js +201 -195
- package/dist/formats/png/CjsPngFormat.js.map +1 -1
- 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 +634 -629
- package/dist/formats/stl/core/stl.js.map +1 -1
- package/dist/formats/stl/core/targets.js +163 -163
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +197 -192
- package/dist/formats/tga/CjsTgaFormat.js.map +1 -1
- package/dist/formats/tga/core/helpers.js +446 -446
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +198 -192
- package/dist/formats/wav/CjsWavFormat.js.map +1 -1
- package/dist/formats/wav/core/helpers.js +328 -328
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +197 -191
- package/dist/formats/webm/CjsWebmFormat.js.map +1 -1
- package/dist/formats/webm/core/helpers.js +537 -537
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +91 -86
- package/dist/formats/webp/CjsWebpFormat.js.map +1 -1
- package/dist/formats/webp/core/helpers.js +214 -214
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +242 -241
- package/dist/formats/wem/CjsWemFormat.js.map +1 -1
- 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 +89 -83
- package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
- package/dist/formats/yaml/core/CjsYamlReader.js +311 -305
- package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
- 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 +73 -0
- package/docs/architecture.md +86 -0
- package/docs/concepts/resource-lifecycle.md +217 -0
- package/docs/formats/README.md +105 -0
- package/docs/formats/gr2.md +161 -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/classes/README.md +33 -0
- package/docs/reference/classes/core.md +106 -0
- package/docs/reference/classes/dropped.md +46 -0
- package/docs/reference/classes/formats.md +522 -0
- package/docs/reference/classes/resources.md +346 -0
- package/docs/reference/classes/texture.md +26 -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/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +0 -4
- package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js.map +0 -1
- package/resource-lifecycle.md +0 -679
|
@@ -1,360 +1,360 @@
|
|
|
1
|
-
const OUTPUT_IMAGE = "image";
|
|
2
|
-
const OUTPUT_RGBA = "rgba";
|
|
3
|
-
const OUTPUT_RAW = "raw";
|
|
4
|
-
const OUTPUT_JSON = "json";
|
|
5
|
-
const DEFAULT_VALUES = Object.freeze({
|
|
6
|
-
emit: OUTPUT_RAW,
|
|
7
|
-
inputType: "gif",
|
|
8
|
-
source: ""
|
|
9
|
-
});
|
|
10
|
-
function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsGifFormat") {
|
|
11
|
-
if (!options || typeof options !== "object" || Array.isArray(options)) {
|
|
12
|
-
throw new TypeError(`${readerName}: options must be an object`);
|
|
13
|
-
}
|
|
14
|
-
const allowed = new Set(["emit", "inputType", "source"]);
|
|
15
|
-
for (const key of Object.keys(options)) {
|
|
16
|
-
if (!allowed.has(key)) throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
|
|
17
|
-
}
|
|
18
|
-
const values = {
|
|
19
|
-
...DEFAULT_VALUES,
|
|
20
|
-
...(base || {}),
|
|
21
|
-
...options
|
|
22
|
-
};
|
|
23
|
-
if (![OUTPUT_IMAGE, OUTPUT_RGBA, OUTPUT_RAW, OUTPUT_JSON, "gifJson"].includes(values.emit)) {
|
|
24
|
-
throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(values.emit)}`);
|
|
25
|
-
}
|
|
26
|
-
return values;
|
|
27
|
-
}
|
|
28
|
-
function toBytes(input) {
|
|
29
|
-
if (input instanceof Uint8Array) return input;
|
|
30
|
-
if (input instanceof ArrayBuffer) return new Uint8Array(input);
|
|
31
|
-
if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
|
|
32
|
-
throw new TypeError("GIF input must be Uint8Array, ArrayBuffer, or a view");
|
|
33
|
-
}
|
|
34
|
-
function isGIF(bytes) {
|
|
35
|
-
return bytes.byteLength >= 13 && (ascii(bytes, 0, 6) === "GIF87a" || ascii(bytes, 0, 6) === "GIF89a");
|
|
36
|
-
}
|
|
37
|
-
function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "gif") {
|
|
38
|
-
const bytes = toBytes(input);
|
|
39
|
-
if (!isGIF(bytes)) throw new TypeError("CjsGifFormat: input is not a GIF87a/GIF89a image");
|
|
40
|
-
const metadata = inspectGif(bytes);
|
|
41
|
-
if (expectedType && metadata.sourceFormat !== expectedType) {
|
|
42
|
-
throw new TypeError(`CjsGifFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
|
|
43
|
-
}
|
|
44
|
-
return {
|
|
45
|
-
...metadata,
|
|
46
|
-
byteLength: bytes.byteLength,
|
|
47
|
-
source: values.source || "buffer"
|
|
48
|
-
};
|
|
49
|
-
}
|
|
50
|
-
function isSupportedWithValues(input, values = DEFAULT_VALUES) {
|
|
51
|
-
try {
|
|
52
|
-
const metadata = inspectWithValues(input, values);
|
|
53
|
-
const decoded = metadata.frameCount > 0 && metadata.lzwSupported;
|
|
54
|
-
return {
|
|
55
|
-
format: "gif",
|
|
56
|
-
source: values.source || "buffer",
|
|
57
|
-
supported: decoded ? "full" : "partial",
|
|
58
|
-
confidence: 1,
|
|
59
|
-
preferred: decoded ? "rgba8unorm" : "raw",
|
|
60
|
-
reason: decoded ? "GIF frame RGBA decode and compositing are available." : "GIF metadata/raw input is recognized but no decodable image frame was found.",
|
|
61
|
-
metadata,
|
|
62
|
-
variants: [{
|
|
63
|
-
kind: "rgba",
|
|
64
|
-
payloadType: "rgba",
|
|
65
|
-
codec: "rgba8unorm",
|
|
66
|
-
supported: decoded,
|
|
67
|
-
reason: decoded ? "" : "GIF LZW frame decode is unavailable.",
|
|
68
|
-
containerOnly: false,
|
|
69
|
-
isDecoded: decoded,
|
|
70
|
-
rgbaDecodeSupported: decoded
|
|
71
|
-
}, {
|
|
72
|
-
kind: "raw",
|
|
73
|
-
payloadType: "raw",
|
|
74
|
-
codec: "gif",
|
|
75
|
-
mimeType: "image/gif",
|
|
76
|
-
supported: true,
|
|
77
|
-
containerOnly: true,
|
|
78
|
-
isDecoded: false,
|
|
79
|
-
rgbaDecodeSupported: decoded
|
|
80
|
-
}],
|
|
81
|
-
warnings: [],
|
|
82
|
-
errors: []
|
|
83
|
-
};
|
|
84
|
-
} catch (error) {
|
|
85
|
-
return {
|
|
86
|
-
format: "gif",
|
|
87
|
-
source: values.source || "buffer",
|
|
88
|
-
supported: "none",
|
|
89
|
-
confidence: 0,
|
|
90
|
-
preferred: "",
|
|
91
|
-
reason: error.message,
|
|
92
|
-
metadata: null,
|
|
93
|
-
variants: [],
|
|
94
|
-
warnings: [],
|
|
95
|
-
errors: [error.message]
|
|
96
|
-
};
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
function readWithValues(input, values = DEFAULT_VALUES) {
|
|
100
|
-
const bytes = toBytes(input);
|
|
101
|
-
const metadata = inspectWithValues(bytes, values);
|
|
102
|
-
if (values.emit === OUTPUT_RAW) {
|
|
103
|
-
return {
|
|
104
|
-
payloadType: "raw",
|
|
105
|
-
sourceFormat: "gif",
|
|
106
|
-
mimeType: "image/gif",
|
|
107
|
-
containerOnly: true,
|
|
108
|
-
isDecoded: false,
|
|
109
|
-
rgbaDecodeSupported: metadata.frameCount > 0 && metadata.lzwSupported,
|
|
110
|
-
metadata,
|
|
111
|
-
bytes
|
|
112
|
-
};
|
|
113
|
-
}
|
|
114
|
-
if (values.emit === OUTPUT_JSON || values.emit === "gifJson") return metadata;
|
|
115
|
-
if (values.emit === OUTPUT_RGBA || values.emit === OUTPUT_IMAGE) {
|
|
116
|
-
return decodeFrames(bytes, metadata);
|
|
117
|
-
}
|
|
118
|
-
const error = new Error(`gif: emit "${values.emit}" is not implemented yet`);
|
|
119
|
-
error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
|
|
120
|
-
throw error;
|
|
121
|
-
}
|
|
122
|
-
function toJsonValue(value) {
|
|
123
|
-
if (value instanceof Uint8Array) return {
|
|
124
|
-
byteLength: value.byteLength
|
|
125
|
-
};
|
|
126
|
-
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
127
|
-
if (value && typeof value === "object") {
|
|
128
|
-
const output = {};
|
|
129
|
-
for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
|
|
130
|
-
return output;
|
|
131
|
-
}
|
|
132
|
-
return value;
|
|
133
|
-
}
|
|
134
|
-
function inspectGif(bytes) {
|
|
135
|
-
const width = readU16LE(bytes, 6);
|
|
136
|
-
const height = readU16LE(bytes, 8);
|
|
137
|
-
const packed = bytes[10];
|
|
138
|
-
const hasGlobalPalette = !!(packed & 0x80);
|
|
139
|
-
const globalPaletteCount = hasGlobalPalette ? 1 << (packed & 7) + 1 : 0;
|
|
140
|
-
if (hasGlobalPalette) readPalette(bytes, 13, globalPaletteCount);
|
|
141
|
-
let offset = 13 + globalPaletteCount * 3;
|
|
142
|
-
let frameCount = 0;
|
|
143
|
-
const frames = [];
|
|
144
|
-
let firstFrame = null;
|
|
145
|
-
let graphicsControl = null;
|
|
146
|
-
let loopCount = null;
|
|
147
|
-
while (offset < bytes.length) {
|
|
148
|
-
const marker = bytes[offset++];
|
|
149
|
-
if (marker === 0x3b) break;
|
|
150
|
-
if (marker === 0x21) {
|
|
151
|
-
const label = bytes[offset++];
|
|
152
|
-
if (label === 0xf9) {
|
|
153
|
-
if (bytes[offset++] !== 4) throw new Error("gif: invalid graphics control extension");
|
|
154
|
-
const control = bytes[offset++];
|
|
155
|
-
graphicsControl = {
|
|
156
|
-
disposalMethod: control >>> 2 & 7,
|
|
157
|
-
userInput: !!(control & 2),
|
|
158
|
-
transparent: !!(control & 1),
|
|
159
|
-
delayCentiseconds: readU16LE(bytes, offset)
|
|
160
|
-
};
|
|
161
|
-
offset += 2;
|
|
162
|
-
graphicsControl.transparentIndex = bytes[offset++];
|
|
163
|
-
if (bytes[offset++] !== 0) throw new Error("gif: unterminated graphics control extension");
|
|
164
|
-
} else if (label === 0xff) {
|
|
165
|
-
const size = bytes[offset++];
|
|
166
|
-
const application = ascii(bytes, offset, size);
|
|
167
|
-
offset += size;
|
|
168
|
-
const data = readSubBlocks(bytes, offset);
|
|
169
|
-
offset = data.offset;
|
|
170
|
-
if (application === "NETSCAPE2.0" || application === "ANIMEXTS1.0") {
|
|
171
|
-
if (data.bytes.length >= 3 && data.bytes[0] === 1) loopCount = readU16LE(data.bytes, 1);
|
|
172
|
-
}
|
|
173
|
-
} else {
|
|
174
|
-
offset = skipSubBlocks(bytes, offset);
|
|
175
|
-
}
|
|
176
|
-
} else if (marker === 0x2c) {
|
|
177
|
-
if (offset + 9 > bytes.length) throw new Error("gif: truncated image descriptor");
|
|
178
|
-
const frame = {
|
|
179
|
-
left: readU16LE(bytes, offset),
|
|
180
|
-
top: readU16LE(bytes, offset + 2),
|
|
181
|
-
width: readU16LE(bytes, offset + 4),
|
|
182
|
-
height: readU16LE(bytes, offset + 6),
|
|
183
|
-
packed: bytes[offset + 8],
|
|
184
|
-
graphicsControl
|
|
185
|
-
};
|
|
186
|
-
offset += 9;
|
|
187
|
-
const localPaletteCount = frame.packed & 0x80 ? 1 << (frame.packed & 7) + 1 : 0;
|
|
188
|
-
frame.localPalette = localPaletteCount ? readPalette(bytes, offset, localPaletteCount) : null;
|
|
189
|
-
offset += localPaletteCount * 3;
|
|
190
|
-
frame.lzwMinCodeSize = bytes[offset++];
|
|
191
|
-
const data = readSubBlocks(bytes, offset);
|
|
192
|
-
frame.compressed = data.bytes;
|
|
193
|
-
offset = data.offset;
|
|
194
|
-
frame.interlaced = !!(frame.packed & 0x40);
|
|
195
|
-
frameCount++;
|
|
196
|
-
frames.push(frame);
|
|
197
|
-
if (!firstFrame) firstFrame = frame;
|
|
198
|
-
graphicsControl = null;
|
|
199
|
-
} else if (marker === 0x00) {
|
|
200
|
-
throw new Error("gif: unexpected data before image descriptor");
|
|
201
|
-
} else {
|
|
202
|
-
throw new Error(`gif: unsupported block marker 0x${marker.toString(16)}`);
|
|
203
|
-
}
|
|
204
|
-
}
|
|
205
|
-
return {
|
|
206
|
-
payloadType: "image",
|
|
207
|
-
mediaTypes: ["image"],
|
|
208
|
-
sourceFormat: "gif",
|
|
209
|
-
version: ascii(bytes, 0, 6),
|
|
210
|
-
width,
|
|
211
|
-
height,
|
|
212
|
-
frameCount,
|
|
213
|
-
animated: frameCount > 1,
|
|
214
|
-
loopCount,
|
|
215
|
-
hasGlobalPalette,
|
|
216
|
-
backgroundColorIndex: bytes[11],
|
|
217
|
-
colorResolution: (packed >>> 4 & 7) + 1,
|
|
218
|
-
lzwSupported: frames.length > 0 && frames.every(frame => frame.lzwMinCodeSize >= 2 && frame.lzwMinCodeSize <= 8),
|
|
219
|
-
firstFrame,
|
|
220
|
-
frames
|
|
221
|
-
};
|
|
222
|
-
}
|
|
223
|
-
function decodeFrames(bytes, metadata) {
|
|
224
|
-
if (!metadata.firstFrame || !metadata.lzwSupported) throw new Error("gif: no supported LZW image frame found");
|
|
225
|
-
const globalPalette = readPalette(bytes, 13, metadata.hasGlobalPalette ? 1 << (bytes[10] & 7) + 1 : 0);
|
|
226
|
-
const canvas = new Uint8Array(metadata.width * metadata.height * 4);
|
|
227
|
-
const frames = [];
|
|
228
|
-
for (const frame of metadata.frames) {
|
|
229
|
-
const restore = frame.graphicsControl?.disposalMethod === 3 ? canvas.slice() : null;
|
|
230
|
-
const palette = frame.localPalette || globalPalette;
|
|
231
|
-
const indices = decodeLzw(frame.compressed, frame.lzwMinCodeSize, frame.width * frame.height);
|
|
232
|
-
const rows = frame.interlaced ? interlacedRows(frame.height) : Array.from({
|
|
233
|
-
length: frame.height
|
|
234
|
-
}, (_, row) => row);
|
|
235
|
-
for (let sourceRow = 0; sourceRow < frame.height; sourceRow++) {
|
|
236
|
-
const targetRow = rows[sourceRow];
|
|
237
|
-
for (let x = 0; x < frame.width; x++) {
|
|
238
|
-
const index = indices[sourceRow * frame.width + x];
|
|
239
|
-
const targetX = frame.left + x;
|
|
240
|
-
const targetY = frame.top + targetRow;
|
|
241
|
-
if (targetX >= metadata.width || targetY >= metadata.height) continue;
|
|
242
|
-
if (frame.graphicsControl?.transparent && index === frame.graphicsControl.transparentIndex) continue;
|
|
243
|
-
const target = (targetY * metadata.width + targetX) * 4;
|
|
244
|
-
const color = palette[index] || [0, 0, 0];
|
|
245
|
-
canvas[target] = color[0];
|
|
246
|
-
canvas[target + 1] = color[1];
|
|
247
|
-
canvas[target + 2] = color[2];
|
|
248
|
-
canvas[target + 3] = 255;
|
|
249
|
-
}
|
|
250
|
-
}
|
|
251
|
-
frames.push({
|
|
252
|
-
index: frames.length,
|
|
253
|
-
delayCentiseconds: frame.graphicsControl?.delayCentiseconds || 0,
|
|
254
|
-
disposalMethod: frame.graphicsControl?.disposalMethod || 0,
|
|
255
|
-
data: canvas.slice()
|
|
256
|
-
});
|
|
257
|
-
const disposal = frame.graphicsControl?.disposalMethod || 0;
|
|
258
|
-
if (disposal === 2) canvas.fill(0);else if (disposal === 3 && restore) canvas.set(restore);
|
|
259
|
-
}
|
|
260
|
-
const data = frames[0].data;
|
|
261
|
-
return {
|
|
262
|
-
payloadType: "rgba",
|
|
263
|
-
sourceFormat: "gif",
|
|
264
|
-
mimeType: "image/gif",
|
|
265
|
-
containerOnly: false,
|
|
266
|
-
isDecoded: true,
|
|
267
|
-
rgbaDecodeSupported: true,
|
|
268
|
-
width: metadata.width,
|
|
269
|
-
height: metadata.height,
|
|
270
|
-
pixelFormat: "rgba8unorm",
|
|
271
|
-
data,
|
|
272
|
-
frames,
|
|
273
|
-
strideBytes: metadata.width * 4,
|
|
274
|
-
origin: "top-left",
|
|
275
|
-
colorSpace: "srgb",
|
|
276
|
-
alphaMode: "straight",
|
|
277
|
-
metadata
|
|
278
|
-
};
|
|
279
|
-
}
|
|
280
|
-
function decodeLzw(bytes, minimumCodeSize, expectedLength) {
|
|
281
|
-
const clear = 1 << minimumCodeSize;
|
|
282
|
-
const end = clear + 1;
|
|
283
|
-
let codeSize = minimumCodeSize + 1;
|
|
284
|
-
let dictionary = Array.from({
|
|
285
|
-
length: clear
|
|
286
|
-
}, (_, index) => [index]);
|
|
287
|
-
let bitOffset = 0;
|
|
288
|
-
let previous = null;
|
|
289
|
-
const output = [];
|
|
290
|
-
while (bitOffset + codeSize <= bytes.length * 8) {
|
|
291
|
-
let code = 0;
|
|
292
|
-
for (let bit = 0; bit < codeSize; bit++) {
|
|
293
|
-
code |= (bytes[bitOffset >>> 3] >>> (bitOffset & 7) & 1) << bit;
|
|
294
|
-
bitOffset++;
|
|
295
|
-
}
|
|
296
|
-
if (code === clear) {
|
|
297
|
-
dictionary = Array.from({
|
|
298
|
-
length: clear
|
|
299
|
-
}, (_, index) => [index]);
|
|
300
|
-
codeSize = minimumCodeSize + 1;
|
|
301
|
-
previous = null;
|
|
302
|
-
continue;
|
|
303
|
-
}
|
|
304
|
-
if (code === end) break;
|
|
305
|
-
let entry;
|
|
306
|
-
if (code < dictionary.length) entry = dictionary[code];else if (code === dictionary.length && previous) entry = previous.concat(previous[0]);else throw new Error("gif: invalid LZW code");
|
|
307
|
-
output.push(...entry);
|
|
308
|
-
if (previous) {
|
|
309
|
-
dictionary.push(previous.concat(entry[0]));
|
|
310
|
-
if (dictionary.length === 1 << codeSize && codeSize < 12) codeSize++;
|
|
311
|
-
}
|
|
312
|
-
previous = entry;
|
|
313
|
-
if (output.length >= expectedLength) break;
|
|
314
|
-
}
|
|
315
|
-
if (output.length < expectedLength) throw new Error("gif: LZW stream ended before the frame was filled");
|
|
316
|
-
return output.slice(0, expectedLength);
|
|
317
|
-
}
|
|
318
|
-
function readSubBlocks(bytes, offset) {
|
|
319
|
-
const output = [];
|
|
320
|
-
while (offset < bytes.length) {
|
|
321
|
-
if (offset >= bytes.length) throw new Error("gif: truncated sub-block sequence");
|
|
322
|
-
const length = bytes[offset++];
|
|
323
|
-
if (!length) return {
|
|
324
|
-
bytes: Uint8Array.from(output),
|
|
325
|
-
offset
|
|
326
|
-
};
|
|
327
|
-
if (offset + length > bytes.length) throw new Error("gif: truncated sub-block payload");
|
|
328
|
-
output.push(...bytes.subarray(offset, offset + length));
|
|
329
|
-
offset += length;
|
|
330
|
-
}
|
|
331
|
-
throw new Error("gif: truncated sub-block sequence");
|
|
332
|
-
}
|
|
333
|
-
function skipSubBlocks(bytes, offset) {
|
|
334
|
-
return readSubBlocks(bytes, offset).offset;
|
|
335
|
-
}
|
|
336
|
-
function readPalette(bytes, offset, count) {
|
|
337
|
-
const palette = [];
|
|
338
|
-
for (let i = 0; i < count; i++) {
|
|
339
|
-
if (offset + 3 > bytes.length) throw new Error("gif: truncated color table");
|
|
340
|
-
palette.push([bytes[offset], bytes[offset + 1], bytes[offset + 2]]);
|
|
341
|
-
offset += 3;
|
|
342
|
-
}
|
|
343
|
-
return palette;
|
|
344
|
-
}
|
|
345
|
-
function interlacedRows(height) {
|
|
346
|
-
const rows = [];
|
|
347
|
-
for (const [start, step] of [[0, 8], [4, 8], [2, 4], [1, 2]]) {
|
|
348
|
-
for (let row = start; row < height; row += step) rows.push(row);
|
|
349
|
-
}
|
|
350
|
-
return rows;
|
|
351
|
-
}
|
|
352
|
-
function ascii(bytes, offset, length) {
|
|
353
|
-
return String.fromCharCode(...bytes.subarray(offset, offset + length));
|
|
354
|
-
}
|
|
355
|
-
function readU16LE(bytes, offset) {
|
|
356
|
-
return bytes[offset] | bytes[offset + 1] << 8;
|
|
357
|
-
}
|
|
358
|
-
|
|
359
|
-
export { DEFAULT_VALUES, OUTPUT_IMAGE, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, inspectWithValues, isGIF, isSupportedWithValues, normalizeValues, readWithValues, toBytes, toJsonValue };
|
|
360
|
-
//# sourceMappingURL=helpers.js.map
|
|
1
|
+
const OUTPUT_IMAGE = "image";
|
|
2
|
+
const OUTPUT_RGBA = "rgba";
|
|
3
|
+
const OUTPUT_RAW = "raw";
|
|
4
|
+
const OUTPUT_JSON = "json";
|
|
5
|
+
const DEFAULT_VALUES = Object.freeze({
|
|
6
|
+
emit: OUTPUT_RAW,
|
|
7
|
+
inputType: "gif",
|
|
8
|
+
source: ""
|
|
9
|
+
});
|
|
10
|
+
function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsGifFormat") {
|
|
11
|
+
if (!options || typeof options !== "object" || Array.isArray(options)) {
|
|
12
|
+
throw new TypeError(`${readerName}: options must be an object`);
|
|
13
|
+
}
|
|
14
|
+
const allowed = new Set(["emit", "inputType", "source"]);
|
|
15
|
+
for (const key of Object.keys(options)) {
|
|
16
|
+
if (!allowed.has(key)) throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
|
|
17
|
+
}
|
|
18
|
+
const values = {
|
|
19
|
+
...DEFAULT_VALUES,
|
|
20
|
+
...(base || {}),
|
|
21
|
+
...options
|
|
22
|
+
};
|
|
23
|
+
if (![OUTPUT_IMAGE, OUTPUT_RGBA, OUTPUT_RAW, OUTPUT_JSON, "gifJson"].includes(values.emit)) {
|
|
24
|
+
throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(values.emit)}`);
|
|
25
|
+
}
|
|
26
|
+
return values;
|
|
27
|
+
}
|
|
28
|
+
function toBytes(input) {
|
|
29
|
+
if (input instanceof Uint8Array) return input;
|
|
30
|
+
if (input instanceof ArrayBuffer) return new Uint8Array(input);
|
|
31
|
+
if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
|
|
32
|
+
throw new TypeError("GIF input must be Uint8Array, ArrayBuffer, or a view");
|
|
33
|
+
}
|
|
34
|
+
function isGIF(bytes) {
|
|
35
|
+
return bytes.byteLength >= 13 && (ascii(bytes, 0, 6) === "GIF87a" || ascii(bytes, 0, 6) === "GIF89a");
|
|
36
|
+
}
|
|
37
|
+
function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "gif") {
|
|
38
|
+
const bytes = toBytes(input);
|
|
39
|
+
if (!isGIF(bytes)) throw new TypeError("CjsGifFormat: input is not a GIF87a/GIF89a image");
|
|
40
|
+
const metadata = inspectGif(bytes);
|
|
41
|
+
if (expectedType && metadata.sourceFormat !== expectedType) {
|
|
42
|
+
throw new TypeError(`CjsGifFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
|
|
43
|
+
}
|
|
44
|
+
return {
|
|
45
|
+
...metadata,
|
|
46
|
+
byteLength: bytes.byteLength,
|
|
47
|
+
source: values.source || "buffer"
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
function isSupportedWithValues(input, values = DEFAULT_VALUES) {
|
|
51
|
+
try {
|
|
52
|
+
const metadata = inspectWithValues(input, values);
|
|
53
|
+
const decoded = metadata.frameCount > 0 && metadata.lzwSupported;
|
|
54
|
+
return {
|
|
55
|
+
format: "gif",
|
|
56
|
+
source: values.source || "buffer",
|
|
57
|
+
supported: decoded ? "full" : "partial",
|
|
58
|
+
confidence: 1,
|
|
59
|
+
preferred: decoded ? "rgba8unorm" : "raw",
|
|
60
|
+
reason: decoded ? "GIF frame RGBA decode and compositing are available." : "GIF metadata/raw input is recognized but no decodable image frame was found.",
|
|
61
|
+
metadata,
|
|
62
|
+
variants: [{
|
|
63
|
+
kind: "rgba",
|
|
64
|
+
payloadType: "rgba",
|
|
65
|
+
codec: "rgba8unorm",
|
|
66
|
+
supported: decoded,
|
|
67
|
+
reason: decoded ? "" : "GIF LZW frame decode is unavailable.",
|
|
68
|
+
containerOnly: false,
|
|
69
|
+
isDecoded: decoded,
|
|
70
|
+
rgbaDecodeSupported: decoded
|
|
71
|
+
}, {
|
|
72
|
+
kind: "raw",
|
|
73
|
+
payloadType: "raw",
|
|
74
|
+
codec: "gif",
|
|
75
|
+
mimeType: "image/gif",
|
|
76
|
+
supported: true,
|
|
77
|
+
containerOnly: true,
|
|
78
|
+
isDecoded: false,
|
|
79
|
+
rgbaDecodeSupported: decoded
|
|
80
|
+
}],
|
|
81
|
+
warnings: [],
|
|
82
|
+
errors: []
|
|
83
|
+
};
|
|
84
|
+
} catch (error) {
|
|
85
|
+
return {
|
|
86
|
+
format: "gif",
|
|
87
|
+
source: values.source || "buffer",
|
|
88
|
+
supported: "none",
|
|
89
|
+
confidence: 0,
|
|
90
|
+
preferred: "",
|
|
91
|
+
reason: error.message,
|
|
92
|
+
metadata: null,
|
|
93
|
+
variants: [],
|
|
94
|
+
warnings: [],
|
|
95
|
+
errors: [error.message]
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
function readWithValues(input, values = DEFAULT_VALUES) {
|
|
100
|
+
const bytes = toBytes(input);
|
|
101
|
+
const metadata = inspectWithValues(bytes, values);
|
|
102
|
+
if (values.emit === OUTPUT_RAW) {
|
|
103
|
+
return {
|
|
104
|
+
payloadType: "raw",
|
|
105
|
+
sourceFormat: "gif",
|
|
106
|
+
mimeType: "image/gif",
|
|
107
|
+
containerOnly: true,
|
|
108
|
+
isDecoded: false,
|
|
109
|
+
rgbaDecodeSupported: metadata.frameCount > 0 && metadata.lzwSupported,
|
|
110
|
+
metadata,
|
|
111
|
+
bytes
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
if (values.emit === OUTPUT_JSON || values.emit === "gifJson") return metadata;
|
|
115
|
+
if (values.emit === OUTPUT_RGBA || values.emit === OUTPUT_IMAGE) {
|
|
116
|
+
return decodeFrames(bytes, metadata);
|
|
117
|
+
}
|
|
118
|
+
const error = new Error(`gif: emit "${values.emit}" is not implemented yet`);
|
|
119
|
+
error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
|
|
120
|
+
throw error;
|
|
121
|
+
}
|
|
122
|
+
function toJsonValue(value) {
|
|
123
|
+
if (value instanceof Uint8Array) return {
|
|
124
|
+
byteLength: value.byteLength
|
|
125
|
+
};
|
|
126
|
+
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
127
|
+
if (value && typeof value === "object") {
|
|
128
|
+
const output = {};
|
|
129
|
+
for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
|
|
130
|
+
return output;
|
|
131
|
+
}
|
|
132
|
+
return value;
|
|
133
|
+
}
|
|
134
|
+
function inspectGif(bytes) {
|
|
135
|
+
const width = readU16LE(bytes, 6);
|
|
136
|
+
const height = readU16LE(bytes, 8);
|
|
137
|
+
const packed = bytes[10];
|
|
138
|
+
const hasGlobalPalette = !!(packed & 0x80);
|
|
139
|
+
const globalPaletteCount = hasGlobalPalette ? 1 << (packed & 7) + 1 : 0;
|
|
140
|
+
if (hasGlobalPalette) readPalette(bytes, 13, globalPaletteCount);
|
|
141
|
+
let offset = 13 + globalPaletteCount * 3;
|
|
142
|
+
let frameCount = 0;
|
|
143
|
+
const frames = [];
|
|
144
|
+
let firstFrame = null;
|
|
145
|
+
let graphicsControl = null;
|
|
146
|
+
let loopCount = null;
|
|
147
|
+
while (offset < bytes.length) {
|
|
148
|
+
const marker = bytes[offset++];
|
|
149
|
+
if (marker === 0x3b) break;
|
|
150
|
+
if (marker === 0x21) {
|
|
151
|
+
const label = bytes[offset++];
|
|
152
|
+
if (label === 0xf9) {
|
|
153
|
+
if (bytes[offset++] !== 4) throw new Error("gif: invalid graphics control extension");
|
|
154
|
+
const control = bytes[offset++];
|
|
155
|
+
graphicsControl = {
|
|
156
|
+
disposalMethod: control >>> 2 & 7,
|
|
157
|
+
userInput: !!(control & 2),
|
|
158
|
+
transparent: !!(control & 1),
|
|
159
|
+
delayCentiseconds: readU16LE(bytes, offset)
|
|
160
|
+
};
|
|
161
|
+
offset += 2;
|
|
162
|
+
graphicsControl.transparentIndex = bytes[offset++];
|
|
163
|
+
if (bytes[offset++] !== 0) throw new Error("gif: unterminated graphics control extension");
|
|
164
|
+
} else if (label === 0xff) {
|
|
165
|
+
const size = bytes[offset++];
|
|
166
|
+
const application = ascii(bytes, offset, size);
|
|
167
|
+
offset += size;
|
|
168
|
+
const data = readSubBlocks(bytes, offset);
|
|
169
|
+
offset = data.offset;
|
|
170
|
+
if (application === "NETSCAPE2.0" || application === "ANIMEXTS1.0") {
|
|
171
|
+
if (data.bytes.length >= 3 && data.bytes[0] === 1) loopCount = readU16LE(data.bytes, 1);
|
|
172
|
+
}
|
|
173
|
+
} else {
|
|
174
|
+
offset = skipSubBlocks(bytes, offset);
|
|
175
|
+
}
|
|
176
|
+
} else if (marker === 0x2c) {
|
|
177
|
+
if (offset + 9 > bytes.length) throw new Error("gif: truncated image descriptor");
|
|
178
|
+
const frame = {
|
|
179
|
+
left: readU16LE(bytes, offset),
|
|
180
|
+
top: readU16LE(bytes, offset + 2),
|
|
181
|
+
width: readU16LE(bytes, offset + 4),
|
|
182
|
+
height: readU16LE(bytes, offset + 6),
|
|
183
|
+
packed: bytes[offset + 8],
|
|
184
|
+
graphicsControl
|
|
185
|
+
};
|
|
186
|
+
offset += 9;
|
|
187
|
+
const localPaletteCount = frame.packed & 0x80 ? 1 << (frame.packed & 7) + 1 : 0;
|
|
188
|
+
frame.localPalette = localPaletteCount ? readPalette(bytes, offset, localPaletteCount) : null;
|
|
189
|
+
offset += localPaletteCount * 3;
|
|
190
|
+
frame.lzwMinCodeSize = bytes[offset++];
|
|
191
|
+
const data = readSubBlocks(bytes, offset);
|
|
192
|
+
frame.compressed = data.bytes;
|
|
193
|
+
offset = data.offset;
|
|
194
|
+
frame.interlaced = !!(frame.packed & 0x40);
|
|
195
|
+
frameCount++;
|
|
196
|
+
frames.push(frame);
|
|
197
|
+
if (!firstFrame) firstFrame = frame;
|
|
198
|
+
graphicsControl = null;
|
|
199
|
+
} else if (marker === 0x00) {
|
|
200
|
+
throw new Error("gif: unexpected data before image descriptor");
|
|
201
|
+
} else {
|
|
202
|
+
throw new Error(`gif: unsupported block marker 0x${marker.toString(16)}`);
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
return {
|
|
206
|
+
payloadType: "image",
|
|
207
|
+
mediaTypes: ["image"],
|
|
208
|
+
sourceFormat: "gif",
|
|
209
|
+
version: ascii(bytes, 0, 6),
|
|
210
|
+
width,
|
|
211
|
+
height,
|
|
212
|
+
frameCount,
|
|
213
|
+
animated: frameCount > 1,
|
|
214
|
+
loopCount,
|
|
215
|
+
hasGlobalPalette,
|
|
216
|
+
backgroundColorIndex: bytes[11],
|
|
217
|
+
colorResolution: (packed >>> 4 & 7) + 1,
|
|
218
|
+
lzwSupported: frames.length > 0 && frames.every(frame => frame.lzwMinCodeSize >= 2 && frame.lzwMinCodeSize <= 8),
|
|
219
|
+
firstFrame,
|
|
220
|
+
frames
|
|
221
|
+
};
|
|
222
|
+
}
|
|
223
|
+
function decodeFrames(bytes, metadata) {
|
|
224
|
+
if (!metadata.firstFrame || !metadata.lzwSupported) throw new Error("gif: no supported LZW image frame found");
|
|
225
|
+
const globalPalette = readPalette(bytes, 13, metadata.hasGlobalPalette ? 1 << (bytes[10] & 7) + 1 : 0);
|
|
226
|
+
const canvas = new Uint8Array(metadata.width * metadata.height * 4);
|
|
227
|
+
const frames = [];
|
|
228
|
+
for (const frame of metadata.frames) {
|
|
229
|
+
const restore = frame.graphicsControl?.disposalMethod === 3 ? canvas.slice() : null;
|
|
230
|
+
const palette = frame.localPalette || globalPalette;
|
|
231
|
+
const indices = decodeLzw(frame.compressed, frame.lzwMinCodeSize, frame.width * frame.height);
|
|
232
|
+
const rows = frame.interlaced ? interlacedRows(frame.height) : Array.from({
|
|
233
|
+
length: frame.height
|
|
234
|
+
}, (_, row) => row);
|
|
235
|
+
for (let sourceRow = 0; sourceRow < frame.height; sourceRow++) {
|
|
236
|
+
const targetRow = rows[sourceRow];
|
|
237
|
+
for (let x = 0; x < frame.width; x++) {
|
|
238
|
+
const index = indices[sourceRow * frame.width + x];
|
|
239
|
+
const targetX = frame.left + x;
|
|
240
|
+
const targetY = frame.top + targetRow;
|
|
241
|
+
if (targetX >= metadata.width || targetY >= metadata.height) continue;
|
|
242
|
+
if (frame.graphicsControl?.transparent && index === frame.graphicsControl.transparentIndex) continue;
|
|
243
|
+
const target = (targetY * metadata.width + targetX) * 4;
|
|
244
|
+
const color = palette[index] || [0, 0, 0];
|
|
245
|
+
canvas[target] = color[0];
|
|
246
|
+
canvas[target + 1] = color[1];
|
|
247
|
+
canvas[target + 2] = color[2];
|
|
248
|
+
canvas[target + 3] = 255;
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
frames.push({
|
|
252
|
+
index: frames.length,
|
|
253
|
+
delayCentiseconds: frame.graphicsControl?.delayCentiseconds || 0,
|
|
254
|
+
disposalMethod: frame.graphicsControl?.disposalMethod || 0,
|
|
255
|
+
data: canvas.slice()
|
|
256
|
+
});
|
|
257
|
+
const disposal = frame.graphicsControl?.disposalMethod || 0;
|
|
258
|
+
if (disposal === 2) canvas.fill(0);else if (disposal === 3 && restore) canvas.set(restore);
|
|
259
|
+
}
|
|
260
|
+
const data = frames[0].data;
|
|
261
|
+
return {
|
|
262
|
+
payloadType: "rgba",
|
|
263
|
+
sourceFormat: "gif",
|
|
264
|
+
mimeType: "image/gif",
|
|
265
|
+
containerOnly: false,
|
|
266
|
+
isDecoded: true,
|
|
267
|
+
rgbaDecodeSupported: true,
|
|
268
|
+
width: metadata.width,
|
|
269
|
+
height: metadata.height,
|
|
270
|
+
pixelFormat: "rgba8unorm",
|
|
271
|
+
data,
|
|
272
|
+
frames,
|
|
273
|
+
strideBytes: metadata.width * 4,
|
|
274
|
+
origin: "top-left",
|
|
275
|
+
colorSpace: "srgb",
|
|
276
|
+
alphaMode: "straight",
|
|
277
|
+
metadata
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
function decodeLzw(bytes, minimumCodeSize, expectedLength) {
|
|
281
|
+
const clear = 1 << minimumCodeSize;
|
|
282
|
+
const end = clear + 1;
|
|
283
|
+
let codeSize = minimumCodeSize + 1;
|
|
284
|
+
let dictionary = Array.from({
|
|
285
|
+
length: clear
|
|
286
|
+
}, (_, index) => [index]);
|
|
287
|
+
let bitOffset = 0;
|
|
288
|
+
let previous = null;
|
|
289
|
+
const output = [];
|
|
290
|
+
while (bitOffset + codeSize <= bytes.length * 8) {
|
|
291
|
+
let code = 0;
|
|
292
|
+
for (let bit = 0; bit < codeSize; bit++) {
|
|
293
|
+
code |= (bytes[bitOffset >>> 3] >>> (bitOffset & 7) & 1) << bit;
|
|
294
|
+
bitOffset++;
|
|
295
|
+
}
|
|
296
|
+
if (code === clear) {
|
|
297
|
+
dictionary = Array.from({
|
|
298
|
+
length: clear
|
|
299
|
+
}, (_, index) => [index]);
|
|
300
|
+
codeSize = minimumCodeSize + 1;
|
|
301
|
+
previous = null;
|
|
302
|
+
continue;
|
|
303
|
+
}
|
|
304
|
+
if (code === end) break;
|
|
305
|
+
let entry;
|
|
306
|
+
if (code < dictionary.length) entry = dictionary[code];else if (code === dictionary.length && previous) entry = previous.concat(previous[0]);else throw new Error("gif: invalid LZW code");
|
|
307
|
+
output.push(...entry);
|
|
308
|
+
if (previous) {
|
|
309
|
+
dictionary.push(previous.concat(entry[0]));
|
|
310
|
+
if (dictionary.length === 1 << codeSize && codeSize < 12) codeSize++;
|
|
311
|
+
}
|
|
312
|
+
previous = entry;
|
|
313
|
+
if (output.length >= expectedLength) break;
|
|
314
|
+
}
|
|
315
|
+
if (output.length < expectedLength) throw new Error("gif: LZW stream ended before the frame was filled");
|
|
316
|
+
return output.slice(0, expectedLength);
|
|
317
|
+
}
|
|
318
|
+
function readSubBlocks(bytes, offset) {
|
|
319
|
+
const output = [];
|
|
320
|
+
while (offset < bytes.length) {
|
|
321
|
+
if (offset >= bytes.length) throw new Error("gif: truncated sub-block sequence");
|
|
322
|
+
const length = bytes[offset++];
|
|
323
|
+
if (!length) return {
|
|
324
|
+
bytes: Uint8Array.from(output),
|
|
325
|
+
offset
|
|
326
|
+
};
|
|
327
|
+
if (offset + length > bytes.length) throw new Error("gif: truncated sub-block payload");
|
|
328
|
+
output.push(...bytes.subarray(offset, offset + length));
|
|
329
|
+
offset += length;
|
|
330
|
+
}
|
|
331
|
+
throw new Error("gif: truncated sub-block sequence");
|
|
332
|
+
}
|
|
333
|
+
function skipSubBlocks(bytes, offset) {
|
|
334
|
+
return readSubBlocks(bytes, offset).offset;
|
|
335
|
+
}
|
|
336
|
+
function readPalette(bytes, offset, count) {
|
|
337
|
+
const palette = [];
|
|
338
|
+
for (let i = 0; i < count; i++) {
|
|
339
|
+
if (offset + 3 > bytes.length) throw new Error("gif: truncated color table");
|
|
340
|
+
palette.push([bytes[offset], bytes[offset + 1], bytes[offset + 2]]);
|
|
341
|
+
offset += 3;
|
|
342
|
+
}
|
|
343
|
+
return palette;
|
|
344
|
+
}
|
|
345
|
+
function interlacedRows(height) {
|
|
346
|
+
const rows = [];
|
|
347
|
+
for (const [start, step] of [[0, 8], [4, 8], [2, 4], [1, 2]]) {
|
|
348
|
+
for (let row = start; row < height; row += step) rows.push(row);
|
|
349
|
+
}
|
|
350
|
+
return rows;
|
|
351
|
+
}
|
|
352
|
+
function ascii(bytes, offset, length) {
|
|
353
|
+
return String.fromCharCode(...bytes.subarray(offset, offset + length));
|
|
354
|
+
}
|
|
355
|
+
function readU16LE(bytes, offset) {
|
|
356
|
+
return bytes[offset] | bytes[offset + 1] << 8;
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
export { DEFAULT_VALUES, OUTPUT_IMAGE, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_RGBA, inspectWithValues, isGIF, isSupportedWithValues, normalizeValues, readWithValues, toBytes, toJsonValue };
|
|
360
|
+
//# sourceMappingURL=helpers.js.map
|