@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.
Files changed (297) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +31 -29
  3. package/README.md +67 -548
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3005 -3005
  6. package/dist/CjsResManQueue.js +214 -214
  7. package/dist/CjsResource.js +566 -566
  8. package/dist/CjsResourceSource.js +68 -59
  9. package/dist/CjsResourceSource.js.map +1 -1
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +197 -192
  13. package/dist/format/CjsFormat.js.map +1 -1
  14. package/dist/format/CjsReader.js +18 -18
  15. package/dist/format/CjsResourceProbe.js +277 -277
  16. package/dist/format/payloadContract.js +173 -173
  17. package/dist/formats/black/CjsBlackFormat.js +278 -278
  18. package/dist/formats/black/core/CjsBlackBinaryReader.js +157 -153
  19. package/dist/formats/black/core/CjsBlackBinaryReader.js.map +1 -1
  20. package/dist/formats/black/core/CjsBlackPropertyReaders.js +387 -382
  21. package/dist/formats/black/core/CjsBlackPropertyReaders.js.map +1 -1
  22. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  23. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +437 -433
  24. package/dist/formats/black/core/CjsBlackSchemaRegistry.js.map +1 -1
  25. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -0
  26. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js.map +1 -0
  27. package/dist/formats/black/core/blackConstants.js +7 -7
  28. package/dist/formats/black/core/blackDefinitions.js +10 -10
  29. package/dist/formats/black/core/blackDefinitions.js.map +1 -1
  30. package/dist/formats/black/core/blackEnums.js +6 -6
  31. package/dist/formats/black/core/blackSchema.js +3 -3
  32. package/dist/formats/black/core/blackVersion.js +22 -22
  33. package/dist/formats/black/core/helpers.js +182 -182
  34. package/dist/formats/black/core/schema.js +4 -4
  35. package/dist/formats/black/index.js +2 -2
  36. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  37. package/dist/formats/bnk/core/graph.js +140 -140
  38. package/dist/formats/bnk/core/helpers.js +409 -409
  39. package/dist/formats/bnk/core/musicNodes.js +493 -489
  40. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  41. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  42. package/dist/formats/bnk/index.js +2 -2
  43. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  44. package/dist/formats/cmf/core/binary.js +123 -118
  45. package/dist/formats/cmf/core/binary.js.map +1 -1
  46. package/dist/formats/cmf/core/buffers.js +233 -233
  47. package/dist/formats/cmf/core/constants.js +47 -47
  48. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  49. package/dist/formats/cmf/core/helpers.js +287 -287
  50. package/dist/formats/cmf/core/pack.js +276 -276
  51. package/dist/formats/cmf/core/schema.js +364 -364
  52. package/dist/formats/cmf/core/shared.js +268 -268
  53. package/dist/formats/cmf/core/writer.js +517 -517
  54. package/dist/formats/cmf/index.js +2 -2
  55. package/dist/formats/dds/CjsDdsFormat.js +200 -193
  56. package/dist/formats/dds/CjsDdsFormat.js.map +1 -1
  57. package/dist/formats/dds/core/bc6h.js +288 -288
  58. package/dist/formats/dds/core/bc7.js +256 -251
  59. package/dist/formats/dds/core/bc7.js.map +1 -1
  60. package/dist/formats/dds/core/helpers.js +815 -815
  61. package/dist/formats/dds/index.js +2 -2
  62. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  63. package/dist/formats/fbx/core/helpers.js +3911 -3901
  64. package/dist/formats/fbx/core/helpers.js.map +1 -1
  65. package/dist/formats/fbx/index.js +2 -2
  66. package/dist/formats/flac/CjsFlacFormat.js +93 -87
  67. package/dist/formats/flac/CjsFlacFormat.js.map +1 -1
  68. package/dist/formats/flac/core/helpers.js +295 -295
  69. package/dist/formats/flac/index.js +2 -2
  70. package/dist/formats/gif/CjsGifFormat.js +92 -87
  71. package/dist/formats/gif/CjsGifFormat.js.map +1 -1
  72. package/dist/formats/gif/core/helpers.js +360 -360
  73. package/dist/formats/gif/index.js +2 -2
  74. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  75. package/dist/formats/gltf/core/helpers.js +292 -292
  76. package/dist/formats/gltf/core/json.js +79 -79
  77. package/dist/formats/gltf/core/parser.js +666 -666
  78. package/dist/formats/gltf/core/targets.js +163 -163
  79. package/dist/formats/gltf/index.js +2 -2
  80. package/dist/formats/gr2/CjsGr2Format.js +46 -0
  81. package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
  82. package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
  83. package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
  84. package/dist/formats/gr2/core/bitknit2.js +280 -0
  85. package/dist/formats/gr2/core/bitknit2.js.map +1 -0
  86. package/dist/formats/gr2/core/curves.js +1047 -0
  87. package/dist/formats/gr2/core/curves.js.map +1 -0
  88. package/dist/formats/gr2/core/gsf.js +72 -0
  89. package/dist/formats/gr2/core/gsf.js.map +1 -0
  90. package/dist/formats/gr2/core/helpers.js +332 -0
  91. package/dist/formats/gr2/core/helpers.js.map +1 -0
  92. package/dist/formats/gr2/core/json.js +622 -0
  93. package/dist/formats/gr2/core/json.js.map +1 -0
  94. package/dist/formats/gr2/core/oodle1.js +388 -0
  95. package/dist/formats/gr2/core/oodle1.js.map +1 -0
  96. package/dist/formats/gr2/core/reader.js +617 -0
  97. package/dist/formats/gr2/core/reader.js.map +1 -0
  98. package/dist/formats/gr2/core/tangents.js +48 -0
  99. package/dist/formats/gr2/core/tangents.js.map +1 -0
  100. package/dist/formats/gr2/core/targets.js +351 -0
  101. package/dist/formats/gr2/core/targets.js.map +1 -0
  102. package/dist/formats/gr2/index.js +3 -0
  103. package/dist/formats/gr2/index.js.map +1 -0
  104. package/dist/formats/index.js +30 -23
  105. package/dist/formats/index.js.map +1 -1
  106. package/dist/formats/jpeg/CjsJpegFormat.js +212 -206
  107. package/dist/formats/jpeg/CjsJpegFormat.js.map +1 -1
  108. package/dist/formats/jpeg/core/helpers.js +350 -350
  109. package/dist/formats/jpeg/core/jpeg.js +387 -377
  110. package/dist/formats/jpeg/core/jpeg.js.map +1 -1
  111. package/dist/formats/jpeg/index.js +2 -2
  112. package/dist/formats/mp3/CjsMp3Format.js +197 -192
  113. package/dist/formats/mp3/CjsMp3Format.js.map +1 -1
  114. package/dist/formats/mp3/core/helpers.js +338 -338
  115. package/dist/formats/mp3/index.js +2 -2
  116. package/dist/formats/mp4/CjsMp4Format.js +197 -191
  117. package/dist/formats/mp4/CjsMp4Format.js.map +1 -1
  118. package/dist/formats/mp4/core/helpers.js +449 -449
  119. package/dist/formats/mp4/index.js +2 -2
  120. package/dist/formats/obj/CjsObjFormat.js +253 -253
  121. package/dist/formats/obj/core/helpers.js +573 -573
  122. package/dist/formats/obj/core/json.js +64 -64
  123. package/dist/formats/obj/core/parser.js +321 -321
  124. package/dist/formats/obj/index.js +2 -2
  125. package/dist/formats/ogg/CjsOggFormat.js +94 -88
  126. package/dist/formats/ogg/CjsOggFormat.js.map +1 -1
  127. package/dist/formats/ogg/core/helpers.js +387 -387
  128. package/dist/formats/ogg/core/imdct.js +178 -178
  129. package/dist/formats/ogg/core/vorbis.js +1004 -999
  130. package/dist/formats/ogg/core/vorbis.js.map +1 -1
  131. package/dist/formats/ogg/index.js +2 -2
  132. package/dist/formats/png/CjsPngFormat.js +201 -195
  133. package/dist/formats/png/CjsPngFormat.js.map +1 -1
  134. package/dist/formats/png/core/helpers.js +583 -583
  135. package/dist/formats/png/index.js +2 -2
  136. package/dist/formats/red/CjsRedFormat.js +261 -261
  137. package/dist/formats/red/core/CjsRedReader.js +194 -194
  138. package/dist/formats/red/core/blackDefinitions.js +3 -3
  139. package/dist/formats/red/core/helpers.js +139 -139
  140. package/dist/formats/red/core/redGraph.js +68 -68
  141. package/dist/formats/red/core/schema.js +4 -4
  142. package/dist/formats/red/index.js +2 -2
  143. package/dist/formats/stl/CjsStlFormat.js +365 -365
  144. package/dist/formats/stl/core/helpers.js +261 -261
  145. package/dist/formats/stl/core/json.js +51 -51
  146. package/dist/formats/stl/core/stl.js +634 -629
  147. package/dist/formats/stl/core/stl.js.map +1 -1
  148. package/dist/formats/stl/core/targets.js +163 -163
  149. package/dist/formats/stl/index.js +2 -2
  150. package/dist/formats/tga/CjsTgaFormat.js +197 -192
  151. package/dist/formats/tga/CjsTgaFormat.js.map +1 -1
  152. package/dist/formats/tga/core/helpers.js +446 -446
  153. package/dist/formats/tga/index.js +2 -2
  154. package/dist/formats/wav/CjsWavFormat.js +198 -192
  155. package/dist/formats/wav/CjsWavFormat.js.map +1 -1
  156. package/dist/formats/wav/core/helpers.js +328 -328
  157. package/dist/formats/wav/index.js +2 -2
  158. package/dist/formats/webm/CjsWebmFormat.js +197 -191
  159. package/dist/formats/webm/CjsWebmFormat.js.map +1 -1
  160. package/dist/formats/webm/core/helpers.js +537 -537
  161. package/dist/formats/webm/index.js +2 -2
  162. package/dist/formats/webp/CjsWebpFormat.js +91 -86
  163. package/dist/formats/webp/CjsWebpFormat.js.map +1 -1
  164. package/dist/formats/webp/core/helpers.js +214 -214
  165. package/dist/formats/webp/index.js +2 -2
  166. package/dist/formats/wem/CjsWemFormat.js +242 -241
  167. package/dist/formats/wem/CjsWemFormat.js.map +1 -1
  168. package/dist/formats/wem/core/bitStream.js +259 -259
  169. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  170. package/dist/formats/wem/core/helpers.js +417 -417
  171. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  172. package/dist/formats/wem/core/ptadpcm.js +77 -77
  173. package/dist/formats/wem/core/resolve.js +121 -121
  174. package/dist/formats/wem/core/wemToOgg.js +485 -485
  175. package/dist/formats/wem/index.js +2 -2
  176. package/dist/formats/yaml/CjsYamlFormat.js +89 -83
  177. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  178. package/dist/formats/yaml/core/CjsYamlReader.js +311 -305
  179. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  180. package/dist/formats/yaml/core/helpers.js +160 -160
  181. package/dist/formats/yaml/index.js +2 -2
  182. package/dist/index.js +49 -48
  183. package/dist/index.js.map +1 -1
  184. package/dist/resourcePath.js +18 -18
  185. package/dist/resourceStates.js +9 -9
  186. package/dist/resources/AudioGeometryResData.js +47 -47
  187. package/dist/resources/GStateBindingCallbackData.js +31 -31
  188. package/dist/resources/MeshDecalData.js +37 -37
  189. package/dist/resources/MeshDecalLodData.js +34 -34
  190. package/dist/resources/Tr2EffectRes.js +71 -71
  191. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  192. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  193. package/dist/resources/Tr2ImageRes.js +114 -114
  194. package/dist/resources/Tr2LightProfileRes.js +40 -40
  195. package/dist/resources/Tr2MaterialArea.js +34 -34
  196. package/dist/resources/Tr2MaterialMesh.js +31 -31
  197. package/dist/resources/Tr2MaterialRes.js +34 -34
  198. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  199. package/dist/resources/Tr2TextureLodManager.js +80 -80
  200. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  201. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  202. package/dist/resources/Tr2TexturePipeline.js +52 -52
  203. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  204. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  205. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
  206. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
  207. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  208. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  209. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  210. package/dist/resources/TriGeometryRes.js +239 -239
  211. package/dist/resources/TriGeometryResAreaData.js +59 -59
  212. package/dist/resources/TriGeometryResJointData.js +38 -38
  213. package/dist/resources/TriGeometryResLodData.js +88 -88
  214. package/dist/resources/TriGeometryResMeshData.js +63 -63
  215. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  216. package/dist/resources/TriGrannyRes.js +43 -43
  217. package/dist/resources/TriJointBinding.js +38 -38
  218. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  219. package/dist/resources/TriRtGeometryConstants.js +88 -88
  220. package/dist/resources/TriTextureRes.js +304 -304
  221. package/dist/resources/enums.js +18 -18
  222. package/dist/resources/resourceBoundary.js +47 -47
  223. package/dist/resources/texturePipelineBehavior.js +308 -308
  224. package/dist/texture/CjsTextureArrayRes.js +406 -406
  225. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  226. package/docs/README.md +73 -0
  227. package/docs/architecture.md +86 -0
  228. package/docs/concepts/resource-lifecycle.md +217 -0
  229. package/docs/formats/README.md +105 -0
  230. package/docs/formats/gr2.md +161 -0
  231. package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
  232. package/docs/formats/stl.md +37 -0
  233. package/docs/formats/wwise.md +44 -0
  234. package/docs/reference/classes/README.md +33 -0
  235. package/docs/reference/classes/core.md +106 -0
  236. package/docs/reference/classes/dropped.md +46 -0
  237. package/docs/reference/classes/formats.md +522 -0
  238. package/docs/reference/classes/resources.md +346 -0
  239. package/docs/reference/classes/texture.md +26 -0
  240. package/docs/reference/events.md +92 -0
  241. package/docs/reference/motherlode-cache.md +244 -0
  242. package/docs/reference/queues.md +102 -0
  243. package/docs/reference/reload.md +107 -0
  244. package/docs/reference/texture-arrays.md +113 -0
  245. package/docs/reference/texture-pipeline.md +53 -0
  246. package/docs/roadmap.md +104 -0
  247. package/format-notices/black/LICENSE +21 -21
  248. package/format-notices/black/NOTICE +47 -47
  249. package/format-notices/bnk/LICENSE +21 -21
  250. package/format-notices/bnk/NOTICE +20 -20
  251. package/format-notices/cmf/LICENSE +21 -21
  252. package/format-notices/cmf/NOTICE +36 -36
  253. package/format-notices/dds/LICENSE +21 -21
  254. package/format-notices/dds/NOTICE +14 -14
  255. package/format-notices/fbx/LICENSE +21 -21
  256. package/format-notices/fbx/NOTICE +14 -14
  257. package/format-notices/flac/LICENSE +21 -21
  258. package/format-notices/flac/NOTICE +14 -14
  259. package/format-notices/gif/LICENSE +21 -21
  260. package/format-notices/gif/NOTICE +14 -14
  261. package/format-notices/gltf/LICENSE +21 -21
  262. package/format-notices/gltf/NOTICE +27 -27
  263. package/format-notices/gr2/LICENSE +21 -0
  264. package/format-notices/gr2/NOTICE +60 -0
  265. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
  266. package/format-notices/jpeg/LICENSE +21 -21
  267. package/format-notices/jpeg/NOTICE +14 -14
  268. package/format-notices/mp3/LICENSE +21 -21
  269. package/format-notices/mp3/NOTICE +14 -14
  270. package/format-notices/mp4/LICENSE +21 -21
  271. package/format-notices/mp4/NOTICE +14 -14
  272. package/format-notices/obj/LICENSE +21 -21
  273. package/format-notices/obj/NOTICE +26 -26
  274. package/format-notices/ogg/LICENSE +21 -21
  275. package/format-notices/ogg/NOTICE +28 -28
  276. package/format-notices/png/LICENSE +21 -21
  277. package/format-notices/png/NOTICE +14 -14
  278. package/format-notices/red/LICENSE +21 -21
  279. package/format-notices/red/NOTICE +31 -31
  280. package/format-notices/stl/LICENSE +21 -21
  281. package/format-notices/stl/NOTICE +21 -21
  282. package/format-notices/tga/LICENSE +21 -21
  283. package/format-notices/tga/NOTICE +14 -14
  284. package/format-notices/wav/LICENSE +21 -21
  285. package/format-notices/wav/NOTICE +14 -14
  286. package/format-notices/webm/LICENSE +21 -21
  287. package/format-notices/webm/NOTICE +14 -14
  288. package/format-notices/webp/LICENSE +21 -21
  289. package/format-notices/webp/NOTICE +14 -14
  290. package/format-notices/wem/LICENSE +57 -57
  291. package/format-notices/wem/NOTICE +33 -33
  292. package/format-notices/yaml/LICENSE +21 -21
  293. package/format-notices/yaml/NOTICE +44 -44
  294. package/package.json +52 -51
  295. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +0 -4
  296. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js.map +0 -1
  297. package/resource-lifecycle.md +0 -679
