@carbonenginejs/runtime-resource 0.12.2 → 0.13.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 (541) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +32 -32
  3. package/README.md +129 -108
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3858 -3494
  6. package/dist/CjsResMan.js.map +1 -1
  7. package/dist/CjsResManFetchProvider.js +94 -94
  8. package/dist/CjsResManWorkQueue.js +301 -301
  9. package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
  10. package/dist/format/CjsBlueReader.js +358 -358
  11. package/dist/format/CjsByteReader.js +310 -310
  12. package/dist/format/CjsByteWriter.js +242 -242
  13. package/dist/format/CjsFormat.js +223 -223
  14. package/dist/format/CjsFormatError.js +41 -41
  15. package/dist/format/CjsReader.js +22 -22
  16. package/dist/format/CjsResourceProbe.js +279 -279
  17. package/dist/format/CjsStringTable.js +268 -268
  18. package/dist/format/carbonEffect/CjsCarbonEffectReader.js +408 -361
  19. package/dist/format/carbonEffect/CjsCarbonEffectReader.js.map +1 -1
  20. package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
  21. package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -0
  22. package/dist/format/carbonEffect/buildCarbonEffectContainer.js.map +1 -0
  23. package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -427
  24. package/dist/format/carbonEffect/carbonEffectBackendBlock.js.map +1 -1
  25. package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -955
  26. package/dist/format/carbonEffect/carbonEffectRecords.js.map +1 -1
  27. package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -0
  28. package/dist/format/carbonEffect/carbonEffectResourceTransform.js.map +1 -0
  29. package/dist/format/compareUtf8.js +36 -36
  30. package/dist/format/effect/effectBodyInventory.js +146 -0
  31. package/dist/format/effect/effectBodyInventory.js.map +1 -0
  32. package/dist/format/effect/effectPermutationGraph.js +257 -257
  33. package/dist/format/effect/effectPermutationGraph.js.map +1 -1
  34. package/dist/format/effect/sha256.js +114 -114
  35. package/dist/format/index.js +11 -11
  36. package/dist/format/payloadContract.js +193 -193
  37. package/dist/formats/black/CjsBlackFormat.js +310 -292
  38. package/dist/formats/black/CjsBlackFormat.js.map +1 -1
  39. package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
  40. package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
  41. package/dist/formats/black/core/CjsBlackReader.js +764 -764
  42. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
  43. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
  44. package/dist/formats/black/core/blackConstants.js +7 -7
  45. package/dist/formats/black/core/blackDefinitions.js +10 -10
  46. package/dist/formats/black/core/blackEnums.js +6 -6
  47. package/dist/formats/black/core/blackSchema.js +3 -3
  48. package/dist/formats/black/core/blackVersion.js +22 -22
  49. package/dist/formats/black/core/helpers.js +199 -199
  50. package/dist/formats/black/core/schema.js +4 -4
  51. package/dist/formats/black/index.js +2 -2
  52. package/dist/formats/bnk/CjsBnkFormat.js +175 -156
  53. package/dist/formats/bnk/CjsBnkFormat.js.map +1 -1
  54. package/dist/formats/bnk/core/busNodes.js +252 -0
  55. package/dist/formats/bnk/core/busNodes.js.map +1 -0
  56. package/dist/formats/bnk/core/effectNodes.js +147 -0
  57. package/dist/formats/bnk/core/effectNodes.js.map +1 -0
  58. package/dist/formats/bnk/core/eventAction.js +416 -305
  59. package/dist/formats/bnk/core/eventAction.js.map +1 -1
  60. package/dist/formats/bnk/core/globalSettings.js +215 -0
  61. package/dist/formats/bnk/core/globalSettings.js.map +1 -0
  62. package/dist/formats/bnk/core/graph.js +137 -137
  63. package/dist/formats/bnk/core/helpers.js +512 -480
  64. package/dist/formats/bnk/core/helpers.js.map +1 -1
  65. package/dist/formats/bnk/core/musicNodes.js +533 -509
  66. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  67. package/dist/formats/bnk/core/nodeBase.js +553 -532
  68. package/dist/formats/bnk/core/nodeBase.js.map +1 -1
  69. package/dist/formats/bnk/core/sfxNodes.js +632 -632
  70. package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
  71. package/dist/formats/bnk/index.js +2 -2
  72. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  73. package/dist/formats/cmf/core/binary.js +194 -194
  74. package/dist/formats/cmf/core/buffers.js +237 -237
  75. package/dist/formats/cmf/core/constants.js +47 -47
  76. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  77. package/dist/formats/cmf/core/helpers.js +318 -318
  78. package/dist/formats/cmf/core/pack.js +276 -276
  79. package/dist/formats/cmf/core/schema.js +374 -374
  80. package/dist/formats/cmf/core/shared.js +277 -277
  81. package/dist/formats/cmf/core/writer.js +571 -571
  82. package/dist/formats/cmf/index.js +2 -2
  83. package/dist/formats/dds/CjsDdsFormat.js +200 -200
  84. package/dist/formats/dds/core/bc6h.js +298 -298
  85. package/dist/formats/dds/core/bc7.js +272 -272
  86. package/dist/formats/dds/core/helpers.js +862 -862
  87. package/dist/formats/dds/index.js +2 -2
  88. package/dist/formats/dxbc/CjsDxbcFormat.js +142 -142
  89. package/dist/formats/dxbc/core/DxbcReader.js +266 -266
  90. package/dist/formats/dxbc/core/container.js +169 -169
  91. package/dist/formats/dxbc/core/decoder.js +789 -789
  92. package/dist/formats/dxbc/core/errors.js +19 -19
  93. package/dist/formats/dxbc/core/helpers.js +220 -220
  94. package/dist/formats/dxbc/core/opcodes.js +45 -45
  95. package/dist/formats/dxbc/core/program.js +91 -91
  96. package/dist/formats/dxbc/core/signature.js +172 -172
  97. package/dist/formats/dxbc/index.js +2 -2
  98. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  99. package/dist/formats/fbx/core/helpers.js +3932 -3932
  100. package/dist/formats/fbx/index.js +2 -2
  101. package/dist/formats/flac/CjsFlacFormat.js +142 -142
  102. package/dist/formats/flac/core/helpers.js +315 -315
  103. package/dist/formats/flac/index.js +2 -2
  104. package/dist/formats/gif/CjsGifFormat.js +141 -141
  105. package/dist/formats/gif/core/helpers.js +380 -380
  106. package/dist/formats/gif/index.js +2 -2
  107. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  108. package/dist/formats/gltf/core/helpers.js +307 -307
  109. package/dist/formats/gltf/core/json.js +79 -79
  110. package/dist/formats/gltf/core/parser.js +679 -679
  111. package/dist/formats/gltf/core/targets.js +173 -173
  112. package/dist/formats/gltf/index.js +2 -2
  113. package/dist/formats/gr2/CjsGr2Format.js +289 -289
  114. package/dist/formats/gr2/core/bitknit2.js +282 -282
  115. package/dist/formats/gr2/core/curves.js +1047 -1047
  116. package/dist/formats/gr2/core/gsf.js +72 -72
  117. package/dist/formats/gr2/core/helpers.js +352 -352
  118. package/dist/formats/gr2/core/json.js +622 -622
  119. package/dist/formats/gr2/core/oodle1.js +388 -388
  120. package/dist/formats/gr2/core/tangents.js +48 -48
  121. package/dist/formats/gr2/core/targets.js +361 -361
  122. package/dist/formats/gr2/index.js +2 -2
  123. package/dist/formats/hlsl/CjsHlslFormat.js +254 -254
  124. package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
  125. package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
  126. package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
  127. package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
  128. package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
  129. package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
  130. package/dist/formats/hlsl/core/analysis.js +51 -51
  131. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -781
  132. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js.map +1 -1
  133. package/dist/formats/hlsl/core/detailMapFamily.js +128 -0
  134. package/dist/formats/hlsl/core/detailMapFamily.js.map +1 -0
  135. package/dist/formats/hlsl/core/helpers.js +270 -270
  136. package/dist/formats/hlsl/core/json.js +284 -284
  137. package/dist/formats/hlsl/core/localLightFamily.js +133 -0
  138. package/dist/formats/hlsl/core/localLightFamily.js.map +1 -0
  139. package/dist/formats/hlsl/core/metadata.js +327 -327
  140. package/dist/formats/hlsl/core/render-states.js +280 -280
  141. package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
  142. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -314
  143. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js.map +1 -1
  144. package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
  145. package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +416 -416
  146. package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
  147. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -742
  148. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js.map +1 -1
  149. package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
  150. package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
  151. package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
  152. package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
  153. package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
  154. package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
  155. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
  156. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
  157. package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
  158. package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
  159. package/dist/formats/hlsl/index.js +3 -3
  160. package/dist/formats/index.js +33 -31
  161. package/dist/formats/index.js.map +1 -1
  162. package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
  163. package/dist/formats/jpeg/core/helpers.js +402 -402
  164. package/dist/formats/jpeg/core/jpeg.js +480 -480
  165. package/dist/formats/jpeg/index.js +2 -2
  166. package/dist/formats/mp3/CjsMp3Format.js +197 -197
  167. package/dist/formats/mp3/core/helpers.js +375 -375
  168. package/dist/formats/mp3/index.js +2 -2
  169. package/dist/formats/mp4/CjsMp4Format.js +197 -197
  170. package/dist/formats/mp4/core/helpers.js +484 -484
  171. package/dist/formats/mp4/index.js +2 -2
  172. package/dist/formats/obj/CjsObjFormat.js +253 -253
  173. package/dist/formats/obj/core/helpers.js +573 -573
  174. package/dist/formats/obj/core/json.js +64 -64
  175. package/dist/formats/obj/core/parser.js +321 -321
  176. package/dist/formats/obj/index.js +2 -2
  177. package/dist/formats/ogg/CjsOggFormat.js +143 -143
  178. package/dist/formats/ogg/core/helpers.js +410 -410
  179. package/dist/formats/ogg/core/imdct.js +178 -178
  180. package/dist/formats/ogg/core/vorbis.js +1017 -1017
  181. package/dist/formats/ogg/index.js +2 -2
  182. package/dist/formats/pickle/CjsPickleFormat.js +214 -0
  183. package/dist/formats/pickle/CjsPickleFormat.js.map +1 -0
  184. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -0
  185. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js.map +1 -0
  186. package/dist/formats/pickle/index.js +2 -0
  187. package/dist/formats/pickle/index.js.map +1 -0
  188. package/dist/formats/png/CjsPngFormat.js +201 -201
  189. package/dist/formats/png/core/helpers.js +635 -635
  190. package/dist/formats/png/index.js +2 -2
  191. package/dist/formats/red/CjsRedFormat.js +263 -263
  192. package/dist/formats/red/core/CjsRedReader.js +246 -246
  193. package/dist/formats/red/core/blackDefinitions.js +3 -3
  194. package/dist/formats/red/core/helpers.js +158 -158
  195. package/dist/formats/red/core/redGraph.js +71 -68
  196. package/dist/formats/red/core/redGraph.js.map +1 -1
  197. package/dist/formats/red/core/schema.js +4 -4
  198. package/dist/formats/red/index.js +2 -2
  199. package/dist/formats/stl/CjsStlFormat.js +365 -365
  200. package/dist/formats/stl/core/helpers.js +261 -261
  201. package/dist/formats/stl/core/json.js +51 -51
  202. package/dist/formats/stl/core/stl.js +642 -642
  203. package/dist/formats/stl/core/targets.js +173 -173
  204. package/dist/formats/stl/index.js +2 -2
  205. package/dist/formats/tga/CjsTgaFormat.js +197 -197
  206. package/dist/formats/tga/core/helpers.js +493 -493
  207. package/dist/formats/tga/index.js +2 -2
  208. package/dist/formats/wav/CjsWavFormat.js +198 -198
  209. package/dist/formats/wav/core/helpers.js +365 -365
  210. package/dist/formats/wav/index.js +2 -2
  211. package/dist/formats/webgl/CjsWebglFormat.js +199 -221
  212. package/dist/formats/webgl/CjsWebglFormat.js.map +1 -1
  213. package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -0
  214. package/dist/formats/webgl/core/buildGlslEffectContainer.js.map +1 -0
  215. package/dist/formats/webgl/core/effectPackage.js +900 -792
  216. package/dist/formats/webgl/core/effectPackage.js.map +1 -1
  217. package/dist/formats/webgl/core/errors.js +27 -27
  218. package/dist/formats/webgl/core/errors.js.map +1 -1
  219. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2678
  220. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js.map +1 -1
  221. package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
  222. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -428
  223. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js.map +1 -1
  224. package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -0
  225. package/dist/formats/webgl/core/glsl/packedLightFixups.js.map +1 -0
  226. package/dist/formats/webgl/core/glslBackendBlock.js +552 -0
  227. package/dist/formats/webgl/core/glslBackendBlock.js.map +1 -0
  228. package/dist/formats/webgl/core/glslBackendBodySet.js +243 -0
  229. package/dist/formats/webgl/core/glslBackendBodySet.js.map +1 -0
  230. package/dist/formats/webgl/core/{cewgCompleteness.js → glslEffectCompleteness.js} +85 -81
  231. package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -0
  232. package/dist/formats/webgl/core/helpers.js +167 -306
  233. package/dist/formats/webgl/core/helpers.js.map +1 -1
  234. package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -0
  235. package/dist/formats/webgl/core/inspectGlslEffectContainer.js.map +1 -0
  236. package/dist/formats/webgl/core/readGlslEffectContainer.js +303 -0
  237. package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -0
  238. package/dist/formats/webgl/index.js +2 -2
  239. package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
  240. package/dist/formats/webgpu/CjsWebgpuFormat.js.map +1 -1
  241. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -197
  242. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js.map +1 -1
  243. package/dist/formats/webgpu/core/{cewgpu/CewgpuContainer.js → carbonWebgpu/CarbonWebgpuContainer.js} +354 -368
  244. package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js.map +1 -0
  245. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/containerViews.js +355 -355
  246. package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js.map +1 -0
  247. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/validateContainer.js +90 -90
  248. package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js.map +1 -0
  249. package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
  250. package/dist/formats/webgpu/core/effectBackendBodySet.js +289 -289
  251. package/dist/formats/webgpu/core/effectBackendBodySet.js.map +1 -1
  252. package/dist/formats/webgpu/core/errors.js +20 -20
  253. package/dist/formats/webgpu/core/errors.js.map +1 -1
  254. package/dist/formats/webgpu/core/helpers.js +443 -443
  255. package/dist/formats/webgpu/core/helpers.js.map +1 -1
  256. package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
  257. package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
  258. package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
  259. package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
  260. package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
  261. package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
  262. package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
  263. package/dist/formats/webgpu/core/packageEffect.js +381 -385
  264. package/dist/formats/webgpu/core/packageEffect.js.map +1 -1
  265. package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
  266. package/dist/formats/webgpu/core/packageEffectSelection.js.map +1 -1
  267. package/dist/formats/webgpu/core/packageMetadata.js +17 -17
  268. package/dist/formats/webgpu/core/schema.js +4 -4
  269. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
  270. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js.map +1 -1
  271. package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
  272. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +320 -320
  273. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js.map +1 -1
  274. package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
  275. package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
  276. package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
  277. package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
  278. package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
  279. package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
  280. package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
  281. package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
  282. package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
  283. package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
  284. package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
  285. package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
  286. package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
  287. package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
  288. package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
  289. package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
  290. package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
  291. package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
  292. package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
  293. package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
  294. package/dist/formats/webgpu/index.js +2 -2
  295. package/dist/formats/webm/CjsWebmFormat.js +197 -197
  296. package/dist/formats/webm/core/helpers.js +572 -572
  297. package/dist/formats/webm/index.js +2 -2
  298. package/dist/formats/webp/CjsWebpFormat.js +140 -140
  299. package/dist/formats/webp/core/helpers.js +237 -237
  300. package/dist/formats/webp/index.js +2 -2
  301. package/dist/formats/wem/CjsWemFormat.js +250 -250
  302. package/dist/formats/wem/core/bitStream.js +261 -261
  303. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  304. package/dist/formats/wem/core/helpers.js +437 -437
  305. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  306. package/dist/formats/wem/core/ptadpcm.js +77 -77
  307. package/dist/formats/wem/core/resolve.js +121 -121
  308. package/dist/formats/wem/core/wemToOgg.js +485 -485
  309. package/dist/formats/wem/index.js +2 -2
  310. package/dist/formats/yaml/CjsYamlFormat.js +134 -134
  311. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  312. package/dist/formats/yaml/core/CjsYamlReader.js +400 -402
  313. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  314. package/dist/formats/yaml/core/helpers.js +196 -170
  315. package/dist/formats/yaml/core/helpers.js.map +1 -1
  316. package/dist/formats/yaml/index.js +2 -2
  317. package/dist/index.js +64 -62
  318. package/dist/index.js.map +1 -1
  319. package/dist/resource/CjsLoadingObject.js +19 -0
  320. package/dist/resource/CjsLoadingObject.js.map +1 -0
  321. package/dist/resource/CjsResource.js +801 -797
  322. package/dist/resource/CjsResource.js.map +1 -1
  323. package/dist/resource/ResourceHandlerMode.js +14 -0
  324. package/dist/resource/ResourceHandlerMode.js.map +1 -0
  325. package/dist/resource/Tr2LightProfileRes.js +32 -32
  326. package/dist/resource/audio/AudioGeometryResData.js +47 -47
  327. package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
  328. package/dist/resource/audio/CjsAudioRes.js +213 -213
  329. package/dist/resource/audio/index.js +4 -4
  330. package/dist/resource/geometry/MeshDecalData.js +37 -37
  331. package/dist/resource/geometry/MeshDecalLodData.js +34 -34
  332. package/dist/resource/geometry/TriGeometryRes.js +675 -675
  333. package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
  334. package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
  335. package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
  336. package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
  337. package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
  338. package/dist/resource/geometry/TriJointBinding.js +38 -38
  339. package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
  340. package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
  341. package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
  342. package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
  343. package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
  344. package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
  345. package/dist/resource/geometry/granny/enums.js +10 -10
  346. package/dist/resource/geometry/granny/index.js +6 -6
  347. package/dist/resource/geometry/index.js +17 -17
  348. package/dist/resource/index.js +54 -52
  349. package/dist/resource/index.js.map +1 -1
  350. package/dist/resource/resourceBoundary.js +64 -64
  351. package/dist/resource/shader/Tr2EffectRes.js +336 -431
  352. package/dist/resource/shader/Tr2EffectRes.js.map +1 -1
  353. package/dist/resource/shader/Tr2MaterialArea.js +31 -31
  354. package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
  355. package/dist/resource/shader/Tr2MaterialRes.js +31 -31
  356. package/dist/resource/shader/Tr2Shader.js +283 -261
  357. package/dist/resource/shader/Tr2Shader.js.map +1 -1
  358. package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
  359. package/dist/resource/shader/index.js +17 -17
  360. package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -135
  361. package/dist/resource/shader/reflection/Tr2EffectConstant.js.map +1 -1
  362. package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
  363. package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -109
  364. package/dist/resource/shader/reflection/Tr2EffectDescription.js.map +1 -1
  365. package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -147
  366. package/dist/resource/shader/reflection/Tr2EffectLibrary.js.map +1 -1
  367. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -105
  368. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js.map +1 -1
  369. package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -86
  370. package/dist/resource/shader/reflection/Tr2EffectResource.js.map +1 -1
  371. package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -241
  372. package/dist/resource/shader/reflection/Tr2EffectStageInput.js.map +1 -1
  373. package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -68
  374. package/dist/resource/shader/reflection/Tr2EffectTechnique.js.map +1 -1
  375. package/dist/resource/shader/reflection/Tr2Pass.js +168 -111
  376. package/dist/resource/shader/reflection/Tr2Pass.js.map +1 -1
  377. package/dist/resource/shader/reflection/carbonRecordFields.js +159 -0
  378. package/dist/resource/shader/reflection/carbonRecordFields.js.map +1 -0
  379. package/dist/resource/shader/reflection/shaderStage.js +22 -0
  380. package/dist/resource/shader/reflection/shaderStage.js.map +1 -0
  381. package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -77
  382. package/dist/resource/shader/sampler/Tr2SamplerSetup.js.map +1 -1
  383. package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
  384. package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
  385. package/dist/resource/texture/Tr2ImageRes.js +120 -120
  386. package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
  387. package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
  388. package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
  389. package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
  390. package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
  391. package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
  392. package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
  393. package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
  394. package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
  395. package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
  396. package/dist/resource/texture/TriTextureRes.js +359 -359
  397. package/dist/resource/texture/index.js +15 -15
  398. package/dist/resource/texture/texturePipelineBehavior.js +308 -308
  399. package/dist/worker/CjsResManMainThreadLoader.js +89 -87
  400. package/dist/worker/CjsResManMainThreadLoader.js.map +1 -1
  401. package/dist/worker/CjsResManWorker.js +218 -217
  402. package/dist/worker/CjsResManWorker.js.map +1 -1
  403. package/dist/worker/CjsResManWorkerLoader.js +437 -434
  404. package/dist/worker/CjsResManWorkerLoader.js.map +1 -1
  405. package/dist/worker/protocol.js +12 -12
  406. package/docs/README.md +98 -98
  407. package/docs/architecture.md +118 -109
  408. package/docs/concepts/resource-lifecycle.md +226 -225
  409. package/docs/concepts/shader-resource-model.md +111 -114
  410. package/docs/concepts/writing-an-engine-adapter.md +115 -115
  411. package/docs/formats/README.md +138 -136
  412. package/docs/formats/carbon-effect-container.md +553 -452
  413. package/docs/formats/dxbc/README.md +68 -68
  414. package/docs/formats/dxbc/architecture.md +80 -80
  415. package/docs/formats/dxbc/reference/api.md +77 -77
  416. package/docs/formats/dxbc/reference/classes/README.md +9 -9
  417. package/docs/formats/dxbc/reference/decoded-output.md +122 -122
  418. package/docs/formats/gr2.md +160 -160
  419. package/docs/formats/hlsl/README.md +54 -54
  420. package/docs/formats/hlsl/architecture.md +65 -67
  421. package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -62
  422. package/docs/formats/hlsl/guides/reading-effects.md +64 -64
  423. package/docs/formats/hlsl/reference/advanced-analysis.md +61 -66
  424. package/docs/formats/hlsl/reference/api.md +92 -98
  425. package/docs/formats/hlsl/reference/classes/README.md +11 -11
  426. package/docs/formats/hlsl/reference/json-graph.md +97 -100
  427. package/docs/formats/pickle.md +82 -0
  428. package/docs/formats/provenance.md +196 -196
  429. package/docs/formats/stl.md +37 -37
  430. package/docs/formats/webgl/README.md +115 -57
  431. package/docs/formats/webgl/architecture.md +69 -70
  432. package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
  433. package/docs/formats/webgl/decl-io.md +1234 -1234
  434. package/docs/formats/webgl/memory-structured.md +890 -871
  435. package/docs/formats/webgl/reference/classes/README.md +9 -9
  436. package/docs/formats/webgl/texture-sample.md +964 -964
  437. package/docs/formats/webgpu/README.md +84 -84
  438. package/docs/formats/webgpu/architecture.md +95 -96
  439. package/docs/formats/webgpu/formats/{cewgpu.md → carbon-webgpu.md} +215 -216
  440. package/docs/formats/webgpu/guides/effect-packaging.md +189 -191
  441. package/docs/formats/webgpu/reference/api.md +196 -197
  442. package/docs/formats/webgpu/reference/classes/README.md +9 -9
  443. package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1543
  444. package/docs/formats/wwise.md +146 -85
  445. package/docs/reference/classes/README.md +35 -35
  446. package/docs/reference/classes/audio.md +30 -30
  447. package/docs/reference/classes/core.md +216 -206
  448. package/docs/reference/classes/dropped.md +46 -46
  449. package/docs/reference/classes/formats.md +944 -952
  450. package/docs/reference/classes/resources.md +456 -456
  451. package/docs/reference/classes/texture.md +26 -26
  452. package/docs/reference/events.md +117 -117
  453. package/docs/reference/motherlode-cache.md +275 -275
  454. package/docs/reference/queues.md +194 -110
  455. package/docs/reference/reload.md +107 -107
  456. package/docs/reference/texture-arrays.md +113 -113
  457. package/docs/reference/texture-pipeline.md +53 -53
  458. package/docs/reference/workers.md +142 -135
  459. package/docs/roadmap.md +150 -150
  460. package/format-notices/black/LICENSE +21 -21
  461. package/format-notices/black/NOTICE +47 -47
  462. package/format-notices/bnk/LICENSE +21 -21
  463. package/format-notices/bnk/NOTICE +21 -21
  464. package/format-notices/cmf/LICENSE +21 -21
  465. package/format-notices/cmf/NOTICE +36 -36
  466. package/format-notices/dds/LICENSE +21 -21
  467. package/format-notices/dds/NOTICE +14 -14
  468. package/format-notices/dxbc/LICENSE +21 -21
  469. package/format-notices/dxbc/NOTICE +20 -20
  470. package/format-notices/fbx/LICENSE +21 -21
  471. package/format-notices/fbx/NOTICE +14 -14
  472. package/format-notices/flac/LICENSE +21 -21
  473. package/format-notices/flac/NOTICE +14 -14
  474. package/format-notices/gif/LICENSE +21 -21
  475. package/format-notices/gif/NOTICE +14 -14
  476. package/format-notices/gltf/LICENSE +21 -21
  477. package/format-notices/gltf/NOTICE +27 -27
  478. package/format-notices/gr2/LICENSE +21 -21
  479. package/format-notices/gr2/NOTICE +60 -60
  480. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
  481. package/format-notices/hlsl/LICENSE +21 -21
  482. package/format-notices/hlsl/NOTICE +25 -25
  483. package/format-notices/jpeg/LICENSE +21 -21
  484. package/format-notices/jpeg/NOTICE +14 -14
  485. package/format-notices/mp3/LICENSE +21 -21
  486. package/format-notices/mp3/NOTICE +14 -14
  487. package/format-notices/mp4/LICENSE +21 -21
  488. package/format-notices/mp4/NOTICE +14 -14
  489. package/format-notices/obj/LICENSE +21 -21
  490. package/format-notices/obj/NOTICE +26 -26
  491. package/format-notices/ogg/LICENSE +21 -21
  492. package/format-notices/ogg/NOTICE +28 -28
  493. package/format-notices/png/LICENSE +21 -21
  494. package/format-notices/png/NOTICE +14 -14
  495. package/format-notices/red/LICENSE +21 -21
  496. package/format-notices/red/NOTICE +31 -31
  497. package/format-notices/stl/LICENSE +21 -21
  498. package/format-notices/stl/NOTICE +21 -21
  499. package/format-notices/tga/LICENSE +21 -21
  500. package/format-notices/tga/NOTICE +14 -14
  501. package/format-notices/wav/LICENSE +21 -21
  502. package/format-notices/wav/NOTICE +14 -14
  503. package/format-notices/webgl/LICENSE +21 -21
  504. package/format-notices/webgl/NOTICE +35 -35
  505. package/format-notices/webgpu/LICENSE +21 -21
  506. package/format-notices/webgpu/NOTICE +31 -31
  507. package/format-notices/webm/LICENSE +21 -21
  508. package/format-notices/webm/NOTICE +14 -14
  509. package/format-notices/webp/LICENSE +21 -21
  510. package/format-notices/webp/NOTICE +14 -14
  511. package/format-notices/wem/LICENSE +57 -57
  512. package/format-notices/wem/NOTICE +33 -33
  513. package/format-notices/yaml/LICENSE +21 -21
  514. package/format-notices/yaml/NOTICE +44 -44
  515. package/package.json +63 -63
  516. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js +0 -372
  517. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js.map +0 -1
  518. package/dist/format/effect/effectReflectionPackage.js +0 -636
  519. package/dist/format/effect/effectReflectionPackage.js.map +0 -1
  520. package/dist/formats/hlsl/core/HlslReader.js +0 -16
  521. package/dist/formats/hlsl/core/HlslReader.js.map +0 -1
  522. package/dist/formats/hlsl/core/portableReflection.js +0 -848
  523. package/dist/formats/hlsl/core/portableReflection.js.map +0 -1
  524. package/dist/formats/hlsl/portable.js +0 -2
  525. package/dist/formats/hlsl/portable.js.map +0 -1
  526. package/dist/formats/webgl/core/cewg/CewgPackage.js +0 -340
  527. package/dist/formats/webgl/core/cewg/CewgPackage.js.map +0 -1
  528. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js +0 -104
  529. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js.map +0 -1
  530. package/dist/formats/webgl/core/cewg/binary.js +0 -19
  531. package/dist/formats/webgl/core/cewg/binary.js.map +0 -1
  532. package/dist/formats/webgl/core/cewgCompleteness.js.map +0 -1
  533. package/dist/formats/webgl/core/effectPackageValidation.js +0 -331
  534. package/dist/formats/webgl/core/effectPackageValidation.js.map +0 -1
  535. package/dist/formats/webgpu/core/cewgpu/CewgpuContainer.js.map +0 -1
  536. package/dist/formats/webgpu/core/cewgpu/containerViews.js.map +0 -1
  537. package/dist/formats/webgpu/core/cewgpu/validateContainer.js.map +0 -1
  538. package/dist/resource/shader/portable.js +0 -33
  539. package/dist/resource/shader/portable.js.map +0 -1
  540. package/docs/formats/hlsl/reference/portable-reflection.md +0 -141
  541. package/docs/formats/webgl/effect-reflection.md +0 -127
