@woosh/meep-engine 3.14.6 → 3.16.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 (1089) hide show
  1. package/editor/Editor.js +7 -7
  2. package/editor/actions/concrete/TransformModifyAction.d.ts +4 -4
  3. package/editor/actions/concrete/TransformModifyAction.d.ts.map +1 -1
  4. package/editor/actions/concrete/TransformModifyAction.js +4 -4
  5. package/editor/camera/camera_framing.js +7 -7
  6. package/editor/ecs/component/editors/ecs/Transform64Editor.d.ts +20 -0
  7. package/editor/ecs/component/editors/ecs/Transform64Editor.d.ts.map +1 -0
  8. package/editor/ecs/component/editors/ecs/Transform64Editor.js +70 -0
  9. package/editor/ecs/component/prototypeObjectEditor.js +2 -2
  10. package/editor/ecs/component/registerEngineComponentEditors.js +3 -3
  11. package/editor/particles/effect/ParticleEffectDocument.d.ts +396 -0
  12. package/editor/particles/effect/ParticleEffectDocument.d.ts.map +1 -0
  13. package/editor/particles/effect/ParticleEffectDocument.js +989 -0
  14. package/editor/particles/effect/ParticleReferenceSimulation.d.ts +113 -0
  15. package/editor/particles/effect/ParticleReferenceSimulation.d.ts.map +1 -0
  16. package/editor/particles/effect/ParticleReferenceSimulation.js +377 -0
  17. package/editor/particles/effect/actions/ParticleGroupDefineAction.d.ts +35 -0
  18. package/editor/particles/effect/actions/ParticleGroupDefineAction.d.ts.map +1 -0
  19. package/editor/particles/effect/actions/ParticleGroupDefineAction.js +45 -0
  20. package/editor/particles/effect/make_starter_particle_effect.d.ts +23 -0
  21. package/editor/particles/effect/make_starter_particle_effect.d.ts.map +1 -0
  22. package/editor/particles/effect/make_starter_particle_effect.js +177 -0
  23. package/editor/persistence/buildNewSceneDataset.d.ts.map +1 -1
  24. package/editor/persistence/buildNewSceneDataset.js +10 -8
  25. package/editor/process/symbolic/AudioEmitterSymbolicDisplay.js +67 -67
  26. package/editor/process/symbolic/CameraSymbolicDisplay.js +146 -146
  27. package/editor/process/symbolic/GridPositionSymbolicDisplay.js +6 -6
  28. package/editor/process/symbolic/LightSymbolicDisplay.js +172 -172
  29. package/editor/process/symbolic/ParticleEmitterSymbolicDisplay.d.ts.map +1 -1
  30. package/editor/process/symbolic/ParticleEmitterSymbolicDisplay.js +6 -3
  31. package/editor/process/symbolic/PositionedMarkerSymbolicDisplay.js +6 -6
  32. package/editor/selection/editor_pick.js +130 -130
  33. package/editor/templates/entity_templates.js +7 -7
  34. package/editor/tools/TransformToolV2.d.ts +3 -3
  35. package/editor/tools/TransformToolV2.d.ts.map +1 -1
  36. package/editor/tools/TransformToolV2.js +58 -25
  37. package/editor/tools/paint/TerrainHeightPaintTool.d.ts.map +1 -1
  38. package/editor/tools/paint/TerrainHeightPaintTool.js +11 -9
  39. package/editor/tools/v2/GizmoNode.js +2 -2
  40. package/editor/tools/v2/TransformControls.d.ts +3 -3
  41. package/editor/tools/v2/TransformControls.d.ts.map +1 -1
  42. package/editor/tools/v2/TransformControls.js +1003 -971
  43. package/editor/tools/v2/handle/gizmo_drag_plane.d.ts.map +1 -1
  44. package/editor/tools/v2/handle/gizmo_drag_plane.js +6 -1
  45. package/editor/view/ecs/components/common/AutoCanvasView.js +17 -0
  46. package/editor/view/node-graph/NodeGraphEditorView.d.ts +143 -2
  47. package/editor/view/node-graph/NodeGraphEditorView.d.ts.map +1 -1
  48. package/editor/view/node-graph/NodeGraphEditorView.js +358 -6
  49. package/editor/view/node-graph/NodeGraphMinimapView.d.ts +120 -0
  50. package/editor/view/node-graph/NodeGraphMinimapView.d.ts.map +1 -0
  51. package/editor/view/node-graph/NodeGraphMinimapView.js +859 -0
  52. package/editor/view/node-graph/NodeGraphPaletteView.d.ts +112 -0
  53. package/editor/view/node-graph/NodeGraphPaletteView.d.ts.map +1 -0
  54. package/editor/view/node-graph/NodeGraphPaletteView.js +352 -0
  55. package/editor/view/node-graph/NodeGraphSearchMenuView.d.ts +76 -0
  56. package/editor/view/node-graph/NodeGraphSearchMenuView.d.ts.map +1 -0
  57. package/editor/view/node-graph/NodeGraphSearchMenuView.js +247 -0
  58. package/editor/view/node-graph/NodeGraphView.d.ts +147 -5
  59. package/editor/view/node-graph/NodeGraphView.d.ts.map +1 -1
  60. package/editor/view/node-graph/NodeGraphView.js +809 -76
  61. package/editor/view/node-graph/NodeIconView.d.ts +33 -0
  62. package/editor/view/node-graph/NodeIconView.d.ts.map +1 -0
  63. package/editor/view/node-graph/NodeIconView.js +54 -0
  64. package/editor/view/node-graph/NodeView.d.ts +71 -1
  65. package/editor/view/node-graph/NodeView.d.ts.map +1 -1
  66. package/editor/view/node-graph/NodeView.js +318 -17
  67. package/editor/view/node-graph/PortView.d.ts +41 -1
  68. package/editor/view/node-graph/PortView.d.ts.map +1 -1
  69. package/editor/view/node-graph/PortView.js +121 -69
  70. package/editor/view/node-graph/actions/ConnectionDeleteAction.d.ts +16 -3
  71. package/editor/view/node-graph/actions/ConnectionDeleteAction.d.ts.map +1 -1
  72. package/editor/view/node-graph/actions/ConnectionDeleteAction.js +29 -3
  73. package/editor/view/node-graph/actions/NodeCreateAction.d.ts +65 -0
  74. package/editor/view/node-graph/actions/NodeCreateAction.d.ts.map +1 -0
  75. package/editor/view/node-graph/actions/NodeCreateAction.js +108 -0
  76. package/editor/view/node-graph/actions/NodeDeleteAction.d.ts +6 -0
  77. package/editor/view/node-graph/actions/NodeDeleteAction.d.ts.map +1 -1
  78. package/editor/view/node-graph/actions/NodeDeleteAction.js +24 -2
  79. package/editor/view/node-graph/connection_wire_geometry.d.ts +34 -0
  80. package/editor/view/node-graph/connection_wire_geometry.d.ts.map +1 -1
  81. package/editor/view/node-graph/connection_wire_geometry.js +79 -3
  82. package/editor/view/node-graph/node-graph.css +678 -0
  83. package/editor/view/particles/effect/ParticleCodeEditorView.d.ts +37 -0
  84. package/editor/view/particles/effect/ParticleCodeEditorView.d.ts.map +1 -0
  85. package/editor/view/particles/effect/ParticleCodeEditorView.js +479 -0
  86. package/editor/view/particles/effect/ParticleEffectEditorView.d.ts +61 -0
  87. package/editor/view/particles/effect/ParticleEffectEditorView.d.ts.map +1 -0
  88. package/editor/view/particles/effect/ParticleEffectEditorView.js +223 -0
  89. package/editor/view/particles/effect/ParticleEmitterInspectorView.d.ts +25 -0
  90. package/editor/view/particles/effect/ParticleEmitterInspectorView.d.ts.map +1 -0
  91. package/editor/view/particles/effect/ParticleEmitterInspectorView.js +606 -0
  92. package/editor/view/particles/effect/ParticleGraphEditorView.d.ts +156 -0
  93. package/editor/view/particles/effect/ParticleGraphEditorView.d.ts.map +1 -0
  94. package/editor/view/particles/effect/ParticleGraphEditorView.js +1636 -0
  95. package/editor/view/particles/effect/ParticleNodeParametersView.d.ts +22 -0
  96. package/editor/view/particles/effect/ParticleNodeParametersView.d.ts.map +1 -0
  97. package/editor/view/particles/effect/ParticleNodeParametersView.js +520 -0
  98. package/editor/view/particles/effect/ParticlePreviewView.d.ts +52 -0
  99. package/editor/view/particles/effect/ParticlePreviewView.d.ts.map +1 -0
  100. package/editor/view/particles/effect/ParticlePreviewView.js +533 -0
  101. package/editor/view/particles/effect/particle-editor.css +556 -0
  102. package/editor/view/prepareMeshLibrary.d.ts.map +1 -1
  103. package/editor/view/prepareMeshLibrary.js +8 -4
  104. package/package.json +1 -1
  105. package/samples/engine/first-scene/main.js +152 -152
  106. package/samples/generation/generators/mir_generator_place_bases.js +3 -3
  107. package/src/core/assert.d.ts +28 -24
  108. package/src/core/assert.d.ts.map +1 -1
  109. package/src/core/assert.js +34 -26
  110. package/src/core/geom/3d/shape/PosedShape3D.d.ts +17 -0
  111. package/src/core/geom/3d/shape/PosedShape3D.d.ts.map +1 -1
  112. package/src/core/geom/3d/shape/PosedShape3D.js +34 -2
  113. package/src/core/graph/format/graphviz/graphviz_escape_html_label.d.ts +17 -0
  114. package/src/core/graph/format/graphviz/graphviz_escape_html_label.d.ts.map +1 -0
  115. package/src/core/graph/format/graphviz/graphviz_escape_html_label.js +25 -0
  116. package/src/core/graph/format/graphviz/graphviz_escape_quoted.d.ts +16 -0
  117. package/src/core/graph/format/graphviz/graphviz_escape_quoted.d.ts.map +1 -0
  118. package/src/core/graph/format/graphviz/graphviz_escape_quoted.js +24 -0
  119. package/src/core/model/node-graph/NodeGraph.d.ts +12 -0
  120. package/src/core/model/node-graph/NodeGraph.d.ts.map +1 -1
  121. package/src/core/model/node-graph/NodeGraph.js +21 -6
  122. package/src/core/model/node-graph/node/NodeDescription.d.ts +36 -0
  123. package/src/core/model/node-graph/node/NodeDescription.d.ts.map +1 -1
  124. package/src/core/model/node-graph/node/NodeDescription.js +41 -0
  125. package/src/core/model/node-graph/visual/ConnectionVisualData.d.ts +119 -0
  126. package/src/core/model/node-graph/visual/ConnectionVisualData.d.ts.map +1 -0
  127. package/src/core/model/node-graph/visual/ConnectionVisualData.js +317 -0
  128. package/src/core/model/node-graph/visual/NodeDescriptionVisualRegistry.d.ts +4 -0
  129. package/src/core/model/node-graph/visual/NodeDescriptionVisualRegistry.d.ts.map +1 -1
  130. package/src/core/model/node-graph/visual/NodeDescriptionVisualRegistry.js +125 -22
  131. package/src/core/model/node-graph/visual/NodeGraphVisualData.d.ts +91 -2
  132. package/src/core/model/node-graph/visual/NodeGraphVisualData.d.ts.map +1 -1
  133. package/src/core/model/node-graph/visual/NodeGraphVisualData.js +164 -113
  134. package/src/core/model/node-graph/visual/layout/LayoutBoxGraph.d.ts +162 -0
  135. package/src/core/model/node-graph/visual/layout/LayoutBoxGraph.d.ts.map +1 -0
  136. package/src/core/model/node-graph/visual/layout/LayoutBoxGraph.js +288 -0
  137. package/src/core/model/node-graph/visual/layout/LayoutProblem.d.ts +109 -0
  138. package/src/core/model/node-graph/visual/layout/LayoutProblem.d.ts.map +1 -0
  139. package/src/core/model/node-graph/visual/layout/LayoutProblem.js +141 -0
  140. package/src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.d.ts +149 -0
  141. package/src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.d.ts.map +1 -0
  142. package/src/core/model/node-graph/visual/layout/NodeGraphLayoutOptions.js +175 -0
  143. package/src/core/model/node-graph/visual/layout/RouteGrid.d.ts +137 -0
  144. package/src/core/model/node-graph/visual/layout/RouteGrid.d.ts.map +1 -0
  145. package/src/core/model/node-graph/visual/layout/RouteGrid.js +242 -0
  146. package/src/core/model/node-graph/visual/layout/RouteSearch.d.ts +114 -0
  147. package/src/core/model/node-graph/visual/layout/RouteSearch.d.ts.map +1 -0
  148. package/src/core/model/node-graph/visual/layout/RouteSearch.js +300 -0
  149. package/src/core/model/node-graph/visual/layout/RouteSet.d.ts +86 -0
  150. package/src/core/model/node-graph/visual/layout/RouteSet.d.ts.map +1 -0
  151. package/src/core/model/node-graph/visual/layout/RouteSet.js +168 -0
  152. package/src/core/model/node-graph/visual/layout/layout_assign_coordinates.d.ts +48 -0
  153. package/src/core/model/node-graph/visual/layout/layout_assign_coordinates.d.ts.map +1 -0
  154. package/src/core/model/node-graph/visual/layout/layout_assign_coordinates.js +555 -0
  155. package/src/core/model/node-graph/visual/layout/layout_assign_layers.d.ts +34 -0
  156. package/src/core/model/node-graph/visual/layout/layout_assign_layers.d.ts.map +1 -0
  157. package/src/core/model/node-graph/visual/layout/layout_assign_layers.js +202 -0
  158. package/src/core/model/node-graph/visual/layout/layout_break_cycles.d.ts +34 -0
  159. package/src/core/model/node-graph/visual/layout/layout_break_cycles.d.ts.map +1 -0
  160. package/src/core/model/node-graph/visual/layout/layout_break_cycles.js +254 -0
  161. package/src/core/model/node-graph/visual/layout/layout_build_problem.d.ts +29 -0
  162. package/src/core/model/node-graph/visual/layout/layout_build_problem.d.ts.map +1 -0
  163. package/src/core/model/node-graph/visual/layout/layout_build_problem.js +184 -0
  164. package/src/core/model/node-graph/visual/layout/layout_insert_lanes.d.ts +29 -0
  165. package/src/core/model/node-graph/visual/layout/layout_insert_lanes.d.ts.map +1 -0
  166. package/src/core/model/node-graph/visual/layout/layout_insert_lanes.js +95 -0
  167. package/src/core/model/node-graph/visual/layout/layout_node_graph.d.ts +56 -0
  168. package/src/core/model/node-graph/visual/layout/layout_node_graph.d.ts.map +1 -0
  169. package/src/core/model/node-graph/visual/layout/layout_node_graph.js +131 -0
  170. package/src/core/model/node-graph/visual/layout/layout_order_layers.d.ts +36 -0
  171. package/src/core/model/node-graph/visual/layout/layout_order_layers.d.ts.map +1 -0
  172. package/src/core/model/node-graph/visual/layout/layout_order_layers.js +415 -0
  173. package/src/core/model/node-graph/visual/layout/layout_orient_links.d.ts +21 -0
  174. package/src/core/model/node-graph/visual/layout/layout_orient_links.d.ts.map +1 -0
  175. package/src/core/model/node-graph/visual/layout/layout_orient_links.js +49 -0
  176. package/src/core/model/node-graph/visual/layout/route_connections.d.ts +41 -0
  177. package/src/core/model/node-graph/visual/layout/route_connections.d.ts.map +1 -0
  178. package/src/core/model/node-graph/visual/layout/route_connections.js +309 -0
  179. package/src/core/model/node-graph/visual/layout/route_grid_build.d.ts +33 -0
  180. package/src/core/model/node-graph/visual/layout/route_grid_build.d.ts.map +1 -0
  181. package/src/core/model/node-graph/visual/layout/route_grid_build.js +237 -0
  182. package/src/core/model/node-graph/visual/layout/route_nudge.d.ts +25 -0
  183. package/src/core/model/node-graph/visual/layout/route_nudge.d.ts.map +1 -0
  184. package/src/core/model/node-graph/visual/layout/route_nudge.js +220 -0
  185. package/src/core/model/node-graph/visual/layout/route_to_spline.d.ts +29 -0
  186. package/src/core/model/node-graph/visual/layout/route_to_spline.d.ts.map +1 -0
  187. package/src/core/model/node-graph/visual/layout/route_to_spline.js +120 -0
  188. package/src/engine/EngineHarness.d.ts.map +1 -1
  189. package/src/engine/EngineHarness.js +593 -586
  190. package/src/engine/EntityCreator.js +116 -116
  191. package/src/engine/achievements/AchievementManager.js +437 -437
  192. package/src/engine/animation/AnimatedActions.js +111 -111
  193. package/src/engine/animation/AnimationUtils.d.ts.map +1 -1
  194. package/src/engine/animation/AnimationUtils.js +246 -234
  195. package/src/engine/animation/Animations.d.ts +1 -0
  196. package/src/engine/animation/Animations.d.ts.map +1 -1
  197. package/src/engine/animation/Animations.js +13 -5
  198. package/src/engine/animation/clip/bind_property_writer.d.ts.map +1 -1
  199. package/src/engine/animation/clip/bind_property_writer.js +12 -5
  200. package/src/engine/animation/curve/binding/BoundTransform64Writer.d.ts +29 -0
  201. package/src/engine/animation/curve/binding/BoundTransform64Writer.d.ts.map +1 -0
  202. package/src/engine/animation/curve/binding/BoundTransform64Writer.js +80 -0
  203. package/src/engine/animation/removeEntityWithMeshParticlesEffect.js +4 -4
  204. package/src/engine/asset/loaders/gltf_test_fixtures.d.ts.map +1 -1
  205. package/src/engine/asset/loaders/gltf_test_fixtures.js +5 -4
  206. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.d.ts +12 -12
  207. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.d.ts.map +1 -1
  208. package/src/engine/control/first-person/FirstPersonPlayerControllerSystem.js +77 -44
  209. package/src/engine/control/first-person/abilities/LedgeGrab.js +1 -1
  210. package/src/engine/control/first-person/abilities/Mantle.js +1 -1
  211. package/src/engine/control/first-person/abilities/Slide.js +1 -1
  212. package/src/engine/control/first-person/collision/KinematicMover.d.ts +5 -9
  213. package/src/engine/control/first-person/collision/KinematicMover.d.ts.map +1 -1
  214. package/src/engine/control/first-person/collision/KinematicMover.js +59 -29
  215. package/src/engine/control/first-person/sensors/FirstPersonSensorsSystem.d.ts +2 -2
  216. package/src/engine/control/first-person/sensors/FirstPersonSensorsSystem.d.ts.map +1 -1
  217. package/src/engine/control/first-person/sensors/FirstPersonSensorsSystem.js +7 -7
  218. package/src/engine/ecs/EventType.d.ts +1 -0
  219. package/src/engine/ecs/EventType.js +35 -10
  220. package/src/engine/ecs/dynamic_actions/actions/definition/SendRequestActionDescription.d.ts.map +1 -1
  221. package/src/engine/ecs/dynamic_actions/actions/definition/SendRequestActionDescription.js +12 -4
  222. package/src/engine/ecs/fow/FogOfWarRevealerSystem.d.ts +4 -4
  223. package/src/engine/ecs/fow/FogOfWarRevealerSystem.d.ts.map +1 -1
  224. package/src/engine/ecs/fow/FogOfWarRevealerSystem.js +10 -11
  225. package/src/engine/ecs/grid/pick.js +1 -1
  226. package/src/engine/ecs/gui/hud/HeadsUpDisplaySystem.d.ts +1 -1
  227. package/src/engine/ecs/gui/hud/HeadsUpDisplaySystem.js +13 -13
  228. package/src/engine/ecs/gui/hud/testHudEdgeStick.js +3 -3
  229. package/src/engine/ecs/ik/InverseKinematicsSystem.d.ts +10 -10
  230. package/src/engine/ecs/ik/InverseKinematicsSystem.d.ts.map +1 -1
  231. package/src/engine/ecs/ik/InverseKinematicsSystem.js +8 -8
  232. package/src/engine/ecs/ik/TwoBoneInverseKinematicsSolver.d.ts.map +1 -1
  233. package/src/engine/ecs/ik/TwoBoneInverseKinematicsSolver.js +120 -97
  234. package/src/engine/ecs/ik/ik_bone_chain.d.ts +16 -5
  235. package/src/engine/ecs/ik/ik_bone_chain.d.ts.map +1 -1
  236. package/src/engine/ecs/ik/ik_bone_chain.js +16 -4
  237. package/src/engine/ecs/ik/ik_probe_terrain_contact.d.ts +7 -3
  238. package/src/engine/ecs/ik/ik_probe_terrain_contact.d.ts.map +1 -1
  239. package/src/engine/ecs/ik/ik_probe_terrain_contact.js +20 -16
  240. package/src/engine/ecs/ik/ik_write_local_rotation.d.ts +18 -0
  241. package/src/engine/ecs/ik/ik_write_local_rotation.d.ts.map +1 -0
  242. package/src/engine/ecs/ik/ik_write_local_rotation.js +30 -0
  243. package/src/engine/ecs/parent/EntityNode.d.ts +24 -6
  244. package/src/engine/ecs/parent/EntityNode.d.ts.map +1 -1
  245. package/src/engine/ecs/parent/EntityNode.js +54 -42
  246. package/src/engine/ecs/parent/EntityNodeFlags.d.ts +0 -1
  247. package/src/engine/ecs/parent/EntityNodeFlags.js +7 -8
  248. package/src/engine/ecs/speaker/VoiceSystem.d.ts +2 -2
  249. package/src/engine/ecs/speaker/VoiceSystem.d.ts.map +1 -1
  250. package/src/engine/ecs/speaker/VoiceSystem.js +4 -4
  251. package/src/engine/ecs/storage/populateEngineSerializationRegistry.d.ts.map +1 -1
  252. package/src/engine/ecs/storage/populateEngineSerializationRegistry.js +2 -0
  253. package/src/engine/ecs/terrain/ecs/Terrain.d.ts +5 -2
  254. package/src/engine/ecs/terrain/ecs/Terrain.d.ts.map +1 -1
  255. package/src/engine/ecs/terrain/ecs/Terrain.js +7 -4
  256. package/src/engine/ecs/terrain/ecs/TerrainSystem.js +3 -3
  257. package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.d.ts +7 -7
  258. package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.d.ts.map +1 -1
  259. package/src/engine/ecs/terrain/ecs/cling/ClingToTerrainSystem.js +84 -36
  260. package/src/engine/ecs/transform/TRANSFORM64_MIGRATION_PLAN_2026_09_04.md +513 -0
  261. package/src/engine/ecs/transform/Transform64.d.ts +48 -11
  262. package/src/engine/ecs/transform/Transform64.d.ts.map +1 -1
  263. package/src/engine/ecs/transform/Transform64.js +54 -15
  264. package/src/engine/ecs/transform/Transform64SerializationAdapter.d.ts +37 -0
  265. package/src/engine/ecs/transform/Transform64SerializationAdapter.d.ts.map +1 -0
  266. package/src/engine/ecs/transform/Transform64SerializationAdapter.js +75 -0
  267. package/src/engine/ecs/transform/__probe.d.ts +4 -0
  268. package/src/engine/ecs/transform/__probe.d.ts.map +1 -0
  269. package/src/engine/ecs/transform/t64_allocation_probe.d.ts +31 -0
  270. package/src/engine/ecs/transform/t64_allocation_probe.d.ts.map +1 -0
  271. package/src/engine/ecs/transform/t64_allocation_probe.js +78 -0
  272. package/src/engine/ecs/transform/t64_announce_change.d.ts +33 -0
  273. package/src/engine/ecs/transform/t64_announce_change.d.ts.map +1 -0
  274. package/src/engine/ecs/transform/t64_announce_change.js +39 -0
  275. package/src/engine/ecs/transform/t64_equals_components.d.ts +30 -0
  276. package/src/engine/ecs/transform/t64_equals_components.d.ts.map +1 -0
  277. package/src/engine/ecs/transform/t64_equals_components.js +59 -0
  278. package/src/engine/ecs/transform/t64_read_rotation.d.ts +13 -0
  279. package/src/engine/ecs/transform/t64_read_rotation.d.ts.map +1 -0
  280. package/src/engine/ecs/transform/t64_read_rotation.js +16 -0
  281. package/src/engine/ecs/transform/t64_read_translation.d.ts +14 -0
  282. package/src/engine/ecs/transform/t64_read_translation.d.ts.map +1 -0
  283. package/src/engine/ecs/transform/t64_read_translation.js +17 -0
  284. package/src/engine/ecs/transform-attachment/TransformAttachment.d.ts +5 -5
  285. package/src/engine/ecs/transform-attachment/TransformAttachment.d.ts.map +1 -1
  286. package/src/engine/ecs/transform-attachment/TransformAttachment.js +4 -4
  287. package/src/engine/ecs/transform-attachment/TransformAttachmentSystem.d.ts +10 -10
  288. package/src/engine/ecs/transform-attachment/TransformAttachmentSystem.d.ts.map +1 -1
  289. package/src/engine/ecs/transform-attachment/TransformAttachmentSystem.js +71 -20
  290. package/src/engine/graphics/debug/createDebugLabel.js +3 -3
  291. package/src/engine/graphics/ecs/camera/pp/PerfectPanner.d.ts.map +1 -1
  292. package/src/engine/graphics/ecs/camera/pp/PerfectPanner.js +5 -4
  293. package/src/engine/graphics/ecs/camera/topdown/TopDownCameraController.d.ts.map +1 -1
  294. package/src/engine/graphics/ecs/camera/topdown/TopDownCameraController.js +8 -3
  295. package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.d.ts +6 -6
  296. package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.d.ts.map +1 -1
  297. package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSystem.js +25 -13
  298. package/src/engine/graphics/ecs/camera/topdown/TopDownCameraLanderSystem.js +1 -1
  299. package/src/engine/graphics/ecs/mesh/setMesh.js +2 -2
  300. package/src/engine/graphics/ecs/path/entity/EntityPath.d.ts.map +1 -1
  301. package/src/engine/graphics/ecs/path/entity/EntityPath.js +21 -7
  302. package/src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.d.ts +4 -4
  303. package/src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.d.ts.map +1 -1
  304. package/src/engine/graphics/ecs/path/entity/EntityPathMarkerDefinition.js +4 -4
  305. package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts +2 -2
  306. package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts.map +1 -1
  307. package/src/engine/graphics/ecs/sprite/SpriteSystemPE.js +145 -135
  308. package/src/engine/graphics/geometry/MikkT/Build4RuleGroups.js +2 -2
  309. package/src/engine/graphics/geometry/MikkT/DegenEpilogue.js +1 -1
  310. package/src/engine/graphics/geometry/MikkT/DegenPrologue.js +1 -1
  311. package/src/engine/graphics/geometry/MikkT/EvalTspace.js +1 -1
  312. package/src/engine/graphics/geometry/MikkT/GenerateTSpaces.js +3 -3
  313. package/src/engine/graphics/render/frame_graph/CORRECTNESS_FIXES_2026_09_04.md +659 -0
  314. package/src/engine/graphics/render/frame_graph/FRAME_GRAPH_RECOMMENDATIONS.md +21 -5
  315. package/src/engine/graphics/render/frame_graph/FrameGraph.d.ts +45 -0
  316. package/src/engine/graphics/render/frame_graph/FrameGraph.d.ts.map +1 -1
  317. package/src/engine/graphics/render/frame_graph/FrameGraph.js +282 -60
  318. package/src/engine/graphics/render/frame_graph/FramePassBuilder.d.ts.map +1 -1
  319. package/src/engine/graphics/render/frame_graph/FramePassBuilder.js +20 -9
  320. package/src/engine/graphics/render/frame_graph/FramePassNode.d.ts +12 -0
  321. package/src/engine/graphics/render/frame_graph/FramePassNode.d.ts.map +1 -1
  322. package/src/engine/graphics/render/frame_graph/FramePassNode.js +13 -0
  323. package/src/engine/graphics/render/frame_graph/FramePassResources.d.ts.map +1 -1
  324. package/src/engine/graphics/render/frame_graph/FramePassResources.js +5 -0
  325. package/src/engine/graphics/render/frame_graph/ResourceEntry.d.ts +19 -1
  326. package/src/engine/graphics/render/frame_graph/ResourceEntry.d.ts.map +1 -1
  327. package/src/engine/graphics/render/frame_graph/ResourceEntry.js +23 -1
  328. package/src/engine/graphics/render/frame_graph/backend/void/VoidRenderContext.d.ts +15 -1
  329. package/src/engine/graphics/render/frame_graph/backend/void/VoidRenderContext.d.ts.map +1 -1
  330. package/src/engine/graphics/render/frame_graph/backend/void/VoidRenderContext.js +33 -16
  331. package/src/engine/graphics/render/frame_graph/resource/RenderResourceManager.d.ts.map +1 -1
  332. package/src/engine/graphics/render/frame_graph/resource/RenderResourceManager.js +19 -1
  333. package/src/engine/graphics/sh3/path_tracer/populate_path_traced_scene_from_ecd.js +6 -6
  334. package/src/engine/graphics3/CameraSystem.d.ts +6 -6
  335. package/src/engine/graphics3/CameraSystem.d.ts.map +1 -1
  336. package/src/engine/graphics3/CameraSystem.js +170 -170
  337. package/src/engine/graphics3/DecalSystem.d.ts +6 -6
  338. package/src/engine/graphics3/DecalSystem.d.ts.map +1 -1
  339. package/src/engine/graphics3/DecalSystem.js +449 -449
  340. package/src/engine/graphics3/LightSystem.d.ts +6 -6
  341. package/src/engine/graphics3/LightSystem.d.ts.map +1 -1
  342. package/src/engine/graphics3/LightSystem.js +234 -221
  343. package/src/engine/graphics3/MeshSystem.d.ts +6 -6
  344. package/src/engine/graphics3/MeshSystem.d.ts.map +1 -1
  345. package/src/engine/graphics3/MeshSystem.js +53 -22
  346. package/src/engine/graphics3/ParticipatingMediaSystem.d.ts +20 -15
  347. package/src/engine/graphics3/ParticipatingMediaSystem.d.ts.map +1 -1
  348. package/src/engine/graphics3/ParticipatingMediaSystem.js +198 -184
  349. package/src/engine/graphics3/ParticleEmitterSystem.d.ts +6 -6
  350. package/src/engine/graphics3/ParticleEmitterSystem.d.ts.map +1 -1
  351. package/src/engine/graphics3/ParticleEmitterSystem.js +310 -289
  352. package/src/engine/graphics3/PickingSystem.d.ts +6 -6
  353. package/src/engine/graphics3/PickingSystem.d.ts.map +1 -1
  354. package/src/engine/graphics3/PickingSystem.js +273 -273
  355. package/src/engine/graphics3/ShadedGeometrySystem.d.ts +6 -6
  356. package/src/engine/graphics3/ShadedGeometrySystem.d.ts.map +1 -1
  357. package/src/engine/graphics3/ShadedGeometrySystem.js +180 -169
  358. package/src/engine/graphics3/TerrainSystem.d.ts.map +1 -1
  359. package/src/engine/graphics3/TerrainSystem.js +565 -566
  360. package/src/engine/graphics3/Trail3DSystem.d.ts +6 -6
  361. package/src/engine/graphics3/Trail3DSystem.d.ts.map +1 -1
  362. package/src/engine/graphics3/Trail3DSystem.js +221 -221
  363. package/src/engine/graphics3/camera_sync_from_transform.d.ts +2 -2
  364. package/src/engine/graphics3/camera_sync_from_transform.d.ts.map +1 -1
  365. package/src/engine/graphics3/camera_sync_from_transform.js +2 -1
  366. package/src/engine/graphics3/debug/gizmo_view_from_camera.js +4 -4
  367. package/src/engine/graphics3/particles/GPUParticularRenderer.d.ts +6 -0
  368. package/src/engine/graphics3/particles/GPUParticularRenderer.d.ts.map +1 -1
  369. package/src/engine/graphics3/particles/GPUParticularRenderer.js +82 -53
  370. package/src/engine/graphics3/particles/particle_gpu_records.d.ts +12 -8
  371. package/src/engine/graphics3/particles/particle_gpu_records.d.ts.map +1 -1
  372. package/src/engine/graphics3/particles/particle_gpu_records.js +53 -45
  373. package/src/engine/graphics3/preview/make_model_preview_scene.js +1 -1
  374. package/src/engine/graphics3/shade_camera_projection_ray.js +4 -4
  375. package/src/engine/graphics3/shade_node_to_entity_composition.d.ts.map +1 -1
  376. package/src/engine/graphics3/shade_node_to_entity_composition.js +88 -84
  377. package/src/engine/grid/grid2transform/GridPosition2TransformSystem.d.ts +7 -7
  378. package/src/engine/grid/grid2transform/GridPosition2TransformSystem.d.ts.map +1 -1
  379. package/src/engine/grid/grid2transform/GridPosition2TransformSystem.js +8 -8
  380. package/src/engine/grid/transform2grid/Transform2GridPositionSystem.d.ts +9 -8
  381. package/src/engine/grid/transform2grid/Transform2GridPositionSystem.d.ts.map +1 -1
  382. package/src/engine/grid/transform2grid/Transform2GridPositionSystem.js +29 -8
  383. package/src/engine/input/ecs/controllers/KeyboardCameraController.js +2 -2
  384. package/src/engine/intelligence/behavior/ecs/OrbitingBehavior.d.ts.map +1 -1
  385. package/src/engine/intelligence/behavior/ecs/OrbitingBehavior.js +35 -21
  386. package/src/engine/intelligence/behavior/util/RotationBehavior.js +5 -5
  387. package/src/engine/intelligence/mcts/StateNode.js +1 -1
  388. package/src/engine/interpolation/TransformPoseSerializationAdapter.d.ts +7 -7
  389. package/src/engine/interpolation/TransformPoseSerializationAdapter.d.ts.map +1 -1
  390. package/src/engine/interpolation/TransformPoseSerializationAdapter.js +14 -15
  391. package/src/engine/interpolation/pose_interpoland.d.ts +2 -2
  392. package/src/engine/interpolation/pose_interpoland.js +4 -4
  393. package/src/engine/navigation/ecs/path_following/PathFollowingSystem.d.ts +4 -4
  394. package/src/engine/navigation/ecs/path_following/PathFollowingSystem.d.ts.map +1 -1
  395. package/src/engine/navigation/ecs/path_following/PathFollowingSystem.js +39 -14
  396. package/src/engine/network/adapters/TransformReplicationAdapter.d.ts +7 -7
  397. package/src/engine/network/adapters/TransformReplicationAdapter.d.ts.map +1 -1
  398. package/src/engine/network/adapters/TransformReplicationAdapter.js +19 -20
  399. package/src/engine/network/orchestrator/ServerAuthoritativeClient.d.ts +48 -0
  400. package/src/engine/network/orchestrator/ServerAuthoritativeClient.d.ts.map +1 -1
  401. package/src/engine/network/orchestrator/ServerAuthoritativeClient.js +246 -3
  402. package/src/engine/network/replication/Replicator.d.ts +5 -3
  403. package/src/engine/network/replication/Replicator.d.ts.map +1 -1
  404. package/src/engine/network/replication/Replicator.js +65 -16
  405. package/src/engine/physics/broadphase/compute_fat_world_aabb.js +3 -3
  406. package/src/engine/physics/ccd/linear_sweep.d.ts.map +1 -1
  407. package/src/engine/physics/ccd/linear_sweep.js +9 -3
  408. package/src/engine/physics/constraint/solve_constraints.js +10 -10
  409. package/src/engine/physics/ecs/ColliderObserverSystem.d.ts +8 -8
  410. package/src/engine/physics/ecs/ColliderObserverSystem.d.ts.map +1 -1
  411. package/src/engine/physics/ecs/ColliderObserverSystem.js +6 -6
  412. package/src/engine/physics/ecs/PhysicsSystem.d.ts +22 -32
  413. package/src/engine/physics/ecs/PhysicsSystem.d.ts.map +1 -1
  414. package/src/engine/physics/ecs/PhysicsSystem.js +2337 -2310
  415. package/src/engine/physics/ecs/find_non_finite_physics_state.js +6 -6
  416. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts +7 -7
  417. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts.map +1 -1
  418. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.js +16 -8
  419. package/src/engine/physics/fluid/ecs/FluidSystem.d.ts +4 -4
  420. package/src/engine/physics/fluid/ecs/FluidSystem.d.ts.map +1 -1
  421. package/src/engine/physics/fluid/ecs/FluidSystem.js +6 -6
  422. package/src/engine/physics/fluid/ecs/WorkerFluidSystem.d.ts +2 -2
  423. package/src/engine/physics/fluid/ecs/WorkerFluidSystem.d.ts.map +1 -1
  424. package/src/engine/physics/fluid/ecs/WorkerFluidSystem.js +4 -4
  425. package/src/engine/physics/fluid/ecs/fluid_reanchor_field.js +7 -7
  426. package/src/engine/physics/fluid/effector/ImpulseFluidEffector.js +4 -4
  427. package/src/engine/physics/fluid/effector/WakeFluidEffector.js +7 -7
  428. package/src/engine/physics/inertia/world_inverse_inertia.js +1 -1
  429. package/src/engine/physics/integration/integrate_position.d.ts.map +1 -1
  430. package/src/engine/physics/integration/integrate_position.js +13 -12
  431. package/src/engine/physics/inverse_kinematics/fabrik/fabrik_solve.d.ts.map +1 -1
  432. package/src/engine/physics/inverse_kinematics/fabrik/fabrik_solve.js +23 -5
  433. package/src/engine/physics/narrowphase/compute_penetration.js +18 -14
  434. package/src/engine/physics/narrowphase/convex_convex_manifold.js +2 -2
  435. package/src/engine/physics/narrowphase/mesh_mesh_tet_manifold.js +9 -9
  436. package/src/engine/physics/narrowphase/narrowphase_step.d.ts.map +1 -1
  437. package/src/engine/physics/narrowphase/narrowphase_step.js +95 -68
  438. package/src/engine/physics/narrowphase/refine_ray_concave.js +1 -1
  439. package/src/engine/physics/narrowphase/refine_ray_hit.js +3 -3
  440. package/src/engine/physics/queries/overlap_shape.d.ts.map +1 -1
  441. package/src/engine/physics/queries/overlap_shape.js +19 -7
  442. package/src/engine/physics/queries/raycast.js +3 -3
  443. package/src/engine/physics/queries/shape_cast.d.ts.map +1 -1
  444. package/src/engine/physics/queries/shape_cast.js +628 -620
  445. package/src/engine/physics/solver/solve_contacts.js +10 -10
  446. package/src/engine/physics/vehicle/RaycastVehicle.d.ts +6 -5
  447. package/src/engine/physics/vehicle/RaycastVehicle.d.ts.map +1 -1
  448. package/src/engine/physics/vehicle/RaycastVehicle.js +10 -5
  449. package/src/engine/sound/ecs/SoundListenerSystem.d.ts +16 -4
  450. package/src/engine/sound/ecs/SoundListenerSystem.d.ts.map +1 -1
  451. package/src/engine/sound/ecs/SoundListenerSystem.js +70 -11
  452. package/src/engine/sound/ecs/audio/AudioEmitterSystem.d.ts +7 -7
  453. package/src/engine/sound/ecs/audio/AudioEmitterSystem.d.ts.map +1 -1
  454. package/src/engine/sound/ecs/audio/AudioEmitterSystem.js +343 -338
  455. package/src/engine/sound/ecs/audio/LiveEmitterSet.d.ts +2 -2
  456. package/src/engine/sound/ecs/audio/LiveEmitterSet.d.ts.map +1 -1
  457. package/src/engine/sound/ecs/audio/LiveEmitterSet.js +356 -345
  458. package/src/engine/sound/ecs/audio/SpatialAudioIndex.d.ts +23 -2
  459. package/src/engine/sound/ecs/audio/SpatialAudioIndex.d.ts.map +1 -1
  460. package/src/engine/sound/ecs/audio/SpatialAudioIndex.js +174 -140
  461. package/src/engine/sound/ecs/trigger/AudioEventTriggerSystem.d.ts +6 -6
  462. package/src/engine/sound/ecs/trigger/AudioEventTriggerSystem.d.ts.map +1 -1
  463. package/src/engine/sound/ecs/trigger/AudioEventTriggerSystem.js +185 -184
  464. package/src/engine/sound/material/detector/terrain/TerrainSoundMaterialSurfaceDetector.js +1 -1
  465. package/src/engine/sound/simulation/core/AcousticRegionIndex.d.ts +2 -1
  466. package/src/engine/sound/simulation/core/AcousticRegionIndex.d.ts.map +1 -1
  467. package/src/engine/sound/simulation/core/AcousticRegionIndex.js +4 -3
  468. package/src/engine/sound/simulation/core/AcousticVolumeRegion.d.ts +3 -2
  469. package/src/engine/sound/simulation/core/AcousticVolumeRegion.d.ts.map +1 -1
  470. package/src/engine/sound/simulation/core/AcousticVolumeRegion.js +6 -4
  471. package/src/engine/sound/simulation/ecs/AcousticSimulationSystem.d.ts +10 -6
  472. package/src/engine/sound/simulation/ecs/AcousticSimulationSystem.d.ts.map +1 -1
  473. package/src/engine/sound/simulation/ecs/AcousticSimulationSystem.js +32 -7
  474. package/src/engine/sound/simulation/ecs/AcousticVolumeSystem.d.ts +7 -7
  475. package/src/engine/sound/simulation/ecs/AcousticVolumeSystem.d.ts.map +1 -1
  476. package/src/engine/sound/simulation/ecs/AcousticVolumeSystem.js +6 -6
  477. package/src/engine/sound/sopra/runtime/EventInstance.d.ts.map +1 -1
  478. package/src/engine/sound/sopra/runtime/EventInstance.js +8 -2
  479. package/src/format/scene/gltf/gltf_component_type.d.ts.map +1 -1
  480. package/src/format/scene/gltf/gltf_component_type.js +3 -1
  481. package/src/format/texture/ktx2/ktx2_read.d.ts.map +1 -1
  482. package/src/format/texture/ktx2/ktx2_read.js +2 -1
  483. package/src/generation/grid/generation/GridTaskDensityMarkerDistribution.d.ts.map +1 -1
  484. package/src/generation/grid/generation/GridTaskDensityMarkerDistribution.js +8 -1
  485. package/src/generation/markers/GridCellActionPlaceMarker.d.ts +4 -4
  486. package/src/generation/markers/GridCellActionPlaceMarker.d.ts.map +1 -1
  487. package/src/generation/markers/GridCellActionPlaceMarker.js +16 -6
  488. package/src/generation/markers/MarkerNode.d.ts +3 -3
  489. package/src/generation/markers/MarkerNode.d.ts.map +1 -1
  490. package/src/generation/markers/MarkerNode.js +3 -3
  491. package/src/generation/markers/actions/MarkerNodeActionEntityPlacement.d.ts +4 -4
  492. package/src/generation/markers/actions/MarkerNodeActionEntityPlacement.d.ts.map +1 -1
  493. package/src/generation/markers/actions/MarkerNodeActionEntityPlacement.js +7 -7
  494. package/src/generation/markers/actions/MarkerNodeActionImaginary.d.ts.map +1 -1
  495. package/src/generation/markers/actions/MarkerNodeActionImaginary.js +20 -2
  496. package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorClingToTerrain.js +1 -1
  497. package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.d.ts.map +1 -1
  498. package/src/generation/markers/actions/placement/MarkerNodeEntityProcessorRandomRotation.js +13 -3
  499. package/src/generation/markers/transform/MarkerNodeTransformRotateRandom.d.ts.map +1 -1
  500. package/src/generation/markers/transform/MarkerNodeTransformRotateRandom.js +11 -1
  501. package/src/generation/markers/transform/MarkerNodeTransformerAddPositionYFromFilter.d.ts.map +1 -1
  502. package/src/generation/markers/transform/MarkerNodeTransformerAddPositionYFromFilter.js +8 -4
  503. package/src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.d.ts.map +1 -1
  504. package/src/generation/markers/transform/MarkerNodeTransformerOffsetPosition.js +13 -5
  505. package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.d.ts.map +1 -1
  506. package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilter.js +8 -2
  507. package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilterGradient.d.ts.map +1 -1
  508. package/src/generation/markers/transform/MarkerNodeTransformerYRotateByFilterGradient.js +16 -2
  509. package/src/shade/RENDERER_CONTRACT.md +584 -580
  510. package/src/shade/device/graph/BufferResourceDescriptor.d.ts.map +1 -1
  511. package/src/shade/device/graph/BufferResourceDescriptor.js +193 -184
  512. package/src/shade/device/graph/TextureResourceDescriptor.d.ts.map +1 -1
  513. package/src/shade/device/graph/TextureResourceDescriptor.js +12 -0
  514. package/src/shade/device/mock/SoftwareGPUDevice.d.ts.map +1 -1
  515. package/src/shade/device/mock/SoftwareGPUDevice.js +8 -0
  516. package/src/shade/playground/avboit/README.md +117 -0
  517. package/src/shade/playground/avboit/index.html +215 -0
  518. package/src/shade/playground/avboit/main.d.ts +2 -0
  519. package/src/shade/playground/avboit/main.d.ts.map +1 -0
  520. package/src/shade/playground/avboit/main.js +875 -0
  521. package/src/shade/playground/basis_textures/main.js +1 -1
  522. package/src/shade/playground/ground_seam/main.js +1 -1
  523. package/src/shade/playground/particle_editor/README.md +175 -0
  524. package/src/shade/playground/particle_editor/index.html +76 -0
  525. package/src/shade/playground/particle_editor/main.d.ts +2 -0
  526. package/src/shade/playground/particle_editor/main.d.ts.map +1 -0
  527. package/src/shade/playground/particle_editor/main.js +139 -0
  528. package/src/shade/playground/particle_system/README.md +92 -62
  529. package/src/shade/playground/particle_system/index.html +67 -21
  530. package/src/shade/playground/particle_system/main.js +247 -102
  531. package/src/shade/{renderer/particles → playground/particle_system}/particle_prototype.d.ts +21 -18
  532. package/src/shade/playground/particle_system/particle_prototype.d.ts.map +1 -0
  533. package/src/shade/{renderer/particles → playground/particle_system}/particle_prototype.js +197 -181
  534. package/src/shade/playground/particle_system/particle_scene.d.ts +136 -20
  535. package/src/shade/playground/particle_system/particle_scene.d.ts.map +1 -1
  536. package/src/shade/playground/particle_system/particle_scene.js +487 -670
  537. package/src/shade/playground/skinned_blas_refit/sweep_views.js +2 -2
  538. package/src/shade/playground/skinned_blas_refit/verify_instance_bounds.d.ts.map +1 -1
  539. package/src/shade/playground/skinned_blas_refit/verify_instance_bounds.js +2 -1
  540. package/src/shade/playground/skinned_blas_refit/verify_skinned_blas_refit.d.ts.map +1 -1
  541. package/src/shade/playground/skinned_blas_refit/verify_skinned_blas_refit.js +2 -1
  542. package/src/shade/playground/sponza_path_trace/main.js +1 -1
  543. package/src/shade/playground/volumetrics_froxel/main.js +917 -917
  544. package/src/shade/playground/volumetrics_froxel/measure.js +559 -559
  545. package/src/shade/renderer/Renderer.d.ts +44 -0
  546. package/src/shade/renderer/Renderer.d.ts.map +1 -1
  547. package/src/shade/renderer/Renderer.js +169 -36
  548. package/src/shade/renderer/ShadeTransparencyMode.d.ts +13 -0
  549. package/src/shade/renderer/ShadeTransparencyMode.d.ts.map +1 -0
  550. package/src/shade/renderer/ShadeTransparencyMode.js +30 -0
  551. package/src/shade/renderer/atmosphere/GPUSky.d.ts.map +1 -1
  552. package/src/shade/renderer/atmosphere/GPUSky.js +4 -2
  553. package/src/shade/renderer/buffer/graph_read_buffer.d.ts.map +1 -1
  554. package/src/shade/renderer/buffer/graph_read_buffer.js +8 -1
  555. package/src/shade/renderer/buffer/table/GPUTypedTable.js +1 -1
  556. package/src/shade/renderer/buffer/table/GPUTypedTableDescriptor.d.ts +30 -0
  557. package/src/shade/renderer/buffer/table/GPUTypedTableDescriptor.d.ts.map +1 -1
  558. package/src/shade/renderer/buffer/table/GPUTypedTableDescriptor.js +84 -0
  559. package/src/shade/renderer/buffer/table/gpu_database_emulator_image.d.ts +27 -0
  560. package/src/shade/renderer/buffer/table/gpu_database_emulator_image.d.ts.map +1 -0
  561. package/src/shade/renderer/buffer/table/gpu_database_words.d.ts +24 -0
  562. package/src/shade/renderer/buffer/table/gpu_database_words.d.ts.map +1 -0
  563. package/src/shade/renderer/buffer/table/gpu_database_words.js +92 -0
  564. package/src/shade/renderer/camera/Camera.d.ts +2 -2
  565. package/src/shade/renderer/camera/Camera.d.ts.map +1 -1
  566. package/src/shade/renderer/camera/Camera.js +11 -5
  567. package/src/shade/renderer/camera/GPUCameraContext.d.ts.map +1 -1
  568. package/src/shade/renderer/camera/GPUCameraContext.js +2 -1
  569. package/src/shade/renderer/camera/OrbitalCameraController.d.ts +3 -3
  570. package/src/shade/renderer/camera/OrbitalCameraController.d.ts.map +1 -1
  571. package/src/shade/renderer/camera/OrbitalCameraController.js +31 -16
  572. package/src/shade/renderer/camera/orbital/OrbitalCameraController.d.ts +2 -2
  573. package/src/shade/renderer/camera/orbital/OrbitalCameraController.d.ts.map +1 -1
  574. package/src/shade/renderer/camera/orbital/OrbitalCameraController.js +4 -3
  575. package/src/shade/renderer/camera/orbital/OrbitalCameraRig.d.ts +10 -5
  576. package/src/shade/renderer/camera/orbital/OrbitalCameraRig.d.ts.map +1 -1
  577. package/src/shade/renderer/camera/orbital/OrbitalCameraRig.js +8 -4
  578. package/src/shade/renderer/extension/FrameContext.d.ts.map +1 -1
  579. package/src/shade/renderer/extension/FrameContext.js +5 -0
  580. package/src/shade/renderer/extension/FrameRecord.d.ts +16 -0
  581. package/src/shade/renderer/extension/FrameRecord.d.ts.map +1 -1
  582. package/src/shade/renderer/extension/FrameRecord.js +31 -0
  583. package/src/shade/renderer/extension/GBufferTextures.d.ts +11 -0
  584. package/src/shade/renderer/extension/GBufferTextures.d.ts.map +1 -1
  585. package/src/shade/renderer/extension/GBufferTextures.js +14 -0
  586. package/src/shade/renderer/geometry/attribute/gpu_vertex_buffer_layout_from_spec.js +1 -1
  587. package/src/shade/renderer/geometry/util/geometry_stripify.js +6 -6
  588. package/src/shade/renderer/geometry/virtual/format/prototypeVGEOFormatViewer.js +8 -8
  589. package/src/shade/renderer/global_illumination/lpv/lpv_visualise_probes.d.ts.map +1 -1
  590. package/src/shade/renderer/global_illumination/lpv/lpv_visualise_probes.js +14 -5
  591. package/src/shade/renderer/global_illumination/probe/octahedral/GPUProbeAtlas.d.ts.map +1 -1
  592. package/src/shade/renderer/global_illumination/probe/octahedral/GPUProbeAtlas.js +17 -9
  593. package/src/shade/renderer/global_illumination/probe/octahedral/border/graph_lpv_paint_border_depth.d.ts +2 -1
  594. package/src/shade/renderer/global_illumination/probe/octahedral/border/graph_lpv_paint_border_depth.d.ts.map +1 -1
  595. package/src/shade/renderer/global_illumination/probe/octahedral/border/graph_lpv_paint_border_depth.js +4 -1
  596. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.d.ts +2 -1
  597. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.d.ts.map +1 -1
  598. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.js +11 -1
  599. package/src/shade/renderer/global_illumination/probe/octahedral/graph_lpv_shade.d.ts +1 -1
  600. package/src/shade/renderer/global_illumination/probe/octahedral/graph_lpv_shade.d.ts.map +1 -1
  601. package/src/shade/renderer/global_illumination/probe/octahedral/graph_lpv_shade.js +4 -2
  602. package/src/shade/renderer/global_illumination/sharc/SpatialHashRadianceCache.d.ts.map +1 -1
  603. package/src/shade/renderer/global_illumination/sharc/SpatialHashRadianceCache.js +5 -1
  604. package/src/shade/renderer/light/cluster/cull/graph_cull_lights.d.ts.map +1 -1
  605. package/src/shade/renderer/light/cluster/cull/graph_cull_lights.js +35 -11
  606. package/src/shade/renderer/loader/gltf/tiny-gltf.d.ts +1 -1
  607. package/src/shade/renderer/particles/DESIGN.md +271 -112
  608. package/src/shade/renderer/particles/GPUParticleSystem.d.ts +251 -86
  609. package/src/shade/renderer/particles/GPUParticleSystem.d.ts.map +1 -1
  610. package/src/shade/renderer/particles/GPUParticleSystem.js +822 -146
  611. package/src/shade/renderer/particles/ParticleConstants.d.ts +96 -3
  612. package/src/shade/renderer/particles/ParticleConstants.d.ts.map +1 -1
  613. package/src/shade/renderer/particles/ParticleConstants.js +103 -4
  614. package/src/shade/renderer/particles/coherence/graph_particle_bucket.d.ts +5 -4
  615. package/src/shade/renderer/particles/coherence/graph_particle_bucket.d.ts.map +1 -1
  616. package/src/shade/renderer/particles/coherence/graph_particle_bucket.js +11 -15
  617. package/src/shade/renderer/particles/coherence/shader_particle_bucket.d.ts +2 -2
  618. package/src/shade/renderer/particles/coherence/shader_particle_bucket.d.ts.map +1 -1
  619. package/src/shade/renderer/particles/coherence/shader_particle_bucket.js +20 -15
  620. package/src/shade/renderer/particles/data/PARTICLE_COUNTERS.d.ts +7 -8
  621. package/src/shade/renderer/particles/data/PARTICLE_COUNTERS.d.ts.map +1 -1
  622. package/src/shade/renderer/particles/data/PARTICLE_COUNTERS.js +7 -17
  623. package/src/shade/renderer/particles/data/PARTICLE_DATABASE_SPEC.d.ts +56 -0
  624. package/src/shade/renderer/particles/data/PARTICLE_DATABASE_SPEC.d.ts.map +1 -0
  625. package/src/shade/renderer/particles/data/PARTICLE_DATABASE_SPEC.js +68 -0
  626. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_STATE.d.ts +39 -0
  627. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_STATE.d.ts.map +1 -0
  628. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_STATE.js +52 -0
  629. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_STRUCT.d.ts +83 -0
  630. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_STRUCT.d.ts.map +1 -0
  631. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_STRUCT.js +166 -0
  632. package/src/shade/renderer/particles/data/chunk_particle_emitter.d.ts +21 -5
  633. package/src/shade/renderer/particles/data/chunk_particle_emitter.d.ts.map +1 -1
  634. package/src/shade/renderer/particles/data/chunk_particle_emitter.js +44 -85
  635. package/src/shade/renderer/particles/data/particle_header.d.ts +62 -0
  636. package/src/shade/renderer/particles/data/particle_header.d.ts.map +1 -0
  637. package/src/shade/renderer/particles/data/particle_header.js +103 -0
  638. package/src/shade/renderer/particles/graph/ParticleGroupBuilder.d.ts +179 -0
  639. package/src/shade/renderer/particles/graph/ParticleGroupBuilder.d.ts.map +1 -0
  640. package/src/shade/renderer/particles/graph/ParticleGroupBuilder.js +303 -0
  641. package/src/shade/renderer/particles/graph/ParticleNodeDescription.d.ts +120 -1
  642. package/src/shade/renderer/particles/graph/ParticleNodeDescription.d.ts.map +1 -1
  643. package/src/shade/renderer/particles/graph/ParticleNodeDescription.js +90 -1
  644. package/src/shade/renderer/particles/graph/ParticleNodeGroup.d.ts +283 -0
  645. package/src/shade/renderer/particles/graph/ParticleNodeGroup.d.ts.map +1 -0
  646. package/src/shade/renderer/particles/graph/ParticleNodeGroup.js +419 -0
  647. package/src/shade/renderer/particles/graph/ParticleNodeRegistry.d.ts +44 -2
  648. package/src/shade/renderer/particles/graph/ParticleNodeRegistry.d.ts.map +1 -1
  649. package/src/shade/renderer/particles/graph/ParticleNodeRegistry.js +476 -40
  650. package/src/shade/renderer/particles/graph/ParticleValueType.d.ts +188 -0
  651. package/src/shade/renderer/particles/graph/ParticleValueType.d.ts.map +1 -0
  652. package/src/shade/renderer/particles/graph/ParticleValueType.js +287 -0
  653. package/src/shade/renderer/particles/graph/compile_particle_graph.d.ts +16 -9
  654. package/src/shade/renderer/particles/graph/compile_particle_graph.d.ts.map +1 -1
  655. package/src/shade/renderer/particles/graph/compile_particle_graph.js +464 -205
  656. package/src/shade/renderer/particles/graph/flatten_particle_graph.d.ts +11 -0
  657. package/src/shade/renderer/particles/graph/flatten_particle_graph.d.ts.map +1 -0
  658. package/src/shade/renderer/particles/graph/flatten_particle_graph.js +213 -0
  659. package/src/shade/renderer/particles/graph/groups/particle_builtin_groups.d.ts +27 -0
  660. package/src/shade/renderer/particles/graph/groups/particle_builtin_groups.d.ts.map +1 -0
  661. package/src/shade/renderer/particles/graph/groups/particle_builtin_groups.js +75 -0
  662. package/src/shade/renderer/particles/graph/groups/particle_groups_geometry.d.ts +83 -0
  663. package/src/shade/renderer/particles/graph/groups/particle_groups_geometry.d.ts.map +1 -0
  664. package/src/shade/renderer/particles/graph/groups/particle_groups_geometry.js +319 -0
  665. package/src/shade/renderer/particles/graph/groups/particle_groups_noise.d.ts +22 -0
  666. package/src/shade/renderer/particles/graph/groups/particle_groups_noise.d.ts.map +1 -0
  667. package/src/shade/renderer/particles/graph/groups/particle_groups_noise.js +517 -0
  668. package/src/shade/renderer/particles/graph/groups/particle_groups_utility.d.ts +70 -0
  669. package/src/shade/renderer/particles/graph/groups/particle_groups_utility.d.ts.map +1 -0
  670. package/src/shade/renderer/particles/graph/groups/particle_groups_utility.js +161 -0
  671. package/src/shade/renderer/particles/graph/groups/simplex_reference.d.ts +8 -0
  672. package/src/shade/renderer/particles/graph/groups/simplex_reference.d.ts.map +1 -0
  673. package/src/shade/renderer/particles/graph/groups/simplex_reference.js +159 -0
  674. package/src/shade/renderer/particles/graph/infer_particle_graph_types.d.ts +88 -0
  675. package/src/shade/renderer/particles/graph/infer_particle_graph_types.d.ts.map +1 -0
  676. package/src/shade/renderer/particles/graph/infer_particle_graph_types.js +234 -0
  677. package/src/shade/renderer/particles/graph/make_particle_group.d.ts +98 -0
  678. package/src/shade/renderer/particles/graph/make_particle_group.d.ts.map +1 -0
  679. package/src/shade/renderer/particles/graph/make_particle_group.js +427 -0
  680. package/src/shade/renderer/particles/graph/particle_graph_authoring.d.ts +11 -4
  681. package/src/shade/renderer/particles/graph/particle_graph_authoring.d.ts.map +1 -1
  682. package/src/shade/renderer/particles/graph/particle_graph_authoring.js +121 -108
  683. package/src/shade/renderer/particles/graph/particle_graph_diagnostic.d.ts +38 -0
  684. package/src/shade/renderer/particles/graph/particle_graph_diagnostic.d.ts.map +1 -0
  685. package/src/shade/renderer/particles/graph/particle_graph_diagnostic.js +25 -0
  686. package/src/shade/renderer/particles/graph/particle_graph_distributions.d.ts +29 -0
  687. package/src/shade/renderer/particles/graph/particle_graph_distributions.d.ts.map +1 -0
  688. package/src/shade/renderer/particles/graph/particle_graph_distributions.js +170 -0
  689. package/src/shade/renderer/particles/graph/particle_graph_json.d.ts +87 -0
  690. package/src/shade/renderer/particles/graph/particle_graph_json.d.ts.map +1 -0
  691. package/src/shade/renderer/particles/graph/particle_graph_json.js +196 -0
  692. package/src/shade/renderer/particles/graph/particle_group_json.d.ts +86 -0
  693. package/src/shade/renderer/particles/graph/particle_group_json.d.ts.map +1 -0
  694. package/src/shade/renderer/particles/graph/particle_group_json.js +182 -0
  695. package/src/shade/renderer/particles/graph/particle_group_library.d.ts +33 -0
  696. package/src/shade/renderer/particles/graph/particle_group_library.d.ts.map +1 -0
  697. package/src/shade/renderer/particles/graph/particle_group_library.js +75 -0
  698. package/src/shade/renderer/particles/graph/particle_node_library.d.ts +37 -0
  699. package/src/shade/renderer/particles/graph/particle_node_library.d.ts.map +1 -0
  700. package/src/shade/renderer/particles/graph/particle_node_library.js +64 -0
  701. package/src/shade/renderer/particles/graph/particle_node_parameters.d.ts +146 -0
  702. package/src/shade/renderer/particles/graph/particle_node_parameters.d.ts.map +1 -0
  703. package/src/shade/renderer/particles/graph/particle_node_parameters.js +234 -0
  704. package/src/shade/renderer/particles/graph/particle_node_presentation.d.ts +30 -0
  705. package/src/shade/renderer/particles/graph/particle_node_presentation.d.ts.map +1 -0
  706. package/src/shade/renderer/particles/graph/particle_node_presentation.js +286 -0
  707. package/src/shade/renderer/particles/graph/validate_particle_graph.d.ts +66 -0
  708. package/src/shade/renderer/particles/graph/validate_particle_graph.d.ts.map +1 -0
  709. package/src/shade/renderer/particles/graph/validate_particle_graph.js +439 -0
  710. package/src/shade/renderer/particles/graph_particles.d.ts +143 -68
  711. package/src/shade/renderer/particles/graph_particles.d.ts.map +1 -1
  712. package/src/shade/renderer/particles/graph_particles.js +424 -71
  713. package/src/shade/renderer/particles/graph_particles_avboit.d.ts +107 -0
  714. package/src/shade/renderer/particles/graph_particles_avboit.d.ts.map +1 -0
  715. package/src/shade/renderer/particles/graph_particles_avboit.js +312 -0
  716. package/src/shade/renderer/particles/isa/InstructionStream.d.ts +41 -8
  717. package/src/shade/renderer/particles/isa/InstructionStream.d.ts.map +1 -1
  718. package/src/shade/renderer/particles/isa/InstructionStream.js +111 -33
  719. package/src/shade/renderer/particles/isa/ParticleAssembler.d.ts +13 -10
  720. package/src/shade/renderer/particles/isa/ParticleAssembler.d.ts.map +1 -1
  721. package/src/shade/renderer/particles/isa/ParticleAssembler.js +30 -26
  722. package/src/shade/renderer/particles/isa/ParticleProgram.d.ts +27 -15
  723. package/src/shade/renderer/particles/isa/ParticleProgram.d.ts.map +1 -1
  724. package/src/shade/renderer/particles/isa/ParticleProgram.js +139 -34
  725. package/src/shade/renderer/particles/isa/ParticleVMISA.d.ts +117 -9
  726. package/src/shade/renderer/particles/isa/ParticleVMISA.d.ts.map +1 -1
  727. package/src/shade/renderer/particles/isa/ParticleVMISA.js +296 -37
  728. package/src/shade/renderer/particles/isa/particle_assembly.d.ts +149 -0
  729. package/src/shade/renderer/particles/isa/particle_assembly.d.ts.map +1 -0
  730. package/src/shade/renderer/particles/isa/particle_assembly.js +999 -0
  731. package/src/shade/renderer/particles/layout/ParticleLayout.d.ts +25 -3
  732. package/src/shade/renderer/particles/layout/ParticleLayout.d.ts.map +1 -1
  733. package/src/shade/renderer/particles/layout/ParticleLayout.js +33 -5
  734. package/src/shade/renderer/particles/optimizer/optimize_particle_program.d.ts +160 -0
  735. package/src/shade/renderer/particles/optimizer/optimize_particle_program.d.ts.map +1 -0
  736. package/src/shade/renderer/particles/optimizer/optimize_particle_program.js +478 -0
  737. package/src/shade/renderer/particles/optimizer/particle_program_analysis.d.ts +291 -0
  738. package/src/shade/renderer/particles/optimizer/particle_program_analysis.d.ts.map +1 -0
  739. package/src/shade/renderer/particles/optimizer/particle_program_analysis.js +647 -0
  740. package/src/shade/renderer/particles/optimizer/particle_program_equivalence.d.ts +95 -0
  741. package/src/shade/renderer/particles/optimizer/particle_program_equivalence.d.ts.map +1 -0
  742. package/src/shade/renderer/particles/optimizer/particle_program_equivalence.js +213 -0
  743. package/src/shade/renderer/particles/optimizer/particle_program_fuzz.d.ts +16 -0
  744. package/src/shade/renderer/particles/optimizer/particle_program_fuzz.d.ts.map +1 -0
  745. package/src/shade/renderer/particles/optimizer/particle_program_fuzz.js +223 -0
  746. package/src/shade/renderer/particles/optimizer/particle_vm_semantics.d.ts +121 -0
  747. package/src/shade/renderer/particles/optimizer/particle_vm_semantics.d.ts.map +1 -0
  748. package/src/shade/renderer/particles/optimizer/particle_vm_semantics.js +206 -0
  749. package/src/shade/renderer/particles/optimizer/pass_dedup_constants.d.ts +11 -0
  750. package/src/shade/renderer/particles/optimizer/pass_dedup_constants.d.ts.map +1 -0
  751. package/src/shade/renderer/particles/optimizer/pass_dedup_constants.js +197 -0
  752. package/src/shade/renderer/particles/optimizer/pass_eliminate_dead_code.d.ts +4 -0
  753. package/src/shade/renderer/particles/optimizer/pass_eliminate_dead_code.d.ts.map +1 -0
  754. package/src/shade/renderer/particles/optimizer/pass_eliminate_dead_code.js +51 -0
  755. package/src/shade/renderer/particles/optimizer/pass_fold_constants.d.ts +4 -0
  756. package/src/shade/renderer/particles/optimizer/pass_fold_constants.d.ts.map +1 -0
  757. package/src/shade/renderer/particles/optimizer/pass_fold_constants.js +561 -0
  758. package/src/shade/renderer/particles/optimizer/pass_narrow_widths.d.ts +4 -0
  759. package/src/shade/renderer/particles/optimizer/pass_narrow_widths.d.ts.map +1 -0
  760. package/src/shade/renderer/particles/optimizer/pass_narrow_widths.js +72 -0
  761. package/src/shade/renderer/particles/optimizer/pass_pack_registers.d.ts +4 -0
  762. package/src/shade/renderer/particles/optimizer/pass_pack_registers.d.ts.map +1 -0
  763. package/src/shade/renderer/particles/optimizer/pass_pack_registers.js +86 -0
  764. package/src/shade/renderer/particles/optimizer/pass_peephole.d.ts +4 -0
  765. package/src/shade/renderer/particles/optimizer/pass_peephole.d.ts.map +1 -0
  766. package/src/shade/renderer/particles/optimizer/pass_peephole.js +271 -0
  767. package/src/shade/renderer/particles/optimizer/pass_propagate_copies.d.ts +4 -0
  768. package/src/shade/renderer/particles/optimizer/pass_propagate_copies.d.ts.map +1 -0
  769. package/src/shade/renderer/particles/optimizer/pass_propagate_copies.js +268 -0
  770. package/src/shade/renderer/particles/optimizer/pass_share_subexpressions.d.ts +4 -0
  771. package/src/shade/renderer/particles/optimizer/pass_share_subexpressions.d.ts.map +1 -0
  772. package/src/shade/renderer/particles/optimizer/pass_share_subexpressions.js +151 -0
  773. package/src/shade/renderer/particles/particle_test_fixtures.d.ts +131 -0
  774. package/src/shade/renderer/particles/particle_test_fixtures.d.ts.map +1 -0
  775. package/src/shade/renderer/particles/particle_test_fixtures.js +203 -0
  776. package/src/shade/renderer/particles/runtime/Emitter.d.ts +219 -0
  777. package/src/shade/renderer/particles/runtime/Emitter.d.ts.map +1 -0
  778. package/src/shade/renderer/particles/runtime/EmitterRegistry.d.ts +128 -60
  779. package/src/shade/renderer/particles/runtime/EmitterRegistry.d.ts.map +1 -1
  780. package/src/shade/renderer/particles/runtime/EmitterRegistry.js +286 -117
  781. package/src/shade/renderer/particles/runtime/ParticleEmitter.d.ts +264 -0
  782. package/src/shade/renderer/particles/runtime/ParticleEmitter.d.ts.map +1 -0
  783. package/src/shade/renderer/particles/runtime/ParticleEmitter.js +404 -0
  784. package/src/shade/renderer/particles/runtime/ParticleSpawnScheduler.d.ts +49 -15
  785. package/src/shade/renderer/particles/runtime/ParticleSpawnScheduler.d.ts.map +1 -1
  786. package/src/shade/renderer/particles/runtime/ProgramArena.d.ts +51 -18
  787. package/src/shade/renderer/particles/runtime/ProgramArena.d.ts.map +1 -1
  788. package/src/shade/renderer/particles/runtime/ProgramArena.js +72 -32
  789. package/src/shade/renderer/particles/runtime/create_particle_effect.d.ts +4 -4
  790. package/src/shade/renderer/particles/runtime/create_particle_effect.d.ts.map +1 -1
  791. package/src/shade/renderer/particles/runtime/create_particle_effect.js +4 -4
  792. package/src/shade/renderer/particles/runtime/emitter_database_image.d.ts +15 -0
  793. package/src/shade/renderer/particles/runtime/emitter_database_image.d.ts.map +1 -0
  794. package/src/shade/renderer/particles/shaders/chunk_particle_avboit_contribution.d.ts +17 -0
  795. package/src/shade/renderer/particles/shaders/chunk_particle_avboit_contribution.d.ts.map +1 -0
  796. package/src/shade/renderer/particles/shaders/chunk_particle_avboit_contribution.js +75 -0
  797. package/src/shade/renderer/particles/shaders/chunk_particle_billboard_vertex.d.ts +20 -0
  798. package/src/shade/renderer/particles/shaders/chunk_particle_billboard_vertex.d.ts.map +1 -0
  799. package/src/shade/renderer/particles/shaders/chunk_particle_billboard_vertex.js +94 -0
  800. package/src/shade/renderer/particles/shaders/chunk_particle_context.d.ts +15 -5
  801. package/src/shade/renderer/particles/shaders/chunk_particle_context.d.ts.map +1 -1
  802. package/src/shade/renderer/particles/shaders/chunk_particle_curve_animation.d.ts +1 -2
  803. package/src/shade/renderer/particles/shaders/chunk_particle_curve_animation.d.ts.map +1 -1
  804. package/src/shade/renderer/particles/shaders/chunk_particle_curve_animation.js +1 -2
  805. package/src/shade/renderer/particles/shaders/chunk_particle_curve_disabled.d.ts +11 -0
  806. package/src/shade/renderer/particles/shaders/chunk_particle_curve_disabled.d.ts.map +1 -0
  807. package/src/shade/renderer/particles/shaders/chunk_particle_curve_disabled.js +13 -0
  808. package/src/shade/renderer/particles/shaders/chunk_particle_emitter_age.d.ts +17 -0
  809. package/src/shade/renderer/particles/shaders/chunk_particle_emitter_age.d.ts.map +1 -0
  810. package/src/shade/renderer/particles/shaders/chunk_particle_emitter_age.js +22 -0
  811. package/src/shade/renderer/particles/shaders/chunk_particle_emitter_world_sphere.d.ts +14 -0
  812. package/src/shade/renderer/particles/shaders/chunk_particle_emitter_world_sphere.d.ts.map +1 -0
  813. package/src/shade/renderer/particles/shaders/chunk_particle_emitter_world_sphere.js +23 -0
  814. package/src/shade/renderer/particles/shaders/chunk_particle_render_math.js +1 -1
  815. package/src/shade/renderer/particles/shaders/chunk_particle_scene_view_depth.d.ts +18 -0
  816. package/src/shade/renderer/particles/shaders/chunk_particle_scene_view_depth.d.ts.map +1 -0
  817. package/src/shade/renderer/particles/shaders/chunk_particle_scene_view_depth.js +24 -0
  818. package/src/shade/renderer/particles/shaders/chunk_particle_setup_context.d.ts +26 -0
  819. package/src/shade/renderer/particles/shaders/chunk_particle_setup_context.d.ts.map +1 -0
  820. package/src/shade/renderer/particles/shaders/chunk_particle_setup_context.js +59 -0
  821. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.d.ts +14 -0
  822. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.d.ts.map +1 -0
  823. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.js +153 -0
  824. package/src/shade/renderer/particles/shaders/shader_particle_avboit_occupancy.d.ts +3 -0
  825. package/src/shade/renderer/particles/shaders/shader_particle_avboit_occupancy.d.ts.map +1 -0
  826. package/src/shade/renderer/particles/shaders/shader_particle_avboit_occupancy.js +124 -0
  827. package/src/shade/renderer/particles/shaders/shader_particle_avboit_splat.d.ts +19 -0
  828. package/src/shade/renderer/particles/shaders/shader_particle_avboit_splat.d.ts.map +1 -0
  829. package/src/shade/renderer/particles/shaders/shader_particle_avboit_splat.js +147 -0
  830. package/src/shade/renderer/particles/shaders/shader_particle_emit.d.ts +18 -8
  831. package/src/shade/renderer/particles/shaders/shader_particle_emit.d.ts.map +1 -1
  832. package/src/shade/renderer/particles/shaders/shader_particle_emit.js +72 -37
  833. package/src/shade/renderer/particles/shaders/shader_particle_emitter_tick.d.ts +5 -0
  834. package/src/shade/renderer/particles/shaders/shader_particle_emitter_tick.d.ts.map +1 -0
  835. package/src/shade/renderer/particles/shaders/shader_particle_emitter_tick.js +216 -0
  836. package/src/shade/renderer/particles/shaders/shader_particle_finalize.d.ts.map +1 -1
  837. package/src/shade/renderer/particles/shaders/shader_particle_finalize.js +7 -3
  838. package/src/shade/renderer/particles/shaders/shader_particle_render.d.ts.map +1 -1
  839. package/src/shade/renderer/particles/shaders/shader_particle_render.js +132 -197
  840. package/src/shade/renderer/particles/shaders/shader_particle_simulate.d.ts.map +1 -1
  841. package/src/shade/renderer/particles/shaders/shader_particle_simulate.js +78 -24
  842. package/src/shade/renderer/particles/shaders/shader_particle_spawn_commands.d.ts +26 -0
  843. package/src/shade/renderer/particles/shaders/shader_particle_spawn_commands.d.ts.map +1 -0
  844. package/src/shade/renderer/particles/shaders/shader_particle_spawn_commands.js +66 -0
  845. package/src/shade/renderer/particles/sort/shader_particle_sort.d.ts +1 -1
  846. package/src/shade/renderer/particles/sort/shader_particle_sort.d.ts.map +1 -1
  847. package/src/shade/renderer/particles/sort/shader_particle_sort.js +21 -36
  848. package/src/shade/renderer/particles/vm/ParticleVMReference.d.ts +2 -2
  849. package/src/shade/renderer/particles/vm/ParticleVMReference.d.ts.map +1 -1
  850. package/src/shade/renderer/particles/vm/ParticleVMReference.js +100 -90
  851. package/src/shade/renderer/particles/vm/chunk_particle_vm.d.ts.map +1 -1
  852. package/src/shade/renderer/particles/vm/chunk_particle_vm.js +270 -138
  853. package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.d.ts +9 -0
  854. package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.d.ts.map +1 -1
  855. package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.js +26 -0
  856. package/src/shade/renderer/postprocess/denoise/debug/graph_pass_debug_reprojection.d.ts +1 -2
  857. package/src/shade/renderer/postprocess/denoise/debug/graph_pass_debug_reprojection.d.ts.map +1 -1
  858. package/src/shade/renderer/postprocess/denoise/debug/graph_pass_debug_reprojection.js +0 -3
  859. package/src/shade/renderer/postprocess/dof/gather/DepthOfFieldU.js +1 -1
  860. package/src/shade/renderer/postprocess/dof/raymarch/DepthOfField.js +1 -1
  861. package/src/shade/renderer/postprocess/nss/NSS.d.ts +1 -1
  862. package/src/shade/renderer/postprocess/nss/NSS.d.ts.map +1 -1
  863. package/src/shade/renderer/postprocess/nss/NSS.js +3 -2
  864. package/src/shade/renderer/postprocess/nss/generate_NSS_WEIGHTS_ACTUAL.js +3 -2
  865. package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.d.ts +7 -2
  866. package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.d.ts.map +1 -1
  867. package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.js +12 -1
  868. package/src/shade/renderer/rasterize/expand/shader_filter_triangle_by_material_side.js +1 -1
  869. package/src/shade/renderer/rasterize/forward/FORWARD_VERTEX_SHADER_STRUCT.d.ts +3 -0
  870. package/src/shade/renderer/rasterize/forward/FORWARD_VERTEX_SHADER_STRUCT.d.ts.map +1 -0
  871. package/src/shade/renderer/rasterize/{native/oit → forward}/FORWARD_VERTEX_SHADER_STRUCT.js +4 -4
  872. package/src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.d.ts +3 -0
  873. package/src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.d.ts.map +1 -0
  874. package/src/shade/renderer/rasterize/forward/SHADING_SCENE_RESOURCE_GROUP.js +17 -0
  875. package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_brick4.d.ts +1 -1
  876. package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.d.ts.map +1 -0
  877. package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_brick4.js +16 -16
  878. package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_ibl.d.ts +1 -1
  879. package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.d.ts.map +1 -0
  880. package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_forward_shade_standard_fragment_ibl.js +17 -17
  881. package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_material_side_should_draw.d.ts +1 -1
  882. package/src/shade/renderer/rasterize/forward/chunk_material_side_should_draw.d.ts.map +1 -0
  883. package/src/shade/renderer/rasterize/{native/oit → forward}/chunk_material_side_should_draw.js +2 -2
  884. package/src/shade/renderer/rasterize/forward/vertex_shader_chunk.d.ts +3 -0
  885. package/src/shade/renderer/rasterize/forward/vertex_shader_chunk.d.ts.map +1 -0
  886. package/src/shade/renderer/rasterize/{native/oit → forward}/vertex_shader_chunk.js +4 -4
  887. package/src/shade/renderer/rasterize/native/avboit/AVBOITSettings.d.ts +27 -0
  888. package/src/shade/renderer/rasterize/native/avboit/AVBOITSettings.d.ts.map +1 -0
  889. package/src/shade/renderer/rasterize/native/avboit/AVBOITSettings.js +27 -0
  890. package/src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.d.ts +87 -0
  891. package/src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.d.ts.map +1 -0
  892. package/src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.js +61 -0
  893. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_CONSTANTS.d.ts +107 -0
  894. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_CONSTANTS.d.ts.map +1 -0
  895. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_CONSTANTS.js +120 -0
  896. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_LEDGER.md +642 -0
  897. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_PLAN_2026_09_03.md +534 -0
  898. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_WARP_STRUCT.d.ts +15 -0
  899. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_WARP_STRUCT.d.ts.map +1 -0
  900. package/src/shade/renderer/rasterize/native/avboit/AVBOIT_WARP_STRUCT.js +33 -0
  901. package/src/shade/renderer/rasterize/native/avboit/avboit_build_depth_curve.d.ts +20 -0
  902. package/src/shade/renderer/rasterize/native/avboit/avboit_build_depth_curve.d.ts.map +1 -0
  903. package/src/shade/renderer/rasterize/native/avboit/avboit_build_depth_curve.js +38 -0
  904. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.d.ts +45 -0
  905. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.d.ts.map +1 -0
  906. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.js +139 -0
  907. package/src/shade/renderer/rasterize/native/avboit/avboit_spec_support.d.ts +37 -0
  908. package/src/shade/renderer/rasterize/native/avboit/avboit_spec_support.d.ts.map +1 -0
  909. package/src/shade/renderer/rasterize/native/avboit/avboit_spec_support.js +73 -0
  910. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_counts_to_extinction.d.ts +9 -0
  911. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_counts_to_extinction.d.ts.map +1 -0
  912. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_counts_to_extinction.js +17 -0
  913. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_dilate_word.d.ts +11 -0
  914. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_dilate_word.d.ts.map +1 -0
  915. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_dilate_word.js +18 -0
  916. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_extinction_to_counts.d.ts +9 -0
  917. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_extinction_to_counts.d.ts.map +1 -0
  918. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_extinction_to_counts.js +17 -0
  919. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_extinction_to_transmittance.d.ts +9 -0
  920. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_extinction_to_transmittance.d.ts.map +1 -0
  921. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_extinction_to_transmittance.js +17 -0
  922. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_fold_pairs.d.ts +15 -0
  923. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_fold_pairs.d.ts.map +1 -0
  924. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_fold_pairs.js +25 -0
  925. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_integral_depth_coordinate.d.ts +17 -0
  926. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_integral_depth_coordinate.d.ts.map +1 -0
  927. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_integral_depth_coordinate.js +35 -0
  928. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_occupancy_range.d.ts +11 -0
  929. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_occupancy_range.d.ts.map +1 -0
  930. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_occupancy_range.js +21 -0
  931. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_occupancy_word_mask.d.ts +9 -0
  932. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_occupancy_word_mask.d.ts.map +1 -0
  933. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_occupancy_word_mask.js +26 -0
  934. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_overflows.d.ts +11 -0
  935. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_overflows.d.ts.map +1 -0
  936. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_overflows.js +22 -0
  937. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_pack_counts.d.ts +10 -0
  938. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_pack_counts.d.ts.map +1 -0
  939. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_pack_counts.js +21 -0
  940. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_sample_transmittance.d.ts +10 -0
  941. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_sample_transmittance.d.ts.map +1 -0
  942. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_sample_transmittance.js +32 -0
  943. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_splat_slice.d.ts +18 -0
  944. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_splat_slice.d.ts.map +1 -0
  945. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_splat_slice.js +58 -0
  946. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_transmission_tint.d.ts +20 -0
  947. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_transmission_tint.d.ts.map +1 -0
  948. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_transmission_tint.js +27 -0
  949. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_transmittance_to_extinction.d.ts +10 -0
  950. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_transmittance_to_extinction.d.ts.map +1 -0
  951. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_transmittance_to_extinction.js +18 -0
  952. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_unpack_counts.d.ts +9 -0
  953. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_unpack_counts.d.ts.map +1 -0
  954. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_unpack_counts.js +21 -0
  955. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_view_depth_to_physical.d.ts +9 -0
  956. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_view_depth_to_physical.d.ts.map +1 -0
  957. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_view_depth_to_physical.js +23 -0
  958. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_view_depth_to_virtual.d.ts +13 -0
  959. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_view_depth_to_virtual.d.ts.map +1 -0
  960. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_view_depth_to_virtual.js +27 -0
  961. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_warp.d.ts +22 -0
  962. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_warp.d.ts.map +1 -0
  963. package/src/shade/renderer/rasterize/native/avboit/chunk_avboit_warp.js +38 -0
  964. package/src/shade/renderer/rasterize/native/avboit/graph_rasterize_meshes_transparent_avboit.d.ts +141 -0
  965. package/src/shade/renderer/rasterize/native/avboit/graph_rasterize_meshes_transparent_avboit.d.ts.map +1 -0
  966. package/src/shade/renderer/rasterize/native/avboit/graph_rasterize_meshes_transparent_avboit.js +994 -0
  967. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_build_warp.d.ts +8 -0
  968. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_build_warp.d.ts.map +1 -0
  969. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_build_warp.js +135 -0
  970. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw_brick4.d.ts +3 -0
  971. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw_brick4.d.ts.map +1 -0
  972. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw_brick4.js +101 -0
  973. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw_ibl.d.ts +3 -0
  974. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw_ibl.d.ts.map +1 -0
  975. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_draw_ibl.js +96 -0
  976. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_integrate.d.ts +3 -0
  977. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_integrate.d.ts.map +1 -0
  978. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_integrate.js +83 -0
  979. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_occupancy.d.ts +9 -0
  980. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_occupancy.d.ts.map +1 -0
  981. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_occupancy.js +119 -0
  982. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_resolve.d.ts +3 -0
  983. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_resolve.d.ts.map +1 -0
  984. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_resolve.js +87 -0
  985. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_splat.d.ts +15 -0
  986. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_splat.d.ts.map +1 -0
  987. package/src/shade/renderer/rasterize/native/avboit/shader_avboit_splat.js +202 -0
  988. package/src/shade/renderer/rasterize/native/material_draw_indirect.d.ts +22 -0
  989. package/src/shade/renderer/rasterize/native/material_draw_indirect.d.ts.map +1 -0
  990. package/src/shade/renderer/rasterize/native/material_draw_indirect.js +69 -0
  991. package/src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.d.ts.map +1 -1
  992. package/src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js +665 -722
  993. package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js +3 -3
  994. package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js +4 -4
  995. package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments_ibl.js +4 -4
  996. package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.d.ts +7 -2
  997. package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.d.ts.map +1 -1
  998. package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.js +16 -2
  999. package/src/shade/renderer/scene/optimization/geometry/geometry_deduplicate.d.ts +3 -3
  1000. package/src/shade/renderer/scene/optimization/geometry/geometry_deduplicate.d.ts.map +1 -1
  1001. package/src/shade/renderer/scene/optimization/geometry/geometry_deduplicate.js +29 -23
  1002. package/src/shade/renderer/scene/optimization/geometry/internal/anchor_grow_topological.d.ts +2 -2
  1003. package/src/shade/renderer/scene/optimization/geometry/internal/anchor_grow_topological.d.ts.map +1 -1
  1004. package/src/shade/renderer/scene/optimization/geometry/internal/anchor_grow_topological.js +3 -3
  1005. package/src/shade/renderer/scene/optimization/geometry/internal/cover_greedy.d.ts +4 -4
  1006. package/src/shade/renderer/scene/optimization/geometry/internal/cover_greedy.d.ts.map +1 -1
  1007. package/src/shade/renderer/scene/optimization/geometry/internal/cover_greedy.js +2 -2
  1008. package/src/shade/renderer/scene/optimization/geometry/internal/match_refit_validate.d.ts +2 -2
  1009. package/src/shade/renderer/scene/optimization/geometry/internal/match_refit_validate.d.ts.map +1 -1
  1010. package/src/shade/renderer/scene/optimization/geometry/internal/match_refit_validate.js +2 -2
  1011. package/src/shade/renderer/scene/optimization/geometry/internal/match_solve_transform.d.ts +7 -7
  1012. package/src/shade/renderer/scene/optimization/geometry/internal/match_solve_transform.d.ts.map +1 -1
  1013. package/src/shade/renderer/scene/optimization/geometry/internal/match_solve_transform.js +79 -71
  1014. package/src/shade/renderer/shader/chunk/math/chunk_lower_bound_branchless.d.ts.map +1 -1
  1015. package/src/shade/renderer/shader/chunk/math/chunk_lower_bound_branchless.js +3 -1
  1016. package/src/shade/renderer/shader/chunk/random/chunk_hash_to_float01.d.ts +13 -3
  1017. package/src/shade/renderer/shader/chunk/random/chunk_hash_to_float01.d.ts.map +1 -1
  1018. package/src/shade/renderer/shader/chunk/random/chunk_hash_to_float01.js +15 -5
  1019. package/src/shade/renderer/shader/chunk/random/chunk_random_uint.d.ts +8 -0
  1020. package/src/shade/renderer/shader/chunk/random/chunk_random_uint.d.ts.map +1 -1
  1021. package/src/shade/renderer/shader/chunk/random/chunk_random_uint.js +15 -5
  1022. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg.d.ts +7 -0
  1023. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg.d.ts.map +1 -1
  1024. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg.js +17 -7
  1025. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg_advance.d.ts +17 -0
  1026. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg_advance.d.ts.map +1 -0
  1027. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg_advance.js +26 -0
  1028. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg_output.d.ts +15 -0
  1029. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg_output.d.ts.map +1 -0
  1030. package/src/shade/renderer/shader/chunk/random/pcg/chunk_pcg_output.js +26 -0
  1031. package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.d.ts.map +1 -1
  1032. package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.js +8 -2
  1033. package/src/shade/renderer/shadow/map/PointLightShadowmap.d.ts.map +1 -1
  1034. package/src/shade/renderer/shadow/map/PointLightShadowmap.js +7 -2
  1035. package/src/shade/renderer/shadow/map/SpotLightShadowmap.d.ts.map +1 -1
  1036. package/src/shade/renderer/shadow/map/SpotLightShadowmap.js +3 -15
  1037. package/src/shade/renderer/shadow/map/TetrahedronPointLightShadowmap.d.ts.map +1 -1
  1038. package/src/shade/renderer/shadow/map/TetrahedronPointLightShadowmap.js +10 -4
  1039. package/src/shade/renderer/shadow/vsm/GPUViewShadowMaps.d.ts.map +1 -1
  1040. package/src/shade/renderer/shadow/vsm/GPUViewShadowMaps.js +7 -2
  1041. package/src/shade/renderer/volumetrics/GPUViewVolumetrics.js +2 -2
  1042. package/src/shade/renderer/volumetrics/ParticipatingMediaVolume.d.ts +3 -3
  1043. package/src/shade/renderer/volumetrics/ParticipatingMediaVolume.d.ts.map +1 -1
  1044. package/src/shade/renderer/volumetrics/ParticipatingMediaVolume.js +3 -3
  1045. package/src/shade/wgsl/emulator/WGSLJavaScriptCompiler.d.ts.map +1 -1
  1046. package/src/shade/wgsl/emulator/WGSLJavaScriptCompiler.js +66 -5
  1047. package/src/shade/wgsl/emulator/WGSLLanguageCore.d.ts.map +1 -1
  1048. package/src/shade/wgsl/emulator/WGSLLanguageCore.js +35 -4
  1049. package/src/view/minimap/Minimap.d.ts.map +1 -1
  1050. package/src/view/minimap/Minimap.js +227 -225
  1051. package/src/view/minimap/MinimapCanvasView.js +3 -3
  1052. package/src/view/minimap/MinimapMarker.d.ts +45 -0
  1053. package/src/view/minimap/MinimapMarker.d.ts.map +1 -0
  1054. package/src/view/minimap/MinimapMarker.js +80 -0
  1055. package/src/view/minimap/MinimapMarkerCollection.d.ts +6 -5
  1056. package/src/view/minimap/MinimapMarkerCollection.d.ts.map +1 -1
  1057. package/src/view/minimap/MinimapMarkerCollection.js +6 -6
  1058. package/src/view/minimap/MinimapMarkerSerializationAdapter.d.ts +19 -0
  1059. package/src/view/minimap/MinimapMarkerSerializationAdapter.d.ts.map +1 -0
  1060. package/src/view/minimap/MinimapMarkerSerializationAdapter.js +42 -0
  1061. package/src/view/minimap/dom/MinimapCameraView.d.ts +1 -1
  1062. package/src/view/minimap/dom/MinimapCameraView.d.ts.map +1 -1
  1063. package/src/view/minimap/dom/MinimapCameraView.js +23 -4
  1064. package/src/view/minimap/dom/MinimapMarkerView.js +3 -3
  1065. package/src/view/minimap/gl/MarkerGL.js +3 -3
  1066. package/src/view/util/DomLayoutFrame.d.ts +53 -0
  1067. package/src/view/util/DomLayoutFrame.d.ts.map +1 -0
  1068. package/src/view/util/DomLayoutFrame.js +122 -0
  1069. package/src/core/model/node-graph/visual/layout/BoxLayoutSpec.js +0 -19
  1070. package/src/core/model/node-graph/visual/layout/ConnectedBoxLayouter.js +0 -241
  1071. package/src/core/model/node-graph/visual/layout/ConnectionEndpointLayoutSpec.js +0 -40
  1072. package/src/core/model/node-graph/visual/layout/ConnectionLayoutSpec.js +0 -28
  1073. package/src/engine/ecs/util/hideEntityGracefully.js +0 -196
  1074. package/src/shade/renderer/particles/cull/chunk_particle_cull.js +0 -38
  1075. package/src/shade/renderer/particles/data/PARTICLE_EMITTER_LAYOUT.js +0 -214
  1076. package/src/shade/renderer/particles/particle_prototype.d.ts.map +0 -1
  1077. package/src/shade/renderer/particles/runtime/ParticleSpawnScheduler.js +0 -86
  1078. package/src/shade/renderer/particles/runtime/spawn_request_encoding.js +0 -52
  1079. package/src/shade/renderer/particles/shaders/chunk_particle_context.js +0 -58
  1080. package/src/shade/renderer/rasterize/native/oit/FORWARD_VERTEX_SHADER_STRUCT.d.ts +0 -3
  1081. package/src/shade/renderer/rasterize/native/oit/FORWARD_VERTEX_SHADER_STRUCT.d.ts.map +0 -1
  1082. package/src/shade/renderer/rasterize/native/oit/SHADING_SCENE_RESOURCE_GROUP.d.ts +0 -3
  1083. package/src/shade/renderer/rasterize/native/oit/SHADING_SCENE_RESOURCE_GROUP.d.ts.map +0 -1
  1084. package/src/shade/renderer/rasterize/native/oit/SHADING_SCENE_RESOURCE_GROUP.js +0 -17
  1085. package/src/shade/renderer/rasterize/native/oit/chunk_forward_shade_standard_fragment_brick4.d.ts.map +0 -1
  1086. package/src/shade/renderer/rasterize/native/oit/chunk_forward_shade_standard_fragment_ibl.d.ts.map +0 -1
  1087. package/src/shade/renderer/rasterize/native/oit/chunk_material_side_should_draw.d.ts.map +0 -1
  1088. package/src/shade/renderer/rasterize/native/oit/vertex_shader_chunk.d.ts +0 -3
  1089. package/src/shade/renderer/rasterize/native/oit/vertex_shader_chunk.d.ts.map +0 -1