@@ -1,233 +1,233 @@
1
- import { MeshoptDecoder } from 'meshoptimizer/decoder';
2
-
3
- const CHANNEL_NAMES = Object.freeze({
4
- Position: "position",
5
- Normal: "normal",
6
- Tangent: "tangent",
7
- Binormal: "binormal",
8
- TexCoord: "texcoord",
9
- Color: "color",
10
- BoneIndices: "blendIndice",
11
- BoneWeights: "blendWeight",
12
- PackedTangent: "packedTangent",
13
- PackedTangentLegacy: "packedTangentLegacy"
14
- });
15
- function decodeGeometrySync(result, sourceBytes) {
16
- const sections = result.sections.map((section, index) => decodeSectionSync(section, index, sourceBytes));
17
- attachGeometry(result, sections);
18
- return result;
19
- }
20
- async function decodeGeometryAsync(result, sourceBytes) {
21
- await MeshoptDecoder.ready;
22
- const sections = result.sections.map((section, index) => decodeSectionWithMeshopt(section, index, sourceBytes));
23
- attachGeometry(result, sections);
24
- return result;
25
- }
26
- function decodeSectionSync(section, index, sourceBytes) {
27
- if (section.compression !== "None") {
28
- throw new Error("CMF compressed GPU buffers require ReadAsync/readAsync so meshoptimizer can initialize");
29
- }
30
- return sectionBytes(section, index, sourceBytes);
31
- }
32
- function decodeSectionWithMeshopt(section, index, sourceBytes) {
33
- const source = sectionBytes(section, index, sourceBytes);
34
- if (section.compression === "None") {
35
- return source;
36
- }
37
- const target = new Uint8Array(section.uncompressedSize);
38
- const count = section.gpuAlignment === 0 ? 0 : section.uncompressedSize / section.gpuAlignment;
39
- if (section.compression === "MeshOptimizerVertexBuffer") {
40
- MeshoptDecoder.decodeVertexBuffer(target, count, section.gpuAlignment, source);
41
- return target;
42
- }
43
- if (section.compression === "MeshOptimizerIndexBuffer") {
44
- MeshoptDecoder.decodeIndexBuffer(target, count, section.gpuAlignment, source);
45
- return target;
46
- }
47
- throw new Error(`Unsupported CMF section compression "${section.compression}"`);
48
- }
49
- function sectionBytes(section, index, sourceBytes) {
50
- if (index === 0 || section.type !== "GpuBuffer") {
51
- return null;
52
- }
53
- return sourceBytes.subarray(section.offset, section.offset + section.compressedSize);
54
- }
55
- function attachGeometry(result, sectionData) {
56
- result.buffers = result.sections.map((section, index) => {
57
- const data = sectionData[index];
58
- return {
59
- index,
60
- type: section.type,
61
- compression: section.compression,
62
- byteLength: data?.byteLength ?? 0,
63
- data
64
- };
65
- });
66
- for (const mesh of result.meshes) {
67
- for (const lod of mesh.lods) {
68
- lod.vertex = readVertexChannels(mesh.decl, lod.vb, sectionData);
69
- lod.indices = readIndexGroups(mesh, lod, sectionData);
70
- for (let i = 0; i < lod.morphTargets.length; i++) {
71
- const target = lod.morphTargets[i];
72
- target.vertex = readVertexChannels(mesh.morphTargets.decl, target.vb, sectionData);
73
- target.name = mesh.morphTargets.targets[i]?.name ?? target.name ?? "";
74
- target.maxDisplacement = mesh.morphTargets.targets[i]?.maxDisplacement ?? target.maxDisplacement ?? 0;
75
- }
76
- }
77
- if (mesh.lods.length > 0) {
78
- mesh.vertex = mesh.lods[0].vertex;
79
- mesh.indices = mesh.lods[0].indices;
80
- } else {
81
- mesh.vertex = createVertexChannels();
82
- mesh.indices = [];
83
- }
84
- }
85
- }
86
- function readVertexChannels(decl, view, sectionData) {
87
- const channels = createVertexChannels();
88
- const bytes = viewData(view, sectionData);
89
- if (!bytes || view.stride === 0) {
90
- return channels;
91
- }
92
- const reader = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
93
- const count = Math.floor(view.size / view.stride);
94
- for (const element of decl) {
95
- const channel = channelName(element);
96
- if (!channels[channel]) channels[channel] = [];
97
- for (let vertex = 0; vertex < count; vertex++) {
98
- const base = vertex * view.stride + element.offset;
99
- for (let component = 0; component < element.elementCount; component++) {
100
- channels[channel].push(readElementComponent(reader, base, element.type, component));
101
- }
102
- }
103
- }
104
- return channels;
105
- }
106
- function readIndexGroups(mesh, lod, sectionData) {
107
- const bytes = viewData(lod.ib, sectionData);
108
- if (!bytes || lod.ib.stride === 0) {
109
- return [];
110
- }
111
- const reader = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength),
112
- allFaces = readIndices(reader, lod.ib.size, lod.ib.stride);
113
- if (lod.areas.length === 0) {
114
- return [{
115
- name: "",
116
- bytesPerIndex: lod.ib.stride,
117
- faces: allFaces
118
- }];
119
- }
120
- return lod.areas.map((area, areaIndex) => {
121
- const sourceArea = mesh.areas[areaIndex];
122
- return {
123
- name: sourceArea?.name ?? "",
124
- bytesPerIndex: lod.ib.stride,
125
- firstElement: area.firstElement,
126
- elementCount: area.elementCount,
127
- faces: allFaces.slice(area.firstElement * 3, (area.firstElement + area.elementCount) * 3)
128
- };
129
- });
130
- }
131
- function readIndices(reader, byteSize, stride) {
132
- const result = [];
133
- for (let offset = 0; offset < byteSize; offset += stride) {
134
- if (stride === 2) result.push(reader.getUint16(offset, true));else if (stride === 4) result.push(reader.getUint32(offset, true));else result.push(reader.getUint8(offset));
135
- }
136
- return result;
137
- }
138
- function viewData(view, sectionData) {
139
- const section = sectionData[view.index];
140
- if (!section || view.size === 0) {
141
- return null;
142
- }
143
- return section.subarray(view.offset, view.offset + view.size);
144
- }
145
- function channelName(element) {
146
- const base = CHANNEL_NAMES[element.usage] ?? lowerFirst(element.usage);
147
- if (element.usage === "TexCoord" || element.usage === "Color") {
148
- return `${base}${element.usageIndex}`;
149
- }
150
- if (element.usageIndex > 0) {
151
- return `${base}${element.usageIndex}`;
152
- }
153
- return base;
154
- }
155
- function createVertexChannels() {
156
- return {
157
- position: [],
158
- normal: [],
159
- tangent: [],
160
- binormal: [],
161
- texcoord0: [],
162
- texcoord1: [],
163
- color0: [],
164
- blendIndice: [],
165
- blendWeight: [],
166
- packedTangent: [],
167
- packedTangentLegacy: []
168
- };
169
- }
170
- function readElementComponent(reader, base, type, component) {
171
- const offset = base + component * elementTypeSize(type);
172
- switch (type) {
173
- case "Float32":
174
- return reader.getFloat32(offset, true);
175
- case "Float16":
176
- return halfToFloat(reader.getUint16(offset, true));
177
- case "UInt16Norm":
178
- return reader.getUint16(offset, true) / 65535;
179
- case "UInt16":
180
- return reader.getUint16(offset, true);
181
- case "Int16Norm":
182
- return Math.max(reader.getInt16(offset, true) / 32767, -1);
183
- case "Int16":
184
- return reader.getInt16(offset, true);
185
- case "UInt8Norm":
186
- return reader.getUint8(offset) / 255;
187
- case "UInt8":
188
- return reader.getUint8(offset);
189
- case "Int8Norm":
190
- return Math.max(reader.getInt8(offset) / 127, -1);
191
- case "Int8":
192
- return reader.getInt8(offset);
193
- default:
194
- throw new Error(`Unsupported CMF vertex element type "${type}"`);
195
- }
196
- }
197
- function elementTypeSize(type) {
198
- switch (type) {
199
- case "Float32":
200
- return 4;
201
- case "Float16":
202
- case "UInt16Norm":
203
- case "UInt16":
204
- case "Int16Norm":
205
- case "Int16":
206
- return 2;
207
- case "UInt8Norm":
208
- case "UInt8":
209
- case "Int8Norm":
210
- case "Int8":
211
- return 1;
212
- default:
213
- throw new Error(`Unsupported CMF vertex element type "${type}"`);
214
- }
215
- }
216
- function halfToFloat(value) {
217
- const sign = value & 0x8000 ? -1 : 1,
218
- exponent = value >> 10 & 0x1f,
219
- fraction = value & 0x03ff;
220
- if (exponent === 0) {
221
- return sign * Math.pow(2, -14) * (fraction / 1024);
222
- }
223
- if (exponent === 31) {
224
- return fraction ? NaN : sign * Infinity;
225
- }
226
- return sign * Math.pow(2, exponent - 15) * (1 + fraction / 1024);
227
- }
228
- function lowerFirst(value) {
229
- return value ? value[0].toLowerCase() + value.slice(1) : value;
230
- }
231
-
232
- export { decodeGeometryAsync, decodeGeometrySync };
233
- //# sourceMappingURL=buffers.js.map
1
+ import { MeshoptDecoder } from 'meshoptimizer/decoder';
2
+
3
+ const CHANNEL_NAMES = Object.freeze({
4
+ Position: "position",
5
+ Normal: "normal",
6
+ Tangent: "tangent",
7
+ Binormal: "binormal",
8
+ TexCoord: "texcoord",
9
+ Color: "color",
10
+ BoneIndices: "blendIndice",
11
+ BoneWeights: "blendWeight",
12
+ PackedTangent: "packedTangent",
13
+ PackedTangentLegacy: "packedTangentLegacy"
14
+ });
15
+ function decodeGeometrySync(result, sourceBytes) {
16
+ const sections = result.sections.map((section, index) => decodeSectionSync(section, index, sourceBytes));
17
+ attachGeometry(result, sections);
18
+ return result;
19
+ }
20
+ async function decodeGeometryAsync(result, sourceBytes) {
21
+ await MeshoptDecoder.ready;
22
+ const sections = result.sections.map((section, index) => decodeSectionWithMeshopt(section, index, sourceBytes));
23
+ attachGeometry(result, sections);
24
+ return result;
25
+ }
26
+ function decodeSectionSync(section, index, sourceBytes) {
27
+ if (section.compression !== "None") {
28
+ throw new Error("CMF compressed GPU buffers require ReadAsync/readAsync so meshoptimizer can initialize");
29
+ }
30
+ return sectionBytes(section, index, sourceBytes);
31
+ }
32
+ function decodeSectionWithMeshopt(section, index, sourceBytes) {
33
+ const source = sectionBytes(section, index, sourceBytes);
34
+ if (section.compression === "None") {
35
+ return source;
36
+ }
37
+ const target = new Uint8Array(section.uncompressedSize);
38
+ const count = section.gpuAlignment === 0 ? 0 : section.uncompressedSize / section.gpuAlignment;
39
+ if (section.compression === "MeshOptimizerVertexBuffer") {
40
+ MeshoptDecoder.decodeVertexBuffer(target, count, section.gpuAlignment, source);
41
+ return target;
42
+ }
43
+ if (section.compression === "MeshOptimizerIndexBuffer") {
44
+ MeshoptDecoder.decodeIndexBuffer(target, count, section.gpuAlignment, source);
45
+ return target;
46
+ }
47
+ throw new Error(`Unsupported CMF section compression "${section.compression}"`);
48
+ }
49
+ function sectionBytes(section, index, sourceBytes) {
50
+ if (index === 0 || section.type !== "GpuBuffer") {
51
+ return null;
52
+ }
53
+ return sourceBytes.subarray(section.offset, section.offset + section.compressedSize);
54
+ }
55
+ function attachGeometry(result, sectionData) {
56
+ result.buffers = result.sections.map((section, index) => {
57
+ const data = sectionData[index];
58
+ return {
59
+ index,
60
+ type: section.type,
61
+ compression: section.compression,
62
+ byteLength: data?.byteLength ?? 0,
63
+ data
64
+ };
65
+ });
66
+ for (const mesh of result.meshes) {
67
+ for (const lod of mesh.lods) {
68
+ lod.vertex = readVertexChannels(mesh.decl, lod.vb, sectionData);
69
+ lod.indices = readIndexGroups(mesh, lod, sectionData);
70
+ for (let i = 0; i < lod.morphTargets.length; i++) {
71
+ const target = lod.morphTargets[i];
72
+ target.vertex = readVertexChannels(mesh.morphTargets.decl, target.vb, sectionData);
73
+ target.name = mesh.morphTargets.targets[i]?.name ?? target.name ?? "";
74
+ target.maxDisplacement = mesh.morphTargets.targets[i]?.maxDisplacement ?? target.maxDisplacement ?? 0;
75
+ }
76
+ }
77
+ if (mesh.lods.length > 0) {
78
+ mesh.vertex = mesh.lods[0].vertex;
79
+ mesh.indices = mesh.lods[0].indices;
80
+ } else {
81
+ mesh.vertex = createVertexChannels();
82
+ mesh.indices = [];
83
+ }
84
+ }
85
+ }
86
+ function readVertexChannels(decl, view, sectionData) {
87
+ const channels = createVertexChannels();
88
+ const bytes = viewData(view, sectionData);
89
+ if (!bytes || view.stride === 0) {
90
+ return channels;
91
+ }
92
+ const reader = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
93
+ const count = Math.floor(view.size / view.stride);
94
+ for (const element of decl) {
95
+ const channel = channelName(element);
96
+ if (!channels[channel]) channels[channel] = [];
97
+ for (let vertex = 0; vertex < count; vertex++) {
98
+ const base = vertex * view.stride + element.offset;
99
+ for (let component = 0; component < element.elementCount; component++) {
100
+ channels[channel].push(readElementComponent(reader, base, element.type, component));
101
+ }
102
+ }
103
+ }
104
+ return channels;
105
+ }
106
+ function readIndexGroups(mesh, lod, sectionData) {
107
+ const bytes = viewData(lod.ib, sectionData);
108
+ if (!bytes || lod.ib.stride === 0) {
109
+ return [];
110
+ }
111
+ const reader = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength),
112
+ allFaces = readIndices(reader, lod.ib.size, lod.ib.stride);
113
+ if (lod.areas.length === 0) {
114
+ return [{
115
+ name: "",
116
+ bytesPerIndex: lod.ib.stride,
117
+ faces: allFaces
118
+ }];
119
+ }
120
+ return lod.areas.map((area, areaIndex) => {
121
+ const sourceArea = mesh.areas[areaIndex];
122
+ return {
123
+ name: sourceArea?.name ?? "",
124
+ bytesPerIndex: lod.ib.stride,
125
+ firstElement: area.firstElement,
126
+ elementCount: area.elementCount,
127
+ faces: allFaces.slice(area.firstElement * 3, (area.firstElement + area.elementCount) * 3)
128
+ };
129
+ });
130
+ }
131
+ function readIndices(reader, byteSize, stride) {
132
+ const result = [];
133
+ for (let offset = 0; offset < byteSize; offset += stride) {
134
+ if (stride === 2) result.push(reader.getUint16(offset, true));else if (stride === 4) result.push(reader.getUint32(offset, true));else result.push(reader.getUint8(offset));
135
+ }
136
+ return result;
137
+ }
138
+ function viewData(view, sectionData) {
139
+ const section = sectionData[view.index];
140
+ if (!section || view.size === 0) {
141
+ return null;
142
+ }
143
+ return section.subarray(view.offset, view.offset + view.size);
144
+ }
145
+ function channelName(element) {
146
+ const base = CHANNEL_NAMES[element.usage] ?? lowerFirst(element.usage);
147
+ if (element.usage === "TexCoord" || element.usage === "Color") {
148
+ return `${base}${element.usageIndex}`;
149
+ }
150
+ if (element.usageIndex > 0) {
151
+ return `${base}${element.usageIndex}`;
152
+ }
153
+ return base;
154
+ }
155
+ function createVertexChannels() {
156
+ return {
157
+ position: [],
158
+ normal: [],
159
+ tangent: [],
160
+ binormal: [],
161
+ texcoord0: [],
162
+ texcoord1: [],
163
+ color0: [],
164
+ blendIndice: [],
165
+ blendWeight: [],
166
+ packedTangent: [],
167
+ packedTangentLegacy: []
168
+ };
169
+ }
170
+ function readElementComponent(reader, base, type, component) {
171
+ const offset = base + component * elementTypeSize(type);
172
+ switch (type) {
173
+ case "Float32":
174
+ return reader.getFloat32(offset, true);
175
+ case "Float16":
176
+ return halfToFloat(reader.getUint16(offset, true));
177
+ case "UInt16Norm":
178
+ return reader.getUint16(offset, true) / 65535;
179
+ case "UInt16":
180
+ return reader.getUint16(offset, true);
181
+ case "Int16Norm":
182
+ return Math.max(reader.getInt16(offset, true) / 32767, -1);
183
+ case "Int16":
184
+ return reader.getInt16(offset, true);
185
+ case "UInt8Norm":
186
+ return reader.getUint8(offset) / 255;
187
+ case "UInt8":
188
+ return reader.getUint8(offset);
189
+ case "Int8Norm":
190
+ return Math.max(reader.getInt8(offset) / 127, -1);
191
+ case "Int8":
192
+ return reader.getInt8(offset);
193
+ default:
194
+ throw new Error(`Unsupported CMF vertex element type "${type}"`);
195
+ }
196
+ }
197
+ function elementTypeSize(type) {
198
+ switch (type) {
199
+ case "Float32":
200
+ return 4;
201
+ case "Float16":
202
+ case "UInt16Norm":
203
+ case "UInt16":
204
+ case "Int16Norm":
205
+ case "Int16":
206
+ return 2;
207
+ case "UInt8Norm":
208
+ case "UInt8":
209
+ case "Int8Norm":
210
+ case "Int8":
211
+ return 1;
212
+ default:
213
+ throw new Error(`Unsupported CMF vertex element type "${type}"`);
214
+ }
215
+ }
216
+ function halfToFloat(value) {
217
+ const sign = value & 0x8000 ? -1 : 1,
218
+ exponent = value >> 10 & 0x1f,
219
+ fraction = value & 0x03ff;
220
+ if (exponent === 0) {
221
+ return sign * Math.pow(2, -14) * (fraction / 1024);
222
+ }
223
+ if (exponent === 31) {
224
+ return fraction ? NaN : sign * Infinity;
225
+ }
226
+ return sign * Math.pow(2, exponent - 15) * (1 + fraction / 1024);
227
+ }
228
+ function lowerFirst(value) {
229
+ return value ? value[0].toLowerCase() + value.slice(1) : value;
230
+ }
231
+
232
+ export { decodeGeometryAsync, decodeGeometrySync };
233
+ //# sourceMappingURL=buffers.js.map
@@ -1,47 +1,47 @@
1
- const FILE_SIGNATURE = 0x66666D63;
2
- const FILE_VERSION = 1;
3
- const OUTPUT_JSON = "json";
4
- const OUTPUT_CMF = "cmf";
5
- const OUTPUT_CMF_JSON = "cmfJson";
6
- const OUTPUT_GR2 = "gr2";
7
- const OUTPUT_NATIVE = "native";
8
- const OUTPUT_RAW = "raw";
9
- const OUTPUT_SHARED = "shared";
10
- const STRUCT_SIZE = Object.freeze({
11
- BufferView: 16,
12
- VertexElement: 8,
13
- MeshArea: 64,
14
- LodMeshArea: 8,
15
- BoneBinding: 40,
16
- MorphTarget: 24,
17
- MorphTargets: 32,
18
- LodMorphTarget: 16,
19
- MeshLod: 72,
20
- AudioOcclusionMesh: 56,
21
- Transform: 40,
22
- BoneWeight: 8,
23
- BoneMask: 32,
24
- Skeleton: 96,
25
- AnimationChannel: 24,
26
- AnimationCurve: 40,
27
- Animation: 56,
28
- MetadataEntry: 32,
29
- Metadata: 16,
30
- Section: 16,
31
- Header: 32,
32
- Data: 48,
33
- Mesh: 216
34
- });
35
- const Usage = Object.freeze(["Position", "Normal", "Tangent", "Binormal", "TexCoord", "Color", "BoneIndices", "BoneWeights", "PackedTangent", "PackedTangentLegacy"]);
36
- const ElementType = Object.freeze(["Float32", "Float16", "UInt16Norm", "UInt16", "Int16Norm", "Int16", "UInt8Norm", "UInt8", "Int8Norm", "Int8"]);
37
- const MeshTopology = Object.freeze(["TriangleList", "PointList"]);
38
- const SectionType = Object.freeze(["Data", "GpuBuffer", "Metadata"]);
39
- const SectionCompression = Object.freeze(["None", "MeshOptimizerVertexBuffer", "MeshOptimizerIndexBuffer"]);
40
- const AnimationChannelTargetType = Object.freeze(["BonePosition", "BoneRotation", "BoneScale", "MorphTarget", "Other"]);
41
- const Interpolation = Object.freeze(["Step", "Linear"]);
42
- const CMF_CLASS_KEYS = Object.freeze(["Root", "Section", "Metadata", "MetadataEntry", "Mesh", "IndexGroup", "VertexElement", "MeshLod", "MeshArea", "LodMeshArea", "BoneBinding", "MorphTargets", "MorphTarget", "LodMorphTarget", "AudioOcclusionMesh", "Skeleton", "BoneMask", "BoneWeight", "Animation", "AnimationChannel", "AnimationCurve"]);
43
- const GR2_CLASS_KEYS = Object.freeze(["Root", "Mesh", "BoneBinding", "IndexGroup", "MorphTarget", "Model", "Skeleton", "Bone", "Animation", "TrackGroup", "TransformTrack", "Curve"]);
44
- const CLASS_KEYS = Object.freeze(Array.from(new Set([...CMF_CLASS_KEYS, ...GR2_CLASS_KEYS])));
45
-
46
- export { AnimationChannelTargetType, CLASS_KEYS, CMF_CLASS_KEYS, ElementType, FILE_SIGNATURE, FILE_VERSION, GR2_CLASS_KEYS, Interpolation, MeshTopology, OUTPUT_CMF, OUTPUT_CMF_JSON, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_NATIVE, OUTPUT_RAW, OUTPUT_SHARED, STRUCT_SIZE, SectionCompression, SectionType, Usage };
47
- //# sourceMappingURL=constants.js.map
1
+ const FILE_SIGNATURE = 0x66666D63;
2
+ const FILE_VERSION = 1;
3
+ const OUTPUT_JSON = "json";
4
+ const OUTPUT_CMF = "cmf";
5
+ const OUTPUT_CMF_JSON = "cmfJson";
6
+ const OUTPUT_GR2 = "gr2";
7
+ const OUTPUT_NATIVE = "native";
8
+ const OUTPUT_RAW = "raw";
9
+ const OUTPUT_SHARED = "shared";
10
+ const STRUCT_SIZE = Object.freeze({
11
+ BufferView: 16,
12
+ VertexElement: 8,
13
+ MeshArea: 64,
14
+ LodMeshArea: 8,
15
+ BoneBinding: 40,
16
+ MorphTarget: 24,
17
+ MorphTargets: 32,
18
+ LodMorphTarget: 16,
19
+ MeshLod: 72,
20
+ AudioOcclusionMesh: 56,
21
+ Transform: 40,
22
+ BoneWeight: 8,
23
+ BoneMask: 32,
24
+ Skeleton: 96,
25
+ AnimationChannel: 24,
26
+ AnimationCurve: 40,
27
+ Animation: 56,
28
+ MetadataEntry: 32,
29
+ Metadata: 16,
30
+ Section: 16,
31
+ Header: 32,
32
+ Data: 48,
33
+ Mesh: 216
34
+ });
35
+ const Usage = Object.freeze(["Position", "Normal", "Tangent", "Binormal", "TexCoord", "Color", "BoneIndices", "BoneWeights", "PackedTangent", "PackedTangentLegacy"]);
36
+ const ElementType = Object.freeze(["Float32", "Float16", "UInt16Norm", "UInt16", "Int16Norm", "Int16", "UInt8Norm", "UInt8", "Int8Norm", "Int8"]);
37
+ const MeshTopology = Object.freeze(["TriangleList", "PointList"]);
38
+ const SectionType = Object.freeze(["Data", "GpuBuffer", "Metadata"]);
39
+ const SectionCompression = Object.freeze(["None", "MeshOptimizerVertexBuffer", "MeshOptimizerIndexBuffer"]);
40
+ const AnimationChannelTargetType = Object.freeze(["BonePosition", "BoneRotation", "BoneScale", "MorphTarget", "Other"]);
41
+ const Interpolation = Object.freeze(["Step", "Linear"]);
42
+ const CMF_CLASS_KEYS = Object.freeze(["Root", "Section", "Metadata", "MetadataEntry", "Mesh", "IndexGroup", "VertexElement", "MeshLod", "MeshArea", "LodMeshArea", "BoneBinding", "MorphTargets", "MorphTarget", "LodMorphTarget", "AudioOcclusionMesh", "Skeleton", "BoneMask", "BoneWeight", "Animation", "AnimationChannel", "AnimationCurve"]);
43
+ const GR2_CLASS_KEYS = Object.freeze(["Root", "Mesh", "BoneBinding", "IndexGroup", "MorphTarget", "Model", "Skeleton", "Bone", "Animation", "TrackGroup", "TransformTrack", "Curve"]);
44
+ const CLASS_KEYS = Object.freeze(Array.from(new Set([...CMF_CLASS_KEYS, ...GR2_CLASS_KEYS])));
45
+
46
+ export { AnimationChannelTargetType, CLASS_KEYS, CMF_CLASS_KEYS, ElementType, FILE_SIGNATURE, FILE_VERSION, GR2_CLASS_KEYS, Interpolation, MeshTopology, OUTPUT_CMF, OUTPUT_CMF_JSON, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_NATIVE, OUTPUT_RAW, OUTPUT_SHARED, STRUCT_SIZE, SectionCompression, SectionType, Usage };
47
+ //# sourceMappingURL=constants.js.map