@woosh/meep-engine 3.52.0 → 3.53.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 (370) hide show
  1. package/package.json +1 -1
  2. package/src/engine/ecs/animation/Animation.d.ts +4 -25
  3. package/src/engine/ecs/animation/Animation.d.ts.map +1 -1
  4. package/src/engine/ecs/animation/Animation.js +9 -41
  5. package/src/engine/ecs/ik/IKGoalSystem.d.ts +4 -5
  6. package/src/engine/ecs/ik/IKGoalSystem.d.ts.map +1 -1
  7. package/src/engine/ecs/ik/IKGoalSystem.js +4 -6
  8. package/src/engine/graphics/ecs/mesh/assetTypeByPath.js +1 -1
  9. package/src/engine/graphics3/AnimationGraphSystem.d.ts +9 -22
  10. package/src/engine/graphics3/AnimationGraphSystem.d.ts.map +1 -1
  11. package/src/engine/graphics3/AnimationGraphSystem.js +58 -203
  12. package/src/engine/graphics3/AnimationSystem.d.ts +7 -18
  13. package/src/engine/graphics3/AnimationSystem.d.ts.map +1 -1
  14. package/src/engine/graphics3/AnimationSystem.js +62 -243
  15. package/src/engine/graphics3/FoliageWindSystem.d.ts +67 -0
  16. package/src/engine/graphics3/FoliageWindSystem.d.ts.map +1 -0
  17. package/src/engine/graphics3/FoliageWindSystem.js +257 -0
  18. package/src/engine/graphics3/GPUFluidSystem.d.ts +7 -0
  19. package/src/engine/graphics3/GPUFluidSystem.d.ts.map +1 -1
  20. package/src/engine/graphics3/GPUFluidSystem.js +39 -1
  21. package/src/engine/graphics3/GPUParticleEmitterSystem.d.ts +0 -1
  22. package/src/engine/graphics3/GPUParticleEmitterSystem.d.ts.map +1 -1
  23. package/src/engine/graphics3/GPUParticleEmitterSystem.js +19 -5
  24. package/src/engine/graphics3/animation/AnimationClips.d.ts +107 -13
  25. package/src/engine/graphics3/animation/AnimationClips.d.ts.map +1 -1
  26. package/src/engine/graphics3/animation/AnimationClips.js +207 -10
  27. package/src/engine/graphics3/animation/AnimationClipsSink.d.ts +89 -0
  28. package/src/engine/graphics3/animation/AnimationClipsSink.d.ts.map +1 -0
  29. package/src/engine/graphics3/animation/AnimationClipsSink.js +205 -0
  30. package/src/engine/graphics3/animation/FoliageWindRigs.d.ts +43 -0
  31. package/src/engine/graphics3/animation/FoliageWindRigs.d.ts.map +1 -0
  32. package/src/engine/graphics3/animation/FoliageWindRigs.js +69 -0
  33. package/src/engine/graphics3/animation/write_clip_playback.d.ts +17 -11
  34. package/src/engine/graphics3/animation/write_clip_playback.d.ts.map +1 -1
  35. package/src/engine/graphics3/animation/write_clip_playback.js +36 -27
  36. package/src/engine/graphics3/decal/GPUDecalRenderer.d.ts.map +1 -1
  37. package/src/engine/graphics3/decal/GPUDecalRenderer.js +8 -6
  38. package/src/engine/graphics3/decal/shader_decal_composite.d.ts.map +1 -1
  39. package/src/engine/graphics3/decal/shader_decal_composite.js +11 -5
  40. package/src/engine/graphics3/pose/collect_entity_playbacks.d.ts +7 -7
  41. package/src/engine/graphics3/pose/collect_entity_playbacks.d.ts.map +1 -1
  42. package/src/engine/graphics3/pose/collect_entity_playbacks.js +14 -15
  43. package/src/engine/graphics3/prefab/Prefab.d.ts +6 -0
  44. package/src/engine/graphics3/prefab/Prefab.d.ts.map +1 -1
  45. package/src/engine/graphics3/prefab/Prefab.js +169 -162
  46. package/src/engine/graphics3/prefab/prefab_compile.d.ts.map +1 -1
  47. package/src/engine/graphics3/prefab/prefab_compile.js +369 -334
  48. package/src/engine/graphics3/prefab/prefab_instantiate.d.ts.map +1 -1
  49. package/src/engine/graphics3/prefab/prefab_instantiate.js +43 -2
  50. package/src/engine/graphics3/terrain/chunk_terrain_material_surface.js +2 -2
  51. package/src/engine/physics/ecs/ContactProbeSystem.d.ts +2 -3
  52. package/src/engine/physics/ecs/ContactProbeSystem.d.ts.map +1 -1
  53. package/src/engine/physics/ecs/ContactProbeSystem.js +2 -4
  54. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts +4 -4
  55. package/src/engine/sound/simulation/PROBE_PLACEMENT.md +4 -4
  56. package/src/engine/sound/simulation/README.md +1 -1
  57. package/src/engine/sound/simulation/probe/bakeProbeField.d.ts +22 -8
  58. package/src/engine/sound/simulation/probe/bakeProbeField.d.ts.map +1 -1
  59. package/src/engine/sound/simulation/probe/bakeProbeField.js +60 -15
  60. package/src/engine/sound/simulation/probe/bakeProbeReflectors.d.ts.map +1 -1
  61. package/src/engine/sound/simulation/probe/bakeProbeReflectors.js +19 -23
  62. package/src/engine/sound/simulation/probe/probe_sdf_grid.d.ts +63 -17
  63. package/src/engine/sound/simulation/probe/probe_sdf_grid.d.ts.map +1 -1
  64. package/src/engine/sound/simulation/probe/probe_sdf_grid.js +67 -17
  65. package/src/generation/foliage/FOLIAGE_DESIGN.md +318 -0
  66. package/src/generation/foliage/FOLIAGE_PLAN.md +198 -0
  67. package/src/generation/foliage/animation/build_tree_wind_rig.d.ts +20 -0
  68. package/src/generation/foliage/animation/build_tree_wind_rig.d.ts.map +1 -0
  69. package/src/generation/foliage/animation/build_tree_wind_rig.js +108 -0
  70. package/src/generation/foliage/asset/TreeAsset.d.ts +86 -0
  71. package/src/generation/foliage/asset/TreeAsset.d.ts.map +1 -0
  72. package/src/generation/foliage/asset/TreeAsset.js +111 -0
  73. package/src/generation/foliage/asset/TreeLODAsset.d.ts +115 -0
  74. package/src/generation/foliage/asset/TreeLODAsset.d.ts.map +1 -0
  75. package/src/generation/foliage/asset/TreeLODAsset.js +346 -0
  76. package/src/generation/foliage/asset/generate_tree.d.ts +15 -0
  77. package/src/generation/foliage/asset/generate_tree.d.ts.map +1 -0
  78. package/src/generation/foliage/asset/generate_tree.js +93 -0
  79. package/src/generation/foliage/asset/place_tree.d.ts +82 -0
  80. package/src/generation/foliage/asset/place_tree.d.ts.map +1 -0
  81. package/src/generation/foliage/asset/place_tree.js +194 -0
  82. package/src/generation/foliage/config/BarkMaterialConfig.d.ts +120 -0
  83. package/src/generation/foliage/config/BarkMaterialConfig.d.ts.map +1 -0
  84. package/src/generation/foliage/config/BarkMaterialConfig.js +250 -0
  85. package/src/generation/foliage/config/BranchLevelConfig.d.ts +288 -0
  86. package/src/generation/foliage/config/BranchLevelConfig.d.ts.map +1 -0
  87. package/src/generation/foliage/config/BranchLevelConfig.js +536 -0
  88. package/src/generation/foliage/config/CrownConfig.d.ts +100 -0
  89. package/src/generation/foliage/config/CrownConfig.d.ts.map +1 -0
  90. package/src/generation/foliage/config/CrownConfig.js +186 -0
  91. package/src/generation/foliage/config/CrownEnvelopeType.d.ts +16 -0
  92. package/src/generation/foliage/config/CrownEnvelopeType.d.ts.map +1 -0
  93. package/src/generation/foliage/config/CrownEnvelopeType.js +17 -0
  94. package/src/generation/foliage/config/FoliageCardType.d.ts +12 -0
  95. package/src/generation/foliage/config/FoliageCardType.d.ts.map +1 -0
  96. package/src/generation/foliage/config/FoliageCardType.js +18 -0
  97. package/src/generation/foliage/config/FoliageConfig.d.ts +151 -0
  98. package/src/generation/foliage/config/FoliageConfig.d.ts.map +1 -0
  99. package/src/generation/foliage/config/FoliageConfig.js +283 -0
  100. package/src/generation/foliage/config/FoliageMaterialConfig.d.ts +90 -0
  101. package/src/generation/foliage/config/FoliageMaterialConfig.d.ts.map +1 -0
  102. package/src/generation/foliage/config/FoliageMaterialConfig.js +181 -0
  103. package/src/generation/foliage/config/PhyllotaxisMode.d.ts +13 -0
  104. package/src/generation/foliage/config/PhyllotaxisMode.d.ts.map +1 -0
  105. package/src/generation/foliage/config/PhyllotaxisMode.js +20 -0
  106. package/src/generation/foliage/config/TreeLODConfig.d.ts +87 -0
  107. package/src/generation/foliage/config/TreeLODConfig.d.ts.map +1 -0
  108. package/src/generation/foliage/config/TreeLODConfig.js +211 -0
  109. package/src/generation/foliage/config/TreePreset.d.ts +16 -0
  110. package/src/generation/foliage/config/TreePreset.d.ts.map +1 -0
  111. package/src/generation/foliage/config/TreePreset.js +17 -0
  112. package/src/generation/foliage/config/TreeSpeciesConfig.d.ts +109 -0
  113. package/src/generation/foliage/config/TreeSpeciesConfig.d.ts.map +1 -0
  114. package/src/generation/foliage/config/TreeSpeciesConfig.js +400 -0
  115. package/src/generation/foliage/config/TreeWindConfig.d.ts +84 -0
  116. package/src/generation/foliage/config/TreeWindConfig.d.ts.map +1 -0
  117. package/src/generation/foliage/config/TreeWindConfig.js +157 -0
  118. package/src/generation/foliage/index.d.ts +38 -0
  119. package/src/generation/foliage/index.d.ts.map +1 -0
  120. package/src/generation/foliage/index.js +43 -0
  121. package/src/generation/foliage/material/make_bark_material.d.ts +37 -0
  122. package/src/generation/foliage/material/make_bark_material.d.ts.map +1 -0
  123. package/src/generation/foliage/material/make_bark_material.js +802 -0
  124. package/src/generation/foliage/material/make_foliage_material.d.ts +14 -0
  125. package/src/generation/foliage/material/make_foliage_material.d.ts.map +1 -0
  126. package/src/generation/foliage/material/make_foliage_material.js +359 -0
  127. package/src/generation/foliage/mesh/branch_collar_project.d.ts +42 -0
  128. package/src/generation/foliage/mesh/branch_collar_project.d.ts.map +1 -0
  129. package/src/generation/foliage/mesh/branch_collar_project.js +203 -0
  130. package/src/generation/foliage/mesh/branch_ring_triangulate.d.ts +35 -0
  131. package/src/generation/foliage/mesh/branch_ring_triangulate.d.ts.map +1 -0
  132. package/src/generation/foliage/mesh/branch_ring_triangulate.js +72 -0
  133. package/src/generation/foliage/mesh/foliage_collect_attachments.d.ts +80 -0
  134. package/src/generation/foliage/mesh/foliage_collect_attachments.d.ts.map +1 -0
  135. package/src/generation/foliage/mesh/foliage_collect_attachments.js +502 -0
  136. package/src/generation/foliage/mesh/tree_mesh_apply_canopy_ao.d.ts +19 -0
  137. package/src/generation/foliage/mesh/tree_mesh_apply_canopy_ao.d.ts.map +1 -0
  138. package/src/generation/foliage/mesh/tree_mesh_apply_canopy_ao.js +150 -0
  139. package/src/generation/foliage/mesh/tree_mesh_build_bark.d.ts +55 -0
  140. package/src/generation/foliage/mesh/tree_mesh_build_bark.d.ts.map +1 -0
  141. package/src/generation/foliage/mesh/tree_mesh_build_bark.js +1047 -0
  142. package/src/generation/foliage/mesh/tree_mesh_build_foliage.d.ts +21 -0
  143. package/src/generation/foliage/mesh/tree_mesh_build_foliage.d.ts.map +1 -0
  144. package/src/generation/foliage/mesh/tree_mesh_build_foliage.js +415 -0
  145. package/src/generation/foliage/presets/make_tree_species_preset.d.ts +13 -0
  146. package/src/generation/foliage/presets/make_tree_species_preset.d.ts.map +1 -0
  147. package/src/generation/foliage/presets/make_tree_species_preset.js +837 -0
  148. package/src/generation/foliage/skeleton/TreeSkeleton.d.ts +443 -0
  149. package/src/generation/foliage/skeleton/TreeSkeleton.d.ts.map +1 -0
  150. package/src/generation/foliage/skeleton/TreeSkeleton.js +1100 -0
  151. package/src/generation/foliage/skeleton/crown_envelope_evaluate.d.ts +27 -0
  152. package/src/generation/foliage/skeleton/crown_envelope_evaluate.d.ts.map +1 -0
  153. package/src/generation/foliage/skeleton/crown_envelope_evaluate.js +121 -0
  154. package/src/generation/foliage/skeleton/spine_frame_double_reflection.d.ts +32 -0
  155. package/src/generation/foliage/skeleton/spine_frame_double_reflection.d.ts.map +1 -0
  156. package/src/generation/foliage/skeleton/spine_frame_double_reflection.js +87 -0
  157. package/src/generation/foliage/skeleton/tree_skeleton_assign_skin_joints.d.ts +33 -0
  158. package/src/generation/foliage/skeleton/tree_skeleton_assign_skin_joints.d.ts.map +1 -0
  159. package/src/generation/foliage/skeleton/tree_skeleton_assign_skin_joints.js +205 -0
  160. package/src/generation/foliage/skeleton/tree_skeleton_compute_pipe_radii.d.ts +14 -0
  161. package/src/generation/foliage/skeleton/tree_skeleton_compute_pipe_radii.d.ts.map +1 -0
  162. package/src/generation/foliage/skeleton/tree_skeleton_compute_pipe_radii.js +179 -0
  163. package/src/generation/foliage/skeleton/tree_skeleton_grow.d.ts +18 -0
  164. package/src/generation/foliage/skeleton/tree_skeleton_grow.d.ts.map +1 -0
  165. package/src/generation/foliage/skeleton/tree_skeleton_grow.js +1104 -0
  166. package/src/shade/playground/additive_blending/index.html +197 -0
  167. package/src/shade/playground/additive_blending/main.d.ts +2 -0
  168. package/src/shade/playground/additive_blending/main.d.ts.map +1 -0
  169. package/src/shade/playground/additive_blending/main.js +529 -0
  170. package/src/shade/playground/foliage_wind/README.md +18 -0
  171. package/src/shade/playground/foliage_wind/foliage_world.d.ts +127 -0
  172. package/src/shade/playground/foliage_wind/foliage_world.d.ts.map +1 -0
  173. package/src/shade/playground/foliage_wind/foliage_world.js +593 -0
  174. package/src/shade/playground/foliage_wind/index.html +254 -0
  175. package/src/shade/playground/foliage_wind/main.d.ts +2 -0
  176. package/src/shade/playground/foliage_wind/main.d.ts.map +1 -0
  177. package/src/shade/playground/foliage_wind/main.js +263 -0
  178. package/src/shade/renderer/Renderer.d.ts.map +1 -1
  179. package/src/shade/renderer/Renderer.js +45 -16
  180. package/src/shade/renderer/animation/ADDITIVE_BLENDING_PLAN.md +145 -0
  181. package/src/shade/renderer/animation/ANIMATION_DATABASE_SPEC.d.ts +9 -1
  182. package/src/shade/renderer/animation/ANIMATION_DATABASE_SPEC.d.ts.map +1 -1
  183. package/src/shade/renderer/animation/ANIMATION_DATABASE_SPEC.js +53 -1
  184. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_JOINT_STRUCT.d.ts +8 -0
  185. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_JOINT_STRUCT.d.ts.map +1 -0
  186. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_JOINT_STRUCT.js +71 -0
  187. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_RIG_STRUCT.d.ts +11 -0
  188. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_RIG_STRUCT.d.ts.map +1 -0
  189. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_RIG_STRUCT.js +32 -0
  190. package/src/shade/renderer/animation/GPUAnimationManager.d.ts +30 -3
  191. package/src/shade/renderer/animation/GPUAnimationManager.d.ts.map +1 -1
  192. package/src/shade/renderer/animation/GPUAnimationManager.js +532 -79
  193. package/src/shade/renderer/animation/POSE_ACCUMULATOR_LAYOUT.d.ts +19 -12
  194. package/src/shade/renderer/animation/POSE_ACCUMULATOR_LAYOUT.d.ts.map +1 -1
  195. package/src/shade/renderer/animation/POSE_ACCUMULATOR_LAYOUT.js +20 -13
  196. package/src/shade/renderer/animation/ShadeAnimationClip.d.ts +35 -8
  197. package/src/shade/renderer/animation/ShadeAnimationClip.d.ts.map +1 -1
  198. package/src/shade/renderer/animation/ShadeAnimationClip.js +433 -2
  199. package/src/shade/renderer/animation/chunk_pose_accumulator.d.ts.map +1 -1
  200. package/src/shade/renderer/animation/chunk_pose_accumulator.js +40 -32
  201. package/src/shade/renderer/animation/foliage/FoliageWindJoint.d.ts +97 -0
  202. package/src/shade/renderer/animation/foliage/FoliageWindJoint.d.ts.map +1 -0
  203. package/src/shade/renderer/animation/foliage/FoliageWindJoint.js +161 -0
  204. package/src/shade/renderer/animation/foliage/FoliageWindRig.d.ts +65 -0
  205. package/src/shade/renderer/animation/foliage/FoliageWindRig.d.ts.map +1 -0
  206. package/src/shade/renderer/animation/foliage/FoliageWindRig.js +89 -0
  207. package/src/shade/renderer/animation/foliage/chunk_foliage_wind_step.d.ts +19 -0
  208. package/src/shade/renderer/animation/foliage/chunk_foliage_wind_step.d.ts.map +1 -0
  209. package/src/shade/renderer/animation/foliage/chunk_foliage_wind_step.js +143 -0
  210. package/src/shade/renderer/animation/foliage/shader_foliage_wind_apply.d.ts +14 -0
  211. package/src/shade/renderer/animation/foliage/shader_foliage_wind_apply.d.ts.map +1 -0
  212. package/src/shade/renderer/animation/foliage/shader_foliage_wind_apply.js +116 -0
  213. package/src/shade/renderer/animation/pose/pose_evaluate_local.d.ts.map +1 -1
  214. package/src/shade/renderer/animation/pose/pose_evaluate_local.js +39 -29
  215. package/src/shade/renderer/animation/shader_animation_pose_resolve.js +37 -37
  216. package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js +2 -2
  217. package/src/shade/renderer/extension/RenderExtension.d.ts +7 -0
  218. package/src/shade/renderer/extension/RenderExtension.d.ts.map +1 -1
  219. package/src/shade/renderer/extension/RenderExtension.js +9 -0
  220. package/src/shade/renderer/extension/RenderExtensionRegistry.d.ts +6 -0
  221. package/src/shade/renderer/extension/RenderExtensionRegistry.d.ts.map +1 -1
  222. package/src/shade/renderer/extension/RenderExtensionRegistry.js +15 -0
  223. package/src/shade/renderer/fluid/GPUFluidCascade.d.ts +7 -0
  224. package/src/shade/renderer/fluid/GPUFluidCascade.d.ts.map +1 -1
  225. package/src/shade/renderer/fluid/GPUFluidCascade.js +15 -0
  226. package/src/shade/renderer/fluid/GPUFluidCascadeStack.d.ts +7 -0
  227. package/src/shade/renderer/fluid/GPUFluidCascadeStack.d.ts.map +1 -1
  228. package/src/shade/renderer/fluid/GPUFluidCascadeStack.js +11 -0
  229. package/src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.d.ts.map +1 -1
  230. package/src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.js +51 -48
  231. package/src/shade/renderer/fluid/mac/FluidMacPasses.d.ts +6 -0
  232. package/src/shade/renderer/fluid/mac/FluidMacPasses.d.ts.map +1 -1
  233. package/src/shade/renderer/fluid/mac/FluidMacPasses.js +16 -0
  234. package/src/shade/renderer/fluid/mac/chunk_fluid_mac_seams.d.ts.map +1 -1
  235. package/src/shade/renderer/fluid/mac/chunk_fluid_mac_seams.js +15 -3
  236. package/src/shade/renderer/fluid/mac/chunk_v3_mac_lattice_corners.d.ts.map +1 -1
  237. package/src/shade/renderer/fluid/mac/chunk_v3_mac_lattice_corners.js +102 -96
  238. package/src/shade/renderer/fluid/mac/shader_fluid_mac_advect_correct.js +12 -12
  239. package/src/shade/renderer/fluid/mac/shader_fluid_mac_advect_predict.js +12 -12
  240. package/src/shade/renderer/fluid/pressure/GPUFluidPressureSolve.d.ts +7 -0
  241. package/src/shade/renderer/fluid/pressure/GPUFluidPressureSolve.d.ts.map +1 -1
  242. package/src/shade/renderer/fluid/pressure/GPUFluidPressureSolve.js +16 -0
  243. package/src/shade/renderer/fluid/publish/FluidWindPublish.d.ts +7 -0
  244. package/src/shade/renderer/fluid/publish/FluidWindPublish.d.ts.map +1 -1
  245. package/src/shade/renderer/fluid/publish/FluidWindPublish.js +10 -0
  246. package/src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.js +2 -2
  247. package/src/shade/renderer/loader/SceneBundle.d.ts +7 -0
  248. package/src/shade/renderer/loader/SceneBundle.d.ts.map +1 -1
  249. package/src/shade/renderer/loader/SceneBundle.js +119 -111
  250. package/src/shade/renderer/material/standard/fragment_gbuffer.d.ts +4 -0
  251. package/src/shade/renderer/material/standard/fragment_gbuffer.d.ts.map +1 -1
  252. package/src/shade/renderer/material/standard/fragment_gbuffer.js +6 -5
  253. package/src/shade/renderer/object_property/chunk_write_object_property_node3d.d.ts +8 -7
  254. package/src/shade/renderer/object_property/chunk_write_object_property_node3d.d.ts.map +1 -1
  255. package/src/shade/renderer/object_property/chunk_write_object_property_node3d.js +9 -8
  256. package/src/shade/renderer/particles/GPUParticleSystem.d.ts.map +1 -1
  257. package/src/shade/renderer/particles/GPUParticleSystem.js +3 -1
  258. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.d.ts.map +1 -1
  259. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.js +9 -4
  260. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader.d.ts.map +1 -1
  261. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader.js +9 -7
  262. package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment.d.ts.map +1 -1
  263. package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment.js +15 -7
  264. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.d.ts.map +1 -1
  265. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.js +6 -4
  266. package/src/shade/renderer/rasterize/native/oit/oit_resolve_fragment_body.js +3 -3
  267. package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.d.ts.map +1 -1
  268. package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js +8 -5
  269. package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.d.ts.map +1 -1
  270. package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js +4 -3
  271. package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.js +1 -1
  272. package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.d.ts +9 -0
  273. package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.d.ts.map +1 -0
  274. package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.js +17 -0
  275. package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.d.ts +8 -0
  276. package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.d.ts.map +1 -1
  277. package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.js +28 -20
  278. package/src/shade/renderer/texture/SAMPLER_TRILINEAR_CLAMP.d.ts +8 -0
  279. package/src/shade/renderer/texture/SAMPLER_TRILINEAR_CLAMP.d.ts.map +1 -0
  280. package/src/shade/renderer/texture/SAMPLER_TRILINEAR_CLAMP.js +15 -0
  281. package/src/shade/renderer/view/chunk_view_mip_bias.d.ts +21 -0
  282. package/src/shade/renderer/view/chunk_view_mip_bias.d.ts.map +1 -0
  283. package/src/shade/renderer/view/chunk_view_mip_bias.js +44 -0
  284. package/src/shade/wgsl/emulator/WGSLJavaScriptCompiler.js +1 -1
  285. package/src/shade/wgsl/emulator/WGSLLanguageCore.d.ts.map +1 -1
  286. package/src/shade/wgsl/emulator/WGSLLanguageCore.js +105 -26
  287. package/src/engine/graphics/composit/CompositingStages.d.ts +0 -6
  288. package/src/engine/graphics/composit/CompositingStages.d.ts.map +0 -1
  289. package/src/engine/graphics/composit/CompositingStages.js +0 -8
  290. package/src/engine/graphics/geometry/buffered/computeBufferAttributeHash.d.ts +0 -7
  291. package/src/engine/graphics/geometry/buffered/computeBufferAttributeHash.d.ts.map +0 -1
  292. package/src/engine/graphics/geometry/buffered/computeBufferAttributeHash.js +0 -24
  293. package/src/engine/graphics/geometry/buffered/computeGeometryBoundingSphereMiniball.d.ts +0 -8
  294. package/src/engine/graphics/geometry/buffered/computeGeometryBoundingSphereMiniball.d.ts.map +0 -1
  295. package/src/engine/graphics/geometry/buffered/computeGeometryBoundingSphereMiniball.js +0 -17
  296. package/src/engine/graphics/geometry/buffered/computeGeometryEquality.d.ts +0 -8
  297. package/src/engine/graphics/geometry/buffered/computeGeometryEquality.d.ts.map +0 -1
  298. package/src/engine/graphics/geometry/buffered/computeGeometryEquality.js +0 -60
  299. package/src/engine/graphics/geometry/buffered/computeGeometryHash.d.ts +0 -7
  300. package/src/engine/graphics/geometry/buffered/computeGeometryHash.d.ts.map +0 -1
  301. package/src/engine/graphics/geometry/buffered/computeGeometryHash.js +0 -26
  302. package/src/engine/graphics/geometry/buffered/compute_buffer_geometry_byte_size.d.ts +0 -7
  303. package/src/engine/graphics/geometry/buffered/compute_buffer_geometry_byte_size.d.ts.map +0 -1
  304. package/src/engine/graphics/geometry/buffered/compute_buffer_geometry_byte_size.js +0 -23
  305. package/src/engine/graphics/geometry/instancing/geometry_copy.d.ts +0 -7
  306. package/src/engine/graphics/geometry/instancing/geometry_copy.d.ts.map +0 -1
  307. package/src/engine/graphics/geometry/instancing/geometry_copy.js +0 -15
  308. package/src/engine/graphics/geometry/instancing/rewriteMaterial.d.ts +0 -2
  309. package/src/engine/graphics/geometry/instancing/rewriteMaterial.d.ts.map +0 -1
  310. package/src/engine/graphics/geometry/instancing/rewriteMaterial.js +0 -57
  311. package/src/engine/graphics/geometry/ribbon/Quad.d.ts +0 -96
  312. package/src/engine/graphics/geometry/ribbon/Quad.d.ts.map +0 -1
  313. package/src/engine/graphics/geometry/ribbon/Quad.js +0 -213
  314. package/src/engine/graphics/geometry/ribbon/copyAttributeV3.d.ts +0 -9
  315. package/src/engine/graphics/geometry/ribbon/copyAttributeV3.d.ts.map +0 -1
  316. package/src/engine/graphics/geometry/ribbon/copyAttributeV3.js +0 -12
  317. package/src/engine/graphics/geometry/ribbon/copyAttributeValue.d.ts +0 -10
  318. package/src/engine/graphics/geometry/ribbon/copyAttributeValue.d.ts.map +0 -1
  319. package/src/engine/graphics/geometry/ribbon/copyAttributeValue.js +0 -17
  320. package/src/engine/graphics/geometry/ribbon/equalAttributeV3.d.ts +0 -10
  321. package/src/engine/graphics/geometry/ribbon/equalAttributeV3.d.ts.map +0 -1
  322. package/src/engine/graphics/geometry/ribbon/equalAttributeV3.js +0 -13
  323. package/src/engine/graphics/geometry/ribbon/equalAttributeValue.d.ts +0 -11
  324. package/src/engine/graphics/geometry/ribbon/equalAttributeValue.d.ts.map +0 -1
  325. package/src/engine/graphics/geometry/ribbon/equalAttributeValue.js +0 -24
  326. package/src/engine/graphics/geometry/ribbon/rotateRibbon.d.ts +0 -6
  327. package/src/engine/graphics/geometry/ribbon/rotateRibbon.d.ts.map +0 -1
  328. package/src/engine/graphics/geometry/ribbon/rotateRibbon.js +0 -37
  329. package/src/engine/graphics/geometry/ribbon/updateTipPosition.d.ts +0 -9
  330. package/src/engine/graphics/geometry/ribbon/updateTipPosition.d.ts.map +0 -1
  331. package/src/engine/graphics/geometry/ribbon/updateTipPosition.js +0 -52
  332. package/src/engine/graphics/geometry/skining/computeSkinnedMeshVertices.d.ts +0 -8
  333. package/src/engine/graphics/geometry/skining/computeSkinnedMeshVertices.d.ts.map +0 -1
  334. package/src/engine/graphics/geometry/skining/computeSkinnedMeshVertices.js +0 -54
  335. package/src/engine/graphics/render/RenderPassType.d.ts +0 -6
  336. package/src/engine/graphics/render/RenderPassType.d.ts.map +0 -1
  337. package/src/engine/graphics/render/RenderPassType.js +0 -8
  338. package/src/engine/graphics/render/layers/RenderLayer.d.ts +0 -78
  339. package/src/engine/graphics/render/layers/RenderLayer.d.ts.map +0 -1
  340. package/src/engine/graphics/render/layers/RenderLayer.js +0 -95
  341. package/src/engine/graphics/render/layers/RenderLayerManager.d.ts +0 -72
  342. package/src/engine/graphics/render/layers/RenderLayerManager.d.ts.map +0 -1
  343. package/src/engine/graphics/render/layers/RenderLayerManager.js +0 -160
  344. package/src/engine/graphics/render/layers/RenderLayerManagerState.d.ts +0 -18
  345. package/src/engine/graphics/render/layers/RenderLayerManagerState.d.ts.map +0 -1
  346. package/src/engine/graphics/render/layers/RenderLayerManagerState.js +0 -48
  347. package/src/engine/graphics/render/layers/RenderLayerState.d.ts +0 -18
  348. package/src/engine/graphics/render/layers/RenderLayerState.d.ts.map +0 -1
  349. package/src/engine/graphics/render/layers/RenderLayerState.js +0 -27
  350. package/src/engine/graphics/render/layers/RenderLayerUtils.d.ts +0 -8
  351. package/src/engine/graphics/render/layers/RenderLayerUtils.d.ts.map +0 -1
  352. package/src/engine/graphics/render/layers/RenderLayerUtils.js +0 -103
  353. package/src/engine/graphics/render/make_bvh_visibility_builder.d.ts +0 -10
  354. package/src/engine/graphics/render/make_bvh_visibility_builder.d.ts.map +0 -1
  355. package/src/engine/graphics/render/make_bvh_visibility_builder.js +0 -64
  356. package/src/engine/graphics/render/view/CameraViewFlags.d.ts +0 -7
  357. package/src/engine/graphics/render/view/CameraViewFlags.d.ts.map +0 -1
  358. package/src/engine/graphics/render/view/CameraViewFlags.js +0 -9
  359. package/src/engine/graphics/render/visibility/IncrementalDeltaSet.d.ts +0 -143
  360. package/src/engine/graphics/render/visibility/IncrementalDeltaSet.d.ts.map +0 -1
  361. package/src/engine/graphics/render/visibility/IncrementalDeltaSet.js +0 -328
  362. package/src/engine/graphics/render/visibility/VisibilityComputer.d.ts +0 -39
  363. package/src/engine/graphics/render/visibility/VisibilityComputer.d.ts.map +0 -1
  364. package/src/engine/graphics/render/visibility/VisibilityComputer.js +0 -80
  365. package/src/engine/graphics/render/visibility/VisibilityFilter.d.ts +0 -29
  366. package/src/engine/graphics/render/visibility/VisibilityFilter.d.ts.map +0 -1
  367. package/src/engine/graphics/render/visibility/VisibilityFilter.js +0 -37
  368. package/src/engine/graphics3/animation/write_graph_playback.d.ts +0 -24
  369. package/src/engine/graphics3/animation/write_graph_playback.d.ts.map +0 -1
  370. package/src/engine/graphics3/animation/write_graph_playback.js +0 -48
