@carbonenginejs/runtime-resource 0.7.0 → 0.8.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.
Files changed (219) hide show
  1. package/FORMAT-PROVENANCE.md +155 -144
  2. package/LICENSE +21 -21
  3. package/NOTICE +29 -29
  4. package/README.md +11 -0
  5. package/dist/CjsMotherLode.js +1271 -1271
  6. package/dist/CjsResMan.js +3005 -3005
  7. package/dist/CjsResManQueue.js +214 -214
  8. package/dist/CjsResource.js +566 -566
  9. package/dist/CjsResourceSource.js +59 -59
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +192 -192
  13. package/dist/format/CjsReader.js +18 -18
  14. package/dist/format/CjsResourceProbe.js +277 -277
  15. package/dist/format/payloadContract.js +173 -173
  16. package/dist/formats/black/CjsBlackFormat.js +278 -278
  17. package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
  18. package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
  19. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  20. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
  21. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
  22. package/dist/formats/black/core/blackConstants.js +7 -7
  23. package/dist/formats/black/core/blackDefinitions.js +10 -10
  24. package/dist/formats/black/core/blackEnums.js +6 -6
  25. package/dist/formats/black/core/blackSchema.js +3 -3
  26. package/dist/formats/black/core/blackVersion.js +22 -22
  27. package/dist/formats/black/core/helpers.js +182 -182
  28. package/dist/formats/black/core/schema.js +4 -4
  29. package/dist/formats/black/index.js +2 -2
  30. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  31. package/dist/formats/bnk/core/graph.js +140 -140
  32. package/dist/formats/bnk/core/helpers.js +409 -409
  33. package/dist/formats/bnk/core/musicNodes.js +489 -489
  34. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  35. package/dist/formats/bnk/index.js +2 -2
  36. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  37. package/dist/formats/cmf/core/binary.js +118 -118
  38. package/dist/formats/cmf/core/buffers.js +233 -233
  39. package/dist/formats/cmf/core/constants.js +47 -47
  40. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  41. package/dist/formats/cmf/core/helpers.js +287 -287
  42. package/dist/formats/cmf/core/pack.js +276 -276
  43. package/dist/formats/cmf/core/schema.js +364 -364
  44. package/dist/formats/cmf/core/shared.js +268 -268
  45. package/dist/formats/cmf/core/writer.js +517 -517
  46. package/dist/formats/cmf/index.js +2 -2
  47. package/dist/formats/dds/CjsDdsFormat.js +193 -193
  48. package/dist/formats/dds/core/bc6h.js +288 -0
  49. package/dist/formats/dds/core/bc6h.js.map +1 -0
  50. package/dist/formats/dds/core/bc7.js +251 -0
  51. package/dist/formats/dds/core/bc7.js.map +1 -0
  52. package/dist/formats/dds/core/helpers.js +815 -812
  53. package/dist/formats/dds/core/helpers.js.map +1 -1
  54. package/dist/formats/dds/index.js +2 -2
  55. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  56. package/dist/formats/fbx/core/helpers.js +3901 -3901
  57. package/dist/formats/fbx/index.js +2 -2
  58. package/dist/formats/flac/CjsFlacFormat.js +87 -87
  59. package/dist/formats/flac/core/helpers.js +295 -295
  60. package/dist/formats/flac/index.js +2 -2
  61. package/dist/formats/gif/CjsGifFormat.js +87 -87
  62. package/dist/formats/gif/core/helpers.js +360 -360
  63. package/dist/formats/gif/index.js +2 -2
  64. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  65. package/dist/formats/gltf/core/helpers.js +292 -292
  66. package/dist/formats/gltf/core/json.js +79 -79
  67. package/dist/formats/gltf/core/parser.js +666 -666
  68. package/dist/formats/gltf/core/targets.js +163 -163
  69. package/dist/formats/gltf/index.js +2 -2
  70. package/dist/formats/index.js +23 -23
  71. package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
  72. package/dist/formats/jpeg/core/helpers.js +350 -350
  73. package/dist/formats/jpeg/core/jpeg.js +377 -377
  74. package/dist/formats/jpeg/index.js +2 -2
  75. package/dist/formats/mp3/CjsMp3Format.js +192 -192
  76. package/dist/formats/mp3/core/helpers.js +338 -338
  77. package/dist/formats/mp3/index.js +2 -2
  78. package/dist/formats/mp4/CjsMp4Format.js +191 -191
  79. package/dist/formats/mp4/core/helpers.js +449 -449
  80. package/dist/formats/mp4/index.js +2 -2
  81. package/dist/formats/obj/CjsObjFormat.js +253 -253
  82. package/dist/formats/obj/core/helpers.js +573 -573
  83. package/dist/formats/obj/core/json.js +64 -64
  84. package/dist/formats/obj/core/parser.js +321 -321
  85. package/dist/formats/obj/index.js +2 -2
  86. package/dist/formats/ogg/CjsOggFormat.js +88 -88
  87. package/dist/formats/ogg/core/helpers.js +387 -387
  88. package/dist/formats/ogg/core/imdct.js +178 -178
  89. package/dist/formats/ogg/core/vorbis.js +999 -999
  90. package/dist/formats/ogg/index.js +2 -2
  91. package/dist/formats/png/CjsPngFormat.js +195 -195
  92. package/dist/formats/png/core/helpers.js +583 -583
  93. package/dist/formats/png/index.js +2 -2
  94. package/dist/formats/red/CjsRedFormat.js +261 -261
  95. package/dist/formats/red/core/CjsRedReader.js +194 -194
  96. package/dist/formats/red/core/blackDefinitions.js +3 -3
  97. package/dist/formats/red/core/helpers.js +139 -139
  98. package/dist/formats/red/core/redGraph.js +68 -68
  99. package/dist/formats/red/core/schema.js +4 -4
  100. package/dist/formats/red/index.js +2 -2
  101. package/dist/formats/stl/CjsStlFormat.js +365 -365
  102. package/dist/formats/stl/core/helpers.js +261 -261
  103. package/dist/formats/stl/core/json.js +51 -51
  104. package/dist/formats/stl/core/stl.js +629 -629
  105. package/dist/formats/stl/core/targets.js +163 -163
  106. package/dist/formats/stl/index.js +2 -2
  107. package/dist/formats/tga/CjsTgaFormat.js +192 -192
  108. package/dist/formats/tga/core/helpers.js +446 -446
  109. package/dist/formats/tga/index.js +2 -2
  110. package/dist/formats/wav/CjsWavFormat.js +192 -192
  111. package/dist/formats/wav/core/helpers.js +328 -328
  112. package/dist/formats/wav/index.js +2 -2
  113. package/dist/formats/webm/CjsWebmFormat.js +191 -191
  114. package/dist/formats/webm/core/helpers.js +537 -537
  115. package/dist/formats/webm/index.js +2 -2
  116. package/dist/formats/webp/CjsWebpFormat.js +86 -86
  117. package/dist/formats/webp/core/helpers.js +214 -214
  118. package/dist/formats/webp/index.js +2 -2
  119. package/dist/formats/wem/CjsWemFormat.js +241 -241
  120. package/dist/formats/wem/core/bitStream.js +259 -259
  121. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  122. package/dist/formats/wem/core/helpers.js +417 -417
  123. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  124. package/dist/formats/wem/core/ptadpcm.js +77 -77
  125. package/dist/formats/wem/core/resolve.js +121 -121
  126. package/dist/formats/wem/core/wemToOgg.js +485 -485
  127. package/dist/formats/wem/index.js +2 -2
  128. package/dist/formats/yaml/CjsYamlFormat.js +83 -83
  129. package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
  130. package/dist/formats/yaml/core/helpers.js +160 -160
  131. package/dist/formats/yaml/index.js +2 -2
  132. package/dist/index.js +48 -48
  133. package/dist/resourcePath.js +18 -18
  134. package/dist/resourceStates.js +9 -9
  135. package/dist/resources/AudioGeometryResData.js +47 -47
  136. package/dist/resources/GStateBindingCallbackData.js +31 -31
  137. package/dist/resources/MeshDecalData.js +37 -37
  138. package/dist/resources/MeshDecalLodData.js +34 -34
  139. package/dist/resources/Tr2EffectRes.js +71 -71
  140. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  141. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  142. package/dist/resources/Tr2ImageRes.js +114 -114
  143. package/dist/resources/Tr2LightProfileRes.js +40 -40
  144. package/dist/resources/Tr2MaterialArea.js +34 -34
  145. package/dist/resources/Tr2MaterialMesh.js +31 -31
  146. package/dist/resources/Tr2MaterialRes.js +34 -34
  147. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  148. package/dist/resources/Tr2TextureLodManager.js +80 -80
  149. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  150. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  151. package/dist/resources/Tr2TexturePipeline.js +52 -52
  152. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  153. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  154. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  155. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  156. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  157. package/dist/resources/TriGeometryRes.js +239 -216
  158. package/dist/resources/TriGeometryRes.js.map +1 -1
  159. package/dist/resources/TriGeometryResAreaData.js +59 -59
  160. package/dist/resources/TriGeometryResJointData.js +38 -38
  161. package/dist/resources/TriGeometryResLodData.js +88 -88
  162. package/dist/resources/TriGeometryResMeshData.js +63 -63
  163. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  164. package/dist/resources/TriGrannyRes.js +43 -43
  165. package/dist/resources/TriJointBinding.js +38 -38
  166. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  167. package/dist/resources/TriRtGeometryConstants.js +88 -88
  168. package/dist/resources/TriTextureRes.js +304 -304
  169. package/dist/resources/enums.js +18 -18
  170. package/dist/resources/resourceBoundary.js +47 -47
  171. package/dist/resources/texturePipelineBehavior.js +308 -308
  172. package/dist/texture/CjsTextureArrayRes.js +406 -406
  173. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  174. package/format-notices/black/LICENSE +21 -21
  175. package/format-notices/black/NOTICE +47 -47
  176. package/format-notices/bnk/LICENSE +21 -21
  177. package/format-notices/bnk/NOTICE +20 -20
  178. package/format-notices/cmf/LICENSE +21 -21
  179. package/format-notices/cmf/NOTICE +36 -36
  180. package/format-notices/dds/LICENSE +21 -21
  181. package/format-notices/dds/NOTICE +14 -14
  182. package/format-notices/fbx/LICENSE +21 -21
  183. package/format-notices/fbx/NOTICE +14 -14
  184. package/format-notices/flac/LICENSE +21 -21
  185. package/format-notices/flac/NOTICE +14 -14
  186. package/format-notices/gif/LICENSE +21 -21
  187. package/format-notices/gif/NOTICE +14 -14
  188. package/format-notices/gltf/LICENSE +21 -21
  189. package/format-notices/gltf/NOTICE +27 -27
  190. package/format-notices/jpeg/LICENSE +21 -21
  191. package/format-notices/jpeg/NOTICE +14 -14
  192. package/format-notices/mp3/LICENSE +21 -21
  193. package/format-notices/mp3/NOTICE +14 -14
  194. package/format-notices/mp4/LICENSE +21 -21
  195. package/format-notices/mp4/NOTICE +14 -14
  196. package/format-notices/obj/LICENSE +21 -21
  197. package/format-notices/obj/NOTICE +26 -26
  198. package/format-notices/ogg/LICENSE +21 -21
  199. package/format-notices/ogg/NOTICE +28 -28
  200. package/format-notices/png/LICENSE +21 -21
  201. package/format-notices/png/NOTICE +14 -14
  202. package/format-notices/red/LICENSE +21 -21
  203. package/format-notices/red/NOTICE +31 -31
  204. package/format-notices/stl/LICENSE +21 -21
  205. package/format-notices/stl/NOTICE +21 -21
  206. package/format-notices/tga/LICENSE +21 -21
  207. package/format-notices/tga/NOTICE +14 -14
  208. package/format-notices/wav/LICENSE +21 -21
  209. package/format-notices/wav/NOTICE +14 -14
  210. package/format-notices/webm/LICENSE +21 -21
  211. package/format-notices/webm/NOTICE +14 -14
  212. package/format-notices/webp/LICENSE +21 -21
  213. package/format-notices/webp/NOTICE +14 -14
  214. package/format-notices/wem/LICENSE +57 -57
  215. package/format-notices/wem/NOTICE +33 -33
  216. package/format-notices/yaml/LICENSE +21 -21
  217. package/format-notices/yaml/NOTICE +44 -44
  218. package/package.json +2 -2
  219. package/resource-lifecycle.md +679 -679
