@carbonenginejs/runtime-resource 0.12.1 → 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,675 +1,675 @@
1
- import { CjsSchema, carbon, impl, type, io } from '@carbonenginejs/runtime-utils/schema';
2
- import { box3 } from '@carbonenginejs/runtime-utils/box3';
3
- import { triangleNormalTo } from '@carbonenginejs/runtime-utils/mesh';
4
- import { ray3 } from '@carbonenginejs/runtime-utils/ray3';
5
- import { sph3 } from '@carbonenginejs/runtime-utils/sph3';
6
- import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
7
- import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
8
- import { CjsResource } from '../CjsResource.js';
9
- import { assertResourcePayloadObject, assertResourcePayloadArray, resourcePayloadError, resourceBoundaryError } from '../resourceBoundary.js';
10
-
11
- // Source: trinity/trinity/Resources/TriGeometryRes.h
12
- // Source: trinity/trinity/Resources/TriGeometryRes.cpp
13
- // Source: trinity/trinity/Resources/TriGeometryRes_Blue.cpp
14
-
15
- /**
16
- * Resource record that owns geometry payload facts (meshes, optional
17
- * skeletons and animations) and LOD-force metadata, while engine packages
18
- * decide device buffers, vertex declarations, and draw-time state.
19
- *
20
- * Geometry inspection composes the generic math supplied by runtime-utils
21
- * with resource-specific payload traversal.
22
- */
23
- class TriGeometryRes extends CjsResource {
24
- forceLod = false;
25
- forcedLodIndex = -1;
26
- name = "";
27
-
28
- /** Creates a TriGeometryRes with caller-provided initial state. */
29
- constructor(values = null) {
30
- super();
31
- this.SetValues(values || {}, {
32
- markDirty: false,
33
- skipUpdate: true,
34
- skipEvents: true
35
- });
36
- }
37
-
38
- /**
39
- * Attach a plain geometry payload.
40
- *
41
- * @param {object|null} payload
42
- * @param {object|null} options
43
- * @returns {TriGeometryRes}
44
- */
45
- SetPayload(payload = null, options = null) {
46
- if (payload === null) {
47
- super.SetPayload(null);
48
- return this;
49
- }
50
- assertResourcePayloadObject("TriGeometryRes", payload);
51
- assertResourcePayloadArray("TriGeometryRes", payload, "meshes");
52
- for (const field of ["skeletons", "animations"]) {
53
- if (payload[field] !== undefined && !Array.isArray(payload[field])) {
54
- throw resourcePayloadError("TriGeometryRes", "Expected an array when provided.", field);
55
- }
56
- }
57
- super.SetPayload(payload);
58
- this.SetValues(options || {});
59
- return this;
60
- }
61
-
62
- /**
63
- * Get mesh count from the CPU geometry payload.
64
- *
65
- * @returns {number}
66
- */
67
- GetMeshCount() {
68
- return this.GetPayload()?.meshes?.length || 0;
69
- }
70
-
71
- /**
72
- * Get animation count from the CPU geometry payload.
73
- *
74
- * @returns {number}
75
- */
76
- GetAnimationCount() {
77
- return this.GetPayload()?.animations?.length || 0;
78
- }
79
-
80
- /**
81
- * Get skeleton count from the CPU geometry payload.
82
- *
83
- * @returns {number}
84
- */
85
- GetSkeletonCount() {
86
- return this.GetPayload()?.skeletons?.length || 0;
87
- }
88
-
89
- /**
90
- * Get one resource-owned skeleton from the CPU geometry payload.
91
- *
92
- * @param {number} skeletonIndex
93
- * @returns {*}
94
- */
95
- GetSkeletonData(skeletonIndex = 0) {
96
- const index = Number(skeletonIndex);
97
- if (!Number.isInteger(index) || index < 0) {
98
- return null;
99
- }
100
- return this.GetPayload()?.skeletons?.[index] || null;
101
- }
102
-
103
- /**
104
- * Get mesh area count from a CPU geometry payload mesh.
105
- *
106
- * @param {number} meshIndex
107
- * @returns {number}
108
- */
109
- GetMeshAreaCount(meshIndex = 0) {
110
- const mesh = this.GetPayload()?.meshes?.[meshIndex];
111
- return mesh?.areas?.length || 0;
112
- }
113
-
114
- /**
115
- * Get mesh name from a CPU geometry payload.
116
- *
117
- * @param {number} meshIndex
118
- * @returns {string}
119
- */
120
- GetMeshName(meshIndex = 0) {
121
- return this.GetPayload()?.meshes?.[meshIndex]?.name || "";
122
- }
123
-
124
- /**
125
- * Get mesh area name from a CPU geometry payload.
126
- *
127
- * @param {number} meshIndex
128
- * @param {number} areaIndex
129
- * @returns {string}
130
- */
131
- GetMeshAreaName(meshIndex = 0, areaIndex = 0) {
132
- return this.GetPayload()?.meshes?.[meshIndex]?.areas?.[areaIndex]?.name || "";
133
- }
134
-
135
- /**
136
- * Get area bounding box from geometry payload data.
137
- *
138
- * @param {number} meshIndex
139
- * @param {number} areaIndex
140
- * @param {ArrayLike<number>|null} outMin
141
- * @param {ArrayLike<number>|null} outMax
142
- * @returns {*|boolean}
143
- */
144
- GetAreaBoundingBox(meshIndex = 0, areaIndex = 0, outMin = null, outMax = null) {
145
- const area = TriGeometryRes.getMeshAreas(this.GetPayload()?.meshes?.[meshIndex])?.[areaIndex];
146
- const bounds = TriGeometryRes.getBounds(area);
147
- return TriGeometryRes.copyBounds(bounds, outMin, outMax);
148
- }
149
-
150
- /**
151
- * Get mesh bounding box from geometry payload data.
152
- * @param {number} meshIndex
153
- * @param {ArrayLike<number>|null} outMin
154
- * @param {ArrayLike<number>|null} outMax
155
- * @returns {*|boolean}
156
- */
157
- GetBoundingBox(meshIndex = 0, outMin = null, outMax = null) {
158
- const payload = this.GetPayload();
159
- const bounds = TriGeometryRes.getBounds(payload?.meshes?.[meshIndex]) || TriGeometryRes.getBounds(payload);
160
- return TriGeometryRes.copyBounds(bounds, outMin, outMax);
161
- }
162
-
163
- /**
164
- * Get mesh bounding sphere from geometry payload data.
165
- * @param {number} meshIndex
166
- * @param {ArrayLike<number>|null} out
167
- * @returns {*|boolean}
168
- */
169
- GetBoundingSphere(meshIndex = 0, out = null) {
170
- const payload = this.GetPayload();
171
- const sphere = TriGeometryRes.getSphere(payload?.meshes?.[meshIndex]) || TriGeometryRes.getSphere(payload);
172
- if (!out) return sphere;
173
- if (!sphere) return false;
174
- vec4.copy(out, sphere);
175
- return true;
176
- }
177
-
178
- /**
179
- * Calculate a transformed bounding box from canonical CPU vertex data.
180
- *
181
- * Carbon stores the same matrix bytes as gl-matrix; transforming one point
182
- * therefore uses the ordinary column-vector index layout.
183
- *
184
- * @param {number} meshIndex
185
- * @param {ArrayLike<number>} transform
186
- * @returns {{min: number[], max: number[]}|null}
187
- */
188
- CalculateBoundingBoxFromTransform(meshIndex = 0, transform = null) {
189
- if (!transform || transform.length < 16) {
190
- throw new TypeError("TriGeometryRes transform must contain 16 matrix elements.");
191
- }
192
- const mesh = this.GetPayload()?.meshes?.[meshIndex];
193
- if (!mesh) return null;
194
- const positions = TriGeometryRes.getMeshPositions(mesh);
195
- const sourceBounds = TriGeometryRes.getBounds(mesh);
196
- if (!positions && !sourceBounds) return null;
197
- const bounds = box3.alloc(),
198
- point = vec3.alloc();
199
- try {
200
- if (!TriGeometryRes.setBoundsFromPositions(bounds, positions, point)) {
201
- if (!sourceBounds) return null;
202
- box3.fromBounds(bounds, sourceBounds.min, sourceBounds.max);
203
- }
204
- box3.transformMat4(bounds, bounds, transform);
205
- return {
206
- min: [bounds[0], bounds[1], bounds[2]],
207
- max: [bounds[3], bounds[4], bounds[5]]
208
- };
209
- } finally {
210
- vec3.unalloc(point);
211
- box3.unalloc(bounds);
212
- }
213
- }
214
-
215
- /**
216
- * Recalculate bounding sphere data from canonical CPU vertex positions.
217
- *
218
- * @returns {boolean}
219
- */
220
- RecalculateBoundingSphere() {
221
- let updated = false;
222
- const sphere = sph3.alloc(),
223
- point = vec3.alloc();
224
- try {
225
- for (const mesh of this.GetPayload()?.meshes || []) {
226
- if (!TriGeometryRes.calculateMeshSphere(sphere, mesh, point)) continue;
227
- TriGeometryRes.setMeshSphere(mesh, sphere);
228
- updated = true;
229
- }
230
- return updated;
231
- } finally {
232
- vec3.unalloc(point);
233
- sph3.unalloc(sphere);
234
- }
235
- }
236
-
237
- /**
238
- * Reloading belongs to the resource manager because it owns source and
239
- * canonical replacement policy.
240
- *
241
- * @throws {Error}
242
- */
243
- Reload() {
244
- throw resourceBoundaryError("TriGeometryRes", "Reload", "Request a reload through CjsResMan so source reads and canonical replacement remain manager-owned.");
245
- }
246
-
247
- /**
248
- * Intersect a ray with canonical CPU triangle data.
249
- *
250
- * @param {ArrayLike<number>} position
251
- * @param {ArrayLike<number>} direction
252
- * @returns {object}
253
- */
254
- GetIntersectionPointNormalBone(position, direction) {
255
- return TriGeometryRes.intersectGeometry(this.GetPayload()?.meshes, position, direction, -1);
256
- }
257
-
258
- /**
259
- * Intersect a ray with one area index across canonical CPU meshes.
260
- *
261
- * @param {ArrayLike<number>} position
262
- * @param {ArrayLike<number>} direction
263
- * @param {number} areaIndex
264
- * @returns {object}
265
- */
266
- GetAreaIntersectionPointNormalBone(position, direction, areaIndex = -1) {
267
- if (!Number.isInteger(areaIndex) || areaIndex < -1) {
268
- throw new RangeError("TriGeometryRes area index must be -1 or a non-negative integer.");
269
- }
270
- return TriGeometryRes.intersectGeometry(this.GetPayload()?.meshes, position, direction, areaIndex);
271
- }
272
-
273
- /**
274
- * Get vertex element descriptors for a mesh.
275
- *
276
- * @param {number} meshIndex
277
- * @returns {Array<*>}
278
- */
279
- GetMeshVertexElements(meshIndex = 0) {
280
- return this.GetPayload()?.meshes?.[meshIndex]?.vertexElements || [];
281
- }
282
-
283
- /**
284
- * Saving belongs to the selected geometry format writer and destination.
285
- *
286
- * @throws {Error}
287
- */
288
- SaveMesh() {
289
- throw resourceBoundaryError("TriGeometryRes", "SaveMesh", "Use a geometry format writer with the resource payload and a caller-owned destination.");
290
- }
291
- static payload = "geometry";
292
-
293
- /**
294
- * Gets the canonical area list from a mesh or its first LOD.
295
- *
296
- * @param {object|null} mesh
297
- * @returns {Array<*>|null}
298
- */
299
- static getMeshAreas(mesh) {
300
- return mesh?.areas || mesh?.lods?.[0]?.areas || null;
301
- }
302
-
303
- /**
304
- * Gets canonical bounds from a geometry payload object.
305
- *
306
- * @param {object|null} value
307
- * @returns {{min: ArrayLike<number>, max: ArrayLike<number>}|null}
308
- */
309
- static getBounds(value) {
310
- if (!value || typeof value !== "object") return null;
311
- if (value.bounds?.min && value.bounds?.max) return value.bounds;
312
- if (value.minBounds && value.maxBounds) {
313
- return {
314
- min: value.minBounds,
315
- max: value.maxBounds
316
- };
317
- }
318
- return null;
319
- }
320
-
321
- /**
322
- * Gets the canonical bounding sphere from a geometry payload object.
323
- *
324
- * @param {object|null} value
325
- * @returns {ArrayLike<number>|null}
326
- */
327
- static getSphere(value) {
328
- if (!value || typeof value !== "object") return null;
329
- return value.sphere || value.boundingSphere || null;
330
- }
331
-
332
- /**
333
- * Copies bounds into caller-owned outputs, or returns the source object.
334
- *
335
- * @param {{min: ArrayLike<number>, max: ArrayLike<number>}|null} bounds
336
- * @param {ArrayLike<number>|null} outMin
337
- * @param {ArrayLike<number>|null} outMax
338
- * @returns {*|boolean}
339
- */
340
- static copyBounds(bounds, outMin, outMax) {
341
- if (!outMin && !outMax) return bounds;
342
- if (!bounds || !outMin || !outMax) return false;
343
- vec3.copy(outMin, bounds.min);
344
- vec3.copy(outMax, bounds.max);
345
- return true;
346
- }
347
-
348
- /**
349
- * Gets canonical positions from a mesh or its first LOD.
350
- *
351
- * @param {object|null} mesh
352
- * @returns {ArrayLike<number>|Array<ArrayLike<number>>|null}
353
- */
354
- static getMeshPositions(mesh) {
355
- return mesh?.vertex?.position || mesh?.positions || mesh?.lods?.[0]?.vertex?.position || mesh?.lods?.[0]?.positions || null;
356
- }
357
-
358
- /**
359
- * Gets the number of vertices represented by flat or nested positions.
360
- *
361
- * @param {ArrayLike<number>|Array<ArrayLike<number>>|null} positions
362
- * @returns {number}
363
- */
364
- static getPositionCount(positions) {
365
- if (!positions) return 0;
366
- return typeof positions[0] === "number" ? Math.floor(positions.length / 3) : positions.length;
367
- }
368
-
369
- /**
370
- * Calculates bounds from canonical positions using caller-owned scratch.
371
- *
372
- * @param {ArrayLike<number>} out
373
- * @param {ArrayLike<number>|Array<ArrayLike<number>>|null} positions
374
- * @param {ArrayLike<number>} point
375
- * @returns {boolean}
376
- */
377
- static setBoundsFromPositions(out, positions, point) {
378
- const count = this.getPositionCount(positions);
379
- let found = false;
380
- for (let index = 0; index < count; index++) {
381
- if (!this.copyPosition(point, positions, index)) continue;
382
- if (!found) {
383
- out[0] = out[3] = point[0];
384
- out[1] = out[4] = point[1];
385
- out[2] = out[5] = point[2];
386
- found = true;
387
- continue;
388
- }
389
- out[0] = Math.min(out[0], point[0]);
390
- out[1] = Math.min(out[1], point[1]);
391
- out[2] = Math.min(out[2], point[2]);
392
- out[3] = Math.max(out[3], point[0]);
393
- out[4] = Math.max(out[4], point[1]);
394
- out[5] = Math.max(out[5], point[2]);
395
- }
396
- return found;
397
- }
398
-
399
- /**
400
- * Calculates a bounding sphere from positions using caller-owned scratch.
401
- *
402
- * @param {ArrayLike<number>} out
403
- * @param {ArrayLike<number>|Array<ArrayLike<number>>|null} positions
404
- * @param {ArrayLike<number>} point
405
- * @returns {boolean}
406
- */
407
- static setSphereFromPositions(out, positions, point) {
408
- const count = this.getPositionCount(positions);
409
- let found = false,
410
- minX = Infinity,
411
- minY = Infinity,
412
- minZ = Infinity,
413
- maxX = -Infinity,
414
- maxY = -Infinity,
415
- maxZ = -Infinity;
416
- for (let index = 0; index < count; index++) {
417
- if (!this.copyPosition(point, positions, index)) continue;
418
- minX = Math.min(minX, point[0]);
419
- minY = Math.min(minY, point[1]);
420
- minZ = Math.min(minZ, point[2]);
421
- maxX = Math.max(maxX, point[0]);
422
- maxY = Math.max(maxY, point[1]);
423
- maxZ = Math.max(maxZ, point[2]);
424
- found = true;
425
- }
426
- if (!found) return false;
427
- out[0] = (minX + maxX) * 0.5;
428
- out[1] = (minY + maxY) * 0.5;
429
- out[2] = (minZ + maxZ) * 0.5;
430
- let maxSquaredRadius = 0;
431
- for (let index = 0; index < count; index++) {
432
- if (!this.copyPosition(point, positions, index)) continue;
433
- const x = out[0] - point[0],
434
- y = out[1] - point[1],
435
- z = out[2] - point[2];
436
- maxSquaredRadius = Math.max(maxSquaredRadius, x * x + y * y + z * z);
437
- }
438
- out[3] = Math.sqrt(maxSquaredRadius);
439
- return true;
440
- }
441
-
442
- /**
443
- * Calculates a mesh sphere from positions or existing bounds.
444
- *
445
- * @param {ArrayLike<number>} out
446
- * @param {object} mesh
447
- * @param {ArrayLike<number>} point
448
- * @returns {boolean}
449
- */
450
- static calculateMeshSphere(out, mesh, point) {
451
- if (this.setSphereFromPositions(out, this.getMeshPositions(mesh), point)) return true;
452
- const bounds = this.getBounds(mesh);
453
- if (!bounds) return false;
454
- sph3.fromBounds(out, bounds.min, bounds.max);
455
- return true;
456
- }
457
-
458
- /**
459
- * Stores a calculated sphere in the mesh's canonical sphere fields.
460
- *
461
- * @param {object} mesh
462
- * @param {ArrayLike<number>} sphere
463
- * @returns {void}
464
- */
465
- static setMeshSphere(mesh, sphere) {
466
- if (mesh.sphere && typeof mesh.sphere.set === "function") mesh.sphere.set(sphere);else mesh.sphere = [...sphere];
467
- if (mesh.boundingSphere && typeof mesh.boundingSphere.set === "function") {
468
- mesh.boundingSphere.set(sphere);
469
- } else if ("boundingSphere" in mesh) {
470
- mesh.boundingSphere = [...sphere];
471
- }
472
- }
473
-
474
- /**
475
- * Intersects a ray with canonical CPU geometry.
476
- *
477
- * @param {Array<object>|null} meshes
478
- * @param {ArrayLike<number>} position
479
- * @param {ArrayLike<number>} direction
480
- * @param {number} areaIndex
481
- * @returns {object}
482
- */
483
- static intersectGeometry(meshes, position, direction, areaIndex) {
484
- this.validateRayVector(position, "position");
485
- this.validateRayVector(direction, "direction");
486
- const ray = ray3.from(ray3.alloc(), position, direction),
487
- point = vec3.alloc(),
488
- vertexA = vec3.alloc(),
489
- vertexB = vec3.alloc(),
490
- vertexC = vec3.alloc(),
491
- normal = vec3.alloc();
492
- let nearest = null;
493
- try {
494
- for (let meshIndex = 0; meshIndex < (meshes?.length || 0); meshIndex++) {
495
- const mesh = meshes[meshIndex];
496
- const positions = this.getMeshPositions(mesh);
497
- if (!positions) continue;
498
- const groups = mesh?.indices || mesh?.lods?.[0]?.indices || null;
499
- if (ArrayBuffer.isView(groups) || Array.isArray(groups) && typeof groups[0] === "number") {
500
- if (areaIndex !== -1 && areaIndex !== 0) continue;
501
- nearest = this.intersectFaces(nearest, groups, 0, mesh, meshIndex, positions, position, ray, point, vertexA, vertexB, vertexC, normal);
502
- continue;
503
- }
504
- if (Array.isArray(groups)) {
505
- for (let groupIndex = 0; groupIndex < groups.length; groupIndex++) {
506
- if (areaIndex !== -1 && areaIndex !== groupIndex) continue;
507
- const faces = groups[groupIndex]?.faces || groups[groupIndex]?.indices || [];
508
- nearest = this.intersectFaces(nearest, faces, groupIndex, mesh, meshIndex, positions, position, ray, point, vertexA, vertexB, vertexC, normal);
509
- }
510
- continue;
511
- }
512
- if (areaIndex === -1 || areaIndex === 0) {
513
- nearest = this.intersectFaces(nearest, null, 0, mesh, meshIndex, positions, position, ray, point, vertexA, vertexB, vertexC, normal);
514
- }
515
- }
516
- return nearest || {
517
- hit: false,
518
- boneIndex: -1,
519
- point: [0, 0, 0],
520
- normal: [0, 0, 0],
521
- distance: Infinity,
522
- meshIndex: -1,
523
- areaIndex
524
- };
525
- } finally {
526
- vec3.unalloc(normal);
527
- vec3.unalloc(vertexC);
528
- vec3.unalloc(vertexB);
529
- vec3.unalloc(vertexA);
530
- vec3.unalloc(point);
531
- ray3.unalloc(ray);
532
- }
533
- }
534
-
535
- /**
536
- * Validates a caller-provided ray vector.
537
- *
538
- * @param {ArrayLike<number>} value
539
- * @param {string} name
540
- * @returns {void}
541
- */
542
- static validateRayVector(value, name) {
543
- if (!value || value.length < 3 || !Number.isFinite(value[0]) || !Number.isFinite(value[1]) || !Number.isFinite(value[2])) {
544
- throw new TypeError(`TriGeometryRes ray ${name} must contain three finite numbers.`);
545
- }
546
- }
547
-
548
- /**
549
- * Intersects a ray with one flat face list.
550
- *
551
- * @param {object|null} nearest
552
- * @param {ArrayLike<number>|null} faces
553
- * @param {number} areaIndex
554
- * @param {object} mesh
555
- * @param {number} meshIndex
556
- * @param {ArrayLike<number>|Array<ArrayLike<number>>} positions
557
- * @param {ArrayLike<number>} rayOrigin
558
- * @param {ArrayLike<number>} ray
559
- * @param {ArrayLike<number>} point
560
- * @param {ArrayLike<number>} vertexA
561
- * @param {ArrayLike<number>} vertexB
562
- * @param {ArrayLike<number>} vertexC
563
- * @param {ArrayLike<number>} normal
564
- * @returns {object|null}
565
- */
566
- static intersectFaces(nearest, faces, areaIndex, mesh, meshIndex, positions, rayOrigin, ray, point, vertexA, vertexB, vertexC, normal) {
567
- const count = faces?.length ?? this.getPositionCount(positions);
568
- for (let index = 0; index + 2 < count; index += 3) {
569
- const vertexIndexA = faces ? faces[index] : index,
570
- vertexIndexB = faces ? faces[index + 1] : index + 1,
571
- vertexIndexC = faces ? faces[index + 2] : index + 2;
572
- if (!this.copyPosition(vertexA, positions, vertexIndexA) || !this.copyPosition(vertexB, positions, vertexIndexB) || !this.copyPosition(vertexC, positions, vertexIndexC) || !ray3.getIntersectVertices(point, ray, vertexA, vertexB, vertexC, false)) {
573
- continue;
574
- }
575
- const distance = vec3.distance(rayOrigin, point);
576
- if (nearest && nearest.distance <= distance) continue;
577
- if (!nearest) {
578
- nearest = {
579
- hit: true,
580
- boneIndex: -1,
581
- point: [0, 0, 0],
582
- normal: [0, 0, 0],
583
- distance,
584
- meshIndex,
585
- areaIndex
586
- };
587
- }
588
- nearest.boneIndex = this.getMeshBoneIndex(mesh, vertexIndexA);
589
- vec3.copy(nearest.point, point);
590
- triangleNormalTo(normal, vertexA, vertexB, vertexC);
591
- vec3.copy(nearest.normal, normal);
592
- nearest.distance = distance;
593
- nearest.meshIndex = meshIndex;
594
- nearest.areaIndex = areaIndex;
595
- }
596
- return nearest;
597
- }
598
-
599
- /**
600
- * Copies one flat or nested position into caller-owned output.
601
- *
602
- * @param {ArrayLike<number>} out
603
- * @param {ArrayLike<number>|Array<ArrayLike<number>>} positions
604
- * @param {number} index
605
- * @returns {boolean}
606
- */
607
- static copyPosition(out, positions, index) {
608
- if (!Number.isInteger(index) || index < 0) return false;
609
- if (typeof positions[0] === "number") {
610
- const offset = index * 3;
611
- if (offset + 2 >= positions.length) return false;
612
- out[0] = positions[offset];
613
- out[1] = positions[offset + 1];
614
- out[2] = positions[offset + 2];
615
- return true;
616
- }
617
- const point = positions[index];
618
- if (!point || point.length < 3) return false;
619
- out[0] = point[0];
620
- out[1] = point[1];
621
- out[2] = point[2];
622
- return true;
623
- }
624
-
625
- /**
626
- * Gets the first blend index for a mesh vertex.
627
- *
628
- * @param {object} mesh
629
- * @param {number} vertexIndex
630
- * @returns {number}
631
- */
632
- static getMeshBoneIndex(mesh, vertexIndex) {
633
- const indices = mesh?.vertex?.blendIndices || mesh?.blendIndices;
634
- if (!indices) return -1;
635
- if (typeof indices[0] === "number") {
636
- return Number(indices[vertexIndex * 4] ?? indices[vertexIndex] ?? -1);
637
- }
638
- return Number(indices[vertexIndex]?.[0] ?? -1);
639
- }
640
- }
641
-
642
- // Declared as data rather than with decorators, so the resource tree loads from
643
- // source without a transform. Field order is key order, and GetValues() exports
644
- // in that order.
645
- CjsSchema.define(TriGeometryRes, {
646
- className: "TriGeometryRes",
647
- family: "resources",
648
- fields: {
649
- forceLod: [type.boolean, io.readwrite],
650
- forcedLodIndex: [type.int32, io.readwrite],
651
- name: [type.string, io.readwrite]
652
- },
653
- methods: {
654
- GetMeshCount: [carbon.method, impl.adapted],
655
- GetAnimationCount: [carbon.method, impl.adapted],
656
- GetSkeletonCount: [carbon.method, impl.adapted],
657
- GetSkeletonData: [carbon.method, impl.adapted],
658
- GetMeshAreaCount: [carbon.method, impl.adapted],
659
- GetMeshName: [carbon.method, impl.adapted],
660
- GetMeshAreaName: [carbon.method, impl.adapted],
661
- GetAreaBoundingBox: [carbon.method, impl.adapted],
662
- GetBoundingBox: [carbon.method, impl.adapted],
663
- GetBoundingSphere: [carbon.method, impl.adapted],
664
- CalculateBoundingBoxFromTransform: [carbon.method, impl.adapted],
665
- RecalculateBoundingSphere: [carbon.method, impl.adapted],
666
- Reload: [carbon.method, impl.notSupported],
667
- GetIntersectionPointNormalBone: [carbon.method, impl.adapted],
668
- GetAreaIntersectionPointNormalBone: [carbon.method, impl.adapted],
669
- GetMeshVertexElements: [carbon.method, impl.adapted],
670
- SaveMesh: [carbon.method, impl.notSupported]
671
- }
672
- });
673
-
674
- export { TriGeometryRes };
675
- //# sourceMappingURL=TriGeometryRes.js.map
1
+ import { CjsSchema, carbon, impl, type, io } from '@carbonenginejs/runtime-utils/schema';
2
+ import { box3 } from '@carbonenginejs/runtime-utils/box3';
3
+ import { triangleNormalTo } from '@carbonenginejs/runtime-utils/mesh';
4
+ import { ray3 } from '@carbonenginejs/runtime-utils/ray3';
5
+ import { sph3 } from '@carbonenginejs/runtime-utils/sph3';
6
+ import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
7
+ import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
8
+ import { CjsResource } from '../CjsResource.js';
9
+ import { assertResourcePayloadObject, assertResourcePayloadArray, resourcePayloadError, resourceBoundaryError } from '../resourceBoundary.js';
10
+
11
+ // Source: trinity/trinity/Resources/TriGeometryRes.h
12
+ // Source: trinity/trinity/Resources/TriGeometryRes.cpp
13
+ // Source: trinity/trinity/Resources/TriGeometryRes_Blue.cpp
14
+
15
+ /**
16
+ * Resource record that owns geometry payload facts (meshes, optional
17
+ * skeletons and animations) and LOD-force metadata, while engine packages
18
+ * decide device buffers, vertex declarations, and draw-time state.
19
+ *
20
+ * Geometry inspection composes the generic math supplied by runtime-utils
21
+ * with resource-specific payload traversal.
22
+ */
23
+ class TriGeometryRes extends CjsResource {
24
+ forceLod = false;
25
+ forcedLodIndex = -1;
26
+ name = "";
27
+
28
+ /** Creates a TriGeometryRes with caller-provided initial state. */
29
+ constructor(values = null) {
30
+ super();
31
+ this.SetValues(values || {}, {
32
+ markDirty: false,
33
+ skipUpdate: true,
34
+ skipEvents: true
35
+ });
36
+ }
37
+
38
+ /**
39
+ * Attach a plain geometry payload.
40
+ *
41
+ * @param {object|null} payload
42
+ * @param {object|null} options
43
+ * @returns {TriGeometryRes}
44
+ */
45
+ SetPayload(payload = null, options = null) {
46
+ if (payload === null) {
47
+ super.SetPayload(null);
48
+ return this;
49
+ }
50
+ assertResourcePayloadObject("TriGeometryRes", payload);
51
+ assertResourcePayloadArray("TriGeometryRes", payload, "meshes");
52
+ for (const field of ["skeletons", "animations"]) {
53
+ if (payload[field] !== undefined && !Array.isArray(payload[field])) {
54
+ throw resourcePayloadError("TriGeometryRes", "Expected an array when provided.", field);
55
+ }
56
+ }
57
+ super.SetPayload(payload);
58
+ this.SetValues(options || {});
59
+ return this;
60
+ }
61
+
62
+ /**
63
+ * Get mesh count from the CPU geometry payload.
64
+ *
65
+ * @returns {number}
66
+ */
67
+ GetMeshCount() {
68
+ return this.GetPayload()?.meshes?.length || 0;
69
+ }
70
+
71
+ /**
72
+ * Get animation count from the CPU geometry payload.
73
+ *
74
+ * @returns {number}
75
+ */
76
+ GetAnimationCount() {
77
+ return this.GetPayload()?.animations?.length || 0;
78
+ }
79
+
80
+ /**
81
+ * Get skeleton count from the CPU geometry payload.
82
+ *
83
+ * @returns {number}
84
+ */
85
+ GetSkeletonCount() {
86
+ return this.GetPayload()?.skeletons?.length || 0;
87
+ }
88
+
89
+ /**
90
+ * Get one resource-owned skeleton from the CPU geometry payload.
91
+ *
92
+ * @param {number} skeletonIndex
93
+ * @returns {*}
94
+ */
95
+ GetSkeletonData(skeletonIndex = 0) {
96
+ const index = Number(skeletonIndex);
97
+ if (!Number.isInteger(index) || index < 0) {
98
+ return null;
99
+ }
100
+ return this.GetPayload()?.skeletons?.[index] || null;
101
+ }
102
+
103
+ /**
104
+ * Get mesh area count from a CPU geometry payload mesh.
105
+ *
106
+ * @param {number} meshIndex
107
+ * @returns {number}
108
+ */
109
+ GetMeshAreaCount(meshIndex = 0) {
110
+ const mesh = this.GetPayload()?.meshes?.[meshIndex];
111
+ return mesh?.areas?.length || 0;
112
+ }
113
+
114
+ /**
115
+ * Get mesh name from a CPU geometry payload.
116
+ *
117
+ * @param {number} meshIndex
118
+ * @returns {string}
119
+ */
120
+ GetMeshName(meshIndex = 0) {
121
+ return this.GetPayload()?.meshes?.[meshIndex]?.name || "";
122
+ }
123
+
124
+ /**
125
+ * Get mesh area name from a CPU geometry payload.
126
+ *
127
+ * @param {number} meshIndex
128
+ * @param {number} areaIndex
129
+ * @returns {string}
130
+ */
131
+ GetMeshAreaName(meshIndex = 0, areaIndex = 0) {
132
+ return this.GetPayload()?.meshes?.[meshIndex]?.areas?.[areaIndex]?.name || "";
133
+ }
134
+
135
+ /**
136
+ * Get area bounding box from geometry payload data.
137
+ *
138
+ * @param {number} meshIndex
139
+ * @param {number} areaIndex
140
+ * @param {ArrayLike<number>|null} outMin
141
+ * @param {ArrayLike<number>|null} outMax
142
+ * @returns {*|boolean}
143
+ */
144
+ GetAreaBoundingBox(meshIndex = 0, areaIndex = 0, outMin = null, outMax = null) {
145
+ const area = TriGeometryRes.getMeshAreas(this.GetPayload()?.meshes?.[meshIndex])?.[areaIndex];
146
+ const bounds = TriGeometryRes.getBounds(area);
147
+ return TriGeometryRes.copyBounds(bounds, outMin, outMax);
148
+ }
149
+
150
+ /**
151
+ * Get mesh bounding box from geometry payload data.
152
+ * @param {number} meshIndex
153
+ * @param {ArrayLike<number>|null} outMin
154
+ * @param {ArrayLike<number>|null} outMax
155
+ * @returns {*|boolean}
156
+ */
157
+ GetBoundingBox(meshIndex = 0, outMin = null, outMax = null) {
158
+ const payload = this.GetPayload();
159
+ const bounds = TriGeometryRes.getBounds(payload?.meshes?.[meshIndex]) || TriGeometryRes.getBounds(payload);
160
+ return TriGeometryRes.copyBounds(bounds, outMin, outMax);
161
+ }
162
+
163
+ /**
164
+ * Get mesh bounding sphere from geometry payload data.
165
+ * @param {number} meshIndex
166
+ * @param {ArrayLike<number>|null} out
167
+ * @returns {*|boolean}
168
+ */
169
+ GetBoundingSphere(meshIndex = 0, out = null) {
170
+ const payload = this.GetPayload();
171
+ const sphere = TriGeometryRes.getSphere(payload?.meshes?.[meshIndex]) || TriGeometryRes.getSphere(payload);
172
+ if (!out) return sphere;
173
+ if (!sphere) return false;
174
+ vec4.copy(out, sphere);
175
+ return true;
176
+ }
177
+
178
+ /**
179
+ * Calculate a transformed bounding box from canonical CPU vertex data.
180
+ *
181
+ * Carbon stores the same matrix bytes as gl-matrix; transforming one point
182
+ * therefore uses the ordinary column-vector index layout.
183
+ *
184
+ * @param {number} meshIndex
185
+ * @param {ArrayLike<number>} transform
186
+ * @returns {{min: number[], max: number[]}|null}
187
+ */
188
+ CalculateBoundingBoxFromTransform(meshIndex = 0, transform = null) {
189
+ if (!transform || transform.length < 16) {
190
+ throw new TypeError("TriGeometryRes transform must contain 16 matrix elements.");
191
+ }
192
+ const mesh = this.GetPayload()?.meshes?.[meshIndex];
193
+ if (!mesh) return null;
194
+ const positions = TriGeometryRes.getMeshPositions(mesh);
195
+ const sourceBounds = TriGeometryRes.getBounds(mesh);
196
+ if (!positions && !sourceBounds) return null;
197
+ const bounds = box3.alloc(),
198
+ point = vec3.alloc();
199
+ try {
200
+ if (!TriGeometryRes.setBoundsFromPositions(bounds, positions, point)) {
201
+ if (!sourceBounds) return null;
202
+ box3.fromBounds(bounds, sourceBounds.min, sourceBounds.max);
203
+ }
204
+ box3.transformMat4(bounds, bounds, transform);
205
+ return {
206
+ min: [bounds[0], bounds[1], bounds[2]],
207
+ max: [bounds[3], bounds[4], bounds[5]]
208
+ };
209
+ } finally {
210
+ vec3.unalloc(point);
211
+ box3.unalloc(bounds);
212
+ }
213
+ }
214
+
215
+ /**
216
+ * Recalculate bounding sphere data from canonical CPU vertex positions.
217
+ *
218
+ * @returns {boolean}
219
+ */
220
+ RecalculateBoundingSphere() {
221
+ let updated = false;
222
+ const sphere = sph3.alloc(),
223
+ point = vec3.alloc();
224
+ try {
225
+ for (const mesh of this.GetPayload()?.meshes || []) {
226
+ if (!TriGeometryRes.calculateMeshSphere(sphere, mesh, point)) continue;
227
+ TriGeometryRes.setMeshSphere(mesh, sphere);
228
+ updated = true;
229
+ }
230
+ return updated;
231
+ } finally {
232
+ vec3.unalloc(point);
233
+ sph3.unalloc(sphere);
234
+ }
235
+ }
236
+
237
+ /**
238
+ * Reloading belongs to the resource manager because it owns source and
239
+ * canonical replacement policy.
240
+ *
241
+ * @throws {Error}
242
+ */
243
+ Reload() {
244
+ throw resourceBoundaryError("TriGeometryRes", "Reload", "Request a reload through CjsResMan so source reads and canonical replacement remain manager-owned.");
245
+ }
246
+
247
+ /**
248
+ * Intersect a ray with canonical CPU triangle data.
249
+ *
250
+ * @param {ArrayLike<number>} position
251
+ * @param {ArrayLike<number>} direction
252
+ * @returns {object}
253
+ */
254
+ GetIntersectionPointNormalBone(position, direction) {
255
+ return TriGeometryRes.intersectGeometry(this.GetPayload()?.meshes, position, direction, -1);
256
+ }
257
+
258
+ /**
259
+ * Intersect a ray with one area index across canonical CPU meshes.
260
+ *
261
+ * @param {ArrayLike<number>} position
262
+ * @param {ArrayLike<number>} direction
263
+ * @param {number} areaIndex
264
+ * @returns {object}
265
+ */
266
+ GetAreaIntersectionPointNormalBone(position, direction, areaIndex = -1) {
267
+ if (!Number.isInteger(areaIndex) || areaIndex < -1) {
268
+ throw new RangeError("TriGeometryRes area index must be -1 or a non-negative integer.");
269
+ }
270
+ return TriGeometryRes.intersectGeometry(this.GetPayload()?.meshes, position, direction, areaIndex);
271
+ }
272
+
273
+ /**
274
+ * Get vertex element descriptors for a mesh.
275
+ *
276
+ * @param {number} meshIndex
277
+ * @returns {Array<*>}
278
+ */
279
+ GetMeshVertexElements(meshIndex = 0) {
280
+ return this.GetPayload()?.meshes?.[meshIndex]?.vertexElements || [];
281
+ }
282
+
283
+ /**
284
+ * Saving belongs to the selected geometry format writer and destination.
285
+ *
286
+ * @throws {Error}
287
+ */
288
+ SaveMesh() {
289
+ throw resourceBoundaryError("TriGeometryRes", "SaveMesh", "Use a geometry format writer with the resource payload and a caller-owned destination.");
290
+ }
291
+ static payload = "geometry";
292
+
293
+ /**
294
+ * Gets the canonical area list from a mesh or its first LOD.
295
+ *
296
+ * @param {object|null} mesh
297
+ * @returns {Array<*>|null}
298
+ */
299
+ static getMeshAreas(mesh) {
300
+ return mesh?.areas || mesh?.lods?.[0]?.areas || null;
301
+ }
302
+
303
+ /**
304
+ * Gets canonical bounds from a geometry payload object.
305
+ *
306
+ * @param {object|null} value
307
+ * @returns {{min: ArrayLike<number>, max: ArrayLike<number>}|null}
308
+ */
309
+ static getBounds(value) {
310
+ if (!value || typeof value !== "object") return null;
311
+ if (value.bounds?.min && value.bounds?.max) return value.bounds;
312
+ if (value.minBounds && value.maxBounds) {
313
+ return {
314
+ min: value.minBounds,
315
+ max: value.maxBounds
316
+ };
317
+ }
318
+ return null;
319
+ }
320
+
321
+ /**
322
+ * Gets the canonical bounding sphere from a geometry payload object.
323
+ *
324
+ * @param {object|null} value
325
+ * @returns {ArrayLike<number>|null}
326
+ */
327
+ static getSphere(value) {
328
+ if (!value || typeof value !== "object") return null;
329
+ return value.sphere || value.boundingSphere || null;
330
+ }
331
+
332
+ /**
333
+ * Copies bounds into caller-owned outputs, or returns the source object.
334
+ *
335
+ * @param {{min: ArrayLike<number>, max: ArrayLike<number>}|null} bounds
336
+ * @param {ArrayLike<number>|null} outMin
337
+ * @param {ArrayLike<number>|null} outMax
338
+ * @returns {*|boolean}
339
+ */
340
+ static copyBounds(bounds, outMin, outMax) {
341
+ if (!outMin && !outMax) return bounds;
342
+ if (!bounds || !outMin || !outMax) return false;
343
+ vec3.copy(outMin, bounds.min);
344
+ vec3.copy(outMax, bounds.max);
345
+ return true;
346
+ }
347
+
348
+ /**
349
+ * Gets canonical positions from a mesh or its first LOD.
350
+ *
351
+ * @param {object|null} mesh
352
+ * @returns {ArrayLike<number>|Array<ArrayLike<number>>|null}
353
+ */
354
+ static getMeshPositions(mesh) {
355
+ return mesh?.vertex?.position || mesh?.positions || mesh?.lods?.[0]?.vertex?.position || mesh?.lods?.[0]?.positions || null;
356
+ }
357
+
358
+ /**
359
+ * Gets the number of vertices represented by flat or nested positions.
360
+ *
361
+ * @param {ArrayLike<number>|Array<ArrayLike<number>>|null} positions
362
+ * @returns {number}
363
+ */
364
+ static getPositionCount(positions) {
365
+ if (!positions) return 0;
366
+ return typeof positions[0] === "number" ? Math.floor(positions.length / 3) : positions.length;
367
+ }
368
+
369
+ /**
370
+ * Calculates bounds from canonical positions using caller-owned scratch.
371
+ *
372
+ * @param {ArrayLike<number>} out
373
+ * @param {ArrayLike<number>|Array<ArrayLike<number>>|null} positions
374
+ * @param {ArrayLike<number>} point
375
+ * @returns {boolean}
376
+ */
377
+ static setBoundsFromPositions(out, positions, point) {
378
+ const count = this.getPositionCount(positions);
379
+ let found = false;
380
+ for (let index = 0; index < count; index++) {
381
+ if (!this.copyPosition(point, positions, index)) continue;
382
+ if (!found) {
383
+ out[0] = out[3] = point[0];
384
+ out[1] = out[4] = point[1];
385
+ out[2] = out[5] = point[2];
386
+ found = true;
387
+ continue;
388
+ }
389
+ out[0] = Math.min(out[0], point[0]);
390
+ out[1] = Math.min(out[1], point[1]);
391
+ out[2] = Math.min(out[2], point[2]);
392
+ out[3] = Math.max(out[3], point[0]);
393
+ out[4] = Math.max(out[4], point[1]);
394
+ out[5] = Math.max(out[5], point[2]);
395
+ }
396
+ return found;
397
+ }
398
+
399
+ /**
400
+ * Calculates a bounding sphere from positions using caller-owned scratch.
401
+ *
402
+ * @param {ArrayLike<number>} out
403
+ * @param {ArrayLike<number>|Array<ArrayLike<number>>|null} positions
404
+ * @param {ArrayLike<number>} point
405
+ * @returns {boolean}
406
+ */
407
+ static setSphereFromPositions(out, positions, point) {
408
+ const count = this.getPositionCount(positions);
409
+ let found = false,
410
+ minX = Infinity,
411
+ minY = Infinity,
412
+ minZ = Infinity,
413
+ maxX = -Infinity,
414
+ maxY = -Infinity,
415
+ maxZ = -Infinity;
416
+ for (let index = 0; index < count; index++) {
417
+ if (!this.copyPosition(point, positions, index)) continue;
418
+ minX = Math.min(minX, point[0]);
419
+ minY = Math.min(minY, point[1]);
420
+ minZ = Math.min(minZ, point[2]);
421
+ maxX = Math.max(maxX, point[0]);
422
+ maxY = Math.max(maxY, point[1]);
423
+ maxZ = Math.max(maxZ, point[2]);
424
+ found = true;
425
+ }
426
+ if (!found) return false;
427
+ out[0] = (minX + maxX) * 0.5;
428
+ out[1] = (minY + maxY) * 0.5;
429
+ out[2] = (minZ + maxZ) * 0.5;
430
+ let maxSquaredRadius = 0;
431
+ for (let index = 0; index < count; index++) {
432
+ if (!this.copyPosition(point, positions, index)) continue;
433
+ const x = out[0] - point[0],
434
+ y = out[1] - point[1],
435
+ z = out[2] - point[2];
436
+ maxSquaredRadius = Math.max(maxSquaredRadius, x * x + y * y + z * z);
437
+ }
438
+ out[3] = Math.sqrt(maxSquaredRadius);
439
+ return true;
440
+ }
441
+
442
+ /**
443
+ * Calculates a mesh sphere from positions or existing bounds.
444
+ *
445
+ * @param {ArrayLike<number>} out
446
+ * @param {object} mesh
447
+ * @param {ArrayLike<number>} point
448
+ * @returns {boolean}
449
+ */
450
+ static calculateMeshSphere(out, mesh, point) {
451
+ if (this.setSphereFromPositions(out, this.getMeshPositions(mesh), point)) return true;
452
+ const bounds = this.getBounds(mesh);
453
+ if (!bounds) return false;
454
+ sph3.fromBounds(out, bounds.min, bounds.max);
455
+ return true;
456
+ }
457
+
458
+ /**
459
+ * Stores a calculated sphere in the mesh's canonical sphere fields.
460
+ *
461
+ * @param {object} mesh
462
+ * @param {ArrayLike<number>} sphere
463
+ * @returns {void}
464
+ */
465
+ static setMeshSphere(mesh, sphere) {
466
+ if (mesh.sphere && typeof mesh.sphere.set === "function") mesh.sphere.set(sphere);else mesh.sphere = [...sphere];
467
+ if (mesh.boundingSphere && typeof mesh.boundingSphere.set === "function") {
468
+ mesh.boundingSphere.set(sphere);
469
+ } else if ("boundingSphere" in mesh) {
470
+ mesh.boundingSphere = [...sphere];
471
+ }
472
+ }
473
+
474
+ /**
475
+ * Intersects a ray with canonical CPU geometry.
476
+ *
477
+ * @param {Array<object>|null} meshes
478
+ * @param {ArrayLike<number>} position
479
+ * @param {ArrayLike<number>} direction
480
+ * @param {number} areaIndex
481
+ * @returns {object}
482
+ */
483
+ static intersectGeometry(meshes, position, direction, areaIndex) {
484
+ this.validateRayVector(position, "position");
485
+ this.validateRayVector(direction, "direction");
486
+ const ray = ray3.from(ray3.alloc(), position, direction),
487
+ point = vec3.alloc(),
488
+ vertexA = vec3.alloc(),
489
+ vertexB = vec3.alloc(),
490
+ vertexC = vec3.alloc(),
491
+ normal = vec3.alloc();
492
+ let nearest = null;
493
+ try {
494
+ for (let meshIndex = 0; meshIndex < (meshes?.length || 0); meshIndex++) {
495
+ const mesh = meshes[meshIndex];
496
+ const positions = this.getMeshPositions(mesh);
497
+ if (!positions) continue;
498
+ const groups = mesh?.indices || mesh?.lods?.[0]?.indices || null;
499
+ if (ArrayBuffer.isView(groups) || Array.isArray(groups) && typeof groups[0] === "number") {
500
+ if (areaIndex !== -1 && areaIndex !== 0) continue;
501
+ nearest = this.intersectFaces(nearest, groups, 0, mesh, meshIndex, positions, position, ray, point, vertexA, vertexB, vertexC, normal);
502
+ continue;
503
+ }
504
+ if (Array.isArray(groups)) {
505
+ for (let groupIndex = 0; groupIndex < groups.length; groupIndex++) {
506
+ if (areaIndex !== -1 && areaIndex !== groupIndex) continue;
507
+ const faces = groups[groupIndex]?.faces || groups[groupIndex]?.indices || [];
508
+ nearest = this.intersectFaces(nearest, faces, groupIndex, mesh, meshIndex, positions, position, ray, point, vertexA, vertexB, vertexC, normal);
509
+ }
510
+ continue;
511
+ }
512
+ if (areaIndex === -1 || areaIndex === 0) {
513
+ nearest = this.intersectFaces(nearest, null, 0, mesh, meshIndex, positions, position, ray, point, vertexA, vertexB, vertexC, normal);
514
+ }
515
+ }
516
+ return nearest || {
517
+ hit: false,
518
+ boneIndex: -1,
519
+ point: [0, 0, 0],
520
+ normal: [0, 0, 0],
521
+ distance: Infinity,
522
+ meshIndex: -1,
523
+ areaIndex
524
+ };
525
+ } finally {
526
+ vec3.unalloc(normal);
527
+ vec3.unalloc(vertexC);
528
+ vec3.unalloc(vertexB);
529
+ vec3.unalloc(vertexA);
530
+ vec3.unalloc(point);
531
+ ray3.unalloc(ray);
532
+ }
533
+ }
534
+
535
+ /**
536
+ * Validates a caller-provided ray vector.
537
+ *
538
+ * @param {ArrayLike<number>} value
539
+ * @param {string} name
540
+ * @returns {void}
541
+ */
542
+ static validateRayVector(value, name) {
543
+ if (!value || value.length < 3 || !Number.isFinite(value[0]) || !Number.isFinite(value[1]) || !Number.isFinite(value[2])) {
544
+ throw new TypeError(`TriGeometryRes ray ${name} must contain three finite numbers.`);
545
+ }
546
+ }
547
+
548
+ /**
549
+ * Intersects a ray with one flat face list.
550
+ *
551
+ * @param {object|null} nearest
552
+ * @param {ArrayLike<number>|null} faces
553
+ * @param {number} areaIndex
554
+ * @param {object} mesh
555
+ * @param {number} meshIndex
556
+ * @param {ArrayLike<number>|Array<ArrayLike<number>>} positions
557
+ * @param {ArrayLike<number>} rayOrigin
558
+ * @param {ArrayLike<number>} ray
559
+ * @param {ArrayLike<number>} point
560
+ * @param {ArrayLike<number>} vertexA
561
+ * @param {ArrayLike<number>} vertexB
562
+ * @param {ArrayLike<number>} vertexC
563
+ * @param {ArrayLike<number>} normal
564
+ * @returns {object|null}
565
+ */
566
+ static intersectFaces(nearest, faces, areaIndex, mesh, meshIndex, positions, rayOrigin, ray, point, vertexA, vertexB, vertexC, normal) {
567
+ const count = faces?.length ?? this.getPositionCount(positions);
568
+ for (let index = 0; index + 2 < count; index += 3) {
569
+ const vertexIndexA = faces ? faces[index] : index,
570
+ vertexIndexB = faces ? faces[index + 1] : index + 1,
571
+ vertexIndexC = faces ? faces[index + 2] : index + 2;
572
+ if (!this.copyPosition(vertexA, positions, vertexIndexA) || !this.copyPosition(vertexB, positions, vertexIndexB) || !this.copyPosition(vertexC, positions, vertexIndexC) || !ray3.getIntersectVertices(point, ray, vertexA, vertexB, vertexC, false)) {
573
+ continue;
574
+ }
575
+ const distance = vec3.distance(rayOrigin, point);
576
+ if (nearest && nearest.distance <= distance) continue;
577
+ if (!nearest) {
578
+ nearest = {
579
+ hit: true,
580
+ boneIndex: -1,
581
+ point: [0, 0, 0],
582
+ normal: [0, 0, 0],
583
+ distance,
584
+ meshIndex,
585
+ areaIndex
586
+ };
587
+ }
588
+ nearest.boneIndex = this.getMeshBoneIndex(mesh, vertexIndexA);
589
+ vec3.copy(nearest.point, point);
590
+ triangleNormalTo(normal, vertexA, vertexB, vertexC);
591
+ vec3.copy(nearest.normal, normal);
592
+ nearest.distance = distance;
593
+ nearest.meshIndex = meshIndex;
594
+ nearest.areaIndex = areaIndex;
595
+ }
596
+ return nearest;
597
+ }
598
+
599
+ /**
600
+ * Copies one flat or nested position into caller-owned output.
601
+ *
602
+ * @param {ArrayLike<number>} out
603
+ * @param {ArrayLike<number>|Array<ArrayLike<number>>} positions
604
+ * @param {number} index
605
+ * @returns {boolean}
606
+ */
607
+ static copyPosition(out, positions, index) {
608
+ if (!Number.isInteger(index) || index < 0) return false;
609
+ if (typeof positions[0] === "number") {
610
+ const offset = index * 3;
611
+ if (offset + 2 >= positions.length) return false;
612
+ out[0] = positions[offset];
613
+ out[1] = positions[offset + 1];
614
+ out[2] = positions[offset + 2];
615
+ return true;
616
+ }
617
+ const point = positions[index];
618
+ if (!point || point.length < 3) return false;
619
+ out[0] = point[0];
620
+ out[1] = point[1];
621
+ out[2] = point[2];
622
+ return true;
623
+ }
624
+
625
+ /**
626
+ * Gets the first blend index for a mesh vertex.
627
+ *
628
+ * @param {object} mesh
629
+ * @param {number} vertexIndex
630
+ * @returns {number}
631
+ */
632
+ static getMeshBoneIndex(mesh, vertexIndex) {
633
+ const indices = mesh?.vertex?.blendIndices || mesh?.blendIndices;
634
+ if (!indices) return -1;
635
+ if (typeof indices[0] === "number") {
636
+ return Number(indices[vertexIndex * 4] ?? indices[vertexIndex] ?? -1);
637
+ }
638
+ return Number(indices[vertexIndex]?.[0] ?? -1);
639
+ }
640
+ }
641
+
642
+ // Declared as data rather than with decorators, so the resource tree loads from
643
+ // source without a transform. Field order is key order, and GetValues() exports
644
+ // in that order.
645
+ CjsSchema.define(TriGeometryRes, {
646
+ className: "TriGeometryRes",
647
+ family: "resources",
648
+ fields: {
649
+ forceLod: [type.boolean, io.readwrite],
650
+ forcedLodIndex: [type.int32, io.readwrite],
651
+ name: [type.string, io.readwrite]
652
+ },
653
+ methods: {
654
+ GetMeshCount: [carbon.method, impl.adapted],
655
+ GetAnimationCount: [carbon.method, impl.adapted],
656
+ GetSkeletonCount: [carbon.method, impl.adapted],
657
+ GetSkeletonData: [carbon.method, impl.adapted],
658
+ GetMeshAreaCount: [carbon.method, impl.adapted],
659
+ GetMeshName: [carbon.method, impl.adapted],
660
+ GetMeshAreaName: [carbon.method, impl.adapted],
661
+ GetAreaBoundingBox: [carbon.method, impl.adapted],
662
+ GetBoundingBox: [carbon.method, impl.adapted],
663
+ GetBoundingSphere: [carbon.method, impl.adapted],
664
+ CalculateBoundingBoxFromTransform: [carbon.method, impl.adapted],
665
+ RecalculateBoundingSphere: [carbon.method, impl.adapted],
666
+ Reload: [carbon.method, impl.notSupported],
667
+ GetIntersectionPointNormalBone: [carbon.method, impl.adapted],
668
+ GetAreaIntersectionPointNormalBone: [carbon.method, impl.adapted],
669
+ GetMeshVertexElements: [carbon.method, impl.adapted],
670
+ SaveMesh: [carbon.method, impl.notSupported]
671
+ }
672
+ });
673
+
674
+ export { TriGeometryRes };
675
+ //# sourceMappingURL=TriGeometryRes.js.map