@@ -0,0 +1,194 @@
1
+ import { assert } from "../../../core/assert.js";
2
+ import { PI2 } from "../../../core/math/PI2.js";
3
+ import { Transform64 } from "../../../engine/ecs/transform/Transform64.js";
4
+ import { FoliageWindRigs } from "../../../engine/graphics3/animation/FoliageWindRigs.js";
5
+ import { prefab_place, prefab_unplace } from "../../../engine/graphics3/prefab/prefab_place.js";
6
+ import { FoliageWindJoint } from "../../../shade/renderer/animation/foliage/FoliageWindJoint.js";
7
+ import { FoliageWindRig } from "../../../shade/renderer/animation/foliage/FoliageWindRig.js";
8
+ import { generate_tree } from "./generate_tree.js";
9
+
10
+ /**
11
+ * Turn-key helper to place a procedural tree (`TreeAsset`, `Prefab`, or on-the-fly generation options)
12
+ * into a bare `GPUSceneContext` + `EntityComponentDataset` (one without ECS graphics systems),
13
+ * automatically registering its GPU fluid-driven `FoliageWindRig` with `GPUAnimationManager` so its
14
+ * bones sample `GPUSceneWind` (3D fluid dynamics cascades + global far-field wind) every frame.
15
+ *
16
+ * When using a full ECS world with `ShadedGeometrySystem`, `MeshSkinSystem`, and `FoliageWindSystem`,
17
+ * prefer `prefab_instantiate(tree.prefab, dataset, root)` directly so the ECS systems manage rows,
18
+ * skins, and wind rigs automatically.
19
+ *
20
+ * @param {import("../../../shade/renderer/scene/GPUSceneContext.js").GPUSceneContext} scene_context
21
+ * @param {import("../../../engine/ecs/EntityComponentDataset.js").EntityComponentDataset} dataset
22
+ * @param {Object} [options={}]
23
+ * @param {import("./TreeAsset.js").TreeAsset} [options.tree] pre-generated `TreeAsset`
24
+ * @param {import("../../../engine/graphics3/prefab/Prefab.js").Prefab} [options.prefab] pre-compiled `Prefab`
25
+ * @param {number} [options.lod=0] LOD index when placing from `TreeAsset`
26
+ * @param {Transform64} [options.placement] explicit `Transform64` placement
27
+ * @param {number[]|{x:number,y:number,z:number}} [options.position] world position `[x, y, z]`
28
+ * @param {number[]|{x:number,y:number,z:number,w:number}} [options.rotation] world quaternion `[x, y, z, w]`
29
+ * @param {number} [options.rotation_y] yaw rotation around `+Y` in radians
30
+ * @param {number|number[]|{x:number,y:number,z:number}} [options.scale] uniform or 3-axis scale
31
+ * @param {boolean} [options.wind=true] whether to register GPU fluid-driven foliage wind rigs
32
+ * @param {number} [options.wind_weight=1.0] foliage wind rig blend weight in `pose_accumulator`
33
+ * @param {number} [options.wind_phase_offset] explicit phase offset in radians for flutter desynchronization
34
+ * @returns {{
35
+ * root: number,
36
+ * instance: import("../../../engine/graphics3/prefab/PrefabInstance.js").PrefabInstance,
37
+ * skins: {entity: number, skin_id: number}[]|null,
38
+ * foliage_rig_ids: number[],
39
+ * drawn: number,
40
+ * tree: import("./TreeAsset.js").TreeAsset|null,
41
+ * prefab: import("../../../engine/graphics3/prefab/Prefab.js").Prefab
42
+ * }}
43
+ */
44
+ export function place_tree(scene_context, dataset, options = {}) {
45
+ assert.defined(scene_context, 'scene_context');
46
+ assert.defined(dataset, 'dataset');
47
+
48
+ const opts = options || {};
49
+ let tree = null;
50
+ let prefab = null;
51
+
52
+ if (opts.prefab && opts.prefab.isPrefab) {
53
+ prefab = opts.prefab;
54
+ } else if (opts.tree && opts.tree.isTreeAsset) {
55
+ tree = opts.tree;
56
+ const lod_idx = Math.max(0, Math.min(tree.lods.length - 1, opts.lod ?? 0));
57
+ prefab = tree.lods[lod_idx].prefab;
58
+ } else if (opts.isTreeAsset) {
59
+ tree = opts;
60
+ prefab = tree.prefab;
61
+ } else if (opts.isPrefab) {
62
+ prefab = opts;
63
+ } else {
64
+ tree = generate_tree(opts);
65
+ const lod_idx = Math.max(0, Math.min(tree.lods.length - 1, opts.lod ?? 0));
66
+ prefab = tree.lods[lod_idx].prefab;
67
+ }
68
+
69
+ const placement = new Transform64();
70
+ if (opts.placement && opts.placement.isTransform64) {
71
+ placement.copy(opts.placement);
72
+ } else {
73
+ if (opts.position !== undefined) {
74
+ if (Array.isArray(opts.position) || ArrayBuffer.isView(opts.position)) {
75
+ placement.setTranslation(opts.position[0] ?? 0, opts.position[1] ?? 0, opts.position[2] ?? 0);
76
+ } else {
77
+ placement.setTranslation(opts.position.x ?? 0, opts.position.y ?? 0, opts.position.z ?? 0);
78
+ }
79
+ }
80
+ if (opts.rotation !== undefined) {
81
+ if (Array.isArray(opts.rotation) || ArrayBuffer.isView(opts.rotation)) {
82
+ placement.setRotation(
83
+ opts.rotation[0] ?? 0,
84
+ opts.rotation[1] ?? 0,
85
+ opts.rotation[2] ?? 0,
86
+ opts.rotation[3] ?? 1
87
+ );
88
+ } else {
89
+ placement.setRotation(
90
+ opts.rotation.x ?? 0,
91
+ opts.rotation.y ?? 0,
92
+ opts.rotation.z ?? 0,
93
+ opts.rotation.w ?? 1
94
+ );
95
+ }
96
+ } else if (typeof opts.rotation_y === "number") {
97
+ const half = opts.rotation_y * 0.5;
98
+ placement.setRotation(0, Math.sin(half), 0, Math.cos(half));
99
+ }
100
+
101
+ if (opts.scale !== undefined) {
102
+ if (typeof opts.scale === "number") {
103
+ placement.setScale(opts.scale, opts.scale, opts.scale);
104
+ } else if (Array.isArray(opts.scale) || ArrayBuffer.isView(opts.scale)) {
105
+ placement.setScale(opts.scale[0] ?? 1, opts.scale[1] ?? 1, opts.scale[2] ?? 1);
106
+ } else {
107
+ placement.setScale(opts.scale.x ?? 1, opts.scale.y ?? 1, opts.scale.z ?? 1);
108
+ }
109
+ }
110
+ }
111
+ placement.updateMatrix();
112
+
113
+ const enable_wind = opts.wind !== false;
114
+ const has_skins = Array.isArray(prefab.skins) && prefab.skins.length > 0;
115
+ const placed = prefab_place(scene_context, dataset, prefab, placement, {
116
+ register_animation: enable_wind || has_skins,
117
+ skinned: has_skins
118
+ });
119
+
120
+ const foliage_rig_ids = [];
121
+ const manager = scene_context.animation_manager;
122
+ const rigs_component = dataset.getComponent(placed.root, FoliageWindRigs);
123
+
124
+ if (!enable_wind && rigs_component !== undefined) {
125
+ dataset.removeComponentFromEntity(placed.root, FoliageWindRigs);
126
+ } else if (enable_wind && rigs_component !== undefined && manager !== undefined && manager !== null) {
127
+ if (typeof opts.wind_phase_offset === "number" && Array.isArray(prefab.foliage_rigs)) {
128
+ const entities = placed.instance.entities;
129
+ const phase_offset = opts.wind_phase_offset;
130
+ rigs_component.rigs = prefab.foliage_rigs.map(rig_template => FoliageWindRig.from({
131
+ name: rig_template.name,
132
+ root: entities[rig_template.root],
133
+ weight: rig_template.weight,
134
+ joints: rig_template.joints.map(j => FoliageWindJoint.from({
135
+ target: entities[j.target],
136
+ branch_axis: j.branch_axis,
137
+ compliance: j.compliance,
138
+ natural_frequency: j.natural_frequency,
139
+ damping_ratio: j.damping_ratio,
140
+ max_angle: j.max_angle,
141
+ turbulence: j.turbulence,
142
+ phase_offset: (j.phase_offset + phase_offset) % PI2,
143
+ })),
144
+ }));
145
+ }
146
+
147
+ if (typeof opts.wind_weight === "number") {
148
+ rigs_component.weight = opts.wind_weight;
149
+ }
150
+
151
+ for (let i = 0; i < rigs_component.rigs.length; i++) {
152
+ const rig_id = manager.register_foliage_rig(rigs_component.rigs[i]);
153
+ if (typeof opts.wind_weight === "number") {
154
+ manager.set_foliage_rig_weight(rig_id, opts.wind_weight);
155
+ }
156
+ foliage_rig_ids.push(rig_id);
157
+ }
158
+ }
159
+
160
+ return {
161
+ root: placed.root,
162
+ instance: placed.instance,
163
+ skins: placed.skins,
164
+ foliage_rig_ids,
165
+ drawn: placed.drawn,
166
+ tree,
167
+ prefab
168
+ };
169
+ }
170
+
171
+ /**
172
+ * Unplaces a tree previously placed via `place_tree`, unregistering its GPU fluid-driven foliage
173
+ * wind rigs BEFORE destroying the prefab instance so target entities still exist in `dataset` during cleanup.
174
+ *
175
+ * @param {import("../../../shade/renderer/scene/GPUSceneContext.js").GPUSceneContext} scene_context
176
+ * @param {import("../../../engine/ecs/EntityComponentDataset.js").EntityComponentDataset} dataset
177
+ * @param {ReturnType<typeof place_tree>} placed
178
+ */
179
+ export function unplace_tree(scene_context, dataset, placed) {
180
+ assert.defined(scene_context, 'scene_context');
181
+ assert.defined(dataset, 'dataset');
182
+ assert.defined(placed, 'placed');
183
+
184
+ // CRITICAL: unregister_foliage_rig must run BEFORE prefab_unplace removes the target entities from dataset!
185
+ if (Array.isArray(placed.foliage_rig_ids) && placed.foliage_rig_ids.length > 0 && scene_context.animation_manager) {
186
+ const manager = scene_context.animation_manager;
187
+ for (let i = 0; i < placed.foliage_rig_ids.length; i++) {
188
+ manager.unregister_foliage_rig(placed.foliage_rig_ids[i]);
189
+ }
190
+ placed.foliage_rig_ids.length = 0;
191
+ }
192
+
193
+ prefab_unplace(scene_context, dataset, placed);
194
+ }
@@ -0,0 +1,120 @@
1
+ /**
2
+ * Procedural bark PBR material & UV tiling configuration.
3
+ */
4
+ export class BarkMaterialConfig {
5
+ /**
6
+ * @param {Partial<BarkMaterialConfig>} [options]
7
+ * @returns {BarkMaterialConfig}
8
+ */
9
+ static from(options?: Partial<BarkMaterialConfig>): BarkMaterialConfig;
10
+ /**
11
+ * Procedural texture resolution (pixels, power of two).
12
+ * @type {number}
13
+ */
14
+ resolution: number;
15
+ /**
16
+ * Botanical bark pattern archetype (`"fissured"` | `"birch"` | `"plated"` | `"ringed"`).
17
+ * @type {string}
18
+ */
19
+ bark_type: string;
20
+ /**
21
+ * Outer bark ridge / periderm color (sRGB).
22
+ * @type {Color}
23
+ */
24
+ primary_color: Color;
25
+ /**
26
+ * Deep fissure / crevice bark color (sRGB).
27
+ * @type {Color}
28
+ */
29
+ secondary_color: Color;
30
+ /**
31
+ * Exposed inner phloem / peeled cambium accent color (sRGB).
32
+ * @type {Color}
33
+ */
34
+ inner_bark_color: Color;
35
+ /**
36
+ * Basal moss / lichen tint color (sRGB).
37
+ * @type {Color}
38
+ */
39
+ moss_color: Color;
40
+ /**
41
+ * Amount [0, 1] of lichen/moss flecking.
42
+ * @type {number}
43
+ */
44
+ moss_amount: number;
45
+ /**
46
+ * Circumferential fissure ridge or plate count across unit UV tile.
47
+ * @type {number}
48
+ */
49
+ fissure_frequency: number;
50
+ /**
51
+ * Normal map relief and occlusion depth of bark fissures [0, 1].
52
+ * @type {number}
53
+ */
54
+ fissure_depth: number;
55
+ /**
56
+ * Horizontal lenticel stripe intensity [0, 1] (characteristic of birch/cherry bark).
57
+ * @type {number}
58
+ */
59
+ lenticel_amount: number;
60
+ /**
61
+ * Papery bark peeling & curling strip intensity [0, 1] (characteristic of birch).
62
+ * @type {number}
63
+ */
64
+ peel_amount: number;
65
+ /**
66
+ * Stepped terrace quantization of bark plates/ridges [0, 1].
67
+ * @type {number}
68
+ */
69
+ plate_terrace: number;
70
+ /**
71
+ * Intensity [0, 1] of embedded callus knots / chevron branch-eye scars and grain flow warping.
72
+ * @type {number}
73
+ */
74
+ knot_amount: number;
75
+ /**
76
+ * Base PBR roughness [0, 1].
77
+ * @type {number}
78
+ */
79
+ roughness: number;
80
+ /**
81
+ * World-space UV tile density (tiles per meter of circumference/length).
82
+ * @type {number}
83
+ */
84
+ texel_density: number;
85
+ /**
86
+ * Helical UV twist rate along branch length (tiles per meter).
87
+ * @type {number}
88
+ */
89
+ twist_uv: number;
90
+ /**
91
+ * @param {Partial<BarkMaterialConfig>} [overrides]
92
+ * @returns {this}
93
+ */
94
+ applyOverrides(overrides?: Partial<BarkMaterialConfig>): this;
95
+ /**
96
+ * @param {BarkMaterialConfig} other
97
+ * @returns {this}
98
+ */
99
+ copy(other: BarkMaterialConfig): this;
100
+ /**
101
+ * @returns {BarkMaterialConfig}
102
+ */
103
+ clone(): BarkMaterialConfig;
104
+ /**
105
+ * @param {BarkMaterialConfig} other
106
+ * @returns {boolean}
107
+ */
108
+ equals(other: BarkMaterialConfig): boolean;
109
+ /**
110
+ * @returns {number}
111
+ */
112
+ hash(): number;
113
+ /**
114
+ * @readonly
115
+ * @type {boolean}
116
+ */
117
+ readonly isBarkMaterialConfig: boolean;
118
+ }
119
+ import { Color } from "../../../core/color/Color.js";
120
+ //# sourceMappingURL=BarkMaterialConfig.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BarkMaterialConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/BarkMaterialConfig.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IAiGI;;;OAGG;IACH,sBAHW,QAAQ,kBAAkB,CAAC,GACzB,kBAAkB,CAM9B;IAxGD;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,WAFU,MAAM,CAEO;IAEvB;;;OAGG;IACH,eAFU,KAAK,CAEkC;IAEjD;;;OAGG;IACH,iBAFU,KAAK,CAEoC;IAEnD;;;OAGG;IACH,kBAFU,KAAK,CAEqC;IAEpD;;;OAGG;IACH,YAFU,KAAK,CAE+B;IAE9C;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,mBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,eAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,eAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,MAAM,CAEA;IAYhB;;;OAGG;IACH,2BAHW,QAAQ,kBAAkB,CAAC,GACzB,IAAI,CA+ChB;IAED;;;OAGG;IACH,YAHW,kBAAkB,GAChB,IAAI,CAqBhB;IAED;;OAEG;IACH,SAFa,kBAAkB,CAM9B;IAED;;;OAGG;IACH,cAHW,kBAAkB,GAChB,OAAO,CAqBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAelB;IAGL;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CANhD;sBAlPqB,8BAA8B"}
@@ -0,0 +1,250 @@
1
+ import { assert } from "../../../core/assert.js";
2
+ import { Color } from "../../../core/color/Color.js";
3
+ import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
4
+ import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
5
+ import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
6
+
7
+ /**
8
+ * Procedural bark PBR material & UV tiling configuration.
9
+ */
10
+ export class BarkMaterialConfig {
11
+ /**
12
+ * Procedural texture resolution (pixels, power of two).
13
+ * @type {number}
14
+ */
15
+ resolution = 256;
16
+
17
+ /**
18
+ * Botanical bark pattern archetype (`"fissured"` | `"birch"` | `"plated"` | `"ringed"`).
19
+ * @type {string}
20
+ */
21
+ bark_type = "fissured";
22
+
23
+ /**
24
+ * Outer bark ridge / periderm color (sRGB).
25
+ * @type {Color}
26
+ */
27
+ primary_color = new Color(0.29, 0.27, 0.24, 1.0);
28
+
29
+ /**
30
+ * Deep fissure / crevice bark color (sRGB).
31
+ * @type {Color}
32
+ */
33
+ secondary_color = new Color(0.11, 0.10, 0.09, 1.0);
34
+
35
+ /**
36
+ * Exposed inner phloem / peeled cambium accent color (sRGB).
37
+ * @type {Color}
38
+ */
39
+ inner_bark_color = new Color(0.32, 0.26, 0.21, 1.0);
40
+
41
+ /**
42
+ * Basal moss / lichen tint color (sRGB).
43
+ * @type {Color}
44
+ */
45
+ moss_color = new Color(0.24, 0.29, 0.18, 1.0);
46
+
47
+ /**
48
+ * Amount [0, 1] of lichen/moss flecking.
49
+ * @type {number}
50
+ */
51
+ moss_amount = 0.10;
52
+
53
+ /**
54
+ * Circumferential fissure ridge or plate count across unit UV tile.
55
+ * @type {number}
56
+ */
57
+ fissure_frequency = 7;
58
+
59
+ /**
60
+ * Normal map relief and occlusion depth of bark fissures [0, 1].
61
+ * @type {number}
62
+ */
63
+ fissure_depth = 0.72;
64
+
65
+ /**
66
+ * Horizontal lenticel stripe intensity [0, 1] (characteristic of birch/cherry bark).
67
+ * @type {number}
68
+ */
69
+ lenticel_amount = 0.0;
70
+
71
+ /**
72
+ * Papery bark peeling & curling strip intensity [0, 1] (characteristic of birch).
73
+ * @type {number}
74
+ */
75
+ peel_amount = 0.35;
76
+
77
+ /**
78
+ * Stepped terrace quantization of bark plates/ridges [0, 1].
79
+ * @type {number}
80
+ */
81
+ plate_terrace = 0.42;
82
+
83
+ /**
84
+ * Intensity [0, 1] of embedded callus knots / chevron branch-eye scars and grain flow warping.
85
+ * @type {number}
86
+ */
87
+ knot_amount = 0.55;
88
+
89
+ /**
90
+ * Base PBR roughness [0, 1].
91
+ * @type {number}
92
+ */
93
+ roughness = 0.90;
94
+
95
+ /**
96
+ * World-space UV tile density (tiles per meter of circumference/length).
97
+ * @type {number}
98
+ */
99
+ texel_density = 1.2;
100
+
101
+ /**
102
+ * Helical UV twist rate along branch length (tiles per meter).
103
+ * @type {number}
104
+ */
105
+ twist_uv = 0.04;
106
+
107
+ /**
108
+ * @param {Partial<BarkMaterialConfig>} [options]
109
+ * @returns {BarkMaterialConfig}
110
+ */
111
+ static from(options = {}) {
112
+ const r = new BarkMaterialConfig();
113
+ r.applyOverrides(options);
114
+ return r;
115
+ }
116
+
117
+ /**
118
+ * @param {Partial<BarkMaterialConfig>} [overrides]
119
+ * @returns {this}
120
+ */
121
+ applyOverrides(overrides = {}) {
122
+ if (overrides === null || overrides === undefined) {
123
+ return this;
124
+ }
125
+ if (overrides.resolution !== undefined) this.resolution = Math.max(16, overrides.resolution | 0);
126
+ if (overrides.bark_type !== undefined) this.bark_type = String(overrides.bark_type);
127
+ if (overrides.primary_color !== undefined) {
128
+ if (Array.isArray(overrides.primary_color)) {
129
+ this.primary_color.setRGB(overrides.primary_color[0], overrides.primary_color[1], overrides.primary_color[2]);
130
+ } else {
131
+ this.primary_color.copy(overrides.primary_color);
132
+ }
133
+ }
134
+ if (overrides.secondary_color !== undefined) {
135
+ if (Array.isArray(overrides.secondary_color)) {
136
+ this.secondary_color.setRGB(overrides.secondary_color[0], overrides.secondary_color[1], overrides.secondary_color[2]);
137
+ } else {
138
+ this.secondary_color.copy(overrides.secondary_color);
139
+ }
140
+ }
141
+ if (overrides.inner_bark_color !== undefined) {
142
+ if (Array.isArray(overrides.inner_bark_color)) {
143
+ this.inner_bark_color.setRGB(overrides.inner_bark_color[0], overrides.inner_bark_color[1], overrides.inner_bark_color[2]);
144
+ } else {
145
+ this.inner_bark_color.copy(overrides.inner_bark_color);
146
+ }
147
+ }
148
+ if (overrides.moss_color !== undefined) {
149
+ if (Array.isArray(overrides.moss_color)) {
150
+ this.moss_color.setRGB(overrides.moss_color[0], overrides.moss_color[1], overrides.moss_color[2]);
151
+ } else {
152
+ this.moss_color.copy(overrides.moss_color);
153
+ }
154
+ }
155
+ if (overrides.moss_amount !== undefined) this.moss_amount = overrides.moss_amount;
156
+ if (overrides.fissure_frequency !== undefined) this.fissure_frequency = Math.max(1, overrides.fissure_frequency | 0);
157
+ if (overrides.fissure_depth !== undefined) this.fissure_depth = overrides.fissure_depth;
158
+ if (overrides.lenticel_amount !== undefined) this.lenticel_amount = overrides.lenticel_amount;
159
+ if (overrides.peel_amount !== undefined) this.peel_amount = overrides.peel_amount;
160
+ if (overrides.plate_terrace !== undefined) this.plate_terrace = overrides.plate_terrace;
161
+ if (overrides.knot_amount !== undefined) this.knot_amount = overrides.knot_amount;
162
+ if (overrides.roughness !== undefined) this.roughness = overrides.roughness;
163
+ if (overrides.texel_density !== undefined) this.texel_density = overrides.texel_density;
164
+ if (overrides.twist_uv !== undefined) this.twist_uv = overrides.twist_uv;
165
+ return this;
166
+ }
167
+
168
+ /**
169
+ * @param {BarkMaterialConfig} other
170
+ * @returns {this}
171
+ */
172
+ copy(other) {
173
+ assert.defined(other, 'other');
174
+ this.resolution = other.resolution;
175
+ this.bark_type = other.bark_type;
176
+ this.primary_color.copy(other.primary_color);
177
+ this.secondary_color.copy(other.secondary_color);
178
+ this.inner_bark_color.copy(other.inner_bark_color);
179
+ this.moss_color.copy(other.moss_color);
180
+ this.moss_amount = other.moss_amount;
181
+ this.fissure_frequency = other.fissure_frequency;
182
+ this.fissure_depth = other.fissure_depth;
183
+ this.lenticel_amount = other.lenticel_amount;
184
+ this.peel_amount = other.peel_amount;
185
+ this.plate_terrace = other.plate_terrace;
186
+ this.knot_amount = other.knot_amount;
187
+ this.roughness = other.roughness;
188
+ this.texel_density = other.texel_density;
189
+ this.twist_uv = other.twist_uv;
190
+ return this;
191
+ }
192
+
193
+ /**
194
+ * @returns {BarkMaterialConfig}
195
+ */
196
+ clone() {
197
+ const r = new BarkMaterialConfig();
198
+ r.copy(this);
199
+ return r;
200
+ }
201
+
202
+ /**
203
+ * @param {BarkMaterialConfig} other
204
+ * @returns {boolean}
205
+ */
206
+ equals(other) {
207
+ if (this === other) return true;
208
+ if (!other || !other.isBarkMaterialConfig) return false;
209
+ return this.resolution === other.resolution
210
+ && this.bark_type === other.bark_type
211
+ && this.primary_color.equals(other.primary_color)
212
+ && this.secondary_color.equals(other.secondary_color)
213
+ && this.inner_bark_color.equals(other.inner_bark_color)
214
+ && this.moss_color.equals(other.moss_color)
215
+ && this.moss_amount === other.moss_amount
216
+ && this.fissure_frequency === other.fissure_frequency
217
+ && this.fissure_depth === other.fissure_depth
218
+ && this.lenticel_amount === other.lenticel_amount
219
+ && this.peel_amount === other.peel_amount
220
+ && this.plate_terrace === other.plate_terrace
221
+ && this.knot_amount === other.knot_amount
222
+ && this.roughness === other.roughness
223
+ && this.texel_density === other.texel_density
224
+ && this.twist_uv === other.twist_uv;
225
+ }
226
+
227
+ /**
228
+ * @returns {number}
229
+ */
230
+ hash() {
231
+ let h = hash_mix2(this.resolution, computeStringHash(this.bark_type));
232
+ h = hash_mix2(h, this.primary_color.hash());
233
+ h = hash_mix2(h, this.secondary_color.hash());
234
+ h = hash_mix2(h, this.inner_bark_color.hash());
235
+ h = hash_mix2(h, this.moss_color.hash());
236
+ h = hash_mix2(h, computeHashFloat(this.fissure_depth));
237
+ h = hash_mix2(h, computeHashFloat(this.lenticel_amount));
238
+ h = hash_mix2(h, computeHashFloat(this.peel_amount));
239
+ h = hash_mix2(h, computeHashFloat(this.plate_terrace));
240
+ h = hash_mix2(h, computeHashFloat(this.knot_amount));
241
+ h = hash_mix2(h, computeHashFloat(this.roughness));
242
+ return h;
243
+ }
244
+ }
245
+
246
+ /**
247
+ * @readonly
248
+ * @type {boolean}
249
+ */
250
+ BarkMaterialConfig.prototype.isBarkMaterialConfig = true;