@aura3d/rendering 1.3.3 → 1.4.1

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 (314) hide show
  1. package/dist/ForwardPass.js +7 -1
  2. package/dist/ForwardPass.js.map +1 -1
  3. package/dist/MorphTarget.d.ts +1 -0
  4. package/dist/MorphTarget.d.ts.map +1 -1
  5. package/dist/MorphTarget.js.map +1 -1
  6. package/dist/Renderer.js +7 -1
  7. package/dist/Renderer.js.map +1 -1
  8. package/package.json +38 -4
  9. package/src/ArchitecturalLightingFixtures.ts +0 -241
  10. package/src/ArchitecturalMaterialCatalog.ts +0 -130
  11. package/src/ArchitecturalMeasurementFixtures.ts +0 -155
  12. package/src/BRDFLut.ts +0 -47
  13. package/src/CameraFraming.ts +0 -200
  14. package/src/CanonicalSceneFixtures.ts +0 -95
  15. package/src/CascadedShadowMaps.ts +0 -449
  16. package/src/ColorManagement.ts +0 -127
  17. package/src/CullingFixtures.ts +0 -280
  18. package/src/DecalGeometry.ts +0 -26
  19. package/src/DepthPass.ts +0 -110
  20. package/src/EnvironmentBackgroundPass.ts +0 -194
  21. package/src/EnvironmentBackgroundResources.ts +0 -309
  22. package/src/EnvironmentLighting.ts +0 -96
  23. package/src/EnvironmentMapResources.ts +0 -1026
  24. package/src/EnvironmentPipeline.ts +0 -69
  25. package/src/EnvironmentPlatform.ts +0 -1306
  26. package/src/EnvironmentPreset.ts +0 -155
  27. package/src/Exposure.ts +0 -66
  28. package/src/ExternalParityRenderPreset.ts +0 -725
  29. package/src/ForwardPass.ts +0 -1663
  30. package/src/FrameVisualMetrics.ts +0 -301
  31. package/src/Geometry.ts +0 -461
  32. package/src/GeometryPrimitives.ts +0 -2
  33. package/src/HDRRenderPipeline.ts +0 -94
  34. package/src/IBL.ts +0 -86
  35. package/src/IndexBuffer.ts +0 -57
  36. package/src/InstancedPBRMaterial.ts +0 -186
  37. package/src/InstancedUnlitMaterial.ts +0 -60
  38. package/src/Instancing.ts +0 -19
  39. package/src/LightCollector.ts +0 -82
  40. package/src/LightUniforms.ts +0 -47
  41. package/src/LightingDebug.ts +0 -80
  42. package/src/LightingDefaults.ts +0 -79
  43. package/src/LightingRig.ts +0 -301
  44. package/src/LineGeometry.ts +0 -2
  45. package/src/Material.ts +0 -209
  46. package/src/MaterialBinding.ts +0 -131
  47. package/src/MaterialInstance.ts +0 -59
  48. package/src/MaterialPresets.ts +0 -272
  49. package/src/MorphTarget.ts +0 -123
  50. package/src/MorphTargetPlan.ts +0 -178
  51. package/src/MorphUnlitMaterial.ts +0 -60
  52. package/src/NormalMappedPBRMaterial.ts +0 -188
  53. package/src/OceanFixtures.ts +0 -318
  54. package/src/PBRLightingDefaults.ts +0 -12
  55. package/src/PBRMaterial.ts +0 -442
  56. package/src/PMREM.ts +0 -53
  57. package/src/PbrReference.ts +0 -681
  58. package/src/PostProcessPass.ts +0 -2507
  59. package/src/ProceduralTextureFixtures.ts +0 -393
  60. package/src/ProductTurntableFixtures.ts +0 -815
  61. package/src/Raycaster.ts +0 -21
  62. package/src/ReflectionProbe.ts +0 -13
  63. package/src/ReflectionSurfaces.ts +0 -219
  64. package/src/RenderBackend.ts +0 -43
  65. package/src/RenderDebugViews.ts +0 -138
  66. package/src/RenderDevice.ts +0 -836
  67. package/src/RenderGraph.ts +0 -194
  68. package/src/RenderPass.ts +0 -27
  69. package/src/RenderPipeline.ts +0 -101
  70. package/src/RenderQueue.ts +0 -12
  71. package/src/RenderState.ts +0 -12
  72. package/src/Renderer.ts +0 -2626
  73. package/src/RendererDebugOverlay.ts +0 -80
  74. package/src/RendererFeatureGates.ts +0 -150
  75. package/src/RendererPostprocessPlan.ts +0 -279
  76. package/src/RendererTiming.ts +0 -251
  77. package/src/RendererVisualPipelineReport.ts +0 -836
  78. package/src/ResourceLifecycle.ts +0 -21
  79. package/src/Sampler.ts +0 -37
  80. package/src/SceneOptimization.ts +0 -518
  81. package/src/ShaderChunks.ts +0 -393
  82. package/src/ShaderLibrary.ts +0 -2766
  83. package/src/ShaderModule.ts +0 -36
  84. package/src/ShaderPreprocessor.ts +0 -260
  85. package/src/ShaderReflection.ts +0 -201
  86. package/src/ShadowMap.ts +0 -237
  87. package/src/ShadowPass.ts +0 -198
  88. package/src/ShadowProjection.ts +0 -115
  89. package/src/SkinnedLitMaterial.ts +0 -397
  90. package/src/SkinnedUnlitMaterial.ts +0 -63
  91. package/src/SkinningBounds.ts +0 -131
  92. package/src/SpaceEnvironmentFixtures.ts +0 -200
  93. package/src/SpriteGeometry.ts +0 -21
  94. package/src/StereoCameraRig.ts +0 -127
  95. package/src/StereoEffects.ts +0 -274
  96. package/src/TerrainFixtures.ts +0 -180
  97. package/src/Texture.ts +0 -307
  98. package/src/TextureBinding.ts +0 -91
  99. package/src/TexturedPBRMaterial.ts +0 -1112
  100. package/src/TexturedUnlitMaterial.ts +0 -67
  101. package/src/ToneMapping.ts +0 -105
  102. package/src/UniformBinder.ts +0 -16
  103. package/src/UniformLayout.ts +0 -129
  104. package/src/UnlitMaterial.ts +0 -75
  105. package/src/VegetationFixtures.ts +0 -314
  106. package/src/VertexBuffer.ts +0 -120
  107. package/src/VertexFormat.ts +0 -171
  108. package/src/VoxelWorldFixtures.ts +0 -280
  109. package/src/WeatherFixtures.ts +0 -223
  110. package/src/WebGL2Device.ts +0 -2280
  111. package/src/WebGL2StateCache.ts +0 -330
  112. package/src/WebGPUDevice.ts +0 -2877
  113. package/src/WebGPURenderToTextureProof.ts +0 -139
  114. package/src/advanced-runtime/AdvancedRenderer.ts +0 -73
  115. package/src/advanced-runtime/index.ts +0 -9
  116. package/src/animation/AnimationMaterialStyle.ts +0 -32
  117. package/src/animation/AnimationRenderPreset.ts +0 -45
  118. package/src/animation/AnimationToonMaterial.ts +0 -387
  119. package/src/animation/AnimationVisualQuality.ts +0 -71
  120. package/src/animation/applyAnimationRenderPreset.ts +0 -180
  121. package/src/animation/index.ts +0 -5
  122. package/src/cinematic/BloomPass.ts +0 -26
  123. package/src/cinematic/CinematicDepthComposition.ts +0 -30
  124. package/src/cinematic/CinematicEvidence.ts +0 -123
  125. package/src/cinematic/CinematicLightingRig.ts +0 -144
  126. package/src/cinematic/CinematicMaterialPresets.ts +0 -130
  127. package/src/cinematic/CinematicPostProcess.ts +0 -83
  128. package/src/cinematic/DepthHazePass.ts +0 -30
  129. package/src/cinematic/EmissivePracticalLightSystem.ts +0 -45
  130. package/src/cinematic/FilmGrainPass.ts +0 -24
  131. package/src/cinematic/FogVolumeSystem.ts +0 -30
  132. package/src/cinematic/GlowCardSystem.ts +0 -44
  133. package/src/cinematic/RainParticleSystem.ts +0 -151
  134. package/src/cinematic/VignettePass.ts +0 -25
  135. package/src/cinematic/WetReflectionApproximation.ts +0 -27
  136. package/src/cinematic/index.ts +0 -14
  137. package/src/effects/CollisionModule.ts +0 -64
  138. package/src/effects/ColorModule.ts +0 -60
  139. package/src/effects/ForceModule.ts +0 -25
  140. package/src/effects/GPUParticleBackend.ts +0 -569
  141. package/src/effects/Particle.ts +0 -108
  142. package/src/effects/ParticleDiagnostics.ts +0 -224
  143. package/src/effects/ParticleEffectPresets.ts +0 -147
  144. package/src/effects/ParticleEmitter.ts +0 -326
  145. package/src/effects/ParticleModule.ts +0 -26
  146. package/src/effects/ParticleRenderPass.ts +0 -117
  147. package/src/effects/ParticleRenderer.ts +0 -132
  148. package/src/effects/ParticleSystem.ts +0 -333
  149. package/src/effects/SizeModule.ts +0 -56
  150. package/src/effects/TrailModule.ts +0 -72
  151. package/src/effects/VelocityModule.ts +0 -75
  152. package/src/effects/index.ts +0 -15
  153. package/src/index.ts +0 -925
  154. package/src/materials/AlphaSorting.ts +0 -30
  155. package/src/materials/MaterialExtensions.ts +0 -42
  156. package/src/materials/PhysicalMaterial.ts +0 -133
  157. package/src/materials/TransmissionPass.ts +0 -51
  158. package/src/performance/BVH.ts +0 -18
  159. package/src/performance/Batcher.ts +0 -2
  160. package/src/performance/FrustumCuller.ts +0 -9
  161. package/src/performance/LOD.ts +0 -20
  162. package/src/performance/Octree.ts +0 -10
  163. package/src/performance/RenderItemSorting.ts +0 -170
  164. package/src/performance/RendererStats.ts +0 -43
  165. package/src/performance/ResourceBudget.ts +0 -44
  166. package/src/postprocess/BloomPass.ts +0 -28
  167. package/src/postprocess/CinematicDiagnostics.ts +0 -642
  168. package/src/postprocess/ColorGradingPass.ts +0 -24
  169. package/src/postprocess/DepthOfFieldPass.ts +0 -12
  170. package/src/postprocess/EffectComposer.ts +0 -349
  171. package/src/postprocess/SSAOPass.ts +0 -20
  172. package/src/postprocess/index.ts +0 -34
  173. package/src/production-runtime/AnimationControlsPipeline.ts +0 -77
  174. package/src/production-runtime/PBRHDRPipeline.ts +0 -381
  175. package/src/production-runtime/ProductionEffectsPipeline.ts +0 -85
  176. package/src/production-runtime/ProductionRendererTypes.ts +0 -136
  177. package/src/production-runtime/ProductionRuntimeRenderer.ts +0 -172
  178. package/src/production-runtime/ProductionWebGL2Renderer.ts +0 -313
  179. package/src/production-runtime/ProductionWebGPURenderer.ts +0 -396
  180. package/src/production-runtime/TransmissionBackdropCapture.ts +0 -130
  181. package/src/production-runtime/animation/MorphTargetRenderer.ts +0 -2
  182. package/src/production-runtime/animation/SkinningRenderer.ts +0 -2
  183. package/src/production-runtime/backends/RendererBackend.ts +0 -17
  184. package/src/production-runtime/backends/WebGL2RendererBackend.ts +0 -30
  185. package/src/production-runtime/backends/WebGPURendererBackend.ts +0 -24
  186. package/src/production-runtime/backends/webgl2/WebGL2Buffer.ts +0 -2
  187. package/src/production-runtime/backends/webgl2/WebGL2Capabilities.ts +0 -2
  188. package/src/production-runtime/backends/webgl2/WebGL2RenderTarget.ts +0 -2
  189. package/src/production-runtime/backends/webgl2/WebGL2Shader.ts +0 -2
  190. package/src/production-runtime/backends/webgl2/WebGL2StateCache.ts +0 -1
  191. package/src/production-runtime/backends/webgl2/WebGL2Texture.ts +0 -2
  192. package/src/production-runtime/backends/webgpu/WebGPUBuffer.ts +0 -2
  193. package/src/production-runtime/backends/webgpu/WebGPUCapabilities.ts +0 -2
  194. package/src/production-runtime/backends/webgpu/WebGPURenderTarget.ts +0 -2
  195. package/src/production-runtime/backends/webgpu/WebGPUShader.ts +0 -2
  196. package/src/production-runtime/backends/webgpu/WebGPUTexture.ts +0 -2
  197. package/src/production-runtime/color/ColorManagement.ts +0 -3
  198. package/src/production-runtime/color/ToneMapping.ts +0 -7
  199. package/src/production-runtime/diagnostics/FrameCapture.ts +0 -2
  200. package/src/production-runtime/diagnostics/GPUCapabilities.ts +0 -2
  201. package/src/production-runtime/diagnostics/RendererStats.ts +0 -2
  202. package/src/production-runtime/environment/EnvironmentMap.ts +0 -1
  203. package/src/production-runtime/environment/HDRLoader.ts +0 -57
  204. package/src/production-runtime/environment/PMREMGenerator.ts +0 -713
  205. package/src/production-runtime/framegraph/FrameGraph.ts +0 -18
  206. package/src/production-runtime/framegraph/RenderPass.ts +0 -15
  207. package/src/production-runtime/geometry/ProjectedDecalGeometry.ts +0 -439
  208. package/src/production-runtime/index.ts +0 -127
  209. package/src/production-runtime/lights/LightManager.ts +0 -7
  210. package/src/production-runtime/lights/ShadowMapRenderer.ts +0 -5
  211. package/src/production-runtime/materials/GLTFMaterialAdapter.ts +0 -6
  212. package/src/production-runtime/materials/GLTFPBRMaterialAdapter.ts +0 -2
  213. package/src/production-runtime/materials/MaterialCompiler.ts +0 -7
  214. package/src/production-runtime/materials/MaterialTextureBindings.ts +0 -5
  215. package/src/production-runtime/materials/PBRMaterial.ts +0 -2
  216. package/src/production-runtime/materials/PBRShaderFeatures.ts +0 -2
  217. package/src/production-runtime/passes/ContactShadowPass.ts +0 -184
  218. package/src/production-runtime/passes/DepthPrepass.ts +0 -7
  219. package/src/production-runtime/passes/OpaquePass.ts +0 -7
  220. package/src/production-runtime/passes/ShadowPass.ts +0 -7
  221. package/src/production-runtime/passes/SkyboxPass.ts +0 -7
  222. package/src/production-runtime/passes/ToneMappingPass.ts +0 -7
  223. package/src/production-runtime/passes/TransparentPass.ts +0 -7
  224. package/src/production-runtime/postprocess/BloomPass.ts +0 -51
  225. package/src/production-runtime/postprocess/ColorGradingPass.ts +0 -49
  226. package/src/production-runtime/postprocess/DOFPass.ts +0 -47
  227. package/src/production-runtime/postprocess/FXAAPass.ts +0 -53
  228. package/src/production-runtime/postprocess/ProductionEffectComposer.ts +0 -78
  229. package/src/production-runtime/postprocess/ProductionPostProcessTypes.ts +0 -174
  230. package/src/production-runtime/postprocess/SSAOPass.ts +0 -45
  231. package/src/production-runtime/resources/GPUBuffer.ts +0 -2
  232. package/src/production-runtime/resources/GPUTexture.ts +0 -2
  233. package/src/production-runtime/resources/RenderTarget.ts +0 -3
  234. package/src/production-runtime/resources/ResourceCache.ts +0 -7
  235. package/src/production-runtime/scene/Camera.ts +0 -1
  236. package/src/production-runtime/scene/Lights.ts +0 -2
  237. package/src/production-runtime/scene/RenderableMesh.ts +0 -2
  238. package/src/production-runtime/scene/RenderablePrimitive.ts +0 -1
  239. package/src/production-runtime/scene/RenderableScene.ts +0 -4
  240. package/src/production-runtime/shaders/ShaderProgramLibrary.ts +0 -7
  241. package/src/production-runtime/shaders/chunks/brdf.glsl +0 -2
  242. package/src/production-runtime/shaders/chunks/ibl.glsl +0 -3
  243. package/src/production-runtime/shaders/chunks/pbr.frag.glsl +0 -47
  244. package/src/production-runtime/shaders/chunks/pbr.vert.glsl +0 -8
  245. package/src/production-runtime/shaders/chunks/shadows.glsl +0 -2
  246. package/src/production-runtime/shaders/wgsl/pbr.wgsl +0 -3
  247. package/src/production-runtime/shaders/wgsl/postprocess.wgsl +0 -2
  248. package/src/production-runtime/shaders/wgsl/skybox.wgsl +0 -2
  249. package/src/shaders/depth.frag.glsl +0 -5
  250. package/src/shaders/depth.vert.glsl +0 -8
  251. package/src/shaders/pbr-direct.frag.glsl +0 -687
  252. package/src/shaders/pbr-direct.vert.glsl +0 -18
  253. package/src/shaders/unlit.frag.glsl +0 -18
  254. package/src/shaders/unlit.vert.glsl +0 -13
  255. package/src/shadows/CascadedShadowPipeline.ts +0 -53
  256. package/src/shadows/ContactShadows.ts +0 -106
  257. package/src/shadows/ShadowDebugViews.ts +0 -46
  258. package/src/threejs-compatibility/InstancingSystem.ts +0 -17
  259. package/src/threejs-compatibility/LightingSystem.ts +0 -22
  260. package/src/threejs-compatibility/MaterialSystem.ts +0 -9
  261. package/src/threejs-compatibility/RenderTargetSystem.ts +0 -35
  262. package/src/threejs-compatibility/RendererDiagnostics.ts +0 -61
  263. package/src/threejs-compatibility/SceneRenderer.ts +0 -34
  264. package/src/threejs-compatibility/ShadowSystem.ts +0 -19
  265. package/src/threejs-compatibility/TextureSystem.ts +0 -19
  266. package/src/threejs-compatibility/ThreeCompatRenderer.ts +0 -90
  267. package/src/threejs-compatibility/TransparencySystem.ts +0 -19
  268. package/src/threejs-compatibility/index.ts +0 -29
  269. package/src/threejs-compatibility/performance/BVH.ts +0 -14
  270. package/src/threejs-compatibility/performance/FrustumCulling.ts +0 -10
  271. package/src/threejs-compatibility/performance/Instancing.ts +0 -4
  272. package/src/threejs-compatibility/performance/LODSystem.ts +0 -16
  273. package/src/threejs-compatibility/performance/OcclusionCulling.ts +0 -6
  274. package/src/threejs-compatibility/performance/RaycastAcceleration.ts +0 -12
  275. package/src/threejs-compatibility/performance/RendererProfiler.ts +0 -19
  276. package/src/threejs-compatibility/performance/TextureStreaming.ts +0 -4
  277. package/src/threejs-compatibility/performance/index.ts +0 -12
  278. package/src/threejs-compatibility/postprocess/BloomPass.ts +0 -16
  279. package/src/threejs-compatibility/postprocess/ColorGradingPass.ts +0 -16
  280. package/src/threejs-compatibility/postprocess/DepthOfFieldPass.ts +0 -21
  281. package/src/threejs-compatibility/postprocess/EffectComposer.ts +0 -14
  282. package/src/threejs-compatibility/postprocess/FXAAPass.ts +0 -15
  283. package/src/threejs-compatibility/postprocess/MotionBlurPass.ts +0 -20
  284. package/src/threejs-compatibility/postprocess/OutlinePass.ts +0 -21
  285. package/src/threejs-compatibility/postprocess/PostProcessTypes.ts +0 -169
  286. package/src/threejs-compatibility/postprocess/RenderPass.ts +0 -9
  287. package/src/threejs-compatibility/postprocess/SMAAPass.ts +0 -15
  288. package/src/threejs-compatibility/postprocess/SSAOPass.ts +0 -21
  289. package/src/threejs-compatibility/postprocess/ShaderPass.ts +0 -7
  290. package/src/threejs-compatibility/postprocess/TAAPass.ts +0 -15
  291. package/src/threejs-compatibility/postprocess/VignettePass.ts +0 -16
  292. package/src/threejs-compatibility/postprocess/index.ts +0 -15
  293. package/src/threejs-compatibility/shaders/NodeMaterial.ts +0 -21
  294. package/src/threejs-compatibility/shaders/RawShaderMaterial.ts +0 -6
  295. package/src/threejs-compatibility/shaders/ShaderDiagnostics.ts +0 -17
  296. package/src/threejs-compatibility/shaders/ShaderMaterial.ts +0 -18
  297. package/src/threejs-compatibility/shaders/ThreeCompatShaderChunks.ts +0 -6
  298. package/src/threejs-compatibility/shaders/Uniforms.ts +0 -18
  299. package/src/threejs-compatibility/shaders/index.ts +0 -9
  300. package/src/threejs-compatibility/vfx/GPUPointCloud.ts +0 -7
  301. package/src/threejs-compatibility/vfx/LineRenderer.ts +0 -13
  302. package/src/threejs-compatibility/vfx/ParticleSystem.ts +0 -23
  303. package/src/threejs-compatibility/vfx/SpriteSystem.ts +0 -14
  304. package/src/threejs-compatibility/vfx/TrailRenderer.ts +0 -8
  305. package/src/threejs-compatibility/vfx/VFXDiagnostics.ts +0 -23
  306. package/src/threejs-compatibility/vfx/index.ts +0 -9
  307. package/src/threejs-example-parity/index.ts +0 -205
  308. package/src/webgpu/WebGPUBuffer.ts +0 -1
  309. package/src/webgpu/WebGPUCompute.ts +0 -2
  310. package/src/webgpu/WebGPUPipelineCache.ts +0 -15
  311. package/src/webgpu/WebGPUPostProcess.ts +0 -2
  312. package/src/webgpu/WebGPUTexture.ts +0 -2
  313. package/tsconfig.json +0 -26
  314. package/vitest.config.ts +0 -20