@@ -1,277 +1,277 @@
1
- /**
2
- * Builds a CMF document from normalized shared geometry for the CMF format
3
- * reader.
4
- */
5
- function buildCmfFromShared(input) {
6
- const root = input && input.meshes ? input : {
7
- meshes: [input]
8
- };
9
- return {
10
- version: 1,
11
- metadata: normalizeMetadata(root.metadata),
12
- meshes: (root.meshes ?? []).map(mesh => buildMesh(mesh)),
13
- skeletons: root.skeletons ?? [],
14
- animations: root.animations ?? []
15
- };
16
- }
17
-
18
- /**
19
- * Builds normalized shared geometry from a CMF document for the CMF format
20
- * reader.
21
- */
22
- function buildSharedFromCmf(raw, classes, hydrationOptions = {}) {
23
- const hydrationClasses = createHydrationClasses(classes, hydrationOptions);
24
- return hydrate("Root", {
25
- cmfVersion: raw.version,
26
- metadata: raw.metadata ? hydrateMetadata(raw.metadata, hydrationClasses) : null,
27
- meshes: raw.meshes.map(mesh => hydrateSharedMesh(mesh, hydrationClasses)),
28
- skeletons: raw.skeletons.map(skeleton => hydrateSkeleton(skeleton, hydrationClasses)),
29
- animations: raw.animations.map(animation => hydrateAnimation(animation, hydrationClasses))
30
- }, hydrationClasses, hydrationOptions);
31
- }
32
- function buildMesh(mesh) {
33
- const vertex = mesh.vertex ?? {},
34
- position = vertex.position ?? [],
35
- boneBindings = (mesh.boneBindings ?? []).map(binding => buildBoneBinding(binding)),
36
- affectedByBones = boneBindings.length > 0,
37
- morphTargets = buildMorphTargets(mesh),
38
- affectedByMorphTargets = morphTargets.targets.length > 0,
39
- stride = estimateVertexStride(vertex),
40
- vertexCount = stride === 0 ? 0 : Math.floor(position.length / 3);
41
- return {
42
- name: mesh.name ?? "",
43
- decl: buildDecl(vertex),
44
- lods: [{
45
- vb: {
46
- index: 1,
47
- offset: 0,
48
- size: vertexCount * stride,
49
- stride
50
- },
51
- ib: {
52
- index: 2,
53
- offset: 0,
54
- size: totalIndexCount(mesh.indices) * bytesPerIndex(mesh.indices),
55
- stride: bytesPerIndex(mesh.indices)
56
- },
57
- areas: (mesh.indices ?? []).map((group, index) => ({
58
- firstElement: firstTriangle(mesh.indices, index),
59
- elementCount: Math.floor((group.faces ?? []).length / 3)
60
- })),
61
- morphTargets: morphTargets.lods,
62
- threshold: 0xffffffff,
63
- vertex,
64
- indices: mesh.indices ?? []
65
- }],
66
- areas: (mesh.indices ?? []).map(group => ({
67
- name: group.name ?? "",
68
- bounds: boundsFromShared(mesh),
69
- bones: [],
70
- affectedByBones,
71
- affectedByMorphTargets
72
- })),
73
- boneBindings,
74
- morphTargets: {
75
- decl: morphTargets.decl,
76
- targets: morphTargets.targets
77
- },
78
- uvDensities: [],
79
- bounds: boundsFromShared(mesh),
80
- audioOcclusionMesh: {
81
- vertices: [],
82
- indices: [],
83
- bounds: {
84
- min: [0, 0, 0],
85
- max: [0, 0, 0]
86
- }
87
- },
88
- topology: "TriangleList",
89
- skeleton: mesh.skeleton ?? null,
90
- vertex,
91
- indices: mesh.indices ?? []
92
- };
93
- }
94
- function buildMorphTargets(mesh) {
95
- const targets = mesh.morphTargets ?? [];
96
- if (!targets.length) {
97
- return {
98
- decl: [],
99
- targets: [],
100
- lods: []
101
- };
102
- }
103
- const firstVertex = targets.find(target => target.vertex)?.vertex ?? {},
104
- decl = buildDecl(firstVertex),
105
- stride = estimateStrideFromDecl(decl);
106
- return {
107
- decl,
108
- targets: targets.map(target => ({
109
- name: target.name ?? "",
110
- maxDisplacement: target.maxDisplacement ?? maxDisplacement(mesh.vertex?.position ?? [], target.vertex?.position ?? [])
111
- })),
112
- lods: targets.map(target => {
113
- const morphVertex = target.vertex ?? {},
114
- vertexCount = Math.floor((morphVertex.position ?? []).length / 3);
115
- return {
116
- vb: {
117
- index: 0,
118
- offset: 0,
119
- size: vertexCount * stride,
120
- stride
121
- },
122
- vertex: morphVertex
123
- };
124
- })
125
- };
126
- }
127
- function buildBoneBinding(binding) {
128
- return {
129
- name: binding.name ?? "",
130
- bounds: {
131
- min: binding.minBounds ?? binding.bounds?.min ?? [0, 0, 0],
132
- max: binding.maxBounds ?? binding.bounds?.max ?? [0, 0, 0]
133
- }
134
- };
135
- }
136
- function buildDecl(vertex) {
137
- const decl = [];
138
- let offset = 0;
139
- for (const channel of [["position", "Position", 3], ["normal", "Normal", 3], ["tangent", "Tangent", 3], ["binormal", "Binormal", 3], ["texcoord0", "TexCoord", 2, 0], ["texcoord1", "TexCoord", 2, 1], ["color0", "Color", 4, 0], ["blendIndice", "BoneIndices", 4, 0, "UInt16"], ["blendWeight", "BoneWeights", 4, 0], ["packedTangent", "PackedTangent", 4, 0, "Int16Norm"], ["packedTangentLegacy", "PackedTangentLegacy", 4, 0, "UInt16Norm"]]) {
140
- const [name, usage, count, usageIndex = 0, type = "Float32"] = channel;
141
- if (!Array.isArray(vertex[name]) || vertex[name].length === 0) {
142
- continue;
143
- }
144
- decl.push({
145
- usage,
146
- usageIndex,
147
- type,
148
- elementCount: count,
149
- offset
150
- });
151
- offset += count * elementTypeSize(type);
152
- }
153
- return decl;
154
- }
155
- function estimateVertexStride(vertex) {
156
- return estimateStrideFromDecl(buildDecl(vertex));
157
- }
158
- function estimateStrideFromDecl(decl) {
159
- return decl.reduce((stride, element) => Math.max(stride, element.offset + element.elementCount * elementTypeSize(element.type)), 0);
160
- }
161
- function elementTypeSize(type) {
162
- return type === "Float32" ? 4 : type.includes("16") ? 2 : 1;
163
- }
164
- function totalIndexCount(indices = []) {
165
- return indices.reduce((total, group) => total + (group.faces?.length ?? 0), 0);
166
- }
167
- function bytesPerIndex(indices = []) {
168
- return indices.some(group => group.bytesPerIndex === 4 || (group.faces ?? []).some(index => index > 0xffff)) ? 4 : 2;
169
- }
170
- function firstTriangle(indices = [], areaIndex) {
171
- let first = 0;
172
- for (let i = 0; i < areaIndex; i++) {
173
- first += Math.floor((indices[i].faces ?? []).length / 3);
174
- }
175
- return first;
176
- }
177
- function boundsFromShared(mesh) {
178
- return {
179
- min: mesh.minBounds ?? mesh.bounds?.min ?? [0, 0, 0],
180
- max: mesh.maxBounds ?? mesh.bounds?.max ?? [0, 0, 0]
181
- };
182
- }
183
- function maxDisplacement(basePositions, targetPositions) {
184
- let max = 0;
185
- for (let i = 0; i < Math.min(basePositions.length, targetPositions.length); i += 3) {
186
- max = Math.max(max, Math.hypot(targetPositions[i] - basePositions[i], targetPositions[i + 1] - basePositions[i + 1], targetPositions[i + 2] - basePositions[i + 2]));
187
- }
188
- return max;
189
- }
190
- function normalizeMetadata(metadata) {
191
- if (!metadata) return null;
192
- if (Array.isArray(metadata.entries)) return metadata;
193
- return {
194
- entries: Object.entries(metadata).map(([key, value]) => ({
195
- key,
196
- value: String(value)
197
- }))
198
- };
199
- }
200
- function hydrateSharedMesh(mesh, classes) {
201
- return hydrate("Mesh", {
202
- name: mesh.name,
203
- morphTargets: mesh.morphTargets.targets.map((target, index) => hydrate("MorphTarget", {
204
- ...target,
205
- vertex: mesh.lods[0]?.morphTargets[index]?.vertex ?? null
206
- }, classes)),
207
- minBounds: mesh.bounds.min,
208
- maxBounds: mesh.bounds.max,
209
- boneBindings: mesh.boneBindings.map(binding => hydrate("BoneBinding", {
210
- name: binding.name,
211
- minBounds: binding.bounds.min,
212
- maxBounds: binding.bounds.max
213
- }, classes)),
214
- vertex: mesh.vertex ?? emptyVertex(),
215
- indices: (mesh.indices ?? []).map(group => hydrate("IndexGroup", {
216
- name: group.name,
217
- bytesPerIndex: group.bytesPerIndex,
218
- faces: group.faces
219
- }, classes)),
220
- lods: mesh.lods,
221
- topology: mesh.topology,
222
- skeleton: mesh.skeleton
223
- }, classes);
224
- }
225
- function hydrateMetadata(metadata, classes) {
226
- return hydrate("Metadata", {
227
- entries: metadata.entries.map(entry => hydrate("MetadataEntry", entry, classes))
228
- }, classes);
229
- }
230
- function hydrateSkeleton(skeleton, classes) {
231
- return hydrate("Skeleton", skeleton, classes);
232
- }
233
- function hydrateAnimation(animation, classes) {
234
- return hydrate("Animation", animation, classes);
235
- }
236
- function emptyVertex() {
237
- return {
238
- position: [],
239
- normal: [],
240
- tangent: [],
241
- binormal: [],
242
- texcoord0: [],
243
- texcoord1: [],
244
- color0: [],
245
- blendIndice: [],
246
- blendWeight: [],
247
- packedTangent: [],
248
- packedTangentLegacy: []
249
- };
250
- }
251
- function hydrate(type, fields, classes, hydrationOptions = {}) {
252
- const Class = classes?.[type];
253
- const options = Object.keys(hydrationOptions).length > 0 ? hydrationOptions : classes?.__hydrationOptions || {};
254
- return Class ? populate(new Class(), fields, options) : fields;
255
- }
256
- function populate(instance, fields, hydrationOptions = {}) {
257
- if (!instance || typeof instance.SetValues !== "function") {
258
- throw new TypeError("CjsCmfFormat shared class population requires classes to implement SetValues(values)");
259
- }
260
- instance.SetValues(fields, {
261
- ...hydrationOptions,
262
- skipUpdate: true,
263
- skipEvents: true
264
- });
265
- return instance;
266
- }
267
- function createHydrationClasses(classes, hydrationOptions) {
268
- const map = Object.create(classes || null);
269
- Object.defineProperty(map, "__hydrationOptions", {
270
- value: hydrationOptions,
271
- enumerable: false
272
- });
273
- return map;
274
- }
275
-
276
- export { buildCmfFromShared, buildSharedFromCmf };
277
- //# sourceMappingURL=shared.js.map
1
+ /**
2
+ * Builds a CMF document from normalized shared geometry for the CMF format
3
+ * reader.
4
+ */
5
+ function buildCmfFromShared(input) {
6
+ const root = input && input.meshes ? input : {
7
+ meshes: [input]
8
+ };
9
+ return {
10
+ version: 1,
11
+ metadata: normalizeMetadata(root.metadata),
12
+ meshes: (root.meshes ?? []).map(mesh => buildMesh(mesh)),
13
+ skeletons: root.skeletons ?? [],
14
+ animations: root.animations ?? []
15
+ };
16
+ }
17
+
18
+ /**
19
+ * Builds normalized shared geometry from a CMF document for the CMF format
20
+ * reader.
21
+ */
22
+ function buildSharedFromCmf(raw, classes, hydrationOptions = {}) {
23
+ const hydrationClasses = createHydrationClasses(classes, hydrationOptions);
24
+ return hydrate("Root", {
25
+ cmfVersion: raw.version,
26
+ metadata: raw.metadata ? hydrateMetadata(raw.metadata, hydrationClasses) : null,
27
+ meshes: raw.meshes.map(mesh => hydrateSharedMesh(mesh, hydrationClasses)),
28
+ skeletons: raw.skeletons.map(skeleton => hydrateSkeleton(skeleton, hydrationClasses)),
29
+ animations: raw.animations.map(animation => hydrateAnimation(animation, hydrationClasses))
30
+ }, hydrationClasses, hydrationOptions);
31
+ }
32
+ function buildMesh(mesh) {
33
+ const vertex = mesh.vertex ?? {},
34
+ position = vertex.position ?? [],
35
+ boneBindings = (mesh.boneBindings ?? []).map(binding => buildBoneBinding(binding)),
36
+ affectedByBones = boneBindings.length > 0,
37
+ morphTargets = buildMorphTargets(mesh),
38
+ affectedByMorphTargets = morphTargets.targets.length > 0,
39
+ stride = estimateVertexStride(vertex),
40
+ vertexCount = stride === 0 ? 0 : Math.floor(position.length / 3);
41
+ return {
42
+ name: mesh.name ?? "",
43
+ decl: buildDecl(vertex),
44
+ lods: [{
45
+ vb: {
46
+ index: 1,
47
+ offset: 0,
48
+ size: vertexCount * stride,
49
+ stride
50
+ },
51
+ ib: {
52
+ index: 2,
53
+ offset: 0,
54
+ size: totalIndexCount(mesh.indices) * bytesPerIndex(mesh.indices),
55
+ stride: bytesPerIndex(mesh.indices)
56
+ },
57
+ areas: (mesh.indices ?? []).map((group, index) => ({
58
+ firstElement: firstTriangle(mesh.indices, index),
59
+ elementCount: Math.floor((group.faces ?? []).length / 3)
60
+ })),
61
+ morphTargets: morphTargets.lods,
62
+ threshold: 0xffffffff,
63
+ vertex,
64
+ indices: mesh.indices ?? []
65
+ }],
66
+ areas: (mesh.indices ?? []).map(group => ({
67
+ name: group.name ?? "",
68
+ bounds: boundsFromShared(mesh),
69
+ bones: [],
70
+ affectedByBones,
71
+ affectedByMorphTargets
72
+ })),
73
+ boneBindings,
74
+ morphTargets: {
75
+ decl: morphTargets.decl,
76
+ targets: morphTargets.targets
77
+ },
78
+ uvDensities: [],
79
+ bounds: boundsFromShared(mesh),
80
+ audioOcclusionMesh: {
81
+ vertices: [],
82
+ indices: [],
83
+ bounds: {
84
+ min: [0, 0, 0],
85
+ max: [0, 0, 0]
86
+ }
87
+ },
88
+ topology: "TriangleList",
89
+ skeleton: mesh.skeleton ?? null,
90
+ vertex,
91
+ indices: mesh.indices ?? []
92
+ };
93
+ }
94
+ function buildMorphTargets(mesh) {
95
+ const targets = mesh.morphTargets ?? [];
96
+ if (!targets.length) {
97
+ return {
98
+ decl: [],
99
+ targets: [],
100
+ lods: []
101
+ };
102
+ }
103
+ const firstVertex = targets.find(target => target.vertex)?.vertex ?? {},
104
+ decl = buildDecl(firstVertex),
105
+ stride = estimateStrideFromDecl(decl);
106
+ return {
107
+ decl,
108
+ targets: targets.map(target => ({
109
+ name: target.name ?? "",
110
+ maxDisplacement: target.maxDisplacement ?? maxDisplacement(mesh.vertex?.position ?? [], target.vertex?.position ?? [])
111
+ })),
112
+ lods: targets.map(target => {
113
+ const morphVertex = target.vertex ?? {},
114
+ vertexCount = Math.floor((morphVertex.position ?? []).length / 3);
115
+ return {
116
+ vb: {
117
+ index: 0,
118
+ offset: 0,
119
+ size: vertexCount * stride,
120
+ stride
121
+ },
122
+ vertex: morphVertex
123
+ };
124
+ })
125
+ };
126
+ }
127
+ function buildBoneBinding(binding) {
128
+ return {
129
+ name: binding.name ?? "",
130
+ bounds: {
131
+ min: binding.minBounds ?? binding.bounds?.min ?? [0, 0, 0],
132
+ max: binding.maxBounds ?? binding.bounds?.max ?? [0, 0, 0]
133
+ }
134
+ };
135
+ }
136
+ function buildDecl(vertex) {
137
+ const decl = [];
138
+ let offset = 0;
139
+ for (const channel of [["position", "Position", 3], ["normal", "Normal", 3], ["tangent", "Tangent", 3], ["binormal", "Binormal", 3], ["texcoord0", "TexCoord", 2, 0], ["texcoord1", "TexCoord", 2, 1], ["color0", "Color", 4, 0], ["blendIndice", "BoneIndices", 4, 0, "UInt16"], ["blendWeight", "BoneWeights", 4, 0], ["packedTangent", "PackedTangent", 4, 0, "Int16Norm"], ["packedTangentLegacy", "PackedTangentLegacy", 4, 0, "UInt16Norm"]]) {
140
+ const [name, usage, count, usageIndex = 0, type = "Float32"] = channel;
141
+ if (!Array.isArray(vertex[name]) || vertex[name].length === 0) {
142
+ continue;
143
+ }
144
+ decl.push({
145
+ usage,
146
+ usageIndex,
147
+ type,
148
+ elementCount: count,
149
+ offset
150
+ });
151
+ offset += count * elementTypeSize(type);
152
+ }
153
+ return decl;
154
+ }
155
+ function estimateVertexStride(vertex) {
156
+ return estimateStrideFromDecl(buildDecl(vertex));
157
+ }
158
+ function estimateStrideFromDecl(decl) {
159
+ return decl.reduce((stride, element) => Math.max(stride, element.offset + element.elementCount * elementTypeSize(element.type)), 0);
160
+ }
161
+ function elementTypeSize(type) {
162
+ return type === "Float32" ? 4 : type.includes("16") ? 2 : 1;
163
+ }
164
+ function totalIndexCount(indices = []) {
165
+ return indices.reduce((total, group) => total + (group.faces?.length ?? 0), 0);
166
+ }
167
+ function bytesPerIndex(indices = []) {
168
+ return indices.some(group => group.bytesPerIndex === 4 || (group.faces ?? []).some(index => index > 0xffff)) ? 4 : 2;
169
+ }
170
+ function firstTriangle(indices = [], areaIndex) {
171
+ let first = 0;
172
+ for (let i = 0; i < areaIndex; i++) {
173
+ first += Math.floor((indices[i].faces ?? []).length / 3);
174
+ }
175
+ return first;
176
+ }
177
+ function boundsFromShared(mesh) {
178
+ return {
179
+ min: mesh.minBounds ?? mesh.bounds?.min ?? [0, 0, 0],
180
+ max: mesh.maxBounds ?? mesh.bounds?.max ?? [0, 0, 0]
181
+ };
182
+ }
183
+ function maxDisplacement(basePositions, targetPositions) {
184
+ let max = 0;
185
+ for (let i = 0; i < Math.min(basePositions.length, targetPositions.length); i += 3) {
186
+ max = Math.max(max, Math.hypot(targetPositions[i] - basePositions[i], targetPositions[i + 1] - basePositions[i + 1], targetPositions[i + 2] - basePositions[i + 2]));
187
+ }
188
+ return max;
189
+ }
190
+ function normalizeMetadata(metadata) {
191
+ if (!metadata) return null;
192
+ if (Array.isArray(metadata.entries)) return metadata;
193
+ return {
194
+ entries: Object.entries(metadata).map(([key, value]) => ({
195
+ key,
196
+ value: String(value)
197
+ }))
198
+ };
199
+ }
200
+ function hydrateSharedMesh(mesh, classes) {
201
+ return hydrate("Mesh", {
202
+ name: mesh.name,
203
+ morphTargets: mesh.morphTargets.targets.map((target, index) => hydrate("MorphTarget", {
204
+ ...target,
205
+ vertex: mesh.lods[0]?.morphTargets[index]?.vertex ?? null
206
+ }, classes)),
207
+ minBounds: mesh.bounds.min,
208
+ maxBounds: mesh.bounds.max,
209
+ boneBindings: mesh.boneBindings.map(binding => hydrate("BoneBinding", {
210
+ name: binding.name,
211
+ minBounds: binding.bounds.min,
212
+ maxBounds: binding.bounds.max
213
+ }, classes)),
214
+ vertex: mesh.vertex ?? emptyVertex(),
215
+ indices: (mesh.indices ?? []).map(group => hydrate("IndexGroup", {
216
+ name: group.name,
217
+ bytesPerIndex: group.bytesPerIndex,
218
+ faces: group.faces
219
+ }, classes)),
220
+ lods: mesh.lods,
221
+ topology: mesh.topology,
222
+ skeleton: mesh.skeleton
223
+ }, classes);
224
+ }
225
+ function hydrateMetadata(metadata, classes) {
226
+ return hydrate("Metadata", {
227
+ entries: metadata.entries.map(entry => hydrate("MetadataEntry", entry, classes))
228
+ }, classes);
229
+ }
230
+ function hydrateSkeleton(skeleton, classes) {
231
+ return hydrate("Skeleton", skeleton, classes);
232
+ }
233
+ function hydrateAnimation(animation, classes) {
234
+ return hydrate("Animation", animation, classes);
235
+ }
236
+ function emptyVertex() {
237
+ return {
238
+ position: [],
239
+ normal: [],
240
+ tangent: [],
241
+ binormal: [],
242
+ texcoord0: [],
243
+ texcoord1: [],
244
+ color0: [],
245
+ blendIndice: [],
246
+ blendWeight: [],
247
+ packedTangent: [],
248
+ packedTangentLegacy: []
249
+ };
250
+ }
251
+ function hydrate(type, fields, classes, hydrationOptions = {}) {
252
+ const Class = classes?.[type];
253
+ const options = Object.keys(hydrationOptions).length > 0 ? hydrationOptions : classes?.__hydrationOptions || {};
254
+ return Class ? populate(new Class(), fields, options) : fields;
255
+ }
256
+ function populate(instance, fields, hydrationOptions = {}) {
257
+ if (!instance || typeof instance.SetValues !== "function") {
258
+ throw new TypeError("CjsCmfFormat shared class population requires classes to implement SetValues(values)");
259
+ }
260
+ instance.SetValues(fields, {
261
+ ...hydrationOptions,
262
+ skipUpdate: true,
263
+ skipEvents: true
264
+ });
265
+ return instance;
266
+ }
267
+ function createHydrationClasses(classes, hydrationOptions) {
268
+ const map = Object.create(classes || null);
269
+ Object.defineProperty(map, "__hydrationOptions", {
270
+ value: hydrationOptions,
271
+ enumerable: false
272
+ });
273
+ return map;
274
+ }
275
+
276
+ export { buildCmfFromShared, buildSharedFromCmf };
277
+ //# sourceMappingURL=shared.js.map