@@ -1,364 +1,364 @@
1
- import { STRUCT_SIZE, FILE_SIGNATURE, FILE_VERSION, SectionCompression, SectionType, MeshTopology, ElementType, Usage, AnimationChannelTargetType, Interpolation } from './constants.js';
2
- import { BinaryReader, crc32, enumName, readBounds, readVector3, readMatrix, readQuaternion } from './binary.js';
3
- import { decodeGeometrySync, decodeGeometryAsync } from './buffers.js';
4
-
5
- function readCmf(input, options = {}) {
6
- const reader = new BinaryReader(input);
7
- const header = readHeader(reader);
8
- validateHeader(reader, header, options);
9
- const dataSection = header.sections[0];
10
- const root = readData(reader, dataSection.offset);
11
- const metadataSection = header.sections.find(section => section.type === "Metadata");
12
- const metadata = metadataSection ? readMetadata(reader, metadataSection.offset) : null;
13
- const result = {
14
- signature: header.signature,
15
- version: header.version,
16
- headerSize: header.headerSize,
17
- crc32: header.crc32,
18
- sections: header.sections,
19
- metadata,
20
- meshes: root.meshes,
21
- skeletons: root.skeletons,
22
- animations: root.animations
23
- };
24
- return options.decodeBuffers ? decodeGeometrySync(result, reader.bytes) : result;
25
- }
26
- async function readCmfAsync(input, options = {}) {
27
- const reader = new BinaryReader(input);
28
- const header = readHeader(reader);
29
- validateHeader(reader, header, options);
30
- const dataSection = header.sections[0];
31
- const root = readData(reader, dataSection.offset);
32
- const metadataSection = header.sections.find(section => section.type === "Metadata");
33
- const metadata = metadataSection ? readMetadata(reader, metadataSection.offset) : null;
34
- const result = {
35
- signature: header.signature,
36
- version: header.version,
37
- headerSize: header.headerSize,
38
- crc32: header.crc32,
39
- sections: header.sections,
40
- metadata,
41
- meshes: root.meshes,
42
- skeletons: root.skeletons,
43
- animations: root.animations
44
- };
45
- return options.decodeBuffers ? await decodeGeometryAsync(result, reader.bytes) : result;
46
- }
47
- function readHeader(reader) {
48
- const signature = reader.u32(0);
49
- const version = reader.u32(4);
50
- const headerSize = reader.u32(8);
51
- const fileCrc32 = reader.u32(12);
52
- const sectionsSpan = readSpan(reader, 16, STRUCT_SIZE.Section);
53
- const sections = readArray(reader, sectionsSpan, readSection);
54
- return {
55
- signature,
56
- signatureText: "cmff",
57
- version,
58
- headerSize,
59
- crc32: fileCrc32,
60
- sections
61
- };
62
- }
63
- function inspectCmf(result) {
64
- return {
65
- signature: result.signature,
66
- version: result.version,
67
- headerSize: result.headerSize,
68
- crc32: result.crc32,
69
- sections: result.sections.map((section, index) => ({
70
- index,
71
- type: section.type,
72
- compression: section.compression,
73
- compressedSize: section.compressedSize,
74
- uncompressedSize: section.uncompressedSize,
75
- gpuAlignment: section.gpuAlignment
76
- })),
77
- metadataEntries: result.metadata?.entries.length ?? 0,
78
- meshes: result.meshes.map(mesh => ({
79
- name: mesh.name,
80
- topology: mesh.topology,
81
- lods: mesh.lods.length,
82
- areas: mesh.areas.length,
83
- vertexElements: mesh.decl.length,
84
- morphTargets: mesh.morphTargets.targets.length,
85
- skeleton: mesh.skeleton
86
- })),
87
- skeletons: result.skeletons.map(skeleton => ({
88
- name: skeleton.name,
89
- bones: skeleton.bones.length,
90
- boneMasks: skeleton.boneMasks.length
91
- })),
92
- animations: result.animations.map(animation => ({
93
- name: animation.name,
94
- duration: animation.duration,
95
- channels: animation.channels.length,
96
- curves: animation.curves.length
97
- }))
98
- };
99
- }
100
- function validateHeader(reader, header, options) {
101
- if (header.signature !== FILE_SIGNATURE) {
102
- throw new Error(`Invalid CMF signature 0x${header.signature.toString(16)}`);
103
- }
104
- if (header.version !== FILE_VERSION) {
105
- throw new Error(`Unsupported CMF version ${header.version}`);
106
- }
107
- if (header.headerSize > reader.bytes.byteLength) {
108
- throw new Error("CMF headerSize exceeds file size");
109
- }
110
- if (header.sections.length === 0) {
111
- throw new Error("CMF header contains no sections");
112
- }
113
- if (header.sections[0].type !== "Data") {
114
- throw new Error("CMF first section must be Data");
115
- }
116
- for (let i = 0; i < header.sections.length; i++) {
117
- const section = header.sections[i];
118
- if (section.offset + section.compressedSize > reader.bytes.byteLength) {
119
- throw new Error(`CMF section ${i} exceeds file bounds`);
120
- }
121
- if (section.type === "Metadata" && i !== header.sections.length - 1) {
122
- throw new Error("CMF Metadata section must be last");
123
- }
124
- }
125
- if (options.validateCrc !== false && header.crc32 !== 0) {
126
- const actual = crc32(reader.bytes, 16, reader.bytes.byteLength);
127
- if (actual !== header.crc32) {
128
- throw new Error(`CMF CRC mismatch: expected 0x${header.crc32.toString(16)}, got 0x${actual.toString(16)}`);
129
- }
130
- }
131
- }
132
- function readSection(reader, offset) {
133
- return {
134
- offset: reader.u32(offset),
135
- compressedSize: reader.u32(offset + 4),
136
- uncompressedSize: reader.u32(offset + 8),
137
- gpuAlignment: reader.u16(offset + 12),
138
- type: enumName(SectionType, reader.u8(offset + 14)),
139
- compression: enumName(SectionCompression, reader.u8(offset + 15))
140
- };
141
- }
142
- function readData(reader, offset) {
143
- return {
144
- meshes: readArray(reader, readSpan(reader, offset, STRUCT_SIZE.Mesh), readMesh),
145
- skeletons: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.Skeleton), readSkeleton),
146
- animations: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.Animation), readAnimation)
147
- };
148
- }
149
- function readMetadata(reader, offset) {
150
- return {
151
- entries: readArray(reader, readSpan(reader, offset, STRUCT_SIZE.MetadataEntry), readMetadataEntry)
152
- };
153
- }
154
- function readMetadataEntry(reader, offset) {
155
- return {
156
- key: readString(reader, offset),
157
- value: readString(reader, offset + 16)
158
- };
159
- }
160
- function readMesh(reader, offset) {
161
- return {
162
- name: readString(reader, offset),
163
- decl: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.VertexElement), readVertexElement),
164
- lods: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.MeshLod), readMeshLod),
165
- areas: readArray(reader, readSpan(reader, offset + 48, STRUCT_SIZE.MeshArea), readMeshArea),
166
- boneBindings: readArray(reader, readSpan(reader, offset + 64, STRUCT_SIZE.BoneBinding), readBoneBinding),
167
- morphTargets: readMorphTargets(reader, offset + 80),
168
- uvDensities: readFloatArray(reader, readSpan(reader, offset + 112, 4)),
169
- bounds: readBounds(reader, offset + 128),
170
- audioOcclusionMesh: readAudioOcclusionMesh(reader, offset + 152),
171
- topology: enumName(MeshTopology, reader.u8(offset + 208)),
172
- skeleton: readSkeletonIndex(reader.u8(offset + 209))
173
- };
174
- }
175
- function readVertexElement(reader, offset) {
176
- return {
177
- usage: enumName(Usage, reader.u8(offset)),
178
- usageIndex: reader.u8(offset + 1),
179
- type: enumName(ElementType, reader.u8(offset + 2)),
180
- elementCount: reader.u8(offset + 3),
181
- offset: reader.u32(offset + 4)
182
- };
183
- }
184
- function readMeshArea(reader, offset) {
185
- return {
186
- name: readString(reader, offset),
187
- bounds: readBounds(reader, offset + 16),
188
- bones: readUint16Array(reader, readSpan(reader, offset + 40, 2)),
189
- affectedByBones: !!reader.u8(offset + 56),
190
- affectedByMorphTargets: !!reader.u8(offset + 57)
191
- };
192
- }
193
- function readLodMeshArea(reader, offset) {
194
- return {
195
- firstElement: reader.u32(offset),
196
- elementCount: reader.u32(offset + 4)
197
- };
198
- }
199
- function readBoneBinding(reader, offset) {
200
- return {
201
- name: readString(reader, offset),
202
- bounds: readBounds(reader, offset + 16)
203
- };
204
- }
205
- function readMorphTargets(reader, offset) {
206
- return {
207
- decl: readArray(reader, readSpan(reader, offset, STRUCT_SIZE.VertexElement), readVertexElement),
208
- targets: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.MorphTarget), readMorphTarget)
209
- };
210
- }
211
- function readMorphTarget(reader, offset) {
212
- return {
213
- name: readString(reader, offset),
214
- maxDisplacement: reader.f32(offset + 16)
215
- };
216
- }
217
- function readMeshLod(reader, offset) {
218
- return {
219
- vb: readBufferView(reader, offset),
220
- ib: readBufferView(reader, offset + 16),
221
- areas: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.LodMeshArea), readLodMeshArea),
222
- morphTargets: readArray(reader, readSpan(reader, offset + 48, STRUCT_SIZE.LodMorphTarget), readLodMorphTarget),
223
- threshold: reader.u32(offset + 64)
224
- };
225
- }
226
- function readLodMorphTarget(reader, offset) {
227
- return {
228
- vb: readBufferView(reader, offset)
229
- };
230
- }
231
- function readAudioOcclusionMesh(reader, offset) {
232
- const verticesSpan = readSpan(reader, offset, 12);
233
- return {
234
- vertices: readArray(reader, verticesSpan, readVector3),
235
- indices: readUint16Array(reader, readSpan(reader, offset + 16, 2)),
236
- bounds: readBounds(reader, offset + 32)
237
- };
238
- }
239
- function readSkeleton(reader, offset) {
240
- return {
241
- name: readString(reader, offset),
242
- bones: readArray(reader, readSpan(reader, offset + 16, 16), readString),
243
- parents: readUint32Array(reader, readSpan(reader, offset + 32, 4)),
244
- restTransforms: readArray(reader, readSpan(reader, offset + 48, STRUCT_SIZE.Transform), readTransform),
245
- invBindTransforms: readArray(reader, readSpan(reader, offset + 64, 64), readMatrix),
246
- boneMasks: readArray(reader, readSpan(reader, offset + 80, STRUCT_SIZE.BoneMask), readBoneMask)
247
- };
248
- }
249
- function readTransform(reader, offset) {
250
- return {
251
- position: readVector3(reader, offset),
252
- rotation: readQuaternion(reader, offset + 12),
253
- scale: readVector3(reader, offset + 28)
254
- };
255
- }
256
- function readBoneMask(reader, offset) {
257
- return {
258
- name: readString(reader, offset),
259
- weights: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.BoneWeight), readBoneWeight)
260
- };
261
- }
262
- function readBoneWeight(reader, offset) {
263
- return {
264
- index: reader.u32(offset),
265
- weight: reader.f32(offset + 4)
266
- };
267
- }
268
- function readAnimation(reader, offset) {
269
- return {
270
- name: readString(reader, offset),
271
- channels: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.AnimationChannel), readAnimationChannel),
272
- curves: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.AnimationCurve), readAnimationCurve),
273
- duration: reader.f32(offset + 48)
274
- };
275
- }
276
- function readAnimationChannel(reader, offset) {
277
- return {
278
- target: readString(reader, offset),
279
- targetType: enumName(AnimationChannelTargetType, reader.u8(offset + 16)),
280
- curveIndex: reader.u32(offset + 20)
281
- };
282
- }
283
- function readAnimationCurve(reader, offset) {
284
- return {
285
- valueDimension: reader.u8(offset),
286
- interpolation: enumName(Interpolation, reader.u8(offset + 1)),
287
- knotType: enumName(ElementType, reader.u8(offset + 2)),
288
- valueType: enumName(ElementType, reader.u8(offset + 3)),
289
- knotCount: reader.u32(offset + 4),
290
- knots: readByteArray(reader, readSpan(reader, offset + 8, 1)),
291
- values: readByteArray(reader, readSpan(reader, offset + 24, 1))
292
- };
293
- }
294
- function readBufferView(reader, offset) {
295
- return {
296
- index: reader.u32(offset),
297
- offset: reader.u32(offset + 4),
298
- size: reader.u32(offset + 8),
299
- stride: reader.u32(offset + 12)
300
- };
301
- }
302
- function readSpan(reader, offset, elementSize) {
303
- const rawOffset = reader.i64(offset);
304
- const byteSize = reader.u64(offset + 8);
305
- const isOffset = (rawOffset & 1) !== 0;
306
- const dataOffset = byteSize === 0 ? null : isOffset ? offset + (rawOffset & -2) : rawOffset;
307
- if (byteSize % elementSize !== 0) {
308
- throw new Error(`CMF span byteSize ${byteSize} is not a multiple of element size ${elementSize}`);
309
- }
310
- if (dataOffset !== null) {
311
- reader.require(dataOffset, byteSize, "span");
312
- }
313
- return {
314
- offset: dataOffset,
315
- byteSize,
316
- count: byteSize / elementSize,
317
- elementSize,
318
- addressMode: isOffset ? "offset" : "pointer"
319
- };
320
- }
321
- function readArray(reader, span, readElement) {
322
- const values = [];
323
- if (span.count === 0) {
324
- return values;
325
- }
326
- for (let i = 0; i < span.count; i++) {
327
- values.push(readElement(reader, span.offset + i * span.elementSize));
328
- }
329
- return values;
330
- }
331
- function readString(reader, offset) {
332
- const span = readSpan(reader, offset, 1);
333
- return span.offset === null ? "" : reader.string(span.offset, span.byteSize);
334
- }
335
- function readByteArray(reader, span) {
336
- return span.offset === null ? [] : Array.from(reader.bytesAt(span.offset, span.byteSize));
337
- }
338
- function readUint16Array(reader, span) {
339
- const values = [];
340
- for (let i = 0; i < span.count; i++) {
341
- values.push(reader.u16(span.offset + i * 2));
342
- }
343
- return values;
344
- }
345
- function readUint32Array(reader, span) {
346
- const values = [];
347
- for (let i = 0; i < span.count; i++) {
348
- values.push(reader.u32(span.offset + i * 4));
349
- }
350
- return values;
351
- }
352
- function readFloatArray(reader, span) {
353
- const values = [];
354
- for (let i = 0; i < span.count; i++) {
355
- values.push(reader.f32(span.offset + i * 4));
356
- }
357
- return values;
358
- }
359
- function readSkeletonIndex(value) {
360
- return value === 0xff ? null : value;
361
- }
362
-
363
- export { inspectCmf, readCmf, readCmfAsync, readHeader };
364
- //# sourceMappingURL=schema.js.map
1
+ import { STRUCT_SIZE, FILE_SIGNATURE, FILE_VERSION, SectionCompression, SectionType, MeshTopology, ElementType, Usage, AnimationChannelTargetType, Interpolation } from './constants.js';
2
+ import { BinaryReader, crc32, enumName, readBounds, readVector3, readMatrix, readQuaternion } from './binary.js';
3
+ import { decodeGeometrySync, decodeGeometryAsync } from './buffers.js';
4
+
5
+ function readCmf(input, options = {}) {
6
+ const reader = new BinaryReader(input);
7
+ const header = readHeader(reader);
8
+ validateHeader(reader, header, options);
9
+ const dataSection = header.sections[0];
10
+ const root = readData(reader, dataSection.offset);
11
+ const metadataSection = header.sections.find(section => section.type === "Metadata");
12
+ const metadata = metadataSection ? readMetadata(reader, metadataSection.offset) : null;
13
+ const result = {
14
+ signature: header.signature,
15
+ version: header.version,
16
+ headerSize: header.headerSize,
17
+ crc32: header.crc32,
18
+ sections: header.sections,
19
+ metadata,
20
+ meshes: root.meshes,
21
+ skeletons: root.skeletons,
22
+ animations: root.animations
23
+ };
24
+ return options.decodeBuffers ? decodeGeometrySync(result, reader.bytes) : result;
25
+ }
26
+ async function readCmfAsync(input, options = {}) {
27
+ const reader = new BinaryReader(input);
28
+ const header = readHeader(reader);
29
+ validateHeader(reader, header, options);
30
+ const dataSection = header.sections[0];
31
+ const root = readData(reader, dataSection.offset);
32
+ const metadataSection = header.sections.find(section => section.type === "Metadata");
33
+ const metadata = metadataSection ? readMetadata(reader, metadataSection.offset) : null;
34
+ const result = {
35
+ signature: header.signature,
36
+ version: header.version,
37
+ headerSize: header.headerSize,
38
+ crc32: header.crc32,
39
+ sections: header.sections,
40
+ metadata,
41
+ meshes: root.meshes,
42
+ skeletons: root.skeletons,
43
+ animations: root.animations
44
+ };
45
+ return options.decodeBuffers ? await decodeGeometryAsync(result, reader.bytes) : result;
46
+ }
47
+ function readHeader(reader) {
48
+ const signature = reader.u32(0);
49
+ const version = reader.u32(4);
50
+ const headerSize = reader.u32(8);
51
+ const fileCrc32 = reader.u32(12);
52
+ const sectionsSpan = readSpan(reader, 16, STRUCT_SIZE.Section);
53
+ const sections = readArray(reader, sectionsSpan, readSection);
54
+ return {
55
+ signature,
56
+ signatureText: "cmff",
57
+ version,
58
+ headerSize,
59
+ crc32: fileCrc32,
60
+ sections
61
+ };
62
+ }
63
+ function inspectCmf(result) {
64
+ return {
65
+ signature: result.signature,
66
+ version: result.version,
67
+ headerSize: result.headerSize,
68
+ crc32: result.crc32,
69
+ sections: result.sections.map((section, index) => ({
70
+ index,
71
+ type: section.type,
72
+ compression: section.compression,
73
+ compressedSize: section.compressedSize,
74
+ uncompressedSize: section.uncompressedSize,
75
+ gpuAlignment: section.gpuAlignment
76
+ })),
77
+ metadataEntries: result.metadata?.entries.length ?? 0,
78
+ meshes: result.meshes.map(mesh => ({
79
+ name: mesh.name,
80
+ topology: mesh.topology,
81
+ lods: mesh.lods.length,
82
+ areas: mesh.areas.length,
83
+ vertexElements: mesh.decl.length,
84
+ morphTargets: mesh.morphTargets.targets.length,
85
+ skeleton: mesh.skeleton
86
+ })),
87
+ skeletons: result.skeletons.map(skeleton => ({
88
+ name: skeleton.name,
89
+ bones: skeleton.bones.length,
90
+ boneMasks: skeleton.boneMasks.length
91
+ })),
92
+ animations: result.animations.map(animation => ({
93
+ name: animation.name,
94
+ duration: animation.duration,
95
+ channels: animation.channels.length,
96
+ curves: animation.curves.length
97
+ }))
98
+ };
99
+ }
100
+ function validateHeader(reader, header, options) {
101
+ if (header.signature !== FILE_SIGNATURE) {
102
+ throw new Error(`Invalid CMF signature 0x${header.signature.toString(16)}`);
103
+ }
104
+ if (header.version !== FILE_VERSION) {
105
+ throw new Error(`Unsupported CMF version ${header.version}`);
106
+ }
107
+ if (header.headerSize > reader.bytes.byteLength) {
108
+ throw new Error("CMF headerSize exceeds file size");
109
+ }
110
+ if (header.sections.length === 0) {
111
+ throw new Error("CMF header contains no sections");
112
+ }
113
+ if (header.sections[0].type !== "Data") {
114
+ throw new Error("CMF first section must be Data");
115
+ }
116
+ for (let i = 0; i < header.sections.length; i++) {
117
+ const section = header.sections[i];
118
+ if (section.offset + section.compressedSize > reader.bytes.byteLength) {
119
+ throw new Error(`CMF section ${i} exceeds file bounds`);
120
+ }
121
+ if (section.type === "Metadata" && i !== header.sections.length - 1) {
122
+ throw new Error("CMF Metadata section must be last");
123
+ }
124
+ }
125
+ if (options.validateCrc !== false && header.crc32 !== 0) {
126
+ const actual = crc32(reader.bytes, 16, reader.bytes.byteLength);
127
+ if (actual !== header.crc32) {
128
+ throw new Error(`CMF CRC mismatch: expected 0x${header.crc32.toString(16)}, got 0x${actual.toString(16)}`);
129
+ }
130
+ }
131
+ }
132
+ function readSection(reader, offset) {
133
+ return {
134
+ offset: reader.u32(offset),
135
+ compressedSize: reader.u32(offset + 4),
136
+ uncompressedSize: reader.u32(offset + 8),
137
+ gpuAlignment: reader.u16(offset + 12),
138
+ type: enumName(SectionType, reader.u8(offset + 14)),
139
+ compression: enumName(SectionCompression, reader.u8(offset + 15))
140
+ };
141
+ }
142
+ function readData(reader, offset) {
143
+ return {
144
+ meshes: readArray(reader, readSpan(reader, offset, STRUCT_SIZE.Mesh), readMesh),
145
+ skeletons: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.Skeleton), readSkeleton),
146
+ animations: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.Animation), readAnimation)
147
+ };
148
+ }
149
+ function readMetadata(reader, offset) {
150
+ return {
151
+ entries: readArray(reader, readSpan(reader, offset, STRUCT_SIZE.MetadataEntry), readMetadataEntry)
152
+ };
153
+ }
154
+ function readMetadataEntry(reader, offset) {
155
+ return {
156
+ key: readString(reader, offset),
157
+ value: readString(reader, offset + 16)
158
+ };
159
+ }
160
+ function readMesh(reader, offset) {
161
+ return {
162
+ name: readString(reader, offset),
163
+ decl: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.VertexElement), readVertexElement),
164
+ lods: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.MeshLod), readMeshLod),
165
+ areas: readArray(reader, readSpan(reader, offset + 48, STRUCT_SIZE.MeshArea), readMeshArea),
166
+ boneBindings: readArray(reader, readSpan(reader, offset + 64, STRUCT_SIZE.BoneBinding), readBoneBinding),
167
+ morphTargets: readMorphTargets(reader, offset + 80),
168
+ uvDensities: readFloatArray(reader, readSpan(reader, offset + 112, 4)),
169
+ bounds: readBounds(reader, offset + 128),
170
+ audioOcclusionMesh: readAudioOcclusionMesh(reader, offset + 152),
171
+ topology: enumName(MeshTopology, reader.u8(offset + 208)),
172
+ skeleton: readSkeletonIndex(reader.u8(offset + 209))
173
+ };
174
+ }
175
+ function readVertexElement(reader, offset) {
176
+ return {
177
+ usage: enumName(Usage, reader.u8(offset)),
178
+ usageIndex: reader.u8(offset + 1),
179
+ type: enumName(ElementType, reader.u8(offset + 2)),
180
+ elementCount: reader.u8(offset + 3),
181
+ offset: reader.u32(offset + 4)
182
+ };
183
+ }
184
+ function readMeshArea(reader, offset) {
185
+ return {
186
+ name: readString(reader, offset),
187
+ bounds: readBounds(reader, offset + 16),
188
+ bones: readUint16Array(reader, readSpan(reader, offset + 40, 2)),
189
+ affectedByBones: !!reader.u8(offset + 56),
190
+ affectedByMorphTargets: !!reader.u8(offset + 57)
191
+ };
192
+ }
193
+ function readLodMeshArea(reader, offset) {
194
+ return {
195
+ firstElement: reader.u32(offset),
196
+ elementCount: reader.u32(offset + 4)
197
+ };
198
+ }
199
+ function readBoneBinding(reader, offset) {
200
+ return {
201
+ name: readString(reader, offset),
202
+ bounds: readBounds(reader, offset + 16)
203
+ };
204
+ }
205
+ function readMorphTargets(reader, offset) {
206
+ return {
207
+ decl: readArray(reader, readSpan(reader, offset, STRUCT_SIZE.VertexElement), readVertexElement),
208
+ targets: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.MorphTarget), readMorphTarget)
209
+ };
210
+ }
211
+ function readMorphTarget(reader, offset) {
212
+ return {
213
+ name: readString(reader, offset),
214
+ maxDisplacement: reader.f32(offset + 16)
215
+ };
216
+ }
217
+ function readMeshLod(reader, offset) {
218
+ return {
219
+ vb: readBufferView(reader, offset),
220
+ ib: readBufferView(reader, offset + 16),
221
+ areas: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.LodMeshArea), readLodMeshArea),
222
+ morphTargets: readArray(reader, readSpan(reader, offset + 48, STRUCT_SIZE.LodMorphTarget), readLodMorphTarget),
223
+ threshold: reader.u32(offset + 64)
224
+ };
225
+ }
226
+ function readLodMorphTarget(reader, offset) {
227
+ return {
228
+ vb: readBufferView(reader, offset)
229
+ };
230
+ }
231
+ function readAudioOcclusionMesh(reader, offset) {
232
+ const verticesSpan = readSpan(reader, offset, 12);
233
+ return {
234
+ vertices: readArray(reader, verticesSpan, readVector3),
235
+ indices: readUint16Array(reader, readSpan(reader, offset + 16, 2)),
236
+ bounds: readBounds(reader, offset + 32)
237
+ };
238
+ }
239
+ function readSkeleton(reader, offset) {
240
+ return {
241
+ name: readString(reader, offset),
242
+ bones: readArray(reader, readSpan(reader, offset + 16, 16), readString),
243
+ parents: readUint32Array(reader, readSpan(reader, offset + 32, 4)),
244
+ restTransforms: readArray(reader, readSpan(reader, offset + 48, STRUCT_SIZE.Transform), readTransform),
245
+ invBindTransforms: readArray(reader, readSpan(reader, offset + 64, 64), readMatrix),
246
+ boneMasks: readArray(reader, readSpan(reader, offset + 80, STRUCT_SIZE.BoneMask), readBoneMask)
247
+ };
248
+ }
249
+ function readTransform(reader, offset) {
250
+ return {
251
+ position: readVector3(reader, offset),
252
+ rotation: readQuaternion(reader, offset + 12),
253
+ scale: readVector3(reader, offset + 28)
254
+ };
255
+ }
256
+ function readBoneMask(reader, offset) {
257
+ return {
258
+ name: readString(reader, offset),
259
+ weights: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.BoneWeight), readBoneWeight)
260
+ };
261
+ }
262
+ function readBoneWeight(reader, offset) {
263
+ return {
264
+ index: reader.u32(offset),
265
+ weight: reader.f32(offset + 4)
266
+ };
267
+ }
268
+ function readAnimation(reader, offset) {
269
+ return {
270
+ name: readString(reader, offset),
271
+ channels: readArray(reader, readSpan(reader, offset + 16, STRUCT_SIZE.AnimationChannel), readAnimationChannel),
272
+ curves: readArray(reader, readSpan(reader, offset + 32, STRUCT_SIZE.AnimationCurve), readAnimationCurve),
273
+ duration: reader.f32(offset + 48)
274
+ };
275
+ }
276
+ function readAnimationChannel(reader, offset) {
277
+ return {
278
+ target: readString(reader, offset),
279
+ targetType: enumName(AnimationChannelTargetType, reader.u8(offset + 16)),
280
+ curveIndex: reader.u32(offset + 20)
281
+ };
282
+ }
283
+ function readAnimationCurve(reader, offset) {
284
+ return {
285
+ valueDimension: reader.u8(offset),
286
+ interpolation: enumName(Interpolation, reader.u8(offset + 1)),
287
+ knotType: enumName(ElementType, reader.u8(offset + 2)),
288
+ valueType: enumName(ElementType, reader.u8(offset + 3)),
289
+ knotCount: reader.u32(offset + 4),
290
+ knots: readByteArray(reader, readSpan(reader, offset + 8, 1)),
291
+ values: readByteArray(reader, readSpan(reader, offset + 24, 1))
292
+ };
293
+ }
294
+ function readBufferView(reader, offset) {
295
+ return {
296
+ index: reader.u32(offset),
297
+ offset: reader.u32(offset + 4),
298
+ size: reader.u32(offset + 8),
299
+ stride: reader.u32(offset + 12)
300
+ };
301
+ }
302
+ function readSpan(reader, offset, elementSize) {
303
+ const rawOffset = reader.i64(offset);
304
+ const byteSize = reader.u64(offset + 8);
305
+ const isOffset = (rawOffset & 1) !== 0;
306
+ const dataOffset = byteSize === 0 ? null : isOffset ? offset + (rawOffset & -2) : rawOffset;
307
+ if (byteSize % elementSize !== 0) {
308
+ throw new Error(`CMF span byteSize ${byteSize} is not a multiple of element size ${elementSize}`);
309
+ }
310
+ if (dataOffset !== null) {
311
+ reader.require(dataOffset, byteSize, "span");
312
+ }
313
+ return {
314
+ offset: dataOffset,
315
+ byteSize,
316
+ count: byteSize / elementSize,
317
+ elementSize,
318
+ addressMode: isOffset ? "offset" : "pointer"
319
+ };
320
+ }
321
+ function readArray(reader, span, readElement) {
322
+ const values = [];
323
+ if (span.count === 0) {
324
+ return values;
325
+ }
326
+ for (let i = 0; i < span.count; i++) {
327
+ values.push(readElement(reader, span.offset + i * span.elementSize));
328
+ }
329
+ return values;
330
+ }
331
+ function readString(reader, offset) {
332
+ const span = readSpan(reader, offset, 1);
333
+ return span.offset === null ? "" : reader.string(span.offset, span.byteSize);
334
+ }
335
+ function readByteArray(reader, span) {
336
+ return span.offset === null ? [] : Array.from(reader.bytesAt(span.offset, span.byteSize));
337
+ }
338
+ function readUint16Array(reader, span) {
339
+ const values = [];
340
+ for (let i = 0; i < span.count; i++) {
341
+ values.push(reader.u16(span.offset + i * 2));
342
+ }
343
+ return values;
344
+ }
345
+ function readUint32Array(reader, span) {
346
+ const values = [];
347
+ for (let i = 0; i < span.count; i++) {
348
+ values.push(reader.u32(span.offset + i * 4));
349
+ }
350
+ return values;
351
+ }
352
+ function readFloatArray(reader, span) {
353
+ const values = [];
354
+ for (let i = 0; i < span.count; i++) {
355
+ values.push(reader.f32(span.offset + i * 4));
356
+ }
357
+ return values;
358
+ }
359
+ function readSkeletonIndex(value) {
360
+ return value === 0xff ? null : value;
361
+ }
362
+
363
+ export { inspectCmf, readCmf, readCmfAsync, readHeader };
364
+ //# sourceMappingURL=schema.js.map