@@ -1,60 +0,0 @@
1
- import { type ColorLike } from "./Particle.js";
2
- import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
3
- import type { Particle } from "./Particle.js";
4
-
5
- export interface ColorKeyframe {
6
- time: number;
7
- color: ColorLike;
8
- }
9
-
10
- function validateGradient(keyframes: readonly ColorKeyframe[]): void {
11
- if (keyframes.length === 0) {
12
- throw new RangeError("ColorModule requires at least one color keyframe.");
13
- }
14
-
15
- let previous = -Number.POSITIVE_INFINITY;
16
- for (const keyframe of keyframes) {
17
- if (keyframe.time < 0 || keyframe.time > 1 || keyframe.time < previous) {
18
- throw new RangeError("ColorModule keyframe times must be sorted in the normalized range [0, 1].");
19
- }
20
- previous = keyframe.time;
21
- }
22
- }
23
-
24
- export function sampleColorGradient(keyframes: readonly ColorKeyframe[], time: number): ColorLike {
25
- if (time <= keyframes[0].time) {
26
- return { ...keyframes[0].color };
27
- }
28
-
29
- for (let index = 1; index < keyframes.length; index += 1) {
30
- const next = keyframes[index];
31
- if (time <= next.time) {
32
- const previous = keyframes[index - 1];
33
- const span = next.time - previous.time || 1;
34
- const alpha = (time - previous.time) / span;
35
-
36
- return {
37
- r: previous.color.r + (next.color.r - previous.color.r) * alpha,
38
- g: previous.color.g + (next.color.g - previous.color.g) * alpha,
39
- b: previous.color.b + (next.color.b - previous.color.b) * alpha,
40
- a: previous.color.a + (next.color.a - previous.color.a) * alpha,
41
- };
42
- }
43
- }
44
-
45
- return { ...keyframes[keyframes.length - 1].color };
46
- }
47
-
48
- export class ColorModule implements ParticleModule {
49
- readonly name = "ColorModule";
50
- readonly gradient: readonly ColorKeyframe[];
51
-
52
- constructor(gradient: readonly ColorKeyframe[]) {
53
- this.gradient = gradient;
54
- validateGradient(gradient);
55
- }
56
-
57
- update(particle: Particle, context: ParticleUpdateContext): void {
58
- particle.color = sampleColorGradient(this.gradient, context.normalizedAge);
59
- }
60
- }
@@ -1,25 +0,0 @@
1
- import type { Particle, Vector3Like } from "./Particle.js";
2
- import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
3
-
4
- export type ForceSampler = Vector3Like | ((particle: Particle, context: ParticleUpdateContext) => Vector3Like);
5
-
6
- export class ForceModule implements ParticleModule {
7
- readonly name = "ForceModule";
8
- readonly force: ForceSampler;
9
-
10
- constructor(force: ForceSampler) {
11
- this.force = force;
12
- }
13
-
14
- update(particle: Particle, context: ParticleUpdateContext): void {
15
- const force = typeof this.force === "function" ? this.force(particle, context) : this.force;
16
-
17
- particle.velocity.x += force.x * context.deltaTime;
18
- particle.velocity.y += force.y * context.deltaTime;
19
- particle.velocity.z += force.z * context.deltaTime;
20
- }
21
- }
22
-
23
- export function gravityForce(gravity = -9.81): ForceModule {
24
- return new ForceModule({ x: 0, y: gravity, z: 0 });
25
- }
@@ -1,569 +0,0 @@
1
- const BUFFER_USAGE = {
2
- MAP_READ: 0x0001,
3
- COPY_SRC: 0x0004,
4
- COPY_DST: 0x0008,
5
- UNIFORM: 0x0040,
6
- STORAGE: 0x0080,
7
- } as const;
8
-
9
- const MAP_MODE = {
10
- READ: 0x0001,
11
- } as const;
12
-
13
- const WORKGROUP_SIZE = 64;
14
-
15
- export interface GPUParticleBackendCapabilities {
16
- supported: boolean;
17
- backend: "webgpu" | "webgl2" | "none";
18
- reason?: string;
19
- adapterName?: string;
20
- }
21
-
22
- export interface GPUParticleUpdateInput {
23
- positions: Float32Array;
24
- velocities: Float32Array;
25
- accelerations?: Float32Array;
26
- deltaTime: number;
27
- count: number;
28
- }
29
-
30
- export interface GPUParticleUpdateResult {
31
- backend: "webgpu";
32
- count: number;
33
- workgroups: number;
34
- positions: Float32Array;
35
- velocities: Float32Array;
36
- }
37
-
38
- export interface GPUParticleSpawnInput {
39
- positions: Float32Array;
40
- velocities: Float32Array;
41
- accelerations?: Float32Array;
42
- count: number;
43
- }
44
-
45
- export interface GPUParticleSpawnResult {
46
- backend: "webgpu";
47
- count: number;
48
- workgroups: number;
49
- positions: Float32Array;
50
- velocities: Float32Array;
51
- accelerations: Float32Array;
52
- }
53
-
54
- export interface GPUParticleBackend {
55
- readonly capabilities: GPUParticleBackendCapabilities;
56
- initialize(): Promise<void>;
57
- spawn?(input: GPUParticleSpawnInput): Promise<GPUParticleSpawnResult>;
58
- update(input: GPUParticleUpdateInput): Promise<GPUParticleUpdateResult>;
59
- dispose(): void;
60
- }
61
-
62
- interface WebGPULike {
63
- requestAdapter(): Promise<WebGPUAdapterLike | null>;
64
- }
65
-
66
- interface WebGPUAdapterLike {
67
- requestDevice(): Promise<WebGPUDeviceLike>;
68
- name?: string;
69
- info?: {
70
- vendor?: string;
71
- architecture?: string;
72
- device?: string;
73
- description?: string;
74
- };
75
- }
76
-
77
- interface WebGPUDeviceLike {
78
- queue: WebGPUQueueLike;
79
- createShaderModule(descriptor: { code: string; label?: string }): WebGPUShaderModuleLike;
80
- createComputePipeline(descriptor: { label?: string; layout: "auto"; compute: { module: WebGPUShaderModuleLike; entryPoint: string } }): WebGPUComputePipelineLike;
81
- createBuffer(descriptor: { label?: string; size: number; usage: number; mappedAtCreation?: boolean }): WebGPUBufferLike;
82
- createBindGroup(descriptor: { label?: string; layout: unknown; entries: readonly WebGPUBindGroupEntryLike[] }): WebGPUBindGroupLike;
83
- createCommandEncoder(descriptor?: { label?: string }): WebGPUCommandEncoderLike;
84
- destroy?(): void;
85
- }
86
-
87
- interface WebGPUQueueLike {
88
- writeBuffer(buffer: WebGPUBufferLike, offset: number, data: ArrayBuffer | ArrayBufferView, dataOffset?: number, size?: number): void;
89
- submit(commands: readonly unknown[]): void;
90
- }
91
-
92
- interface WebGPUShaderModuleLike {}
93
-
94
- interface WebGPUComputePipelineLike {
95
- getBindGroupLayout(index: number): unknown;
96
- }
97
-
98
- interface WebGPUBindGroupLike {}
99
-
100
- interface WebGPUBindGroupEntryLike {
101
- binding: number;
102
- resource: { buffer: WebGPUBufferLike };
103
- }
104
-
105
- interface WebGPUBufferLike {
106
- mapAsync(mode: number): Promise<void>;
107
- getMappedRange(): ArrayBuffer;
108
- unmap(): void;
109
- destroy(): void;
110
- }
111
-
112
- interface WebGPUCommandEncoderLike {
113
- beginComputePass(descriptor?: { label?: string }): WebGPUComputePassEncoderLike;
114
- copyBufferToBuffer(source: WebGPUBufferLike, sourceOffset: number, destination: WebGPUBufferLike, destinationOffset: number, size: number): void;
115
- finish(): unknown;
116
- }
117
-
118
- interface WebGPUComputePassEncoderLike {
119
- setPipeline(pipeline: WebGPUComputePipelineLike): void;
120
- setBindGroup(index: number, bindGroup: WebGPUBindGroupLike): void;
121
- dispatchWorkgroups(x: number): void;
122
- end(): void;
123
- }
124
-
125
- export interface WebGPUParticleBackendOptions {
126
- gpu?: WebGPULike;
127
- shaderSource?: string;
128
- }
129
-
130
- export function detectGPUParticleBackend(globalScope: Pick<typeof globalThis, "navigator"> = globalThis): GPUParticleBackendCapabilities {
131
- const gpu = readWebGPU(globalScope);
132
-
133
- if (gpu) {
134
- return { supported: true, backend: "webgpu" };
135
- }
136
-
137
- return {
138
- supported: false,
139
- backend: "none",
140
- reason: "GPU particle simulation requires WebGPU; CPU particles remain the supported path on this runtime.",
141
- };
142
- }
143
-
144
- export async function queryGPUParticleBackendCapabilities(
145
- globalScope: Pick<typeof globalThis, "navigator"> = globalThis,
146
- ): Promise<GPUParticleBackendCapabilities> {
147
- const gpu = readWebGPU(globalScope);
148
- if (!gpu) {
149
- return detectGPUParticleBackend(globalScope);
150
- }
151
-
152
- const adapter = await gpu.requestAdapter();
153
- if (!adapter) {
154
- return {
155
- supported: false,
156
- backend: "webgpu",
157
- reason: "WebGPU exists but no adapter was granted for particle simulation.",
158
- };
159
- }
160
-
161
- return {
162
- supported: true,
163
- backend: "webgpu",
164
- adapterName: describeAdapter(adapter),
165
- };
166
- }
167
-
168
- export function createGPUParticleBackend(options: WebGPUParticleBackendOptions = {}): GPUParticleBackend {
169
- const gpu = options.gpu ?? readWebGPU(globalThis);
170
- return gpu ? new WebGPUParticleBackend({ ...options, gpu }) : new UnsupportedGPUParticleBackend();
171
- }
172
-
173
- export class UnsupportedGPUParticleBackend implements GPUParticleBackend {
174
- readonly capabilities: GPUParticleBackendCapabilities;
175
-
176
- constructor(capabilities: GPUParticleBackendCapabilities = detectGPUParticleBackend()) {
177
- this.capabilities = capabilities.supported
178
- ? {
179
- supported: false,
180
- backend: capabilities.backend,
181
- reason: "GPU particle simulation is not supported by the current runtime configuration.",
182
- }
183
- : capabilities;
184
- }
185
-
186
- async initialize(): Promise<void> {
187
- throw new Error(this.capabilities.reason ?? "GPU particle simulation is not supported by this runtime.");
188
- }
189
-
190
- async update(): Promise<GPUParticleUpdateResult> {
191
- throw new Error(this.capabilities.reason ?? "GPU particle simulation is not supported by this runtime.");
192
- }
193
-
194
- dispose(): void {
195
- // No native resources are owned when the backend is unsupported.
196
- }
197
- }
198
-
199
- export class WebGPUParticleBackend implements GPUParticleBackend {
200
- readonly capabilities: GPUParticleBackendCapabilities = { supported: true, backend: "webgpu" };
201
-
202
- private readonly gpu: WebGPULike;
203
- private readonly shaderSource: string;
204
- private adapter: WebGPUAdapterLike | null = null;
205
- private device: WebGPUDeviceLike | null = null;
206
- private updatePipeline: WebGPUComputePipelineLike | null = null;
207
- private spawnPipeline: WebGPUComputePipelineLike | null = null;
208
-
209
- constructor(options: WebGPUParticleBackendOptions = {}) {
210
- const gpu = options.gpu ?? readWebGPU(globalThis);
211
- if (!gpu) {
212
- throw new Error("WebGPUParticleBackend requires a WebGPU-capable runtime or an injected gpu adapter.");
213
- }
214
-
215
- this.gpu = gpu;
216
- this.shaderSource = options.shaderSource ?? createDefaultParticleComputeShader();
217
- }
218
-
219
- async initialize(): Promise<void> {
220
- if (this.device && this.updatePipeline && this.spawnPipeline) {
221
- return;
222
- }
223
-
224
- this.adapter = await this.gpu.requestAdapter();
225
- if (!this.adapter) {
226
- throw new Error("WebGPU adapter request failed for particle simulation.");
227
- }
228
-
229
- this.device = await this.adapter.requestDevice();
230
- const module = this.device.createShaderModule({
231
- label: "aura3d-particles-update",
232
- code: this.shaderSource,
233
- });
234
- this.updatePipeline = this.device.createComputePipeline({
235
- label: "aura3d-particles-update",
236
- layout: "auto",
237
- compute: {
238
- module,
239
- entryPoint: "main",
240
- },
241
- });
242
- this.spawnPipeline = this.device.createComputePipeline({
243
- label: "aura3d-particles-spawn",
244
- layout: "auto",
245
- compute: {
246
- module,
247
- entryPoint: "spawn_main",
248
- },
249
- });
250
- }
251
-
252
- async spawn(input: GPUParticleSpawnInput): Promise<GPUParticleSpawnResult> {
253
- validateSpawnInput(input);
254
-
255
- if (input.count === 0) {
256
- return {
257
- backend: "webgpu",
258
- count: 0,
259
- workgroups: 0,
260
- positions: input.positions.slice(),
261
- velocities: input.velocities.slice(),
262
- accelerations: input.accelerations?.slice() ?? new Float32Array(),
263
- };
264
- }
265
-
266
- await this.initialize();
267
- const device = this.requireDevice();
268
- const pipeline = this.requireSpawnPipeline();
269
- const byteLength = input.count * 4 * Float32Array.BYTES_PER_ELEMENT;
270
-
271
- const positionBuffer = createStorageBuffer(device, "aura3d-particles-spawn-positions", byteLength);
272
- const velocityBuffer = createStorageBuffer(device, "aura3d-particles-spawn-velocities", byteLength);
273
- const accelerationBuffer = createStorageBuffer(device, "aura3d-particles-spawn-accelerations", byteLength);
274
- const paramsBuffer = device.createBuffer({
275
- label: "aura3d-particles-spawn-params",
276
- size: 16,
277
- usage: BUFFER_USAGE.UNIFORM | BUFFER_USAGE.COPY_DST,
278
- });
279
- const positionReadback = createReadbackBuffer(device, "aura3d-particles-spawn-positions-readback", byteLength);
280
- const velocityReadback = createReadbackBuffer(device, "aura3d-particles-spawn-velocities-readback", byteLength);
281
- const accelerationReadback = createReadbackBuffer(device, "aura3d-particles-spawn-accelerations-readback", byteLength);
282
-
283
- try {
284
- device.queue.writeBuffer(positionBuffer, 0, viewParticleSlice(input.positions, input.count));
285
- device.queue.writeBuffer(velocityBuffer, 0, viewParticleSlice(input.velocities, input.count));
286
- device.queue.writeBuffer(accelerationBuffer, 0, viewParticleSlice(input.accelerations ?? new Float32Array(input.count * 4), input.count));
287
- device.queue.writeBuffer(paramsBuffer, 0, createParamsBuffer(0, input.count));
288
-
289
- const bindGroup = device.createBindGroup({
290
- label: "aura3d-particles-spawn-bind-group",
291
- layout: pipeline.getBindGroupLayout(0),
292
- entries: [
293
- { binding: 0, resource: { buffer: positionBuffer } },
294
- { binding: 1, resource: { buffer: velocityBuffer } },
295
- { binding: 2, resource: { buffer: accelerationBuffer } },
296
- { binding: 3, resource: { buffer: paramsBuffer } },
297
- ],
298
- });
299
- const commandEncoder = device.createCommandEncoder({ label: "aura3d-particles-spawn-encoder" });
300
- const computePass = commandEncoder.beginComputePass({ label: "aura3d-particles-spawn-pass" });
301
- computePass.setPipeline(pipeline);
302
- computePass.setBindGroup(0, bindGroup);
303
- const workgroups = Math.ceil(input.count / WORKGROUP_SIZE);
304
- computePass.dispatchWorkgroups(workgroups);
305
- computePass.end();
306
- commandEncoder.copyBufferToBuffer(positionBuffer, 0, positionReadback, 0, byteLength);
307
- commandEncoder.copyBufferToBuffer(velocityBuffer, 0, velocityReadback, 0, byteLength);
308
- commandEncoder.copyBufferToBuffer(accelerationBuffer, 0, accelerationReadback, 0, byteLength);
309
-
310
- device.queue.submit([commandEncoder.finish()]);
311
-
312
- const [positions, velocities, accelerations] = await Promise.all([
313
- readFloat32Buffer(positionReadback, byteLength),
314
- readFloat32Buffer(velocityReadback, byteLength),
315
- readFloat32Buffer(accelerationReadback, byteLength),
316
- ]);
317
-
318
- return {
319
- backend: "webgpu",
320
- count: input.count,
321
- workgroups,
322
- positions,
323
- velocities,
324
- accelerations,
325
- };
326
- } finally {
327
- positionBuffer.destroy();
328
- velocityBuffer.destroy();
329
- accelerationBuffer.destroy();
330
- paramsBuffer.destroy();
331
- positionReadback.destroy();
332
- velocityReadback.destroy();
333
- accelerationReadback.destroy();
334
- }
335
- }
336
-
337
- async update(input: GPUParticleUpdateInput): Promise<GPUParticleUpdateResult> {
338
- validateUpdateInput(input);
339
-
340
- if (input.count === 0) {
341
- return {
342
- backend: "webgpu",
343
- count: 0,
344
- workgroups: 0,
345
- positions: input.positions.slice(),
346
- velocities: input.velocities.slice(),
347
- };
348
- }
349
-
350
- await this.initialize();
351
- const device = this.requireDevice();
352
- const pipeline = this.requireUpdatePipeline();
353
- const byteLength = input.count * 4 * Float32Array.BYTES_PER_ELEMENT;
354
-
355
- const positionBuffer = createStorageBuffer(device, "aura3d-particles-positions", byteLength);
356
- const velocityBuffer = createStorageBuffer(device, "aura3d-particles-velocities", byteLength);
357
- const accelerationBuffer = createStorageBuffer(device, "aura3d-particles-accelerations", byteLength);
358
- const paramsBuffer = device.createBuffer({
359
- label: "aura3d-particles-params",
360
- size: 16,
361
- usage: BUFFER_USAGE.UNIFORM | BUFFER_USAGE.COPY_DST,
362
- });
363
- const positionReadback = createReadbackBuffer(device, "aura3d-particles-positions-readback", byteLength);
364
- const velocityReadback = createReadbackBuffer(device, "aura3d-particles-velocities-readback", byteLength);
365
-
366
- try {
367
- device.queue.writeBuffer(positionBuffer, 0, viewParticleSlice(input.positions, input.count));
368
- device.queue.writeBuffer(velocityBuffer, 0, viewParticleSlice(input.velocities, input.count));
369
- device.queue.writeBuffer(accelerationBuffer, 0, viewParticleSlice(input.accelerations ?? new Float32Array(input.count * 4), input.count));
370
- device.queue.writeBuffer(paramsBuffer, 0, createParamsBuffer(input.deltaTime, input.count));
371
-
372
- const bindGroup = device.createBindGroup({
373
- label: "aura3d-particles-update-bind-group",
374
- layout: pipeline.getBindGroupLayout(0),
375
- entries: [
376
- { binding: 0, resource: { buffer: positionBuffer } },
377
- { binding: 1, resource: { buffer: velocityBuffer } },
378
- { binding: 2, resource: { buffer: accelerationBuffer } },
379
- { binding: 3, resource: { buffer: paramsBuffer } },
380
- ],
381
- });
382
- const commandEncoder = device.createCommandEncoder({ label: "aura3d-particles-update-encoder" });
383
- const computePass = commandEncoder.beginComputePass({ label: "aura3d-particles-update-pass" });
384
- computePass.setPipeline(pipeline);
385
- computePass.setBindGroup(0, bindGroup);
386
- const workgroups = Math.ceil(input.count / WORKGROUP_SIZE);
387
- computePass.dispatchWorkgroups(workgroups);
388
- computePass.end();
389
- commandEncoder.copyBufferToBuffer(positionBuffer, 0, positionReadback, 0, byteLength);
390
- commandEncoder.copyBufferToBuffer(velocityBuffer, 0, velocityReadback, 0, byteLength);
391
-
392
- device.queue.submit([commandEncoder.finish()]);
393
-
394
- const [positions, velocities] = await Promise.all([
395
- readFloat32Buffer(positionReadback, byteLength),
396
- readFloat32Buffer(velocityReadback, byteLength),
397
- ]);
398
-
399
- return {
400
- backend: "webgpu",
401
- count: input.count,
402
- workgroups,
403
- positions,
404
- velocities,
405
- };
406
- } finally {
407
- positionBuffer.destroy();
408
- velocityBuffer.destroy();
409
- accelerationBuffer.destroy();
410
- paramsBuffer.destroy();
411
- positionReadback.destroy();
412
- velocityReadback.destroy();
413
- }
414
- }
415
-
416
- dispose(): void {
417
- this.updatePipeline = null;
418
- this.spawnPipeline = null;
419
- this.adapter = null;
420
- this.device?.destroy?.();
421
- this.device = null;
422
- }
423
-
424
- private requireDevice(): WebGPUDeviceLike {
425
- if (!this.device) {
426
- throw new Error("WebGPU particle backend was not initialized.");
427
- }
428
- return this.device;
429
- }
430
-
431
- private requireUpdatePipeline(): WebGPUComputePipelineLike {
432
- if (!this.updatePipeline) {
433
- throw new Error("WebGPU particle update compute pipeline was not initialized.");
434
- }
435
- return this.updatePipeline;
436
- }
437
-
438
- private requireSpawnPipeline(): WebGPUComputePipelineLike {
439
- if (!this.spawnPipeline) {
440
- throw new Error("WebGPU particle spawn compute pipeline was not initialized.");
441
- }
442
- return this.spawnPipeline;
443
- }
444
- }
445
-
446
- function readWebGPU(globalScope: Pick<typeof globalThis, "navigator">): WebGPULike | undefined {
447
- return (globalScope.navigator as Navigator & { gpu?: WebGPULike } | undefined)?.gpu;
448
- }
449
-
450
- function describeAdapter(adapter: WebGPUAdapterLike): string | undefined {
451
- if (adapter.name) {
452
- return adapter.name;
453
- }
454
-
455
- if (!adapter.info) {
456
- return undefined;
457
- }
458
-
459
- const parts = [adapter.info.vendor, adapter.info.architecture, adapter.info.device, adapter.info.description].filter(Boolean);
460
- return parts.length > 0 ? parts.join(" ") : undefined;
461
- }
462
-
463
- function validateUpdateInput(input: GPUParticleUpdateInput): void {
464
- if (!Number.isFinite(input.deltaTime) || input.deltaTime < 0) {
465
- throw new RangeError("GPU particle deltaTime must be a finite non-negative number.");
466
- }
467
-
468
- if (!Number.isInteger(input.count) || input.count < 0) {
469
- throw new RangeError("GPU particle count must be a non-negative integer.");
470
- }
471
-
472
- const requiredFloats = input.count * 4;
473
- if (input.positions.length < requiredFloats || input.velocities.length < requiredFloats) {
474
- throw new RangeError("GPU particle positions and velocities must provide vec4 values for each particle.");
475
- }
476
- if (input.accelerations && input.accelerations.length < requiredFloats) {
477
- throw new RangeError("GPU particle accelerations must provide vec4 values for each particle.");
478
- }
479
- }
480
-
481
- function validateSpawnInput(input: GPUParticleSpawnInput): void {
482
- if (!Number.isInteger(input.count) || input.count < 0) {
483
- throw new RangeError("GPU particle spawn count must be a non-negative integer.");
484
- }
485
-
486
- const requiredFloats = input.count * 4;
487
- if (input.positions.length < requiredFloats || input.velocities.length < requiredFloats) {
488
- throw new RangeError("GPU particle spawn positions and velocities must provide vec4 values for each particle.");
489
- }
490
- if (input.accelerations && input.accelerations.length < requiredFloats) {
491
- throw new RangeError("GPU particle spawn accelerations must provide vec4 values for each particle.");
492
- }
493
- }
494
-
495
- function createStorageBuffer(device: WebGPUDeviceLike, label: string, size: number): WebGPUBufferLike {
496
- return device.createBuffer({
497
- label,
498
- size,
499
- usage: BUFFER_USAGE.STORAGE | BUFFER_USAGE.COPY_DST | BUFFER_USAGE.COPY_SRC,
500
- });
501
- }
502
-
503
- function createReadbackBuffer(device: WebGPUDeviceLike, label: string, size: number): WebGPUBufferLike {
504
- return device.createBuffer({
505
- label,
506
- size,
507
- usage: BUFFER_USAGE.MAP_READ | BUFFER_USAGE.COPY_DST,
508
- });
509
- }
510
-
511
- function viewParticleSlice(values: Float32Array, count: number): Float32Array {
512
- const floatCount = count * 4;
513
- return values.byteOffset === 0 && values.length === floatCount ? values : values.slice(0, floatCount);
514
- }
515
-
516
- function createParamsBuffer(deltaTime: number, count: number): ArrayBuffer {
517
- const buffer = new ArrayBuffer(16);
518
- const view = new DataView(buffer);
519
- view.setFloat32(0, deltaTime, true);
520
- view.setUint32(4, count, true);
521
- return buffer;
522
- }
523
-
524
- async function readFloat32Buffer(buffer: WebGPUBufferLike, byteLength: number): Promise<Float32Array> {
525
- await buffer.mapAsync(MAP_MODE.READ);
526
- const mapped = buffer.getMappedRange();
527
- const copy = mapped.slice(0, byteLength);
528
- buffer.unmap();
529
- return new Float32Array(copy);
530
- }
531
-
532
- function createDefaultParticleComputeShader(): string {
533
- return `
534
- struct SimParams {
535
- deltaTime: f32,
536
- count: u32,
537
- pad0: u32,
538
- pad1: u32,
539
- };
540
-
541
- @group(0) @binding(0) var<storage, read_write> positions: array<vec4<f32>>;
542
- @group(0) @binding(1) var<storage, read_write> velocities: array<vec4<f32>>;
543
- @group(0) @binding(2) var<storage, read> accelerations: array<vec4<f32>>;
544
- @group(0) @binding(3) var<uniform> params: SimParams;
545
-
546
- @compute @workgroup_size(${WORKGROUP_SIZE})
547
- fn main(@builtin(global_invocation_id) globalId: vec3<u32>) {
548
- let index = globalId.x;
549
- if (index >= params.count) {
550
- return;
551
- }
552
-
553
- velocities[index].xyz = velocities[index].xyz + accelerations[index].xyz * params.deltaTime;
554
- positions[index].xyz = positions[index].xyz + velocities[index].xyz * params.deltaTime;
555
- positions[index].w = positions[index].w + params.deltaTime;
556
- }
557
-
558
- @compute @workgroup_size(${WORKGROUP_SIZE})
559
- fn spawn_main(@builtin(global_invocation_id) globalId: vec3<u32>) {
560
- let index = globalId.x;
561
- if (index >= params.count) {
562
- return;
563
- }
564
-
565
- positions[index] = positions[index];
566
- velocities[index] = velocities[index];
567
- }
568
- `;
569
- }