@aura3d/rendering 1.4.0 → 1.4.2

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 (308) hide show
  1. package/package.json +38 -4
  2. package/AGENTS.md +0 -46
  3. package/src/ArchitecturalLightingFixtures.ts +0 -241
  4. package/src/ArchitecturalMaterialCatalog.ts +0 -130
  5. package/src/ArchitecturalMeasurementFixtures.ts +0 -155
  6. package/src/BRDFLut.ts +0 -47
  7. package/src/CameraFraming.ts +0 -200
  8. package/src/CanonicalSceneFixtures.ts +0 -95
  9. package/src/CascadedShadowMaps.ts +0 -449
  10. package/src/ColorManagement.ts +0 -127
  11. package/src/CullingFixtures.ts +0 -280
  12. package/src/DecalGeometry.ts +0 -26
  13. package/src/DepthPass.ts +0 -110
  14. package/src/EnvironmentBackgroundPass.ts +0 -194
  15. package/src/EnvironmentBackgroundResources.ts +0 -309
  16. package/src/EnvironmentLighting.ts +0 -96
  17. package/src/EnvironmentMapResources.ts +0 -1026
  18. package/src/EnvironmentPipeline.ts +0 -69
  19. package/src/EnvironmentPlatform.ts +0 -1306
  20. package/src/EnvironmentPreset.ts +0 -155
  21. package/src/Exposure.ts +0 -66
  22. package/src/ExternalParityRenderPreset.ts +0 -725
  23. package/src/ForwardPass.ts +0 -1668
  24. package/src/FrameVisualMetrics.ts +0 -301
  25. package/src/Geometry.ts +0 -461
  26. package/src/GeometryPrimitives.ts +0 -2
  27. package/src/HDRRenderPipeline.ts +0 -94
  28. package/src/IBL.ts +0 -86
  29. package/src/IndexBuffer.ts +0 -57
  30. package/src/InstancedPBRMaterial.ts +0 -186
  31. package/src/InstancedUnlitMaterial.ts +0 -60
  32. package/src/Instancing.ts +0 -19
  33. package/src/LightCollector.ts +0 -82
  34. package/src/LightUniforms.ts +0 -47
  35. package/src/LightingDebug.ts +0 -80
  36. package/src/LightingDefaults.ts +0 -79
  37. package/src/LightingRig.ts +0 -301
  38. package/src/LineGeometry.ts +0 -2
  39. package/src/Material.ts +0 -209
  40. package/src/MaterialBinding.ts +0 -131
  41. package/src/MaterialInstance.ts +0 -59
  42. package/src/MaterialPresets.ts +0 -272
  43. package/src/MorphTarget.ts +0 -124
  44. package/src/MorphTargetPlan.ts +0 -178
  45. package/src/MorphUnlitMaterial.ts +0 -60
  46. package/src/NormalMappedPBRMaterial.ts +0 -188
  47. package/src/OceanFixtures.ts +0 -318
  48. package/src/PBRLightingDefaults.ts +0 -12
  49. package/src/PBRMaterial.ts +0 -442
  50. package/src/PMREM.ts +0 -53
  51. package/src/PbrReference.ts +0 -681
  52. package/src/PostProcessPass.ts +0 -2507
  53. package/src/ProceduralTextureFixtures.ts +0 -393
  54. package/src/ProductTurntableFixtures.ts +0 -815
  55. package/src/Raycaster.ts +0 -21
  56. package/src/ReflectionProbe.ts +0 -13
  57. package/src/ReflectionSurfaces.ts +0 -219
  58. package/src/RenderBackend.ts +0 -43
  59. package/src/RenderDebugViews.ts +0 -138
  60. package/src/RenderDevice.ts +0 -836
  61. package/src/RenderGraph.ts +0 -194
  62. package/src/RenderPass.ts +0 -27
  63. package/src/RenderPipeline.ts +0 -101
  64. package/src/RenderQueue.ts +0 -12
  65. package/src/RenderState.ts +0 -12
  66. package/src/Renderer.ts +0 -2631
  67. package/src/RendererDebugOverlay.ts +0 -80
  68. package/src/RendererFeatureGates.ts +0 -150
  69. package/src/RendererPostprocessPlan.ts +0 -279
  70. package/src/RendererTiming.ts +0 -251
  71. package/src/RendererVisualPipelineReport.ts +0 -836
  72. package/src/ResourceLifecycle.ts +0 -21
  73. package/src/Sampler.ts +0 -37
  74. package/src/SceneOptimization.ts +0 -518
  75. package/src/ShaderChunks.ts +0 -393
  76. package/src/ShaderLibrary.ts +0 -2766
  77. package/src/ShaderModule.ts +0 -36
  78. package/src/ShaderPreprocessor.ts +0 -260
  79. package/src/ShaderReflection.ts +0 -201
  80. package/src/ShadowMap.ts +0 -237
  81. package/src/ShadowPass.ts +0 -198
  82. package/src/ShadowProjection.ts +0 -115
  83. package/src/SkinnedLitMaterial.ts +0 -397
  84. package/src/SkinnedUnlitMaterial.ts +0 -63
  85. package/src/SkinningBounds.ts +0 -131
  86. package/src/SpaceEnvironmentFixtures.ts +0 -200
  87. package/src/SpriteGeometry.ts +0 -21
  88. package/src/StereoCameraRig.ts +0 -127
  89. package/src/StereoEffects.ts +0 -274
  90. package/src/TerrainFixtures.ts +0 -180
  91. package/src/Texture.ts +0 -307
  92. package/src/TextureBinding.ts +0 -91
  93. package/src/TexturedPBRMaterial.ts +0 -1112
  94. package/src/TexturedUnlitMaterial.ts +0 -67
  95. package/src/ToneMapping.ts +0 -105
  96. package/src/UniformBinder.ts +0 -16
  97. package/src/UniformLayout.ts +0 -129
  98. package/src/UnlitMaterial.ts +0 -75
  99. package/src/VegetationFixtures.ts +0 -314
  100. package/src/VertexBuffer.ts +0 -120
  101. package/src/VertexFormat.ts +0 -171
  102. package/src/VoxelWorldFixtures.ts +0 -280
  103. package/src/WeatherFixtures.ts +0 -223
  104. package/src/WebGL2Device.ts +0 -2280
  105. package/src/WebGL2StateCache.ts +0 -330
  106. package/src/WebGPUDevice.ts +0 -2877
  107. package/src/WebGPURenderToTextureProof.ts +0 -139
  108. package/src/advanced-runtime/AdvancedRenderer.ts +0 -73
  109. package/src/advanced-runtime/index.ts +0 -9
  110. package/src/animation/AnimationMaterialStyle.ts +0 -32
  111. package/src/animation/AnimationRenderPreset.ts +0 -45
  112. package/src/animation/AnimationToonMaterial.ts +0 -387
  113. package/src/animation/AnimationVisualQuality.ts +0 -71
  114. package/src/animation/applyAnimationRenderPreset.ts +0 -180
  115. package/src/animation/index.ts +0 -5
  116. package/src/cinematic/BloomPass.ts +0 -26
  117. package/src/cinematic/CinematicDepthComposition.ts +0 -30
  118. package/src/cinematic/CinematicEvidence.ts +0 -123
  119. package/src/cinematic/CinematicLightingRig.ts +0 -144
  120. package/src/cinematic/CinematicMaterialPresets.ts +0 -130
  121. package/src/cinematic/CinematicPostProcess.ts +0 -83
  122. package/src/cinematic/DepthHazePass.ts +0 -30
  123. package/src/cinematic/EmissivePracticalLightSystem.ts +0 -45
  124. package/src/cinematic/FilmGrainPass.ts +0 -24
  125. package/src/cinematic/FogVolumeSystem.ts +0 -30
  126. package/src/cinematic/GlowCardSystem.ts +0 -44
  127. package/src/cinematic/RainParticleSystem.ts +0 -151
  128. package/src/cinematic/VignettePass.ts +0 -25
  129. package/src/cinematic/WetReflectionApproximation.ts +0 -27
  130. package/src/cinematic/index.ts +0 -14
  131. package/src/effects/CollisionModule.ts +0 -64
  132. package/src/effects/ColorModule.ts +0 -60
  133. package/src/effects/ForceModule.ts +0 -25
  134. package/src/effects/GPUParticleBackend.ts +0 -569
  135. package/src/effects/Particle.ts +0 -108
  136. package/src/effects/ParticleDiagnostics.ts +0 -224
  137. package/src/effects/ParticleEffectPresets.ts +0 -147
  138. package/src/effects/ParticleEmitter.ts +0 -326
  139. package/src/effects/ParticleModule.ts +0 -26
  140. package/src/effects/ParticleRenderPass.ts +0 -117
  141. package/src/effects/ParticleRenderer.ts +0 -132
  142. package/src/effects/ParticleSystem.ts +0 -333
  143. package/src/effects/SizeModule.ts +0 -56
  144. package/src/effects/TrailModule.ts +0 -72
  145. package/src/effects/VelocityModule.ts +0 -75
  146. package/src/effects/index.ts +0 -15
  147. package/src/index.ts +0 -925
  148. package/src/materials/AlphaSorting.ts +0 -30
  149. package/src/materials/MaterialExtensions.ts +0 -42
  150. package/src/materials/PhysicalMaterial.ts +0 -133
  151. package/src/materials/TransmissionPass.ts +0 -51
  152. package/src/performance/BVH.ts +0 -18
  153. package/src/performance/Batcher.ts +0 -2
  154. package/src/performance/FrustumCuller.ts +0 -9
  155. package/src/performance/LOD.ts +0 -20
  156. package/src/performance/Octree.ts +0 -10
  157. package/src/performance/RenderItemSorting.ts +0 -170
  158. package/src/performance/RendererStats.ts +0 -43
  159. package/src/performance/ResourceBudget.ts +0 -44
  160. package/src/postprocess/BloomPass.ts +0 -28
  161. package/src/postprocess/CinematicDiagnostics.ts +0 -642
  162. package/src/postprocess/ColorGradingPass.ts +0 -24
  163. package/src/postprocess/DepthOfFieldPass.ts +0 -12
  164. package/src/postprocess/EffectComposer.ts +0 -349
  165. package/src/postprocess/SSAOPass.ts +0 -20
  166. package/src/postprocess/index.ts +0 -34
  167. package/src/production-runtime/AnimationControlsPipeline.ts +0 -77
  168. package/src/production-runtime/PBRHDRPipeline.ts +0 -381
  169. package/src/production-runtime/ProductionEffectsPipeline.ts +0 -85
  170. package/src/production-runtime/ProductionRendererTypes.ts +0 -136
  171. package/src/production-runtime/ProductionRuntimeRenderer.ts +0 -172
  172. package/src/production-runtime/ProductionWebGL2Renderer.ts +0 -313
  173. package/src/production-runtime/ProductionWebGPURenderer.ts +0 -396
  174. package/src/production-runtime/TransmissionBackdropCapture.ts +0 -130
  175. package/src/production-runtime/animation/MorphTargetRenderer.ts +0 -2
  176. package/src/production-runtime/animation/SkinningRenderer.ts +0 -2
  177. package/src/production-runtime/backends/RendererBackend.ts +0 -17
  178. package/src/production-runtime/backends/WebGL2RendererBackend.ts +0 -30
  179. package/src/production-runtime/backends/WebGPURendererBackend.ts +0 -24
  180. package/src/production-runtime/backends/webgl2/WebGL2Buffer.ts +0 -2
  181. package/src/production-runtime/backends/webgl2/WebGL2Capabilities.ts +0 -2
  182. package/src/production-runtime/backends/webgl2/WebGL2RenderTarget.ts +0 -2
  183. package/src/production-runtime/backends/webgl2/WebGL2Shader.ts +0 -2
  184. package/src/production-runtime/backends/webgl2/WebGL2StateCache.ts +0 -1
  185. package/src/production-runtime/backends/webgl2/WebGL2Texture.ts +0 -2
  186. package/src/production-runtime/backends/webgpu/WebGPUBuffer.ts +0 -2
  187. package/src/production-runtime/backends/webgpu/WebGPUCapabilities.ts +0 -2
  188. package/src/production-runtime/backends/webgpu/WebGPURenderTarget.ts +0 -2
  189. package/src/production-runtime/backends/webgpu/WebGPUShader.ts +0 -2
  190. package/src/production-runtime/backends/webgpu/WebGPUTexture.ts +0 -2
  191. package/src/production-runtime/color/ColorManagement.ts +0 -3
  192. package/src/production-runtime/color/ToneMapping.ts +0 -7
  193. package/src/production-runtime/diagnostics/FrameCapture.ts +0 -2
  194. package/src/production-runtime/diagnostics/GPUCapabilities.ts +0 -2
  195. package/src/production-runtime/diagnostics/RendererStats.ts +0 -2
  196. package/src/production-runtime/environment/EnvironmentMap.ts +0 -1
  197. package/src/production-runtime/environment/HDRLoader.ts +0 -57
  198. package/src/production-runtime/environment/PMREMGenerator.ts +0 -713
  199. package/src/production-runtime/framegraph/FrameGraph.ts +0 -18
  200. package/src/production-runtime/framegraph/RenderPass.ts +0 -15
  201. package/src/production-runtime/geometry/ProjectedDecalGeometry.ts +0 -439
  202. package/src/production-runtime/index.ts +0 -127
  203. package/src/production-runtime/lights/LightManager.ts +0 -7
  204. package/src/production-runtime/lights/ShadowMapRenderer.ts +0 -5
  205. package/src/production-runtime/materials/GLTFMaterialAdapter.ts +0 -6
  206. package/src/production-runtime/materials/GLTFPBRMaterialAdapter.ts +0 -2
  207. package/src/production-runtime/materials/MaterialCompiler.ts +0 -7
  208. package/src/production-runtime/materials/MaterialTextureBindings.ts +0 -5
  209. package/src/production-runtime/materials/PBRMaterial.ts +0 -2
  210. package/src/production-runtime/materials/PBRShaderFeatures.ts +0 -2
  211. package/src/production-runtime/passes/ContactShadowPass.ts +0 -184
  212. package/src/production-runtime/passes/DepthPrepass.ts +0 -7
  213. package/src/production-runtime/passes/OpaquePass.ts +0 -7
  214. package/src/production-runtime/passes/ShadowPass.ts +0 -7
  215. package/src/production-runtime/passes/SkyboxPass.ts +0 -7
  216. package/src/production-runtime/passes/ToneMappingPass.ts +0 -7
  217. package/src/production-runtime/passes/TransparentPass.ts +0 -7
  218. package/src/production-runtime/postprocess/BloomPass.ts +0 -51
  219. package/src/production-runtime/postprocess/ColorGradingPass.ts +0 -49
  220. package/src/production-runtime/postprocess/DOFPass.ts +0 -47
  221. package/src/production-runtime/postprocess/FXAAPass.ts +0 -53
  222. package/src/production-runtime/postprocess/ProductionEffectComposer.ts +0 -78
  223. package/src/production-runtime/postprocess/ProductionPostProcessTypes.ts +0 -174
  224. package/src/production-runtime/postprocess/SSAOPass.ts +0 -45
  225. package/src/production-runtime/resources/GPUBuffer.ts +0 -2
  226. package/src/production-runtime/resources/GPUTexture.ts +0 -2
  227. package/src/production-runtime/resources/RenderTarget.ts +0 -3
  228. package/src/production-runtime/resources/ResourceCache.ts +0 -7
  229. package/src/production-runtime/scene/Camera.ts +0 -1
  230. package/src/production-runtime/scene/Lights.ts +0 -2
  231. package/src/production-runtime/scene/RenderableMesh.ts +0 -2
  232. package/src/production-runtime/scene/RenderablePrimitive.ts +0 -1
  233. package/src/production-runtime/scene/RenderableScene.ts +0 -4
  234. package/src/production-runtime/shaders/ShaderProgramLibrary.ts +0 -7
  235. package/src/production-runtime/shaders/chunks/brdf.glsl +0 -2
  236. package/src/production-runtime/shaders/chunks/ibl.glsl +0 -3
  237. package/src/production-runtime/shaders/chunks/pbr.frag.glsl +0 -47
  238. package/src/production-runtime/shaders/chunks/pbr.vert.glsl +0 -8
  239. package/src/production-runtime/shaders/chunks/shadows.glsl +0 -2
  240. package/src/production-runtime/shaders/wgsl/pbr.wgsl +0 -3
  241. package/src/production-runtime/shaders/wgsl/postprocess.wgsl +0 -2
  242. package/src/production-runtime/shaders/wgsl/skybox.wgsl +0 -2
  243. package/src/shaders/depth.frag.glsl +0 -5
  244. package/src/shaders/depth.vert.glsl +0 -8
  245. package/src/shaders/pbr-direct.frag.glsl +0 -687
  246. package/src/shaders/pbr-direct.vert.glsl +0 -18
  247. package/src/shaders/unlit.frag.glsl +0 -18
  248. package/src/shaders/unlit.vert.glsl +0 -13
  249. package/src/shadows/CascadedShadowPipeline.ts +0 -53
  250. package/src/shadows/ContactShadows.ts +0 -106
  251. package/src/shadows/ShadowDebugViews.ts +0 -46
  252. package/src/threejs-compatibility/InstancingSystem.ts +0 -17
  253. package/src/threejs-compatibility/LightingSystem.ts +0 -22
  254. package/src/threejs-compatibility/MaterialSystem.ts +0 -9
  255. package/src/threejs-compatibility/RenderTargetSystem.ts +0 -35
  256. package/src/threejs-compatibility/RendererDiagnostics.ts +0 -61
  257. package/src/threejs-compatibility/SceneRenderer.ts +0 -34
  258. package/src/threejs-compatibility/ShadowSystem.ts +0 -19
  259. package/src/threejs-compatibility/TextureSystem.ts +0 -19
  260. package/src/threejs-compatibility/ThreeCompatRenderer.ts +0 -90
  261. package/src/threejs-compatibility/TransparencySystem.ts +0 -19
  262. package/src/threejs-compatibility/index.ts +0 -29
  263. package/src/threejs-compatibility/performance/BVH.ts +0 -14
  264. package/src/threejs-compatibility/performance/FrustumCulling.ts +0 -10
  265. package/src/threejs-compatibility/performance/Instancing.ts +0 -4
  266. package/src/threejs-compatibility/performance/LODSystem.ts +0 -16
  267. package/src/threejs-compatibility/performance/OcclusionCulling.ts +0 -6
  268. package/src/threejs-compatibility/performance/RaycastAcceleration.ts +0 -12
  269. package/src/threejs-compatibility/performance/RendererProfiler.ts +0 -19
  270. package/src/threejs-compatibility/performance/TextureStreaming.ts +0 -4
  271. package/src/threejs-compatibility/performance/index.ts +0 -12
  272. package/src/threejs-compatibility/postprocess/BloomPass.ts +0 -16
  273. package/src/threejs-compatibility/postprocess/ColorGradingPass.ts +0 -16
  274. package/src/threejs-compatibility/postprocess/DepthOfFieldPass.ts +0 -21
  275. package/src/threejs-compatibility/postprocess/EffectComposer.ts +0 -14
  276. package/src/threejs-compatibility/postprocess/FXAAPass.ts +0 -15
  277. package/src/threejs-compatibility/postprocess/MotionBlurPass.ts +0 -20
  278. package/src/threejs-compatibility/postprocess/OutlinePass.ts +0 -21
  279. package/src/threejs-compatibility/postprocess/PostProcessTypes.ts +0 -169
  280. package/src/threejs-compatibility/postprocess/RenderPass.ts +0 -9
  281. package/src/threejs-compatibility/postprocess/SMAAPass.ts +0 -15
  282. package/src/threejs-compatibility/postprocess/SSAOPass.ts +0 -21
  283. package/src/threejs-compatibility/postprocess/ShaderPass.ts +0 -7
  284. package/src/threejs-compatibility/postprocess/TAAPass.ts +0 -15
  285. package/src/threejs-compatibility/postprocess/VignettePass.ts +0 -16
  286. package/src/threejs-compatibility/postprocess/index.ts +0 -15
  287. package/src/threejs-compatibility/shaders/NodeMaterial.ts +0 -21
  288. package/src/threejs-compatibility/shaders/RawShaderMaterial.ts +0 -6
  289. package/src/threejs-compatibility/shaders/ShaderDiagnostics.ts +0 -17
  290. package/src/threejs-compatibility/shaders/ShaderMaterial.ts +0 -18
  291. package/src/threejs-compatibility/shaders/ThreeCompatShaderChunks.ts +0 -6
  292. package/src/threejs-compatibility/shaders/Uniforms.ts +0 -18
  293. package/src/threejs-compatibility/shaders/index.ts +0 -9
  294. package/src/threejs-compatibility/vfx/GPUPointCloud.ts +0 -7
  295. package/src/threejs-compatibility/vfx/LineRenderer.ts +0 -13
  296. package/src/threejs-compatibility/vfx/ParticleSystem.ts +0 -23
  297. package/src/threejs-compatibility/vfx/SpriteSystem.ts +0 -14
  298. package/src/threejs-compatibility/vfx/TrailRenderer.ts +0 -8
  299. package/src/threejs-compatibility/vfx/VFXDiagnostics.ts +0 -23
  300. package/src/threejs-compatibility/vfx/index.ts +0 -9
  301. package/src/threejs-example-parity/index.ts +0 -205
  302. package/src/webgpu/WebGPUBuffer.ts +0 -1
  303. package/src/webgpu/WebGPUCompute.ts +0 -2
  304. package/src/webgpu/WebGPUPipelineCache.ts +0 -15
  305. package/src/webgpu/WebGPUPostProcess.ts +0 -2
  306. package/src/webgpu/WebGPUTexture.ts +0 -2
  307. package/tsconfig.json +0 -26
  308. 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
- }