@woosh/meep-engine 3.11.3 → 3.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (596) hide show
  1. package/README.md +14 -18
  2. package/editor/SelectionVisualizer.js +127 -127
  3. package/editor/entity_world_bounds.js +27 -27
  4. package/editor/particles/rebuildParticleEmitter.js +31 -31
  5. package/editor/process/SymbolicDisplayProcess.js +1 -1
  6. package/editor/process/symbolic/CameraSymbolicDisplay.js +146 -146
  7. package/editor/process/symbolic/LightSymbolicDisplay.js +172 -172
  8. package/editor/prototypeEditorShell.js +156 -156
  9. package/editor/selection/editor_pick.js +130 -130
  10. package/editor/selection/screen_rect_frustum.js +119 -119
  11. package/editor/tools/v2/TransformControls.js +971 -971
  12. package/package.json +1 -1
  13. package/src/engine/Engine.d.ts +3 -3
  14. package/src/engine/Engine.d.ts.map +1 -1
  15. package/src/engine/Engine.js +726 -726
  16. package/src/engine/EngineHarness.d.ts +1 -1
  17. package/src/engine/EngineHarness.js +590 -590
  18. package/src/engine/ecs/HIERARCHY_REVIEW.md +717 -717
  19. package/src/engine/ecs/terrain/ecs/BuildLightTexture.d.ts +1 -1
  20. package/src/engine/ecs/terrain/ecs/BuildLightTexture.js +27 -27
  21. package/src/engine/ecs/terrain/ecs/Terrain.d.ts +1 -5
  22. package/src/engine/ecs/terrain/ecs/Terrain.d.ts.map +1 -1
  23. package/src/engine/ecs/terrain/ecs/Terrain.js +790 -790
  24. package/src/engine/ecs/terrain/util/loadVisibleTerrainTiles.js +129 -129
  25. package/src/engine/graphics/ecs/camera/camera_find_active.d.ts +1 -1
  26. package/src/engine/graphics/ecs/camera/camera_find_active.js +28 -28
  27. package/src/engine/graphics/ecs/mesh-v2/ShadedGeometry.d.ts +1 -1
  28. package/src/engine/graphics/ecs/mesh-v2/ShadedGeometry.js +428 -428
  29. package/src/engine/graphics/ecs/water/Water.d.ts +1 -1
  30. package/src/engine/graphics/ecs/water/Water.js +104 -104
  31. package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.d.ts +1 -1
  32. package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js +1 -1
  33. package/src/engine/graphics3/AnimationGraphSystem.d.ts +65 -0
  34. package/src/engine/graphics3/AnimationGraphSystem.d.ts.map +1 -0
  35. package/src/engine/graphics3/AnimationGraphSystem.js +329 -0
  36. package/src/engine/graphics3/AnimationGraphSystem3.d.ts +6 -61
  37. package/src/engine/graphics3/AnimationGraphSystem3.d.ts.map +1 -1
  38. package/src/engine/graphics3/AnimationGraphSystem3.js +6 -325
  39. package/src/engine/graphics3/AnimationSystem.d.ts +76 -0
  40. package/src/engine/graphics3/AnimationSystem.d.ts.map +1 -0
  41. package/src/engine/graphics3/AnimationSystem.js +352 -0
  42. package/src/engine/graphics3/AnimationSystem3.d.ts +6 -72
  43. package/src/engine/graphics3/AnimationSystem3.d.ts.map +1 -1
  44. package/src/engine/graphics3/AnimationSystem3.js +6 -348
  45. package/src/engine/graphics3/CameraSystem.d.ts +49 -0
  46. package/src/engine/graphics3/CameraSystem.d.ts.map +1 -0
  47. package/src/engine/graphics3/CameraSystem.js +170 -0
  48. package/src/engine/graphics3/CameraSystem3.d.ts +6 -45
  49. package/src/engine/graphics3/CameraSystem3.d.ts.map +1 -1
  50. package/src/engine/graphics3/CameraSystem3.js +6 -166
  51. package/src/engine/graphics3/DebugDrawSystem.d.ts +72 -0
  52. package/src/engine/graphics3/DebugDrawSystem.d.ts.map +1 -0
  53. package/src/engine/graphics3/DebugDrawSystem.js +205 -0
  54. package/src/engine/graphics3/DebugDrawSystem3.d.ts +6 -68
  55. package/src/engine/graphics3/DebugDrawSystem3.d.ts.map +1 -1
  56. package/src/engine/graphics3/DebugDrawSystem3.js +6 -201
  57. package/src/engine/graphics3/DecalSystem.d.ts +81 -0
  58. package/src/engine/graphics3/DecalSystem.d.ts.map +1 -0
  59. package/src/engine/graphics3/DecalSystem.js +441 -0
  60. package/src/engine/graphics3/DecalSystem3.d.ts +6 -77
  61. package/src/engine/graphics3/DecalSystem3.d.ts.map +1 -1
  62. package/src/engine/graphics3/DecalSystem3.js +6 -437
  63. package/src/engine/graphics3/FogOfWarSystem.d.ts +74 -0
  64. package/src/engine/graphics3/FogOfWarSystem.d.ts.map +1 -0
  65. package/src/engine/graphics3/FogOfWarSystem.js +265 -0
  66. package/src/engine/graphics3/FogOfWarSystem3.d.ts +6 -70
  67. package/src/engine/graphics3/FogOfWarSystem3.d.ts.map +1 -1
  68. package/src/engine/graphics3/FogOfWarSystem3.js +6 -261
  69. package/src/engine/graphics3/GraphicsEngine.d.ts +340 -0
  70. package/src/engine/graphics3/GraphicsEngine.d.ts.map +1 -0
  71. package/src/engine/graphics3/GraphicsEngine.js +790 -0
  72. package/src/engine/graphics3/GraphicsEngine3.d.ts +6 -336
  73. package/src/engine/graphics3/GraphicsEngine3.d.ts.map +1 -1
  74. package/src/engine/graphics3/GraphicsEngine3.js +6 -786
  75. package/src/engine/graphics3/HighlightSystem.d.ts +82 -0
  76. package/src/engine/graphics3/HighlightSystem.d.ts.map +1 -0
  77. package/src/engine/graphics3/HighlightSystem.js +241 -0
  78. package/src/engine/graphics3/HighlightSystem3.d.ts +6 -78
  79. package/src/engine/graphics3/HighlightSystem3.d.ts.map +1 -1
  80. package/src/engine/graphics3/HighlightSystem3.js +6 -237
  81. package/src/engine/graphics3/LightSystem.d.ts +40 -0
  82. package/src/engine/graphics3/LightSystem.d.ts.map +1 -0
  83. package/src/engine/graphics3/LightSystem.js +211 -0
  84. package/src/engine/graphics3/LightSystem3.d.ts +6 -36
  85. package/src/engine/graphics3/LightSystem3.d.ts.map +1 -1
  86. package/src/engine/graphics3/LightSystem3.js +6 -207
  87. package/src/engine/graphics3/MeshSystem.d.ts +106 -0
  88. package/src/engine/graphics3/MeshSystem.d.ts.map +1 -0
  89. package/src/engine/graphics3/MeshSystem.js +647 -0
  90. package/src/engine/graphics3/MeshSystem3.d.ts +6 -102
  91. package/src/engine/graphics3/MeshSystem3.d.ts.map +1 -1
  92. package/src/engine/graphics3/MeshSystem3.js +6 -642
  93. package/src/engine/graphics3/ParticipatingMedia.d.ts +2 -2
  94. package/src/engine/graphics3/ParticipatingMedia.js +203 -203
  95. package/src/engine/graphics3/ParticipatingMediaSystem.d.ts +87 -0
  96. package/src/engine/graphics3/ParticipatingMediaSystem.d.ts.map +1 -0
  97. package/src/engine/graphics3/ParticipatingMediaSystem.js +184 -0
  98. package/src/engine/graphics3/ParticipatingMediaSystem3.d.ts +6 -83
  99. package/src/engine/graphics3/ParticipatingMediaSystem3.d.ts.map +1 -1
  100. package/src/engine/graphics3/ParticipatingMediaSystem3.js +6 -180
  101. package/src/engine/graphics3/ParticleEmitterSystem.d.ts +76 -0
  102. package/src/engine/graphics3/ParticleEmitterSystem.d.ts.map +1 -0
  103. package/src/engine/graphics3/ParticleEmitterSystem.js +289 -0
  104. package/src/engine/graphics3/ParticleEmitterSystem3.d.ts +6 -72
  105. package/src/engine/graphics3/ParticleEmitterSystem3.d.ts.map +1 -1
  106. package/src/engine/graphics3/ParticleEmitterSystem3.js +6 -285
  107. package/src/engine/graphics3/PathDisplaySystem.d.ts +70 -0
  108. package/src/engine/graphics3/PathDisplaySystem.d.ts.map +1 -0
  109. package/src/engine/graphics3/PathDisplaySystem.js +309 -0
  110. package/src/engine/graphics3/PathDisplaySystem3.d.ts +6 -66
  111. package/src/engine/graphics3/PathDisplaySystem3.d.ts.map +1 -1
  112. package/src/engine/graphics3/PathDisplaySystem3.js +6 -305
  113. package/src/engine/graphics3/Pickable.d.ts +1 -1
  114. package/src/engine/graphics3/Pickable.js +65 -65
  115. package/src/engine/graphics3/PickingQuery.d.ts +1 -1
  116. package/src/engine/graphics3/PickingQuery.js +48 -48
  117. package/src/engine/graphics3/PickingSystem.d.ts +67 -0
  118. package/src/engine/graphics3/PickingSystem.d.ts.map +1 -0
  119. package/src/engine/graphics3/PickingSystem.js +273 -0
  120. package/src/engine/graphics3/PickingSystem3.d.ts +6 -63
  121. package/src/engine/graphics3/PickingSystem3.d.ts.map +1 -1
  122. package/src/engine/graphics3/PickingSystem3.js +6 -269
  123. package/src/engine/graphics3/ShadedGeometrySystem.d.ts +47 -0
  124. package/src/engine/graphics3/ShadedGeometrySystem.d.ts.map +1 -0
  125. package/src/engine/graphics3/ShadedGeometrySystem.js +169 -0
  126. package/src/engine/graphics3/ShadedGeometrySystem3.d.ts +6 -43
  127. package/src/engine/graphics3/ShadedGeometrySystem3.d.ts.map +1 -1
  128. package/src/engine/graphics3/ShadedGeometrySystem3.js +6 -165
  129. package/src/engine/graphics3/TerrainSystem.d.ts +80 -0
  130. package/src/engine/graphics3/TerrainSystem.d.ts.map +1 -0
  131. package/src/engine/graphics3/TerrainSystem.js +566 -0
  132. package/src/engine/graphics3/TerrainSystem3.d.ts +6 -76
  133. package/src/engine/graphics3/TerrainSystem3.d.ts.map +1 -1
  134. package/src/engine/graphics3/TerrainSystem3.js +6 -562
  135. package/src/engine/graphics3/TooltipComponentSystem.d.ts +65 -0
  136. package/src/engine/graphics3/TooltipComponentSystem.d.ts.map +1 -0
  137. package/src/engine/graphics3/TooltipComponentSystem.js +328 -0
  138. package/src/engine/graphics3/TooltipComponentSystem3.d.ts +6 -61
  139. package/src/engine/graphics3/TooltipComponentSystem3.d.ts.map +1 -1
  140. package/src/engine/graphics3/TooltipComponentSystem3.js +6 -324
  141. package/src/engine/graphics3/Trail3DSystem.d.ts +73 -0
  142. package/src/engine/graphics3/Trail3DSystem.d.ts.map +1 -0
  143. package/src/engine/graphics3/Trail3DSystem.js +221 -0
  144. package/src/engine/graphics3/Trail3DSystem3.d.ts +6 -69
  145. package/src/engine/graphics3/Trail3DSystem3.d.ts.map +1 -1
  146. package/src/engine/graphics3/Trail3DSystem3.js +6 -217
  147. package/src/engine/graphics3/VolumetricLightMap.d.ts +2 -2
  148. package/src/engine/graphics3/VolumetricLightMap.js +2 -2
  149. package/src/engine/graphics3/VolumetricLightMapSystem.d.ts +98 -0
  150. package/src/engine/graphics3/VolumetricLightMapSystem.d.ts.map +1 -0
  151. package/src/engine/graphics3/VolumetricLightMapSystem.js +261 -0
  152. package/src/engine/graphics3/VolumetricLightMapSystem3.d.ts +6 -94
  153. package/src/engine/graphics3/VolumetricLightMapSystem3.d.ts.map +1 -1
  154. package/src/engine/graphics3/VolumetricLightMapSystem3.js +10 -261
  155. package/src/engine/graphics3/WaterSystem.d.ts +59 -0
  156. package/src/engine/graphics3/WaterSystem.d.ts.map +1 -0
  157. package/src/engine/graphics3/WaterSystem.js +293 -0
  158. package/src/engine/graphics3/WaterSystem3.d.ts +6 -55
  159. package/src/engine/graphics3/WaterSystem3.d.ts.map +1 -1
  160. package/src/engine/graphics3/WaterSystem3.js +6 -289
  161. package/src/engine/graphics3/animation/AnimationGraphController.d.ts +1 -1
  162. package/src/engine/graphics3/animation/AnimationGraphController.js +518 -518
  163. package/src/engine/graphics3/animation/ClipListPlayer.d.ts +1 -1
  164. package/src/engine/graphics3/animation/ClipListPlayer.js +263 -263
  165. package/src/engine/graphics3/animation/ClipPlayback.d.ts +2 -2
  166. package/src/engine/graphics3/animation/ClipPlayback.js +84 -84
  167. package/src/engine/graphics3/decal/GPUDecalRenderer.js +3 -3
  168. package/src/engine/graphics3/decal/graph_build_decal_clusters.d.ts.map +1 -1
  169. package/src/engine/graphics3/decal/graph_build_decal_clusters.js +6 -8
  170. package/src/engine/graphics3/decal/shader_cluster_assign_decals.d.ts +0 -7
  171. package/src/engine/graphics3/decal/shader_cluster_assign_decals.d.ts.map +1 -1
  172. package/src/engine/graphics3/decal/shader_cluster_assign_decals.js +1 -1
  173. package/src/engine/graphics3/decal/shader_cull_decals_frustum.d.ts +0 -4
  174. package/src/engine/graphics3/decal/shader_cull_decals_frustum.d.ts.map +1 -1
  175. package/src/engine/graphics3/decal/shader_cull_decals_frustum.js +1 -1
  176. package/src/engine/graphics3/decal/shader_decal_composite.d.ts.map +1 -1
  177. package/src/engine/graphics3/decal/shader_decal_composite.js +4 -2
  178. package/src/engine/graphics3/highlight/GPUHighlightRenderer.d.ts.map +1 -1
  179. package/src/engine/graphics3/highlight/GPUHighlightRenderer.js +2 -3
  180. package/src/engine/graphics3/highlight/pack_highlight_table.d.ts +2 -2
  181. package/src/engine/graphics3/highlight/pack_highlight_table.d.ts.map +1 -1
  182. package/src/engine/graphics3/highlight/pack_highlight_table.js +74 -74
  183. package/src/engine/graphics3/highlight/shader_highlight_outline.js +150 -150
  184. package/src/engine/graphics3/pose/query_entity_node_world_pose.d.ts +1 -1
  185. package/src/engine/graphics3/pose/query_entity_node_world_pose.js +101 -101
  186. package/src/engine/graphics3/preview/make_model_thumbnail.d.ts +3 -3
  187. package/src/engine/graphics3/preview/make_model_thumbnail.d.ts.map +1 -1
  188. package/src/engine/graphics3/preview/make_model_thumbnail.js +48 -48
  189. package/src/engine/graphics3/shade_camera_projection_ray.d.ts +1 -1
  190. package/src/engine/graphics3/shade_camera_projection_ray.js +77 -77
  191. package/src/engine/graphics3/shade_node_to_entity_composition.d.ts +1 -1
  192. package/src/engine/graphics3/shade_node_to_entity_composition.js +84 -84
  193. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts +4 -4
  194. package/src/shade/RENDERER_CONTRACT.md +2 -1
  195. package/src/shade/descriptor/pipeline/compute/ComputePipelineDescriptor.d.ts +18 -0
  196. package/src/shade/descriptor/pipeline/compute/ComputePipelineDescriptor.d.ts.map +1 -1
  197. package/src/shade/descriptor/pipeline/compute/ComputePipelineDescriptor.js +73 -0
  198. package/src/shade/device/PASS_ENCODER_PROPOSAL_2026_08_31.md +750 -0
  199. package/src/shade/device/ShadeGPUCommandContext.d.ts +10 -16
  200. package/src/shade/device/ShadeGPUCommandContext.d.ts.map +1 -1
  201. package/src/shade/device/ShadeGPUCommandContext.js +801 -994
  202. package/src/shade/device/pass/ShadeGPUComputePassEncoder.d.ts +107 -0
  203. package/src/shade/device/pass/ShadeGPUComputePassEncoder.d.ts.map +1 -0
  204. package/src/shade/device/pass/ShadeGPUComputePassEncoder.js +222 -0
  205. package/src/shade/device/pass/ShadeGPURenderPassEncoder.d.ts +168 -0
  206. package/src/shade/device/pass/ShadeGPURenderPassEncoder.d.ts.map +1 -0
  207. package/src/shade/device/pass/ShadeGPURenderPassEncoder.js +317 -0
  208. package/src/shade/device/timing/GPUTimerArray.d.ts +4 -9
  209. package/src/shade/device/timing/GPUTimerArray.d.ts.map +1 -1
  210. package/src/shade/device/timing/GPUTimerArray.js +261 -289
  211. package/src/shade/device/timing/GPU_PROFILER_PROPOSAL_2026_08_28.md +20 -2
  212. package/src/shade/device/timing/ShadeGPUContextProfiler.d.ts +59 -0
  213. package/src/shade/device/timing/ShadeGPUContextProfiler.d.ts.map +1 -0
  214. package/src/shade/device/timing/ShadeGPUContextProfiler.js +182 -0
  215. package/src/shade/device/timing/profile/GPUProfileSession.d.ts +4 -4
  216. package/src/shade/device/timing/profile/GPUProfileSession.js +4 -4
  217. package/src/shade/playground/skinned_blas_refit/shader_blas_audit_leaf_triangles.d.ts.map +1 -1
  218. package/src/shade/playground/skinned_blas_refit/shader_blas_audit_leaf_triangles.js +3 -2
  219. package/src/shade/playground/skinned_blas_refit/shader_blas_audit_points.d.ts.map +1 -1
  220. package/src/shade/playground/skinned_blas_refit/shader_blas_audit_points.js +3 -2
  221. package/src/shade/playground/skinned_blas_refit/shader_blas_audit_visibility.d.ts.map +1 -1
  222. package/src/shade/playground/skinned_blas_refit/shader_blas_audit_visibility.js +135 -134
  223. package/src/shade/playground/skinned_blas_refit/verify_leaf_triangles.js +202 -202
  224. package/src/shade/playground/skinned_blas_refit/verify_traversal_reachability.js +249 -249
  225. package/src/shade/renderer/Renderer.d.ts +0 -6
  226. package/src/shade/renderer/Renderer.d.ts.map +1 -1
  227. package/src/shade/renderer/Renderer.js +0 -29
  228. package/src/shade/renderer/STATIC_GRAPHICS_ENGINE_ASSETS.js +1 -1
  229. package/src/shade/renderer/animation/GPUAnimationManager.d.ts.map +1 -1
  230. package/src/shade/renderer/animation/GPUAnimationManager.js +1 -3
  231. package/src/shade/renderer/animation/pose/PosePlayback.d.ts +2 -1
  232. package/src/shade/renderer/animation/pose/PosePlayback.d.ts.map +1 -1
  233. package/src/shade/renderer/animation/pose/PosePlayback.js +2 -1
  234. package/src/shade/renderer/animation/shader_animation_apply.d.ts.map +1 -1
  235. package/src/shade/renderer/animation/shader_animation_apply.js +128 -129
  236. package/src/shade/renderer/animation/shader_animation_pose_resolve.d.ts.map +1 -1
  237. package/src/shade/renderer/animation/shader_animation_pose_resolve.js +176 -177
  238. package/src/shade/renderer/animation/shader_animation_tick.d.ts.map +1 -1
  239. package/src/shade/renderer/animation/shader_animation_tick.js +4 -2
  240. package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.d.ts.map +1 -1
  241. package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js +8 -18
  242. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_geometry_sphere_derive.d.ts.map +1 -1
  243. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_geometry_sphere_derive.js +3 -2
  244. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_meshlet_bounds_reduce.d.ts.map +1 -1
  245. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_meshlet_bounds_reduce.js +4 -2
  246. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_meshlet_bounds_scatter.d.ts +1 -1
  247. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_meshlet_bounds_scatter.d.ts.map +1 -1
  248. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_meshlet_bounds_scatter.js +24 -10
  249. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_skinned_mesh_bounds_refresh.d.ts.map +1 -1
  250. package/src/shade/renderer/animation/skinning/bounds_refresh/shader_skinned_mesh_bounds_refresh.js +3 -2
  251. package/src/shade/renderer/animation/skinning/shader_meshlet_apply_skinning.d.ts.map +1 -1
  252. package/src/shade/renderer/animation/skinning/shader_meshlet_apply_skinning.js +5 -2
  253. package/src/shade/renderer/animation/skinning/shader_skin_matrix_prep.d.ts.map +1 -1
  254. package/src/shade/renderer/animation/skinning/shader_skin_matrix_prep.js +104 -105
  255. package/src/shade/renderer/atmosphere/shader_multiscatter_lut.d.ts.map +1 -1
  256. package/src/shade/renderer/atmosphere/shader_multiscatter_lut.js +0 -1
  257. package/src/shade/renderer/atmosphere/shader_transmittance_lut.js +3 -3
  258. package/src/shade/renderer/buffer/graph_inspect_gpu_buffer.js +136 -136
  259. package/src/shade/renderer/buffer/table/GPUDatabase.d.ts.map +1 -1
  260. package/src/shade/renderer/buffer/table/GPUDatabase.js +16 -22
  261. package/src/shade/renderer/buffer/table/gpu_table_element_upload_shader.d.ts.map +1 -1
  262. package/src/shade/renderer/buffer/table/gpu_table_element_upload_shader.js +7 -2
  263. package/src/shade/renderer/buffer/table/single/GPUSingleTypeTable.d.ts.map +1 -1
  264. package/src/shade/renderer/buffer/table/single/GPUSingleTypeTable.js +11 -5
  265. package/src/shade/renderer/buffer/util/shader_buffer_copy_storage_to_storage.d.ts.map +1 -1
  266. package/src/shade/renderer/buffer/util/shader_buffer_copy_storage_to_storage.js +43 -42
  267. package/src/shade/renderer/buffer/util/shader_buffer_intra_copy_regions.d.ts.map +1 -1
  268. package/src/shade/renderer/buffer/util/shader_buffer_intra_copy_regions.js +83 -84
  269. package/src/shade/renderer/deferred/shader_tonemap_HDR.d.ts.map +1 -1
  270. package/src/shade/renderer/deferred/shader_tonemap_HDR.js +4 -1
  271. package/src/shade/renderer/dynamic/GPUDynamicMeshResidency.d.ts +2 -2
  272. package/src/shade/renderer/dynamic/GPUDynamicMeshResidency.d.ts.map +1 -1
  273. package/src/shade/renderer/dynamic/GPUDynamicMeshResidency.js +167 -167
  274. package/src/shade/renderer/dynamic/shader_dynamic_mesh.d.ts.map +1 -1
  275. package/src/shade/renderer/dynamic/shader_dynamic_mesh.js +177 -170
  276. package/src/shade/renderer/extension/RENDER_EXTENSION_DESIGN.md +918 -918
  277. package/src/shade/renderer/fow/GPUFogOfWarRenderer.js +3 -3
  278. package/src/shade/renderer/fow/shader_fog_of_war.d.ts.map +1 -1
  279. package/src/shade/renderer/fow/shader_fog_of_war.js +3 -1
  280. package/src/shade/renderer/geometry/bvh/record_blas_refit.js +102 -102
  281. package/src/shade/renderer/geometry/bvh/shader_blas_refit_leaf_bounds.d.ts.map +1 -1
  282. package/src/shade/renderer/geometry/bvh/shader_blas_refit_leaf_bounds.js +5 -2
  283. package/src/shade/renderer/geometry/meshlet/GPUMeshletManager.d.ts.map +1 -1
  284. package/src/shade/renderer/geometry/meshlet/GPUMeshletManager.js +3 -11
  285. package/src/shade/renderer/geometry/meshlet/shader_meshlet_metadata_address_patch.d.ts +1 -1
  286. package/src/shade/renderer/geometry/meshlet/shader_meshlet_metadata_address_patch.d.ts.map +1 -1
  287. package/src/shade/renderer/geometry/meshlet/shader_meshlet_metadata_address_patch.js +6 -4
  288. package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.d.ts.map +1 -1
  289. package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js +5 -10
  290. package/src/shade/renderer/geometry/sdf/shader_build_sdf.js +129 -129
  291. package/src/shade/renderer/geometry/sdf/shader_sdf_visualize.d.ts.map +1 -1
  292. package/src/shade/renderer/geometry/sdf/shader_sdf_visualize.js +5 -3
  293. package/src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_probes.d.ts.map +1 -1
  294. package/src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_probes.js +4 -1
  295. package/src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_resolve_probes.d.ts.map +1 -1
  296. package/src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_resolve_probes.js +3 -1
  297. package/src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.d.ts.map +1 -1
  298. package/src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.js +114 -112
  299. package/src/shade/renderer/global_illumination/lpv/placement/graph_generate_probe_locations.js +367 -367
  300. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lpv_store_sh.d.ts.map +1 -1
  301. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lpv_store_sh.js +4 -1
  302. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.d.ts.map +1 -1
  303. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.js +9 -6
  304. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_reduce_atlas_to_sh.d.ts.map +1 -1
  305. package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_reduce_atlas_to_sh.js +4 -1
  306. package/src/shade/renderer/global_illumination/sharc/SpatialHashRadianceCache.d.ts.map +1 -1
  307. package/src/shade/renderer/global_illumination/sharc/SpatialHashRadianceCache.js +6 -8
  308. package/src/shade/renderer/global_illumination/sharc/shader/shader_sharc_evict.d.ts.map +1 -1
  309. package/src/shade/renderer/global_illumination/sharc/shader/shader_sharc_evict.js +3 -1
  310. package/src/shade/renderer/global_illumination/sharc/shader/shader_sharc_update.d.ts.map +1 -1
  311. package/src/shade/renderer/global_illumination/sharc/shader/shader_sharc_update.js +3 -1
  312. package/src/shade/renderer/gpu_primitive/bvh/GPU_BVH_BUILD_PLAN.md +1115 -1115
  313. package/src/shade/renderer/gpu_primitive/bvh/PHASE1_HANDOVER.md +3 -3
  314. package/src/shade/renderer/gpu_primitive/bvh/graph_bvh_build_lbvh.js +10 -10
  315. package/src/shade/renderer/gpu_primitive/bvh/shader_bvh_emit_hierarchy.d.ts.map +1 -1
  316. package/src/shade/renderer/gpu_primitive/bvh/shader_bvh_emit_hierarchy.js +4 -2
  317. package/src/shade/renderer/gpu_primitive/bvh/shader_bvh_morton.d.ts.map +1 -1
  318. package/src/shade/renderer/gpu_primitive/bvh/shader_bvh_morton.js +87 -83
  319. package/src/shade/renderer/gpu_primitive/bvh/shader_bvh_refit.d.ts.map +1 -1
  320. package/src/shade/renderer/gpu_primitive/bvh/shader_bvh_refit.js +4 -2
  321. package/src/shade/renderer/gpu_primitive/bvh/verify_gpu_bvh_build.d.ts +2 -2
  322. package/src/shade/renderer/gpu_primitive/bvh/verify_gpu_bvh_build.d.ts.map +1 -1
  323. package/src/shade/renderer/gpu_primitive/bvh/verify_gpu_bvh_build.js +43 -8
  324. package/src/shade/renderer/gpu_primitive/sort/graph_radix_sort.d.ts.map +1 -1
  325. package/src/shade/renderer/gpu_primitive/sort/graph_radix_sort.js +4 -5
  326. package/src/shade/renderer/gpu_primitive/sort/shader_radix_sort_histogram.d.ts.map +1 -1
  327. package/src/shade/renderer/gpu_primitive/sort/shader_radix_sort_histogram.js +88 -85
  328. package/src/shade/renderer/gpu_primitive/sort/shader_radix_sort_scatter.d.ts.map +1 -1
  329. package/src/shade/renderer/gpu_primitive/sort/shader_radix_sort_scatter.js +194 -192
  330. package/src/shade/renderer/hiz/HierarchicalZBuffer.d.ts.map +1 -1
  331. package/src/shade/renderer/hiz/HierarchicalZBuffer.js +33 -69
  332. package/src/shade/renderer/hiz/shader_hzb_reduce_any.d.ts.map +1 -1
  333. package/src/shade/renderer/hiz/shader_hzb_reduce_any.js +6 -1
  334. package/src/shade/renderer/hiz/shader_hzb_reduce_mip0_clip.d.ts.map +1 -1
  335. package/src/shade/renderer/hiz/shader_hzb_reduce_mip0_clip.js +23 -7
  336. package/src/shade/renderer/light/cluster/cull/graph_cull_lights.d.ts.map +1 -1
  337. package/src/shade/renderer/light/cluster/cull/graph_cull_lights.js +191 -198
  338. package/src/shade/renderer/light/cluster/cull/shader_cull_lights_frustum.d.ts +0 -6
  339. package/src/shade/renderer/light/cluster/cull/shader_cull_lights_frustum.d.ts.map +1 -1
  340. package/src/shade/renderer/light/cluster/cull/shader_cull_lights_frustum.js +120 -120
  341. package/src/shade/renderer/light/cluster/cull/shader_cull_lights_hzb.d.ts +0 -4
  342. package/src/shade/renderer/light/cluster/cull/shader_cull_lights_hzb.d.ts.map +1 -1
  343. package/src/shade/renderer/light/cluster/cull/shader_cull_lights_hzb.js +112 -112
  344. package/src/shade/renderer/light/cluster/graph_assign_clsuters.d.ts.map +1 -1
  345. package/src/shade/renderer/light/cluster/graph_assign_clsuters.js +4 -7
  346. package/src/shade/renderer/light/cluster/shader_cluster_assign_lights.d.ts +0 -6
  347. package/src/shade/renderer/light/cluster/shader_cluster_assign_lights.d.ts.map +1 -1
  348. package/src/shade/renderer/light/cluster/shader_cluster_assign_lights.js +1 -1
  349. package/src/shade/renderer/light/environment/execute_filter_environment_map.d.ts.map +1 -1
  350. package/src/shade/renderer/light/environment/execute_filter_environment_map.js +1 -2
  351. package/src/shade/renderer/light/environment/shader_convolve_reflection_map.d.ts.map +1 -1
  352. package/src/shade/renderer/light/environment/shader_convolve_reflection_map.js +6 -1
  353. package/src/shade/renderer/lightmap/bake/raster/graph_draw_lightmap_viz_buffer.d.ts.map +1 -1
  354. package/src/shade/renderer/lightmap/bake/raster/graph_draw_lightmap_viz_buffer.js +234 -219
  355. package/src/shade/renderer/lightmap/bake/raster/shader_lightmap_to_viz_buffer.js +222 -222
  356. package/src/shade/renderer/lightmap/bake/shader_lightmap_denoise_sh.js +191 -191
  357. package/src/shade/renderer/lightmap/bake/tile/shader_lightmap_accummulate_tile.d.ts.map +1 -1
  358. package/src/shade/renderer/lightmap/bake/tile/shader_lightmap_accummulate_tile.js +85 -82
  359. package/src/shade/renderer/lightmap/bake/tile/shader_lightmap_tile_composit.js +81 -81
  360. package/src/shade/renderer/material/GPUMaterialContext.js +380 -380
  361. package/src/shade/renderer/material/standard/fragment_gbuffer_vt.js +169 -169
  362. package/src/shade/renderer/object_property/shader_object_property_process.d.ts.map +1 -1
  363. package/src/shade/renderer/object_property/shader_object_property_process.js +83 -84
  364. package/src/shade/renderer/object_property/shader_refresh_all_mesh_bounds.d.ts.map +1 -1
  365. package/src/shade/renderer/object_property/shader_refresh_all_mesh_bounds.js +57 -58
  366. package/src/shade/renderer/particles/graph_particles.d.ts.map +1 -1
  367. package/src/shade/renderer/particles/graph_particles.js +5 -3
  368. package/src/shade/renderer/particles/prototypeParticleSystem.js +5 -7
  369. package/src/shade/renderer/particles/shaders/shader_particle_emit.d.ts.map +1 -1
  370. package/src/shade/renderer/particles/shaders/shader_particle_emit.js +27 -13
  371. package/src/shade/renderer/particles/shaders/shader_particle_finalize.d.ts.map +1 -1
  372. package/src/shade/renderer/particles/shaders/shader_particle_finalize.js +4 -4
  373. package/src/shade/renderer/particles/shaders/shader_particle_render.d.ts.map +1 -1
  374. package/src/shade/renderer/particles/shaders/shader_particle_render.js +190 -183
  375. package/src/shade/renderer/particles/shaders/shader_particle_simulate.d.ts.map +1 -1
  376. package/src/shade/renderer/particles/shaders/shader_particle_simulate.js +18 -7
  377. package/src/shade/renderer/particles/sort/shader_particle_sort.d.ts.map +1 -1
  378. package/src/shade/renderer/particles/sort/shader_particle_sort.js +47 -21
  379. package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.d.ts.map +1 -1
  380. package/src/shade/renderer/path_tracer/accumulating/AccumulatingPathTracer.js +7 -10
  381. package/src/shade/renderer/path_tracer/accumulating/shader_accumulating_path_tracer.d.ts.map +1 -1
  382. package/src/shade/renderer/path_tracer/accumulating/shader_accumulating_path_tracer.js +4 -1
  383. package/src/shade/renderer/path_tracer/graph_path_trace_scene.js +184 -184
  384. package/src/shade/renderer/postprocess/bloom/shader_bloom_mix.d.ts.map +1 -1
  385. package/src/shade/renderer/postprocess/bloom/shader_bloom_mix.js +3 -1
  386. package/src/shade/renderer/postprocess/cas/shader_ffx_rcas.d.ts.map +1 -1
  387. package/src/shade/renderer/postprocess/cas/shader_ffx_rcas.js +4 -2
  388. package/src/shade/renderer/postprocess/denoise/fragment_shader_denoise_ao.js +147 -147
  389. package/src/shade/renderer/postprocess/denoise/graph_atorus_denoise_luma.d.ts.map +1 -1
  390. package/src/shade/renderer/postprocess/denoise/graph_atorus_denoise_luma.js +19 -17
  391. package/src/shade/renderer/postprocess/dof/gather/graph_postprocess_dof2.d.ts.map +1 -1
  392. package/src/shade/renderer/postprocess/dof/gather/graph_postprocess_dof2.js +1 -2
  393. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_gather_far.d.ts.map +1 -1
  394. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_gather_far.js +4 -1
  395. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_gather_near.d.ts.map +1 -1
  396. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_gather_near.js +4 -1
  397. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_recombine.d.ts.map +1 -1
  398. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_recombine.js +4 -1
  399. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_setup.d.ts.map +1 -1
  400. package/src/shade/renderer/postprocess/dof/gather/shader_dof2_setup.js +4 -1
  401. package/src/shade/renderer/postprocess/dof/raymarch/graph_postprocess_dof.d.ts.map +1 -1
  402. package/src/shade/renderer/postprocess/dof/raymarch/graph_postprocess_dof.js +5 -8
  403. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_composite.d.ts.map +1 -1
  404. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_composite.js +4 -1
  405. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_prefilter.d.ts.map +1 -1
  406. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_prefilter.js +4 -1
  407. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_raymarch.d.ts.map +1 -1
  408. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_raymarch.js +4 -1
  409. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_raymarch_compute.d.ts.map +1 -1
  410. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_raymarch_compute.js +4 -2
  411. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_slice_compute.d.ts.map +1 -1
  412. package/src/shade/renderer/postprocess/dof/raymarch/shader_dof_slice_compute.js +4 -2
  413. package/src/shade/renderer/postprocess/dof/shader_dof_autofocus.d.ts.map +1 -1
  414. package/src/shade/renderer/postprocess/dof/shader_dof_autofocus.js +4 -1
  415. package/src/shade/renderer/postprocess/eye/GPUCameraExposureManager.d.ts.map +1 -1
  416. package/src/shade/renderer/postprocess/eye/GPUCameraExposureManager.js +8 -11
  417. package/src/shade/renderer/postprocess/eye/shader_autoexposure_adapt.d.ts.map +1 -1
  418. package/src/shade/renderer/postprocess/eye/shader_autoexposure_adapt.js +5 -1
  419. package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao.d.ts.map +1 -1
  420. package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao.js +11 -8
  421. package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao_with_irradiance.d.ts.map +1 -1
  422. package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao_with_irradiance.js +7 -8
  423. package/src/shade/renderer/postprocess/motion_blur/shader_motion_blur_reconstruct.d.ts.map +1 -1
  424. package/src/shade/renderer/postprocess/motion_blur/shader_motion_blur_reconstruct.js +3 -1
  425. package/src/shade/renderer/postprocess/nss/NSS.d.ts +1 -1
  426. package/src/shade/renderer/postprocess/nss/shader_nss_concat.d.ts.map +1 -1
  427. package/src/shade/renderer/postprocess/nss/shader_nss_concat.js +3 -2
  428. package/src/shade/renderer/postprocess/nss/shader_nss_conv_layer.d.ts.map +1 -1
  429. package/src/shade/renderer/postprocess/nss/shader_nss_conv_layer.js +225 -226
  430. package/src/shade/renderer/postprocess/nss/shader_nss_extract_feedback.d.ts.map +1 -1
  431. package/src/shade/renderer/postprocess/nss/shader_nss_extract_feedback.js +49 -50
  432. package/src/shade/renderer/postprocess/nss/shader_nss_postprocess.d.ts.map +1 -1
  433. package/src/shade/renderer/postprocess/nss/shader_nss_postprocess.js +291 -292
  434. package/src/shade/renderer/postprocess/nss/shader_nss_preprocess.d.ts.map +1 -1
  435. package/src/shade/renderer/postprocess/nss/shader_nss_preprocess.js +230 -231
  436. package/src/shade/renderer/postprocess/ssr/depth_max_shader.d.ts.map +1 -1
  437. package/src/shade/renderer/postprocess/ssr/depth_max_shader.js +70 -68
  438. package/src/shade/renderer/postprocess/ssr/reproject/shader_ffx_denoiser_reflections_reproject.d.ts +16 -2
  439. package/src/shade/renderer/postprocess/ssr/reproject/shader_ffx_denoiser_reflections_reproject.d.ts.map +1 -1
  440. package/src/shade/renderer/postprocess/ssr/reproject/shader_ffx_denoiser_reflections_reproject.js +12 -12
  441. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader_IBL.d.ts.map +1 -1
  442. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader_IBL.js +3 -1
  443. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader_LPV.d.ts.map +1 -1
  444. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader_LPV.js +4 -1
  445. package/src/shade/renderer/postprocess/ssr/shader_downsample_encoded_normal.d.ts.map +1 -1
  446. package/src/shade/renderer/postprocess/ssr/shader_downsample_encoded_normal.js +103 -101
  447. package/src/shade/renderer/postprocess/ssr/ssr_spatial_denoise_shader.d.ts.map +1 -1
  448. package/src/shade/renderer/postprocess/ssr/ssr_spatial_denoise_shader.js +4 -2
  449. package/src/shade/renderer/postprocess/ssr/ssr_trace_shader.d.ts.map +1 -1
  450. package/src/shade/renderer/postprocess/ssr/ssr_trace_shader.js +3 -1
  451. package/src/shade/renderer/postprocess/taa/shader_taa.d.ts.map +1 -1
  452. package/src/shade/renderer/postprocess/taa/shader_taa.js +4 -1
  453. package/src/shade/renderer/postprocess/upscale-dither/fragment_shader_upscale_dither.js +5 -5
  454. package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.d.ts.map +1 -1
  455. package/src/shade/renderer/rasterize/bucket/prepare_meshlet_draw_commands_by_material.js +339 -341
  456. package/src/shade/renderer/rasterize/bucket/shader_count_meshlets_by_material.d.ts.map +1 -1
  457. package/src/shade/renderer/rasterize/bucket/shader_count_meshlets_by_material.js +68 -69
  458. package/src/shade/renderer/rasterize/bucket/shader_make_meshlet_indirect_draw_commands_by_material.d.ts.map +1 -1
  459. package/src/shade/renderer/rasterize/bucket/shader_make_meshlet_indirect_draw_commands_by_material.js +59 -60
  460. package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.d.ts.map +1 -1
  461. package/src/shade/renderer/rasterize/bucket/shader_read_out_bucket.js +0 -1
  462. package/src/shade/renderer/rasterize/bucket/shader_sort_meshlets_by_material.d.ts.map +1 -1
  463. package/src/shade/renderer/rasterize/bucket/shader_sort_meshlets_by_material.js +64 -65
  464. package/src/shade/renderer/rasterize/compute/graph_mesh_frustum_cull.d.ts.map +1 -1
  465. package/src/shade/renderer/rasterize/compute/graph_mesh_frustum_cull.js +168 -169
  466. package/src/shade/renderer/rasterize/compute/graph_mesh_sphere_cull.d.ts.map +1 -1
  467. package/src/shade/renderer/rasterize/compute/graph_mesh_sphere_cull.js +160 -161
  468. package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_mesh_filter_2way.d.ts.map +1 -1
  469. package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_mesh_filter_2way.js +6 -2
  470. package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_meshlet_filter_1way_full.d.ts.map +1 -1
  471. package/src/shade/renderer/rasterize/cull/hzb/shader_hzb_meshlet_filter_1way_full.js +4 -2
  472. package/src/shade/renderer/rasterize/expand/bucket/mesh/shader_instances_classify_bucket.d.ts.map +1 -1
  473. package/src/shade/renderer/rasterize/expand/bucket/mesh/shader_instances_classify_bucket.js +139 -140
  474. package/src/shade/renderer/rasterize/expand/bucket/mesh/shader_instances_count_by_rasterization_bucket.d.ts.map +1 -1
  475. package/src/shade/renderer/rasterize/expand/bucket/mesh/shader_instances_count_by_rasterization_bucket.js +91 -92
  476. package/src/shade/renderer/rasterize/expand/bucket/mesh/shader_instances_rasterization_bucket_sort.d.ts.map +1 -1
  477. package/src/shade/renderer/rasterize/expand/bucket/mesh/shader_instances_rasterization_bucket_sort.js +88 -89
  478. package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_count_by_rasterization_bucket.d.ts.map +1 -1
  479. package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_count_by_rasterization_bucket.js +90 -91
  480. package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.d.ts.map +1 -1
  481. package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js +5 -2
  482. package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_rasterization_bucket_sort.d.ts.map +1 -1
  483. package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_rasterization_bucket_sort.js +89 -90
  484. package/src/shade/renderer/rasterize/expand/graph_mesh_filter_one_way.d.ts.map +1 -1
  485. package/src/shade/renderer/rasterize/expand/graph_mesh_filter_one_way.js +169 -170
  486. package/src/shade/renderer/rasterize/expand/mesh/shader_mesh_expand_to_meshlets_prefix.d.ts.map +1 -1
  487. package/src/shade/renderer/rasterize/expand/mesh/shader_mesh_expand_to_meshlets_prefix.js +89 -90
  488. package/src/shade/renderer/rasterize/expand/mesh/shader_meshes_to_meshlet_counts.d.ts.map +1 -1
  489. package/src/shade/renderer/rasterize/expand/mesh/shader_meshes_to_meshlet_counts.js +61 -62
  490. package/src/shade/renderer/rasterize/expand/pass1/filter_meshlets.2-way.compute.d.ts.map +1 -1
  491. package/src/shade/renderer/rasterize/expand/pass1/filter_meshlets.2-way.compute.js +153 -154
  492. package/src/shade/renderer/rasterize/native/depth/shadow_rasterization_alpha_tested_pass_descriptor.js +144 -144
  493. package/src/shade/renderer/rasterize/native/depth/shadow_rasterization_pass_descriptor.js +88 -88
  494. package/src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js +722 -722
  495. package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js +217 -217
  496. package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js +179 -179
  497. package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments_ibl.js +178 -178
  498. package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js +194 -194
  499. package/src/shade/renderer/rasterize/native/viz/viz_rasterization_opaque_pass_descriptor.js +76 -76
  500. package/src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.d.ts.map +1 -1
  501. package/src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.js +1 -9
  502. package/src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.d.ts.map +1 -1
  503. package/src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.js +1 -6
  504. package/src/shade/renderer/restir/di/graph_restir_di.d.ts.map +1 -1
  505. package/src/shade/renderer/restir/di/graph_restir_di.js +2 -3
  506. package/src/shade/renderer/restir/di/graph_restir_di_denoise.d.ts.map +1 -1
  507. package/src/shade/renderer/restir/di/graph_restir_di_denoise.js +1 -2
  508. package/src/shade/renderer/restir/di/shader_restir_di_denoise.d.ts.map +1 -1
  509. package/src/shade/renderer/restir/di/shader_restir_di_denoise.js +5 -3
  510. package/src/shade/renderer/restir/di/shader_restir_di_resample.d.ts.map +1 -1
  511. package/src/shade/renderer/restir/di/shader_restir_di_resample.js +4 -3
  512. package/src/shade/renderer/restir/di/shader_restir_di_resolve.d.ts.map +1 -1
  513. package/src/shade/renderer/restir/di/shader_restir_di_resolve.js +4 -3
  514. package/src/shade/renderer/restir/di/shader_restir_di_spatial.d.ts.map +1 -1
  515. package/src/shade/renderer/restir/di/shader_restir_di_spatial.js +116 -117
  516. package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.d.ts.map +1 -1
  517. package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.js +3 -7
  518. package/src/shade/renderer/scene/hierarchy/graph_scene_update_transform_hierarchy_naive.js +123 -123
  519. package/src/shade/renderer/scene/hierarchy/shader_nodes_record_input_positions.d.ts.map +1 -1
  520. package/src/shade/renderer/scene/hierarchy/shader_nodes_record_input_positions.js +64 -65
  521. package/src/shade/renderer/scene/hierarchy/shader_nodes_update_transform_hierarchy.d.ts.map +1 -1
  522. package/src/shade/renderer/scene/hierarchy/shader_nodes_update_transform_hierarchy.js +372 -373
  523. package/src/shade/renderer/scene/hierarchy/shader_nodes_update_transform_hierarchy_naive.d.ts.map +1 -1
  524. package/src/shade/renderer/scene/hierarchy/shader_nodes_update_transform_hierarchy_naive.js +111 -112
  525. package/src/shade/renderer/scene/shader_bvh_extract_instance_leaves.d.ts.map +1 -1
  526. package/src/shade/renderer/scene/shader_bvh_extract_instance_leaves.js +147 -145
  527. package/src/shade/renderer/shader/ComputeShader.d.ts +26 -5
  528. package/src/shade/renderer/shader/ComputeShader.d.ts.map +1 -1
  529. package/src/shade/renderer/shader/ComputeShader.js +347 -296
  530. package/src/shade/renderer/shader/ImageShader.js +217 -217
  531. package/src/shade/renderer/shader/ShaderDescriptor.d.ts +5 -0
  532. package/src/shade/renderer/shader/ShaderDescriptor.d.ts.map +1 -1
  533. package/src/shade/renderer/shader/ShaderDescriptor.js +20 -0
  534. package/src/shade/renderer/shader/pass/RenderPassDescriptor.d.ts +2 -2
  535. package/src/shade/renderer/shader/pass/RenderPassDescriptor.d.ts.map +1 -1
  536. package/src/shade/renderer/shader/pass/RenderPassDescriptor.js +189 -189
  537. package/src/shade/renderer/shader/resource/ShaderResourceSetDescriptor.d.ts.map +1 -1
  538. package/src/shade/renderer/shader/resource/ShaderResourceSetDescriptor.js +3 -1
  539. package/src/shade/renderer/shader/util/compute_infer_workgroup_size_from_source.d.ts +47 -0
  540. package/src/shade/renderer/shader/util/compute_infer_workgroup_size_from_source.d.ts.map +1 -0
  541. package/src/shade/renderer/shader/util/compute_infer_workgroup_size_from_source.js +448 -0
  542. package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.d.ts.map +1 -1
  543. package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.js +14 -18
  544. package/src/shade/renderer/shadow/map/csm/graph_csm_setup_cascades.js +3 -3
  545. package/src/shade/renderer/shadow/map/shader/shader_shadowmap_remap_cube_to_octahedral.d.ts.map +1 -1
  546. package/src/shade/renderer/shadow/map/shader/shader_shadowmap_remap_cube_to_octahedral.js +5 -1
  547. package/src/shade/renderer/shadow/ray/shader_shadow_upscale.d.ts.map +1 -1
  548. package/src/shade/renderer/shadow/ray/shader_shadow_upscale.js +3 -1
  549. package/src/shade/renderer/shadow/ray/staged/gen/graph_gen_rays.js +73 -73
  550. package/src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.d.ts.map +1 -1
  551. package/src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js +151 -148
  552. package/src/shade/renderer/shadow/ray/staged/trace/graph_trace_rays.d.ts.map +1 -1
  553. package/src/shade/renderer/shadow/ray/staged/trace/graph_trace_rays.js +6 -4
  554. package/src/shade/renderer/shadow/ray/staged/trace/shader_trace_rays.d.ts.map +1 -1
  555. package/src/shade/renderer/shadow/ray/staged/trace/shader_trace_rays.js +18 -4
  556. package/src/shade/renderer/shadow/sdf/cascade/CascadedSceneSDF.d.ts.map +1 -1
  557. package/src/shade/renderer/shadow/sdf/cascade/CascadedSceneSDF.js +11 -12
  558. package/src/shade/renderer/shadow/sdf/cascade/shader_build_scene_sdf_f32.d.ts.map +1 -1
  559. package/src/shade/renderer/shadow/sdf/cascade/shader_build_scene_sdf_f32.js +6 -2
  560. package/src/shade/renderer/shadow/sdf/cascade/shader_scene_sdf_debug_viz.d.ts.map +1 -1
  561. package/src/shade/renderer/shadow/sdf/cascade/shader_scene_sdf_debug_viz.js +129 -127
  562. package/src/shade/renderer/shadow/sdf/graph_draw_sdf_shadows.d.ts.map +1 -1
  563. package/src/shade/renderer/shadow/sdf/graph_draw_sdf_shadows.js +5 -3
  564. package/src/shade/renderer/texture/virtual/VirtualTextureManager.d.ts.map +1 -1
  565. package/src/shade/renderer/texture/virtual/VirtualTextureManager.js +2 -5
  566. package/src/shade/renderer/texture/virtual/build_shader_vt_feedback.d.ts.map +1 -1
  567. package/src/shade/renderer/texture/virtual/build_shader_vt_feedback.js +3 -2
  568. package/src/shade/renderer/volumetrics/GPUViewVolumetrics.js +1 -1
  569. package/src/shade/renderer/volumetrics/graph_build_volumetrics.d.ts.map +1 -1
  570. package/src/shade/renderer/volumetrics/graph_build_volumetrics.js +14 -19
  571. package/src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.d.ts +3 -2
  572. package/src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.d.ts.map +1 -1
  573. package/src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.js +3 -2
  574. package/src/shade/renderer/volumetrics/taa/shader_volumetrics_taa.d.ts +0 -2
  575. package/src/shade/renderer/volumetrics/taa/shader_volumetrics_taa.d.ts.map +1 -1
  576. package/src/shade/renderer/volumetrics/taa/shader_volumetrics_taa.js +17 -6
  577. package/src/shade/renderer/water/shader_water.js +246 -246
  578. package/src/shade/vitest.setup.mjs +1 -1
  579. package/src/shade/wgsl/emulator/ComputeShaderEmulator.js +291 -291
  580. package/src/shade/wgsl/validate_wgsl_source.d.ts.map +1 -1
  581. package/src/shade/wgsl/validate_wgsl_source.js +8 -3
  582. package/src/view/minimap/Minimap.d.ts +2 -2
  583. package/src/view/minimap/Minimap.d.ts.map +1 -1
  584. package/src/view/minimap/Minimap.js +225 -225
  585. package/src/view/minimap/dom/MinimapCameraView.d.ts +3 -3
  586. package/src/view/minimap/dom/MinimapCameraView.d.ts.map +1 -1
  587. package/src/view/minimap/dom/MinimapCameraView.js +206 -206
  588. package/src/shade/device/timing/profile/make_profiling_pass_encoder.d.ts +0 -21
  589. package/src/shade/device/timing/profile/make_profiling_pass_encoder.d.ts.map +0 -1
  590. package/src/shade/device/timing/profile/make_profiling_pass_encoder.js +0 -114
  591. package/src/shade/device/timing/profile/parse_workgroup_size.d.ts +0 -20
  592. package/src/shade/device/timing/profile/parse_workgroup_size.d.ts.map +0 -1
  593. package/src/shade/device/timing/profile/parse_workgroup_size.js +0 -43
  594. package/src/shade/renderer/shadow/map/csm/shader/shader_setup_cascades.d.ts +0 -3
  595. package/src/shade/renderer/shadow/map/csm/shader/shader_setup_cascades.d.ts.map +0 -1
  596. package/src/shade/renderer/shadow/map/csm/shader/shader_setup_cascades.js +0 -20
@@ -1,723 +1,723 @@
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 {GPURenderPassEncoder} 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 { 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;
723
723
  }