@@ -1,723 +1,666 @@
1
- import { assert } from "../../../../../core/assert.js";
2
- import { SamplerDescriptor } from "../../../../descriptor/texture/SamplerDescriptor.js";
3
- import { TextureResourceDescriptor } from "../../../../device/graph/TextureResourceDescriptor.js";
4
- import { rp_rewrite_for_primitive_state } from "../../../../device/pipeline/rp_rewrite_for_primitive_state.js";
5
- import { STRUCT_UNINDEXED_DRAW_COMMAND } from "../../../gpu_primitive/indirect/STRUCT_UNINDEXED_DRAW_COMMAND.js";
6
- import { BindGroupDescriptor } from "../../../binding/BindGroupDescriptor.js";
7
- import { SHADING_LIGHT_RESOURCE_GROUP } from "../../../deferred/SHADING_LIGHT_RESOURCE_GROUP.js";
8
- import { ShadeDrawMode } from "../../../material/ShadeDrawMode.js";
9
- import { ShadeDrawSide } from "../../../material/ShadeDrawSide.js";
10
- import { SHADING_MATERIAL_RESOURCE_GROUP } from "../../../material/standard/SHADING_MATERIAL_RESOURCE_GROUP.js";
11
- import { TransparencyMode } from "../../../material/TransparencyMode.js";
12
- import { ShadeIndirectLightingMode } from "../../../ShadeIndirectLightingMode.js";
13
- import { graph_image_pass } from "../../../shader/graph/graph_image_pass.js";
14
- import { graph_import_buffer } from "../../../shader/graph/graph_import_buffer.js";
15
- import { graph_import_texture } from "../../../shader/graph/graph_import_texture.js";
16
- import {
17
- SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR
18
- } from "../../../shadow/map/SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR.js";
19
- import { STATIC_GRAPHICS_ENGINE_ASSETS } from "../../../STATIC_GRAPHICS_ENGINE_ASSETS.js";
20
- import { rasterization_material_bucket } from "../../expand/bucket/chunk_rasterization_material_bucket.js";
21
- import { construct_primitive_state } from "../../bucket/construct_primitive_state.js";
22
- import { filter_materials_by_bucket } from "../../bucket/filter_materials_by_bucket.js";
23
- import {
24
- graph_prepare_meshlet_draw_commands_by_material
25
- } from "../../bucket/prepare_meshlet_draw_commands_by_material.js";
26
- import {
27
- RASTERIZATION_SHADER_BIND_GROUP_SCENE,
28
- RASTERIZATION_SHADER_BIND_GROUP_VIEW
29
- } from "../alpha_tested_pass_resources.js";
30
- import { shader_oit_blend } from "./shader_oit_blend.js";
31
- import { shader_oit_generate_moments } from "./shader_oit_generate_moments.js";
32
- import { shader_oit_resolve_moments } from "./shader_oit_resolve_moments.js";
33
- import { shader_oit_resolve_moments_ibl } from "./shader_oit_resolve_moments_ibl.js";
34
- import { SHADING_SCENE_RESOURCE_GROUP } from "./SHADING_SCENE_RESOURCE_GROUP.js";
35
-
36
- const DRAW_COMMAND_BYTE_SIZE = STRUCT_UNINDEXED_DRAW_COMMAND.aligned_size;
37
-
38
- const BIND_GROUP_LAYOUT_SCENE = SHADING_SCENE_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
39
- const BIND_GROUP_LAYOUT_MATERIAL = SHADING_MATERIAL_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
40
- const BIND_GROUP_LAYOUT_LIGHT = SHADING_LIGHT_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
41
-
42
-
43
- /**
44
- *
45
- * @param {GPUMaterialManager} material_manager
46
- * @param {number} material_count
47
- * @param {ShadeMaterial[]} materials
48
- * @param {RenderPassDescriptor} render_pass_descriptor
49
- * @param {BindGroupManager} bind_manager
50
- * @param {ShadeGPURenderPassEncoder} pass_encoder
51
- * @param {GPUBuffer} command_buffer_draw
52
- */
53
- function material_draw(
54
- material_manager,
55
- material_count,
56
- materials,
57
- render_pass_descriptor,
58
- bind_manager,
59
- pass_encoder,
60
- command_buffer_draw
61
- ) {
62
-
63
- assert.defined(material_manager, 'material_manager');
64
- assert.isNonNegativeInteger(material_count, 'material_count');
65
- assert.isArray(materials, 'materials');
66
-
67
- for (let i = 0; i < material_count; i++) {
68
-
69
- const material = materials[i];
70
- const gpu_material = material_manager.obtain(material);
71
-
72
- if (!gpu_material.is_built) {
73
- // skip, not ready for rendering
74
- continue;
75
- }
76
-
77
- const material_resource_group = render_pass_descriptor.resources.groups[0];
78
- const binding_entries = material_resource_group.generateBindings(gpu_material.binding_data);
79
- const material_bindings = bind_manager.obtain(BindGroupDescriptor.from(
80
- BIND_GROUP_LAYOUT_MATERIAL,
81
- binding_entries
82
- ));
83
-
84
- // set material-specific bind group at 0
85
- pass_encoder.setBindGroup(0, material_bindings)
86
-
87
- pass_encoder.drawIndirect(
88
- command_buffer_draw,
89
- i * DRAW_COMMAND_BYTE_SIZE,
90
- );
91
-
92
- }
93
- }
94
-
95
- /**
96
- *
97
- * @param {FrameGraph} graph
98
- * @param {GPUViewContext} view_ctx
99
- * @param {number} material_count
100
- * @param {ShadeMaterial[]} materials
101
- * @param {boolean} [clear_targets]
102
- * @param {number} texture_moments
103
- * @param {number} texture_optical_depth
104
- * @param {number} draw_commands
105
- * @param {number} meshlets
106
- * @param {number} depth_texture
107
- * @param {number} light_cluster_parameters
108
- * @param {number} light_cluster_lookup
109
- * @param {number} light_cluster_data
110
- * @param {number} shadowmap_atlas
111
- * @param {number} output
112
- * @param {PrimitiveState} primitive
113
- * @param {ShadeIndirectLightingMode} indirect_lighting_mode
114
- * @return {number}
115
- */
116
- function graph_oit_resolve_moments({
117
- graph,
118
- view_ctx,
119
- material_count,
120
- materials,
121
- clear_targets = true,
122
- texture_moments,
123
- texture_optical_depth,
124
- draw_commands,
125
- meshlets,
126
- depth_texture ,
127
- primitive,
128
- light_cluster_parameters ,
129
- light_cluster_lookup ,
130
- light_cluster_data ,
131
-
132
- shadowmap_atlas ,
133
-
134
- volumetrics_lut,
135
- volumetrics_metadata,
136
-
137
- output = -1,
138
- indirect_lighting_mode = ShadeIndirectLightingMode.IBL,
139
- }) {
140
-
141
- assert.isNonNegativeInteger(material_count, 'material_count');
142
- assert.isNonNegativeInteger(draw_commands, 'draw_commands');
143
- assert.isNonNegativeInteger(meshlets, 'meshlets');
144
-
145
- const scene_ctx = view_ctx.scene;
146
-
147
- /**
148
- *
149
- * @param data
150
- * @param {FramePassResources} resources
151
- * @param {GraphicsExecutionContext} context
152
- */
153
- function execute(data, resources, context) {
154
-
155
- assert.ok(context.graphics.device.features.has("indirect-first-instance"), '"indirect-first-instance" feature needs to be enabled for non-zero firstInstance values to be used.')
156
-
157
- const command_buffer_draw = resources.get(data.draw_commands);
158
- const meshlet_buffer = resources.get(data.meshlets);
159
-
160
- const t_moments = resources.get(data.moments);
161
- const t_optical_depth = resources.get(data.optical_depth);
162
- const t_resolved = resources.get(data.resolved);
163
- const t_depth = resources.get(data.depth);
164
-
165
- const light_cluster_parameters = resources.get(data.light_cluster_parameters);
166
- const light_cluster_lookup = resources.get(data.light_cluster_lookup);
167
- const light_cluster_data = resources.get(data.light_cluster_data);
168
-
169
- const shadowmap_atlas = resources.get(data.shadowmap_atlas);
170
-
171
- const t_volumetrics_lut = resources.get(data.volumetrics_lut);
172
- const volumetrics_metadata = resources.get(data.volumetrics_metadata);
173
-
174
- const encoder = context.encoder;
175
-
176
- const graphics = context.graphics;
177
-
178
- const bind_manager = graphics.bind_groups;
179
-
180
- const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
181
- BIND_GROUP_LAYOUT_SCENE,
182
- [
183
- { buffer: meshlet_buffer },
184
- { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
185
- { buffer: scene_ctx.geometries.meshlets.buffer_data },
186
- { buffer: scene_ctx.scene_database_buffer },
187
- { buffer: scene_ctx.geometries.buffer_metadata },
188
- ]
189
- ));
190
-
191
- const sampler_shadowmap = context.graphics.samplers.obtain(SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR);
192
-
193
- const light_bindings = bind_manager.obtain(BindGroupDescriptor.from(
194
- BIND_GROUP_LAYOUT_LIGHT,
195
- [
196
- { buffer: view_ctx.scene.lights.buffer_data },
197
- view_ctx.scene.lights.environment.obtainView(),
198
- //
199
- { buffer: light_cluster_parameters },
200
- { buffer: light_cluster_lookup },
201
- { buffer: light_cluster_data },
202
- //
203
- shadowmap_atlas.obtainView(),
204
- sampler_shadowmap,
205
- ]
206
- ));
207
-
208
- // Select render pass descriptor based on indirect lighting mode
209
- const use_brick4 = data.indirect_lighting_mode === ShadeIndirectLightingMode.Brick4;
210
- const render_pass_descriptor = use_brick4
211
- ? shader_oit_resolve_moments
212
- : shader_oit_resolve_moments_ibl;
213
-
214
- const pass_encoder = encoder.beginRenderPass(render_pass_descriptor.toGPU({
215
- colorTargets: [t_resolved],
216
- depthTarget: t_depth,
217
- colorLoadOp: clear_targets ? "clear" : "load",
218
- depthLoadOp: "load",
219
- storeOp: "store",
220
- }));
221
-
222
- const pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitive);
223
-
224
- const pipeline = graphics.render_pipelines.obtain(pipeline_descriptor)
225
- pass_encoder.setPipeline(pipeline);
226
-
227
- pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_SCENE, scene_bindings);
228
- pass_encoder.setBindGroup(3, light_bindings);
229
-
230
- const sampler_linear = graphics.samplers.obtain(SamplerDescriptor.from({
231
- magFilter: "linear",
232
- }));
233
-
234
- const t_split_sum_lut = graphics.textures.obtain(STATIC_GRAPHICS_ENGINE_ASSETS.split_sum);
235
-
236
- const stbn_vec3 = graphics.textures.obtain(STATIC_GRAPHICS_ENGINE_ASSETS.stbn_vec3);
237
-
238
- // Brick4 variant requires brick4 buffer in the view bind group;
239
- // IBL variant does not. Volumetrics bindings are appended last (after sLinear), matching
240
- // the order declared in shader_oit_resolve_moments[_ibl].
241
- const view_bind_entries = use_brick4
242
- ? [
243
- { buffer: view_ctx.camera.buffer.buffer },
244
- { buffer: view_ctx.uniform_buffer.buffer },
245
- t_moments.obtainView(),
246
- t_optical_depth.obtainView(),
247
- { buffer: view_ctx.scene.volumetric_light_map.buffer },
248
- t_split_sum_lut.obtainView(),
249
- sampler_linear,
250
- // volumetrics
251
- { buffer: volumetrics_metadata },
252
- t_volumetrics_lut.obtainView(),
253
- stbn_vec3.obtainView(),
254
- ]
255
- : [
256
- { buffer: view_ctx.camera.buffer.buffer },
257
- { buffer: view_ctx.uniform_buffer.buffer },
258
- t_moments.obtainView(),
259
- t_optical_depth.obtainView(),
260
- t_split_sum_lut.obtainView(),
261
- sampler_linear,
262
- // volumetrics
263
- { buffer: volumetrics_metadata },
264
- t_volumetrics_lut.obtainView(),
265
- stbn_vec3.obtainView(),
266
- ];
267
-
268
- const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
269
- render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_VIEW],
270
- view_bind_entries
271
- ));
272
-
273
- pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_VIEW, view_bindings);
274
-
275
- material_draw(
276
- scene_ctx.materials,
277
- material_count,
278
- materials,
279
- render_pass_descriptor,
280
- bind_manager,
281
- pass_encoder,
282
- command_buffer_draw
283
- );
284
-
285
- pass_encoder.end();
286
-
287
- }
288
-
289
- const pass_data = {
290
- indirect_lighting_mode,
291
- };
292
- const pass = graph.add("MBOIT/resolve moments", pass_data, execute);
293
-
294
- pass_data.draw_commands = pass.read(draw_commands);
295
- pass_data.meshlets = pass.read(meshlets)
296
-
297
- pass_data.depth = pass.read(depth_texture);
298
-
299
- pass_data.optical_depth = pass.read(texture_optical_depth);
300
- pass_data.moments = pass.read(texture_moments);
301
-
302
- if (output !== -1) {
303
- pass.read(output);
304
- pass_data.resolved = pass.write(output);
305
- } else {
306
- pass_data.resolved = pass.create("OIT resolved", TextureResourceDescriptor.from({
307
- resolution: view_ctx.resolution,
308
- format: 'rgba16float',
309
- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING
310
- }));
311
- }
312
-
313
- pass_data.light_cluster_parameters = pass.read(light_cluster_parameters);
314
- pass_data.light_cluster_lookup = pass.read(light_cluster_lookup);
315
- pass_data.light_cluster_data = pass.read(light_cluster_data);
316
-
317
- pass_data.shadowmap_atlas = pass.read(shadowmap_atlas);
318
-
319
- pass_data.volumetrics_lut = pass.read(volumetrics_lut);
320
- pass_data.volumetrics_metadata = pass.read(volumetrics_metadata);
321
-
322
- return pass_data.resolved;
323
- }
324
-
325
- /**
326
- *
327
- * @param {FrameGraph} graph
328
- * @param {GPUViewContext} view_ctx
329
- * @param {number} material_count
330
- * @param {ShadeMaterial[]} materials
331
- * @param {number} draw_commands resource ID
332
- * @param {number} meshlets resource ID
333
- * @param {number} depth_texture resource ID
334
- * @param {number} [output_optical_depth]
335
- * @param {number} [output_moments]
336
- * @param {PrimitiveState} primitive
337
- * @param {boolean} [clear_targets]
338
- * @return {{optical_depth:number, moments:number}}
339
- */
340
- function graph_oit_generate_moments({
341
- graph,
342
- view_ctx,
343
- material_count,
344
- materials,
345
- draw_commands,
346
- meshlets,
347
- depth_texture ,
348
- output_optical_depth = -1,
349
- output_moments = -1,
350
- primitive,
351
- clear_targets = true,
352
- }) {
353
-
354
- assert.isNonNegativeInteger(material_count, 'material_count');
355
- assert.isNonNegativeInteger(draw_commands, 'draw_commands');
356
- assert.isNonNegativeInteger(meshlets, 'meshlets');
357
- assert.equal(view_ctx.isGPUViewContext, true, 'view_ctx.isGPUViewContext !== true');
358
-
359
-
360
- const scene_ctx = view_ctx.scene;
361
-
362
- /**
363
- *
364
- * @param data
365
- * @param {FramePassResources} resources
366
- * @param {GraphicsExecutionContext} context
367
- */
368
- function execute(data, resources, context) {
369
-
370
- assert.ok(context.graphics.device.features.has("indirect-first-instance"), '"indirect-first-instance" feature needs to be enabled for non-zero firstInstance values to be used.')
371
-
372
-
373
- const command_buffer_draw = resources.get(data.draw_commands);
374
- const meshlet_buffer = resources.get(data.meshlets);
375
-
376
- const t_moments = resources.get(data.moments);
377
- const t_optical_depth = resources.get(data.optical_depth);
378
- const t_depth = resources.get(data.depth);
379
-
380
- const encoder = context.encoder;
381
-
382
- const graphics = context.graphics;
383
-
384
- const bind_manager = graphics.bind_groups;
385
-
386
- const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
387
- BIND_GROUP_LAYOUT_SCENE,
388
- [
389
- { buffer: meshlet_buffer },
390
- { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
391
- { buffer: scene_ctx.geometries.meshlets.buffer_data },
392
- { buffer: scene_ctx.scene_database_buffer },
393
- { buffer: scene_ctx.geometries.buffer_metadata },
394
- ]
395
- ));
396
-
397
- const render_pass_descriptor = shader_oit_generate_moments;
398
- const pass_encoder = encoder.beginRenderPass(render_pass_descriptor.toGPU({
399
- colorTargets: [
400
- t_optical_depth,
401
- t_moments,
402
- ],
403
- depthTarget: t_depth,
404
- colorLoadOp: clear_targets ? "clear" : "load",
405
- // we don't modify depth, only use it for depth test
406
- depthLoadOp: "load",
407
- storeOp: "store",
408
- }));
409
-
410
- const pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitive);
411
-
412
- const pipeline = graphics.render_pipelines.obtain(pipeline_descriptor)
413
- pass_encoder.setPipeline(pipeline);
414
-
415
- pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_SCENE, scene_bindings);
416
-
417
- const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
418
- render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_VIEW],
419
- [
420
- { buffer: view_ctx.camera.buffer.buffer },
421
- { buffer: view_ctx.uniform_buffer.buffer },
422
- ]
423
- ));
424
-
425
- pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_VIEW, view_bindings);
426
-
427
- material_draw(
428
- scene_ctx.materials,
429
- material_count,
430
- materials,
431
- render_pass_descriptor,
432
- bind_manager,
433
- pass_encoder,
434
- command_buffer_draw
435
- );
436
-
437
- pass_encoder.end();
438
-
439
- }
440
-
441
- const pass_data = {};
442
- const pass = graph.add("MBOIT/generate moments", pass_data, execute);
443
-
444
- pass_data.draw_commands = pass.read(draw_commands);
445
- pass_data.meshlets = pass.read(meshlets)
446
-
447
- pass_data.depth = pass.read(depth_texture);
448
-
449
- if (output_optical_depth !== -1) {
450
- pass.read(output_optical_depth);
451
- pass_data.optical_depth = pass.write(output_optical_depth);
452
- } else {
453
- pass_data.optical_depth = pass.create("OIT depth", TextureResourceDescriptor.from({
454
- resolution: view_ctx.resolution,
455
- format: 'r32float',
456
- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING
457
- }));
458
- }
459
-
460
- if (output_moments !== -1) {
461
- pass.read(output_moments);
462
- pass_data.moments = pass.write(output_moments);
463
- } else {
464
-
465
- pass_data.moments = pass.create('OIT moments', TextureResourceDescriptor.from({
466
- resolution: view_ctx.resolution,
467
- format: 'rgba32float',
468
- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING
469
- }));
470
- }
471
-
472
- return {
473
- optical_depth: pass_data.optical_depth,
474
- moments: pass_data.moments
475
- }
476
- }
477
-
478
- /**
479
- * Order-independent transparency. Does not write depth.
480
- *
481
- * @param {FrameGraph} graph
482
- * @param {number} buckets
483
- * @param {GPUViewContext} view_ctx
484
- * @param {number[]} viewport
485
- * @param {number} color_texture resource ID
486
- * @param {number} [depth_texture] resource ID
487
- * @param {GPUCollectionLimits} limits
488
- * @param {number} light_cluster_parameters
489
- * @param {number} light_cluster_lookup
490
- * @param {number} light_cluster_data
491
- * @param {number} shadowmap_atlas
492
- * @param {ShadeIndirectLightingMode} indirect_lighting_mode
493
- * @returns {number} resource ID of modified color texture
494
- */
495
- export function graph_rasterize_meshes_transparent_oit({
496
- graph,
497
- buckets,
498
- view_ctx,
499
- viewport,
500
- depth_texture ,
501
- color_texture,
502
- limits,
503
- light_cluster_parameters ,
504
- light_cluster_lookup ,
505
- light_cluster_data ,
506
-
507
- shadowmap_atlas ,
508
-
509
- volumetrics_lut,
510
- volumetrics_metadata,
511
-
512
- indirect_lighting_mode = ShadeIndirectLightingMode.IBL,
513
- }) {
514
-
515
-
516
- assert.isNonNegativeInteger(buckets, 'buckets');
517
-
518
- assert.isNonNegativeInteger(light_cluster_parameters, 'light_cluster_parameters');
519
- assert.isNonNegativeInteger(light_cluster_lookup, 'light_cluster_lookup');
520
- assert.isNonNegativeInteger(light_cluster_data, 'light_cluster_data');
521
-
522
- assert.isNonNegativeInteger(shadowmap_atlas, 'shadowmap_atlas');
523
-
524
-
525
- assert.equal(view_ctx.isGPUViewContext, true, 'view_ctx.isGPUViewContext !== true');
526
-
527
- const scene_ctx = view_ctx.scene;
528
-
529
- /**
530
- *
531
- * @type {ShadeMaterial[]}
532
- */
533
- const materials_front = [];
534
- /**
535
- *
536
- * @type {ShadeMaterial[]}
537
- */
538
- const materials_double = [];
539
-
540
- const scene_materials = scene_ctx.scene.instances.materials;
541
-
542
- // we need to draw with different pipeline states, so the code is a little convoluted
543
- // Essentially, we draw Double-side and Front-sided materials
544
-
545
- const material_count_front = filter_materials_by_bucket(
546
- materials_front, 0,
547
- TransparencyMode.Transparent,
548
- ShadeDrawMode.Triangles,
549
- ShadeDrawSide.Front,
550
- scene_materials,
551
- scene_materials.length
552
- );
553
-
554
- const material_count_double = filter_materials_by_bucket(
555
- materials_double, 0,
556
- TransparencyMode.Transparent,
557
- ShadeDrawMode.Triangles,
558
- ShadeDrawSide.Double,
559
- scene_materials,
560
- scene_materials.length
561
- );
562
-
563
- if ((material_count_front + material_count_double) === 0) {
564
- // nothing to do
565
- return color_texture;
566
- }
567
-
568
- // TODO prepare depth bounds (min-max) for better moments, using meshlet metadata that has survived the cull
569
- // tight bounds will help improve reconstruction accuracy according to the original paper
570
-
571
- const bucket_index_front = rasterization_material_bucket(
572
- TransparencyMode.Transparent, ShadeDrawMode.Triangles, ShadeDrawSide.Front
573
- );
574
-
575
- const bucket_index_double = rasterization_material_bucket(
576
- TransparencyMode.Transparent, ShadeDrawMode.Triangles, ShadeDrawSide.Double
577
- );
578
-
579
- const primitive_front = construct_primitive_state(
580
- ShadeDrawMode.Triangles, ShadeDrawSide.Front,
581
- );
582
- const primitive_double = construct_primitive_state(
583
- ShadeDrawMode.Triangles, ShadeDrawSide.Double,
584
- );
585
-
586
- const gr_hzb = graph_import_texture(graph, view_ctx.hierarchical_z_buffer.texture);
587
- const gr_camera = graph_import_buffer(graph, view_ctx.camera.buffer.buffer);
588
-
589
- // Prepare draw artifacts
590
- // ======
591
-
592
- const {
593
- meshlets: meshlets_front,
594
- draw_commands: draw_commands_front
595
- } = graph_prepare_meshlet_draw_commands_by_material({
596
- graph,
597
- materials: materials_front,
598
- bucket_id: bucket_index_front,
599
- limits,
600
- buckets,
601
- scene: scene_ctx,
602
- camera: gr_camera,
603
- hzb: gr_hzb,
604
- resolution: [viewport[2], viewport[3]],
605
- label: `${view_ctx.label}/OIT-front`,
606
- });
607
-
608
- const {
609
- meshlets: meshlets_double,
610
- draw_commands: draw_commands_double
611
- } = graph_prepare_meshlet_draw_commands_by_material({
612
- graph,
613
- materials: materials_double,
614
- bucket_id: bucket_index_double,
615
- limits,
616
- buckets,
617
- scene: scene_ctx,
618
- camera: gr_camera,
619
- hzb: gr_hzb,
620
- resolution: [viewport[2], viewport[3]],
621
- label: `${view_ctx.label}/OIT-double`,
622
- });
623
-
624
- // Generate moments
625
- // ==========
626
-
627
- const { moments: moments_front, optical_depth: optical_depth_front } = graph_oit_generate_moments({
628
- graph,
629
- view_ctx,
630
- material_count: material_count_front,
631
- meshlets: meshlets_front,
632
- clear_targets: true,
633
- materials: materials_front,
634
- draw_commands: draw_commands_front,
635
- depth_texture,
636
- primitive: primitive_front,
637
- });
638
-
639
- const { moments, optical_depth } = graph_oit_generate_moments({
640
- graph,
641
- view_ctx,
642
- material_count: material_count_double,
643
- meshlets: meshlets_double,
644
- clear_targets: false,
645
- materials: materials_double,
646
- draw_commands: draw_commands_double,
647
- output_optical_depth: optical_depth_front,
648
- output_moments: moments_front,
649
- depth_texture,
650
- primitive: primitive_double,
651
- });
652
-
653
- // Resolve moments
654
- // ===========
655
-
656
- let resolved = graph_oit_resolve_moments({
657
- graph,
658
- view_ctx,
659
- primitive: primitive_front,
660
- material_count: material_count_front,
661
- materials: materials_front,
662
- clear_targets: true,
663
- draw_commands: draw_commands_front,
664
- meshlets: meshlets_front,
665
- depth_texture,
666
- texture_moments: moments,
667
- texture_optical_depth: optical_depth,
668
-
669
- //
670
- light_cluster_parameters,
671
- light_cluster_lookup,
672
- light_cluster_data,
673
-
674
- shadowmap_atlas,
675
-
676
- volumetrics_lut,
677
- volumetrics_metadata,
678
-
679
- indirect_lighting_mode,
680
- });
681
-
682
- resolved = graph_oit_resolve_moments({
683
- graph,
684
- view_ctx,
685
- primitive: primitive_double,
686
- output: resolved,
687
- material_count: material_count_double,
688
- materials: materials_double,
689
- clear_targets: false,
690
- draw_commands: draw_commands_double,
691
- meshlets: meshlets_double,
692
- depth_texture,
693
- texture_moments: moments,
694
- texture_optical_depth: optical_depth,
695
-
696
- //
697
- light_cluster_parameters,
698
- light_cluster_lookup,
699
- light_cluster_data,
700
-
701
- shadowmap_atlas,
702
-
703
- volumetrics_lut,
704
- volumetrics_metadata,
705
-
706
- indirect_lighting_mode,
707
- });
708
-
709
- const [blended] = graph_image_pass({
710
- graph,
711
- shader: shader_oit_blend,
712
- output: [color_texture],
713
- load_op: "load",
714
- store_op: "store",
715
- inputs: {
716
- transparent: resolved,
717
- moment_zero: optical_depth,
718
- }
719
- });
720
-
721
-
722
- return blended;
1
+ import { assert } from "../../../../../core/assert.js";
2
+ import { SamplerDescriptor } from "../../../../descriptor/texture/SamplerDescriptor.js";
3
+ import { TextureResourceDescriptor } from "../../../../device/graph/TextureResourceDescriptor.js";
4
+ import { rp_rewrite_for_primitive_state } from "../../../../device/pipeline/rp_rewrite_for_primitive_state.js";
5
+ import { BindGroupDescriptor } from "../../../binding/BindGroupDescriptor.js";
6
+ import { SHADING_LIGHT_RESOURCE_GROUP } from "../../../deferred/SHADING_LIGHT_RESOURCE_GROUP.js";
7
+ import { ShadeDrawMode } from "../../../material/ShadeDrawMode.js";
8
+ import { ShadeDrawSide } from "../../../material/ShadeDrawSide.js";
9
+ import { TransparencyMode } from "../../../material/TransparencyMode.js";
10
+ import { ShadeIndirectLightingMode } from "../../../ShadeIndirectLightingMode.js";
11
+ import { graph_image_pass } from "../../../shader/graph/graph_image_pass.js";
12
+ import { graph_import_buffer } from "../../../shader/graph/graph_import_buffer.js";
13
+ import { graph_import_texture } from "../../../shader/graph/graph_import_texture.js";
14
+ import {
15
+ SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR
16
+ } from "../../../shadow/map/SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR.js";
17
+ import { STATIC_GRAPHICS_ENGINE_ASSETS } from "../../../STATIC_GRAPHICS_ENGINE_ASSETS.js";
18
+ import { rasterization_material_bucket } from "../../expand/bucket/chunk_rasterization_material_bucket.js";
19
+ import { construct_primitive_state } from "../../bucket/construct_primitive_state.js";
20
+ import { filter_materials_by_bucket } from "../../bucket/filter_materials_by_bucket.js";
21
+ import {
22
+ graph_prepare_meshlet_draw_commands_by_material
23
+ } from "../../bucket/prepare_meshlet_draw_commands_by_material.js";
24
+ import {
25
+ RASTERIZATION_SHADER_BIND_GROUP_SCENE,
26
+ RASTERIZATION_SHADER_BIND_GROUP_VIEW
27
+ } from "../alpha_tested_pass_resources.js";
28
+ import { material_draw_indirect } from "../material_draw_indirect.js";
29
+ import { shader_oit_blend } from "./shader_oit_blend.js";
30
+ import { shader_oit_generate_moments } from "./shader_oit_generate_moments.js";
31
+ import { shader_oit_resolve_moments } from "./shader_oit_resolve_moments.js";
32
+ import { shader_oit_resolve_moments_ibl } from "./shader_oit_resolve_moments_ibl.js";
33
+ import { SHADING_SCENE_RESOURCE_GROUP } from "../../forward/SHADING_SCENE_RESOURCE_GROUP.js";
34
+
35
+ const BIND_GROUP_LAYOUT_SCENE = SHADING_SCENE_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
36
+ const BIND_GROUP_LAYOUT_LIGHT = SHADING_LIGHT_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
37
+
38
+ /**
39
+ *
40
+ * @param {FrameGraph} graph
41
+ * @param {GPUViewContext} view_ctx
42
+ * @param {number} material_count
43
+ * @param {ShadeMaterial[]} materials
44
+ * @param {boolean} [clear_targets]
45
+ * @param {number} texture_moments
46
+ * @param {number} texture_optical_depth
47
+ * @param {number} draw_commands
48
+ * @param {number} meshlets
49
+ * @param {number} depth_texture
50
+ * @param {number} light_cluster_parameters
51
+ * @param {number} light_cluster_lookup
52
+ * @param {number} light_cluster_data
53
+ * @param {number} shadowmap_atlas
54
+ * @param {number} output
55
+ * @param {PrimitiveState} primitive
56
+ * @param {ShadeIndirectLightingMode} indirect_lighting_mode
57
+ * @return {number}
58
+ */
59
+ function graph_oit_resolve_moments({
60
+ graph,
61
+ view_ctx,
62
+ material_count,
63
+ materials,
64
+ clear_targets = true,
65
+ texture_moments,
66
+ texture_optical_depth,
67
+ draw_commands,
68
+ meshlets,
69
+ depth_texture ,
70
+ primitive,
71
+ light_cluster_parameters ,
72
+ light_cluster_lookup ,
73
+ light_cluster_data ,
74
+
75
+ shadowmap_atlas ,
76
+
77
+ volumetrics_lut,
78
+ volumetrics_metadata,
79
+
80
+ output = -1,
81
+ indirect_lighting_mode = ShadeIndirectLightingMode.IBL,
82
+ }) {
83
+
84
+ assert.isNonNegativeInteger(material_count, 'material_count');
85
+ assert.isNonNegativeInteger(draw_commands, 'draw_commands');
86
+ assert.isNonNegativeInteger(meshlets, 'meshlets');
87
+
88
+ const scene_ctx = view_ctx.scene;
89
+
90
+ /**
91
+ *
92
+ * @param data
93
+ * @param {FramePassResources} resources
94
+ * @param {GraphicsExecutionContext} context
95
+ */
96
+ function execute(data, resources, context) {
97
+
98
+ assert.ok(context.graphics.device.features.has("indirect-first-instance"), '"indirect-first-instance" feature needs to be enabled for non-zero firstInstance values to be used.')
99
+
100
+ const command_buffer_draw = resources.get(data.draw_commands);
101
+ const meshlet_buffer = resources.get(data.meshlets);
102
+
103
+ const t_moments = resources.get(data.moments);
104
+ const t_optical_depth = resources.get(data.optical_depth);
105
+ const t_resolved = resources.get(data.resolved);
106
+ const t_depth = resources.get(data.depth);
107
+
108
+ const light_cluster_parameters = resources.get(data.light_cluster_parameters);
109
+ const light_cluster_lookup = resources.get(data.light_cluster_lookup);
110
+ const light_cluster_data = resources.get(data.light_cluster_data);
111
+
112
+ const shadowmap_atlas = resources.get(data.shadowmap_atlas);
113
+
114
+ const t_volumetrics_lut = resources.get(data.volumetrics_lut);
115
+ const volumetrics_metadata = resources.get(data.volumetrics_metadata);
116
+
117
+ const encoder = context.encoder;
118
+
119
+ const graphics = context.graphics;
120
+
121
+ const bind_manager = graphics.bind_groups;
122
+
123
+ const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
124
+ BIND_GROUP_LAYOUT_SCENE,
125
+ [
126
+ { buffer: meshlet_buffer },
127
+ { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
128
+ { buffer: scene_ctx.geometries.meshlets.buffer_data },
129
+ { buffer: scene_ctx.scene_database_buffer },
130
+ { buffer: scene_ctx.geometries.buffer_metadata },
131
+ ]
132
+ ));
133
+
134
+ const sampler_shadowmap = context.graphics.samplers.obtain(SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR);
135
+
136
+ const light_bindings = bind_manager.obtain(BindGroupDescriptor.from(
137
+ BIND_GROUP_LAYOUT_LIGHT,
138
+ [
139
+ { buffer: view_ctx.scene.lights.buffer_data },
140
+ view_ctx.scene.lights.environment.obtainView(),
141
+ //
142
+ { buffer: light_cluster_parameters },
143
+ { buffer: light_cluster_lookup },
144
+ { buffer: light_cluster_data },
145
+ //
146
+ shadowmap_atlas.obtainView(),
147
+ sampler_shadowmap,
148
+ ]
149
+ ));
150
+
151
+ // Select render pass descriptor based on indirect lighting mode
152
+ const use_brick4 = data.indirect_lighting_mode === ShadeIndirectLightingMode.Brick4;
153
+ const render_pass_descriptor = use_brick4
154
+ ? shader_oit_resolve_moments
155
+ : shader_oit_resolve_moments_ibl;
156
+
157
+ const pass_encoder = encoder.beginRenderPass(render_pass_descriptor.toGPU({
158
+ colorTargets: [t_resolved],
159
+ depthTarget: t_depth,
160
+ colorLoadOp: clear_targets ? "clear" : "load",
161
+ depthLoadOp: "load",
162
+ storeOp: "store",
163
+ }));
164
+
165
+ const pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitive);
166
+
167
+ const pipeline = graphics.render_pipelines.obtain(pipeline_descriptor)
168
+ pass_encoder.setPipeline(pipeline);
169
+
170
+ pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_SCENE, scene_bindings);
171
+ pass_encoder.setBindGroup(3, light_bindings);
172
+
173
+ const sampler_linear = graphics.samplers.obtain(SamplerDescriptor.from({
174
+ magFilter: "linear",
175
+ }));
176
+
177
+ const t_split_sum_lut = graphics.textures.obtain(STATIC_GRAPHICS_ENGINE_ASSETS.split_sum);
178
+
179
+ const stbn_vec3 = graphics.textures.obtain(STATIC_GRAPHICS_ENGINE_ASSETS.stbn_vec3);
180
+
181
+ // Brick4 variant requires brick4 buffer in the view bind group;
182
+ // IBL variant does not. Volumetrics bindings are appended last (after sLinear), matching
183
+ // the order declared in shader_oit_resolve_moments[_ibl].
184
+ const view_bind_entries = use_brick4
185
+ ? [
186
+ { buffer: view_ctx.camera.buffer.buffer },
187
+ { buffer: view_ctx.uniform_buffer.buffer },
188
+ t_moments.obtainView(),
189
+ t_optical_depth.obtainView(),
190
+ { buffer: view_ctx.scene.volumetric_light_map.buffer },
191
+ t_split_sum_lut.obtainView(),
192
+ sampler_linear,
193
+ // volumetrics
194
+ { buffer: volumetrics_metadata },
195
+ t_volumetrics_lut.obtainView(),
196
+ stbn_vec3.obtainView(),
197
+ ]
198
+ : [
199
+ { buffer: view_ctx.camera.buffer.buffer },
200
+ { buffer: view_ctx.uniform_buffer.buffer },
201
+ t_moments.obtainView(),
202
+ t_optical_depth.obtainView(),
203
+ t_split_sum_lut.obtainView(),
204
+ sampler_linear,
205
+ // volumetrics
206
+ { buffer: volumetrics_metadata },
207
+ t_volumetrics_lut.obtainView(),
208
+ stbn_vec3.obtainView(),
209
+ ];
210
+
211
+ const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
212
+ render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_VIEW],
213
+ view_bind_entries
214
+ ));
215
+
216
+ pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_VIEW, view_bindings);
217
+
218
+ material_draw_indirect(
219
+ scene_ctx.materials,
220
+ material_count,
221
+ materials,
222
+ render_pass_descriptor,
223
+ bind_manager,
224
+ pass_encoder,
225
+ command_buffer_draw
226
+ );
227
+
228
+ pass_encoder.end();
229
+
230
+ }
231
+
232
+ const pass_data = {
233
+ indirect_lighting_mode,
234
+ };
235
+ const pass = graph.add("MBOIT/resolve moments", pass_data, execute);
236
+
237
+ pass_data.draw_commands = pass.read(draw_commands);
238
+ pass_data.meshlets = pass.read(meshlets)
239
+
240
+ pass_data.depth = pass.read(depth_texture);
241
+
242
+ pass_data.optical_depth = pass.read(texture_optical_depth);
243
+ pass_data.moments = pass.read(texture_moments);
244
+
245
+ if (output !== -1) {
246
+ pass.read(output);
247
+ pass_data.resolved = pass.write(output);
248
+ } else {
249
+ pass_data.resolved = pass.create("OIT resolved", TextureResourceDescriptor.from({
250
+ resolution: view_ctx.resolution,
251
+ format: 'rgba16float',
252
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING
253
+ }));
254
+ }
255
+
256
+ pass_data.light_cluster_parameters = pass.read(light_cluster_parameters);
257
+ pass_data.light_cluster_lookup = pass.read(light_cluster_lookup);
258
+ pass_data.light_cluster_data = pass.read(light_cluster_data);
259
+
260
+ pass_data.shadowmap_atlas = pass.read(shadowmap_atlas);
261
+
262
+ pass_data.volumetrics_lut = pass.read(volumetrics_lut);
263
+ pass_data.volumetrics_metadata = pass.read(volumetrics_metadata);
264
+
265
+ return pass_data.resolved;
266
+ }
267
+
268
+ /**
269
+ *
270
+ * @param {FrameGraph} graph
271
+ * @param {GPUViewContext} view_ctx
272
+ * @param {number} material_count
273
+ * @param {ShadeMaterial[]} materials
274
+ * @param {number} draw_commands resource ID
275
+ * @param {number} meshlets resource ID
276
+ * @param {number} depth_texture resource ID
277
+ * @param {number} [output_optical_depth]
278
+ * @param {number} [output_moments]
279
+ * @param {PrimitiveState} primitive
280
+ * @param {boolean} [clear_targets]
281
+ * @return {{optical_depth:number, moments:number}}
282
+ */
283
+ function graph_oit_generate_moments({
284
+ graph,
285
+ view_ctx,
286
+ material_count,
287
+ materials,
288
+ draw_commands,
289
+ meshlets,
290
+ depth_texture ,
291
+ output_optical_depth = -1,
292
+ output_moments = -1,
293
+ primitive,
294
+ clear_targets = true,
295
+ }) {
296
+
297
+ assert.isNonNegativeInteger(material_count, 'material_count');
298
+ assert.isNonNegativeInteger(draw_commands, 'draw_commands');
299
+ assert.isNonNegativeInteger(meshlets, 'meshlets');
300
+ assert.equal(view_ctx.isGPUViewContext, true, 'view_ctx.isGPUViewContext !== true');
301
+
302
+
303
+ const scene_ctx = view_ctx.scene;
304
+
305
+ /**
306
+ *
307
+ * @param data
308
+ * @param {FramePassResources} resources
309
+ * @param {GraphicsExecutionContext} context
310
+ */
311
+ function execute(data, resources, context) {
312
+
313
+ assert.ok(context.graphics.device.features.has("indirect-first-instance"), '"indirect-first-instance" feature needs to be enabled for non-zero firstInstance values to be used.')
314
+
315
+
316
+ const command_buffer_draw = resources.get(data.draw_commands);
317
+ const meshlet_buffer = resources.get(data.meshlets);
318
+
319
+ const t_moments = resources.get(data.moments);
320
+ const t_optical_depth = resources.get(data.optical_depth);
321
+ const t_depth = resources.get(data.depth);
322
+
323
+ const encoder = context.encoder;
324
+
325
+ const graphics = context.graphics;
326
+
327
+ const bind_manager = graphics.bind_groups;
328
+
329
+ const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
330
+ BIND_GROUP_LAYOUT_SCENE,
331
+ [
332
+ { buffer: meshlet_buffer },
333
+ { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
334
+ { buffer: scene_ctx.geometries.meshlets.buffer_data },
335
+ { buffer: scene_ctx.scene_database_buffer },
336
+ { buffer: scene_ctx.geometries.buffer_metadata },
337
+ ]
338
+ ));
339
+
340
+ const render_pass_descriptor = shader_oit_generate_moments;
341
+ const pass_encoder = encoder.beginRenderPass(render_pass_descriptor.toGPU({
342
+ colorTargets: [
343
+ t_optical_depth,
344
+ t_moments,
345
+ ],
346
+ depthTarget: t_depth,
347
+ colorLoadOp: clear_targets ? "clear" : "load",
348
+ // we don't modify depth, only use it for depth test
349
+ depthLoadOp: "load",
350
+ storeOp: "store",
351
+ }));
352
+
353
+ const pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitive);
354
+
355
+ const pipeline = graphics.render_pipelines.obtain(pipeline_descriptor)
356
+ pass_encoder.setPipeline(pipeline);
357
+
358
+ pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_SCENE, scene_bindings);
359
+
360
+ const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
361
+ render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_VIEW],
362
+ [
363
+ { buffer: view_ctx.camera.buffer.buffer },
364
+ { buffer: view_ctx.uniform_buffer.buffer },
365
+ ]
366
+ ));
367
+
368
+ pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_VIEW, view_bindings);
369
+
370
+ material_draw_indirect(
371
+ scene_ctx.materials,
372
+ material_count,
373
+ materials,
374
+ render_pass_descriptor,
375
+ bind_manager,
376
+ pass_encoder,
377
+ command_buffer_draw
378
+ );
379
+
380
+ pass_encoder.end();
381
+
382
+ }
383
+
384
+ const pass_data = {};
385
+ const pass = graph.add("MBOIT/generate moments", pass_data, execute);
386
+
387
+ pass_data.draw_commands = pass.read(draw_commands);
388
+ pass_data.meshlets = pass.read(meshlets)
389
+
390
+ pass_data.depth = pass.read(depth_texture);
391
+
392
+ if (output_optical_depth !== -1) {
393
+ pass.read(output_optical_depth);
394
+ pass_data.optical_depth = pass.write(output_optical_depth);
395
+ } else {
396
+ pass_data.optical_depth = pass.create("OIT depth", TextureResourceDescriptor.from({
397
+ resolution: view_ctx.resolution,
398
+ format: 'r32float',
399
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING
400
+ }));
401
+ }
402
+
403
+ if (output_moments !== -1) {
404
+ pass.read(output_moments);
405
+ pass_data.moments = pass.write(output_moments);
406
+ } else {
407
+
408
+ pass_data.moments = pass.create('OIT moments', TextureResourceDescriptor.from({
409
+ resolution: view_ctx.resolution,
410
+ format: 'rgba32float',
411
+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING
412
+ }));
413
+ }
414
+
415
+ return {
416
+ optical_depth: pass_data.optical_depth,
417
+ moments: pass_data.moments
418
+ }
419
+ }
420
+
421
+ /**
422
+ * Order-independent transparency. Does not write depth.
423
+ *
424
+ * @param {FrameGraph} graph
425
+ * @param {number} buckets
426
+ * @param {GPUViewContext} view_ctx
427
+ * @param {number[]} viewport
428
+ * @param {number} color_texture resource ID
429
+ * @param {number} [depth_texture] resource ID
430
+ * @param {GPUCollectionLimits} limits
431
+ * @param {number} light_cluster_parameters
432
+ * @param {number} light_cluster_lookup
433
+ * @param {number} light_cluster_data
434
+ * @param {number} shadowmap_atlas
435
+ * @param {ShadeIndirectLightingMode} indirect_lighting_mode
436
+ * @returns {number} resource ID of modified color texture
437
+ */
438
+ export function graph_rasterize_meshes_transparent_oit({
439
+ graph,
440
+ buckets,
441
+ view_ctx,
442
+ viewport,
443
+ depth_texture ,
444
+ color_texture,
445
+ limits,
446
+ light_cluster_parameters ,
447
+ light_cluster_lookup ,
448
+ light_cluster_data ,
449
+
450
+ shadowmap_atlas ,
451
+
452
+ volumetrics_lut,
453
+ volumetrics_metadata,
454
+
455
+ indirect_lighting_mode = ShadeIndirectLightingMode.IBL,
456
+ }) {
457
+
458
+
459
+ assert.isNonNegativeInteger(buckets, 'buckets');
460
+
461
+ assert.isNonNegativeInteger(light_cluster_parameters, 'light_cluster_parameters');
462
+ assert.isNonNegativeInteger(light_cluster_lookup, 'light_cluster_lookup');
463
+ assert.isNonNegativeInteger(light_cluster_data, 'light_cluster_data');
464
+
465
+ assert.isNonNegativeInteger(shadowmap_atlas, 'shadowmap_atlas');
466
+
467
+
468
+ assert.equal(view_ctx.isGPUViewContext, true, 'view_ctx.isGPUViewContext !== true');
469
+
470
+ const scene_ctx = view_ctx.scene;
471
+
472
+ /**
473
+ *
474
+ * @type {ShadeMaterial[]}
475
+ */
476
+ const materials_front = [];
477
+ /**
478
+ *
479
+ * @type {ShadeMaterial[]}
480
+ */
481
+ const materials_double = [];
482
+
483
+ const scene_materials = scene_ctx.scene.instances.materials;
484
+
485
+ // we need to draw with different pipeline states, so the code is a little convoluted
486
+ // Essentially, we draw Double-side and Front-sided materials
487
+
488
+ const material_count_front = filter_materials_by_bucket(
489
+ materials_front, 0,
490
+ TransparencyMode.Transparent,
491
+ ShadeDrawMode.Triangles,
492
+ ShadeDrawSide.Front,
493
+ scene_materials,
494
+ scene_materials.length
495
+ );
496
+
497
+ const material_count_double = filter_materials_by_bucket(
498
+ materials_double, 0,
499
+ TransparencyMode.Transparent,
500
+ ShadeDrawMode.Triangles,
501
+ ShadeDrawSide.Double,
502
+ scene_materials,
503
+ scene_materials.length
504
+ );
505
+
506
+ if ((material_count_front + material_count_double) === 0) {
507
+ // nothing to do
508
+ return color_texture;
509
+ }
510
+
511
+ // TODO prepare depth bounds (min-max) for better moments, using meshlet metadata that has survived the cull
512
+ // tight bounds will help improve reconstruction accuracy according to the original paper
513
+
514
+ const bucket_index_front = rasterization_material_bucket(
515
+ TransparencyMode.Transparent, ShadeDrawMode.Triangles, ShadeDrawSide.Front
516
+ );
517
+
518
+ const bucket_index_double = rasterization_material_bucket(
519
+ TransparencyMode.Transparent, ShadeDrawMode.Triangles, ShadeDrawSide.Double
520
+ );
521
+
522
+ const primitive_front = construct_primitive_state(
523
+ ShadeDrawMode.Triangles, ShadeDrawSide.Front,
524
+ );
525
+ const primitive_double = construct_primitive_state(
526
+ ShadeDrawMode.Triangles, ShadeDrawSide.Double,
527
+ );
528
+
529
+ const gr_hzb = graph_import_texture(graph, view_ctx.hierarchical_z_buffer.texture);
530
+ const gr_camera = graph_import_buffer(graph, view_ctx.camera.buffer.buffer);
531
+
532
+ // Prepare draw artifacts
533
+ // ======
534
+
535
+ const {
536
+ meshlets: meshlets_front,
537
+ draw_commands: draw_commands_front
538
+ } = graph_prepare_meshlet_draw_commands_by_material({
539
+ graph,
540
+ materials: materials_front,
541
+ bucket_id: bucket_index_front,
542
+ limits,
543
+ buckets,
544
+ scene: scene_ctx,
545
+ camera: gr_camera,
546
+ hzb: gr_hzb,
547
+ resolution: [viewport[2], viewport[3]],
548
+ label: `${view_ctx.label}/OIT-front`,
549
+ });
550
+
551
+ const {
552
+ meshlets: meshlets_double,
553
+ draw_commands: draw_commands_double
554
+ } = graph_prepare_meshlet_draw_commands_by_material({
555
+ graph,
556
+ materials: materials_double,
557
+ bucket_id: bucket_index_double,
558
+ limits,
559
+ buckets,
560
+ scene: scene_ctx,
561
+ camera: gr_camera,
562
+ hzb: gr_hzb,
563
+ resolution: [viewport[2], viewport[3]],
564
+ label: `${view_ctx.label}/OIT-double`,
565
+ });
566
+
567
+ // Generate moments
568
+ // ==========
569
+
570
+ const { moments: moments_front, optical_depth: optical_depth_front } = graph_oit_generate_moments({
571
+ graph,
572
+ view_ctx,
573
+ material_count: material_count_front,
574
+ meshlets: meshlets_front,
575
+ clear_targets: true,
576
+ materials: materials_front,
577
+ draw_commands: draw_commands_front,
578
+ depth_texture,
579
+ primitive: primitive_front,
580
+ });
581
+
582
+ const { moments, optical_depth } = graph_oit_generate_moments({
583
+ graph,
584
+ view_ctx,
585
+ material_count: material_count_double,
586
+ meshlets: meshlets_double,
587
+ clear_targets: false,
588
+ materials: materials_double,
589
+ draw_commands: draw_commands_double,
590
+ output_optical_depth: optical_depth_front,
591
+ output_moments: moments_front,
592
+ depth_texture,
593
+ primitive: primitive_double,
594
+ });
595
+
596
+ // Resolve moments
597
+ // ===========
598
+
599
+ let resolved = graph_oit_resolve_moments({
600
+ graph,
601
+ view_ctx,
602
+ primitive: primitive_front,
603
+ material_count: material_count_front,
604
+ materials: materials_front,
605
+ clear_targets: true,
606
+ draw_commands: draw_commands_front,
607
+ meshlets: meshlets_front,
608
+ depth_texture,
609
+ texture_moments: moments,
610
+ texture_optical_depth: optical_depth,
611
+
612
+ //
613
+ light_cluster_parameters,
614
+ light_cluster_lookup,
615
+ light_cluster_data,
616
+
617
+ shadowmap_atlas,
618
+
619
+ volumetrics_lut,
620
+ volumetrics_metadata,
621
+
622
+ indirect_lighting_mode,
623
+ });
624
+
625
+ resolved = graph_oit_resolve_moments({
626
+ graph,
627
+ view_ctx,
628
+ primitive: primitive_double,
629
+ output: resolved,
630
+ material_count: material_count_double,
631
+ materials: materials_double,
632
+ clear_targets: false,
633
+ draw_commands: draw_commands_double,
634
+ meshlets: meshlets_double,
635
+ depth_texture,
636
+ texture_moments: moments,
637
+ texture_optical_depth: optical_depth,
638
+
639
+ //
640
+ light_cluster_parameters,
641
+ light_cluster_lookup,
642
+ light_cluster_data,
643
+
644
+ shadowmap_atlas,
645
+
646
+ volumetrics_lut,
647
+ volumetrics_metadata,
648
+
649
+ indirect_lighting_mode,
650
+ });
651
+
652
+ const [blended] = graph_image_pass({
653
+ graph,
654
+ shader: shader_oit_blend,
655
+ output: [color_texture],
656
+ load_op: "load",
657
+ store_op: "store",
658
+ inputs: {
659
+ transparent: resolved,
660
+ moment_zero: optical_depth,
661
+ }
662
+ });
663
+
664
+
665
+ return blended;
723
666
  }