@carbonenginejs/runtime-resource 0.13.0 → 0.14.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 (453) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +32 -32
  3. package/README.md +129 -129
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3858 -3858
  6. package/dist/CjsResManFetchProvider.js +94 -94
  7. package/dist/CjsResManWorkQueue.js +301 -301
  8. package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
  9. package/dist/format/CjsBlueReader.js +358 -358
  10. package/dist/format/CjsByteReader.js +310 -310
  11. package/dist/format/CjsByteWriter.js +242 -242
  12. package/dist/format/CjsFormat.js +223 -223
  13. package/dist/format/CjsFormatError.js +41 -41
  14. package/dist/format/CjsReader.js +22 -22
  15. package/dist/format/CjsResourceProbe.js +279 -279
  16. package/dist/format/CjsStringTable.js +268 -268
  17. package/dist/format/carbonEffect/CjsCarbonEffectReader.js +265 -265
  18. package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
  19. package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -182
  20. package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -321
  21. package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -1147
  22. package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -197
  23. package/dist/format/compareUtf8.js +36 -36
  24. package/dist/format/effect/effectBodyInventory.js +146 -146
  25. package/dist/format/effect/effectPermutationGraph.js +257 -257
  26. package/dist/format/effect/sha256.js +114 -114
  27. package/dist/format/index.js +11 -11
  28. package/dist/format/payloadContract.js +193 -193
  29. package/dist/formats/black/CjsBlackFormat.js +310 -310
  30. package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
  31. package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
  32. package/dist/formats/black/core/CjsBlackReader.js +764 -764
  33. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
  34. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
  35. package/dist/formats/black/core/blackConstants.js +7 -7
  36. package/dist/formats/black/core/blackDefinitions.js +10 -10
  37. package/dist/formats/black/core/blackEnums.js +6 -6
  38. package/dist/formats/black/core/blackSchema.js +3 -3
  39. package/dist/formats/black/core/blackVersion.js +22 -22
  40. package/dist/formats/black/core/helpers.js +199 -199
  41. package/dist/formats/black/core/schema.js +4 -4
  42. package/dist/formats/black/index.js +2 -2
  43. package/dist/formats/bnk/CjsBnkFormat.js +175 -175
  44. package/dist/formats/bnk/core/busNodes.js +252 -252
  45. package/dist/formats/bnk/core/effectNodes.js +147 -147
  46. package/dist/formats/bnk/core/eventAction.js +416 -416
  47. package/dist/formats/bnk/core/globalSettings.js +215 -215
  48. package/dist/formats/bnk/core/graph.js +137 -137
  49. package/dist/formats/bnk/core/helpers.js +512 -512
  50. package/dist/formats/bnk/core/musicNodes.js +540 -540
  51. package/dist/formats/bnk/core/nodeBase.js +553 -553
  52. package/dist/formats/bnk/core/sfxNodes.js +632 -632
  53. package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
  54. package/dist/formats/bnk/index.js +2 -2
  55. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  56. package/dist/formats/cmf/core/binary.js +194 -194
  57. package/dist/formats/cmf/core/buffers.js +237 -237
  58. package/dist/formats/cmf/core/constants.js +47 -47
  59. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  60. package/dist/formats/cmf/core/helpers.js +318 -318
  61. package/dist/formats/cmf/core/pack.js +276 -276
  62. package/dist/formats/cmf/core/schema.js +374 -374
  63. package/dist/formats/cmf/core/shared.js +277 -277
  64. package/dist/formats/cmf/core/writer.js +571 -571
  65. package/dist/formats/cmf/index.js +2 -2
  66. package/dist/formats/dds/CjsDdsFormat.js +200 -200
  67. package/dist/formats/dds/core/bc6h.js +298 -298
  68. package/dist/formats/dds/core/bc7.js +272 -272
  69. package/dist/formats/dds/core/helpers.js +901 -862
  70. package/dist/formats/dds/core/helpers.js.map +1 -1
  71. package/dist/formats/dds/index.js +2 -2
  72. package/dist/formats/dxbc/CjsDxbcFormat.js +187 -142
  73. package/dist/formats/dxbc/CjsDxbcFormat.js.map +1 -1
  74. package/dist/formats/dxbc/core/DxbcReader.js +266 -266
  75. package/dist/formats/dxbc/core/container.js +169 -169
  76. package/dist/formats/dxbc/core/decoder.js +789 -789
  77. package/dist/formats/dxbc/core/disassemble.js +240 -0
  78. package/dist/formats/dxbc/core/disassemble.js.map +1 -0
  79. package/dist/formats/dxbc/core/errors.js +19 -19
  80. package/dist/formats/dxbc/core/helpers.js +220 -220
  81. package/dist/formats/dxbc/core/opcodes.js +45 -45
  82. package/dist/formats/dxbc/core/program.js +91 -91
  83. package/dist/formats/dxbc/core/signature.js +172 -172
  84. package/dist/formats/dxbc/index.js +2 -2
  85. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  86. package/dist/formats/fbx/core/helpers.js +3932 -3932
  87. package/dist/formats/fbx/index.js +2 -2
  88. package/dist/formats/flac/CjsFlacFormat.js +142 -142
  89. package/dist/formats/flac/core/helpers.js +315 -315
  90. package/dist/formats/flac/index.js +2 -2
  91. package/dist/formats/gif/CjsGifFormat.js +141 -141
  92. package/dist/formats/gif/core/helpers.js +380 -380
  93. package/dist/formats/gif/index.js +2 -2
  94. package/dist/formats/gltf/CjsGltfFormat.js +252 -290
  95. package/dist/formats/gltf/CjsGltfFormat.js.map +1 -1
  96. package/dist/formats/gltf/core/helpers.js +287 -307
  97. package/dist/formats/gltf/core/helpers.js.map +1 -1
  98. package/dist/formats/gltf/core/json.js +79 -79
  99. package/dist/formats/gltf/core/parser.js +679 -679
  100. package/dist/formats/gltf/core/targets.js +173 -173
  101. package/dist/formats/gltf/index.js +2 -2
  102. package/dist/formats/gr2/CjsGr2Format.js +289 -289
  103. package/dist/formats/gr2/core/bitknit2.js +282 -282
  104. package/dist/formats/gr2/core/curves.js +1047 -1047
  105. package/dist/formats/gr2/core/gsf.js +72 -72
  106. package/dist/formats/gr2/core/helpers.js +352 -352
  107. package/dist/formats/gr2/core/json.js +622 -622
  108. package/dist/formats/gr2/core/oodle1.js +388 -388
  109. package/dist/formats/gr2/core/tangents.js +48 -48
  110. package/dist/formats/gr2/core/targets.js +361 -361
  111. package/dist/formats/gr2/index.js +2 -2
  112. package/dist/formats/hlsl/CjsHlslFormat.js +233 -254
  113. package/dist/formats/hlsl/CjsHlslFormat.js.map +1 -1
  114. package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
  115. package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
  116. package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
  117. package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
  118. package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
  119. package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
  120. package/dist/formats/hlsl/core/analysis.js +51 -51
  121. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -850
  122. package/dist/formats/hlsl/core/detailMapFamily.js +128 -128
  123. package/dist/formats/hlsl/core/helpers.js +270 -270
  124. package/dist/formats/hlsl/core/json.js +284 -284
  125. package/dist/formats/hlsl/core/localLightFamily.js +133 -133
  126. package/dist/formats/hlsl/core/metadata.js +327 -327
  127. package/dist/formats/hlsl/core/render-states.js +280 -280
  128. package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
  129. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -320
  130. package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
  131. package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +423 -416
  132. package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js.map +1 -1
  133. package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
  134. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -62
  135. package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
  136. package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
  137. package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
  138. package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
  139. package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
  140. package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
  141. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
  142. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
  143. package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
  144. package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
  145. package/dist/formats/hlsl/index.js +3 -3
  146. package/dist/formats/index.js +33 -33
  147. package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
  148. package/dist/formats/jpeg/core/helpers.js +402 -402
  149. package/dist/formats/jpeg/core/jpeg.js +480 -480
  150. package/dist/formats/jpeg/index.js +2 -2
  151. package/dist/formats/mp3/CjsMp3Format.js +197 -197
  152. package/dist/formats/mp3/core/helpers.js +375 -375
  153. package/dist/formats/mp3/index.js +2 -2
  154. package/dist/formats/mp4/CjsMp4Format.js +197 -197
  155. package/dist/formats/mp4/core/helpers.js +484 -484
  156. package/dist/formats/mp4/index.js +2 -2
  157. package/dist/formats/obj/CjsObjFormat.js +232 -253
  158. package/dist/formats/obj/CjsObjFormat.js.map +1 -1
  159. package/dist/formats/obj/core/helpers.js +553 -573
  160. package/dist/formats/obj/core/helpers.js.map +1 -1
  161. package/dist/formats/obj/core/json.js +64 -64
  162. package/dist/formats/obj/core/parser.js +321 -321
  163. package/dist/formats/obj/index.js +2 -2
  164. package/dist/formats/ogg/CjsOggFormat.js +143 -143
  165. package/dist/formats/ogg/core/helpers.js +410 -410
  166. package/dist/formats/ogg/core/imdct.js +178 -178
  167. package/dist/formats/ogg/core/vorbis.js +1017 -1017
  168. package/dist/formats/ogg/index.js +2 -2
  169. package/dist/formats/pickle/CjsPickleFormat.js +214 -214
  170. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -551
  171. package/dist/formats/pickle/index.js +2 -2
  172. package/dist/formats/png/CjsPngFormat.js +201 -201
  173. package/dist/formats/png/core/helpers.js +635 -635
  174. package/dist/formats/png/index.js +2 -2
  175. package/dist/formats/red/CjsRedFormat.js +263 -263
  176. package/dist/formats/red/core/CjsRedReader.js +246 -246
  177. package/dist/formats/red/core/blackDefinitions.js +3 -3
  178. package/dist/formats/red/core/helpers.js +158 -158
  179. package/dist/formats/red/core/redGraph.js +71 -71
  180. package/dist/formats/red/core/schema.js +4 -4
  181. package/dist/formats/red/index.js +2 -2
  182. package/dist/formats/stl/CjsStlFormat.js +320 -365
  183. package/dist/formats/stl/CjsStlFormat.js.map +1 -1
  184. package/dist/formats/stl/core/helpers.js +241 -261
  185. package/dist/formats/stl/core/helpers.js.map +1 -1
  186. package/dist/formats/stl/core/json.js +51 -51
  187. package/dist/formats/stl/core/stl.js +642 -642
  188. package/dist/formats/stl/core/targets.js +173 -173
  189. package/dist/formats/stl/index.js +2 -2
  190. package/dist/formats/tga/CjsTgaFormat.js +197 -197
  191. package/dist/formats/tga/core/helpers.js +493 -493
  192. package/dist/formats/tga/index.js +2 -2
  193. package/dist/formats/wav/CjsWavFormat.js +198 -198
  194. package/dist/formats/wav/core/helpers.js +365 -365
  195. package/dist/formats/wav/index.js +2 -2
  196. package/dist/formats/webgl/CjsWebglFormat.js +199 -199
  197. package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -70
  198. package/dist/formats/webgl/core/effectPackage.js +900 -900
  199. package/dist/formats/webgl/core/errors.js +27 -27
  200. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2820
  201. package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
  202. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -486
  203. package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -98
  204. package/dist/formats/webgl/core/glslBackendBlock.js +552 -552
  205. package/dist/formats/webgl/core/glslBackendBodySet.js +243 -243
  206. package/dist/formats/webgl/core/glslEffectCompleteness.js +85 -85
  207. package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -1
  208. package/dist/formats/webgl/core/helpers.js +167 -167
  209. package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -122
  210. package/dist/formats/webgl/core/readGlslEffectContainer.js +202 -256
  211. package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -1
  212. package/dist/formats/webgl/index.js +2 -2
  213. package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
  214. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -89
  215. package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js +354 -354
  216. package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js +355 -355
  217. package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js +90 -90
  218. package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
  219. package/dist/formats/webgpu/core/effectBackendBodySet.js +306 -306
  220. package/dist/formats/webgpu/core/errors.js +20 -20
  221. package/dist/formats/webgpu/core/helpers.js +443 -443
  222. package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
  223. package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
  224. package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
  225. package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
  226. package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
  227. package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
  228. package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
  229. package/dist/formats/webgpu/core/packageEffect.js +381 -381
  230. package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
  231. package/dist/formats/webgpu/core/packageMetadata.js +17 -17
  232. package/dist/formats/webgpu/core/schema.js +4 -4
  233. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
  234. package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
  235. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +325 -325
  236. package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
  237. package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
  238. package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
  239. package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
  240. package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
  241. package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
  242. package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
  243. package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
  244. package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
  245. package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
  246. package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
  247. package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
  248. package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
  249. package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
  250. package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
  251. package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
  252. package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
  253. package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
  254. package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
  255. package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
  256. package/dist/formats/webgpu/index.js +2 -2
  257. package/dist/formats/webm/CjsWebmFormat.js +197 -197
  258. package/dist/formats/webm/core/helpers.js +572 -572
  259. package/dist/formats/webm/index.js +2 -2
  260. package/dist/formats/webp/CjsWebpFormat.js +140 -140
  261. package/dist/formats/webp/core/helpers.js +237 -237
  262. package/dist/formats/webp/index.js +2 -2
  263. package/dist/formats/wem/CjsWemFormat.js +250 -250
  264. package/dist/formats/wem/core/bitStream.js +261 -261
  265. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  266. package/dist/formats/wem/core/helpers.js +437 -437
  267. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  268. package/dist/formats/wem/core/ptadpcm.js +77 -77
  269. package/dist/formats/wem/core/resolve.js +121 -121
  270. package/dist/formats/wem/core/wemToOgg.js +485 -485
  271. package/dist/formats/wem/index.js +2 -2
  272. package/dist/formats/yaml/CjsYamlFormat.js +134 -134
  273. package/dist/formats/yaml/core/CjsYamlReader.js +400 -400
  274. package/dist/formats/yaml/core/helpers.js +196 -196
  275. package/dist/formats/yaml/index.js +2 -2
  276. package/dist/index.js +64 -64
  277. package/dist/resource/CjsLoadingObject.js +19 -19
  278. package/dist/resource/CjsResource.js +801 -801
  279. package/dist/resource/ResourceHandlerMode.js +14 -14
  280. package/dist/resource/Tr2LightProfileRes.js +32 -32
  281. package/dist/resource/audio/AudioGeometryResData.js +47 -47
  282. package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
  283. package/dist/resource/audio/CjsAudioRes.js +213 -213
  284. package/dist/resource/audio/index.js +4 -4
  285. package/dist/resource/geometry/MeshDecalData.js +37 -37
  286. package/dist/resource/geometry/MeshDecalLodData.js +34 -34
  287. package/dist/resource/geometry/TriGeometryRes.js +675 -675
  288. package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
  289. package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
  290. package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
  291. package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
  292. package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
  293. package/dist/resource/geometry/TriJointBinding.js +38 -38
  294. package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
  295. package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
  296. package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
  297. package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
  298. package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
  299. package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
  300. package/dist/resource/geometry/granny/enums.js +10 -10
  301. package/dist/resource/geometry/granny/index.js +6 -6
  302. package/dist/resource/geometry/index.js +17 -17
  303. package/dist/resource/index.js +54 -54
  304. package/dist/resource/resourceBoundary.js +64 -64
  305. package/dist/resource/shader/Tr2EffectRes.js +336 -336
  306. package/dist/resource/shader/Tr2MaterialArea.js +31 -31
  307. package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
  308. package/dist/resource/shader/Tr2MaterialRes.js +31 -31
  309. package/dist/resource/shader/Tr2Shader.js +283 -283
  310. package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
  311. package/dist/resource/shader/index.js +17 -17
  312. package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -143
  313. package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
  314. package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -114
  315. package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -168
  316. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -125
  317. package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -120
  318. package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -372
  319. package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -78
  320. package/dist/resource/shader/reflection/Tr2Pass.js +168 -168
  321. package/dist/resource/shader/reflection/carbonRecordFields.js +159 -159
  322. package/dist/resource/shader/reflection/shaderStage.js +22 -22
  323. package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -135
  324. package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
  325. package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
  326. package/dist/resource/texture/Tr2ImageRes.js +120 -120
  327. package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
  328. package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
  329. package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
  330. package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
  331. package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
  332. package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
  333. package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
  334. package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
  335. package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
  336. package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
  337. package/dist/resource/texture/TriTextureRes.js +359 -359
  338. package/dist/resource/texture/index.js +15 -15
  339. package/dist/resource/texture/texturePipelineBehavior.js +308 -308
  340. package/dist/worker/CjsResManMainThreadLoader.js +89 -89
  341. package/dist/worker/CjsResManWorker.js +218 -218
  342. package/dist/worker/CjsResManWorkerLoader.js +437 -437
  343. package/dist/worker/protocol.js +12 -12
  344. package/docs/README.md +98 -98
  345. package/docs/architecture.md +118 -118
  346. package/docs/concepts/resource-lifecycle.md +226 -226
  347. package/docs/concepts/shader-resource-model.md +111 -111
  348. package/docs/concepts/writing-an-engine-adapter.md +115 -115
  349. package/docs/formats/README.md +138 -138
  350. package/docs/formats/carbon-effect-container.md +553 -553
  351. package/docs/formats/dxbc/README.md +68 -68
  352. package/docs/formats/dxbc/architecture.md +80 -80
  353. package/docs/formats/dxbc/reference/api.md +105 -77
  354. package/docs/formats/dxbc/reference/classes/README.md +9 -9
  355. package/docs/formats/dxbc/reference/decoded-output.md +122 -122
  356. package/docs/formats/gr2.md +160 -160
  357. package/docs/formats/hlsl/README.md +54 -54
  358. package/docs/formats/hlsl/architecture.md +66 -65
  359. package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -60
  360. package/docs/formats/hlsl/guides/reading-effects.md +68 -64
  361. package/docs/formats/hlsl/reference/advanced-analysis.md +61 -61
  362. package/docs/formats/hlsl/reference/api.md +91 -92
  363. package/docs/formats/hlsl/reference/classes/README.md +11 -11
  364. package/docs/formats/hlsl/reference/json-graph.md +97 -97
  365. package/docs/formats/pickle.md +82 -82
  366. package/docs/formats/provenance.md +196 -196
  367. package/docs/formats/stl.md +37 -37
  368. package/docs/formats/webgl/README.md +115 -115
  369. package/docs/formats/webgl/architecture.md +69 -69
  370. package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
  371. package/docs/formats/webgl/decl-io.md +1234 -1234
  372. package/docs/formats/webgl/memory-structured.md +890 -890
  373. package/docs/formats/webgl/reference/classes/README.md +9 -9
  374. package/docs/formats/webgl/texture-sample.md +964 -964
  375. package/docs/formats/webgpu/README.md +84 -84
  376. package/docs/formats/webgpu/architecture.md +95 -95
  377. package/docs/formats/webgpu/formats/carbon-webgpu.md +215 -215
  378. package/docs/formats/webgpu/guides/effect-packaging.md +189 -189
  379. package/docs/formats/webgpu/reference/api.md +196 -196
  380. package/docs/formats/webgpu/reference/classes/README.md +9 -9
  381. package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1546
  382. package/docs/formats/wwise.md +146 -146
  383. package/docs/reference/classes/README.md +35 -35
  384. package/docs/reference/classes/audio.md +30 -30
  385. package/docs/reference/classes/core.md +216 -216
  386. package/docs/reference/classes/dropped.md +46 -46
  387. package/docs/reference/classes/formats.md +944 -944
  388. package/docs/reference/classes/resources.md +456 -456
  389. package/docs/reference/classes/texture.md +26 -26
  390. package/docs/reference/events.md +117 -117
  391. package/docs/reference/motherlode-cache.md +275 -275
  392. package/docs/reference/queues.md +194 -194
  393. package/docs/reference/reload.md +107 -107
  394. package/docs/reference/texture-arrays.md +113 -113
  395. package/docs/reference/texture-pipeline.md +53 -53
  396. package/docs/reference/workers.md +142 -142
  397. package/docs/roadmap.md +150 -150
  398. package/format-notices/black/LICENSE +21 -21
  399. package/format-notices/black/NOTICE +47 -47
  400. package/format-notices/bnk/LICENSE +21 -21
  401. package/format-notices/bnk/NOTICE +21 -21
  402. package/format-notices/cmf/LICENSE +21 -21
  403. package/format-notices/cmf/NOTICE +36 -36
  404. package/format-notices/dds/LICENSE +21 -21
  405. package/format-notices/dds/NOTICE +14 -14
  406. package/format-notices/dxbc/LICENSE +21 -21
  407. package/format-notices/dxbc/NOTICE +20 -20
  408. package/format-notices/fbx/LICENSE +21 -21
  409. package/format-notices/fbx/NOTICE +14 -14
  410. package/format-notices/flac/LICENSE +21 -21
  411. package/format-notices/flac/NOTICE +14 -14
  412. package/format-notices/gif/LICENSE +21 -21
  413. package/format-notices/gif/NOTICE +14 -14
  414. package/format-notices/gltf/LICENSE +21 -21
  415. package/format-notices/gltf/NOTICE +27 -27
  416. package/format-notices/gr2/LICENSE +21 -21
  417. package/format-notices/gr2/NOTICE +60 -60
  418. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
  419. package/format-notices/hlsl/LICENSE +21 -21
  420. package/format-notices/hlsl/NOTICE +25 -25
  421. package/format-notices/jpeg/LICENSE +21 -21
  422. package/format-notices/jpeg/NOTICE +14 -14
  423. package/format-notices/mp3/LICENSE +21 -21
  424. package/format-notices/mp3/NOTICE +14 -14
  425. package/format-notices/mp4/LICENSE +21 -21
  426. package/format-notices/mp4/NOTICE +14 -14
  427. package/format-notices/obj/LICENSE +21 -21
  428. package/format-notices/obj/NOTICE +26 -26
  429. package/format-notices/ogg/LICENSE +21 -21
  430. package/format-notices/ogg/NOTICE +28 -28
  431. package/format-notices/png/LICENSE +21 -21
  432. package/format-notices/png/NOTICE +14 -14
  433. package/format-notices/red/LICENSE +21 -21
  434. package/format-notices/red/NOTICE +31 -31
  435. package/format-notices/stl/LICENSE +21 -21
  436. package/format-notices/stl/NOTICE +21 -21
  437. package/format-notices/tga/LICENSE +21 -21
  438. package/format-notices/tga/NOTICE +14 -14
  439. package/format-notices/wav/LICENSE +21 -21
  440. package/format-notices/wav/NOTICE +14 -14
  441. package/format-notices/webgl/LICENSE +21 -21
  442. package/format-notices/webgl/NOTICE +35 -35
  443. package/format-notices/webgpu/LICENSE +21 -21
  444. package/format-notices/webgpu/NOTICE +31 -31
  445. package/format-notices/webm/LICENSE +21 -21
  446. package/format-notices/webm/NOTICE +14 -14
  447. package/format-notices/webp/LICENSE +21 -21
  448. package/format-notices/webp/NOTICE +14 -14
  449. package/format-notices/wem/LICENSE +57 -57
  450. package/format-notices/wem/NOTICE +33 -33
  451. package/format-notices/yaml/LICENSE +21 -21
  452. package/format-notices/yaml/NOTICE +44 -44
  453. package/package.json +63 -63
@@ -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