@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.
- package/dist/ForwardPass.js +7 -1
- package/dist/ForwardPass.js.map +1 -1
- package/dist/MorphTarget.d.ts +1 -0
- package/dist/MorphTarget.d.ts.map +1 -1
- package/dist/MorphTarget.js.map +1 -1
- package/dist/Renderer.js +7 -1
- package/dist/Renderer.js.map +1 -1
- package/package.json +38 -4
- package/src/ArchitecturalLightingFixtures.ts +0 -241
- package/src/ArchitecturalMaterialCatalog.ts +0 -130
- package/src/ArchitecturalMeasurementFixtures.ts +0 -155
- package/src/BRDFLut.ts +0 -47
- package/src/CameraFraming.ts +0 -200
- package/src/CanonicalSceneFixtures.ts +0 -95
- package/src/CascadedShadowMaps.ts +0 -449
- package/src/ColorManagement.ts +0 -127
- package/src/CullingFixtures.ts +0 -280
- package/src/DecalGeometry.ts +0 -26
- package/src/DepthPass.ts +0 -110
- package/src/EnvironmentBackgroundPass.ts +0 -194
- package/src/EnvironmentBackgroundResources.ts +0 -309
- package/src/EnvironmentLighting.ts +0 -96
- package/src/EnvironmentMapResources.ts +0 -1026
- package/src/EnvironmentPipeline.ts +0 -69
- package/src/EnvironmentPlatform.ts +0 -1306
- package/src/EnvironmentPreset.ts +0 -155
- package/src/Exposure.ts +0 -66
- package/src/ExternalParityRenderPreset.ts +0 -725
- package/src/ForwardPass.ts +0 -1663
- package/src/FrameVisualMetrics.ts +0 -301
- package/src/Geometry.ts +0 -461
- package/src/GeometryPrimitives.ts +0 -2
- package/src/HDRRenderPipeline.ts +0 -94
- package/src/IBL.ts +0 -86
- package/src/IndexBuffer.ts +0 -57
- package/src/InstancedPBRMaterial.ts +0 -186
- package/src/InstancedUnlitMaterial.ts +0 -60
- package/src/Instancing.ts +0 -19
- package/src/LightCollector.ts +0 -82
- package/src/LightUniforms.ts +0 -47
- package/src/LightingDebug.ts +0 -80
- package/src/LightingDefaults.ts +0 -79
- package/src/LightingRig.ts +0 -301
- package/src/LineGeometry.ts +0 -2
- package/src/Material.ts +0 -209
- package/src/MaterialBinding.ts +0 -131
- package/src/MaterialInstance.ts +0 -59
- package/src/MaterialPresets.ts +0 -272
- package/src/MorphTarget.ts +0 -123
- package/src/MorphTargetPlan.ts +0 -178
- package/src/MorphUnlitMaterial.ts +0 -60
- package/src/NormalMappedPBRMaterial.ts +0 -188
- package/src/OceanFixtures.ts +0 -318
- package/src/PBRLightingDefaults.ts +0 -12
- package/src/PBRMaterial.ts +0 -442
- package/src/PMREM.ts +0 -53
- package/src/PbrReference.ts +0 -681
- package/src/PostProcessPass.ts +0 -2507
- package/src/ProceduralTextureFixtures.ts +0 -393
- package/src/ProductTurntableFixtures.ts +0 -815
- package/src/Raycaster.ts +0 -21
- package/src/ReflectionProbe.ts +0 -13
- package/src/ReflectionSurfaces.ts +0 -219
- package/src/RenderBackend.ts +0 -43
- package/src/RenderDebugViews.ts +0 -138
- package/src/RenderDevice.ts +0 -836
- package/src/RenderGraph.ts +0 -194
- package/src/RenderPass.ts +0 -27
- package/src/RenderPipeline.ts +0 -101
- package/src/RenderQueue.ts +0 -12
- package/src/RenderState.ts +0 -12
- package/src/Renderer.ts +0 -2626
- package/src/RendererDebugOverlay.ts +0 -80
- package/src/RendererFeatureGates.ts +0 -150
- package/src/RendererPostprocessPlan.ts +0 -279
- package/src/RendererTiming.ts +0 -251
- package/src/RendererVisualPipelineReport.ts +0 -836
- package/src/ResourceLifecycle.ts +0 -21
- package/src/Sampler.ts +0 -37
- package/src/SceneOptimization.ts +0 -518
- package/src/ShaderChunks.ts +0 -393
- package/src/ShaderLibrary.ts +0 -2766
- package/src/ShaderModule.ts +0 -36
- package/src/ShaderPreprocessor.ts +0 -260
- package/src/ShaderReflection.ts +0 -201
- package/src/ShadowMap.ts +0 -237
- package/src/ShadowPass.ts +0 -198
- package/src/ShadowProjection.ts +0 -115
- package/src/SkinnedLitMaterial.ts +0 -397
- package/src/SkinnedUnlitMaterial.ts +0 -63
- package/src/SkinningBounds.ts +0 -131
- package/src/SpaceEnvironmentFixtures.ts +0 -200
- package/src/SpriteGeometry.ts +0 -21
- package/src/StereoCameraRig.ts +0 -127
- package/src/StereoEffects.ts +0 -274
- package/src/TerrainFixtures.ts +0 -180
- package/src/Texture.ts +0 -307
- package/src/TextureBinding.ts +0 -91
- package/src/TexturedPBRMaterial.ts +0 -1112
- package/src/TexturedUnlitMaterial.ts +0 -67
- package/src/ToneMapping.ts +0 -105
- package/src/UniformBinder.ts +0 -16
- package/src/UniformLayout.ts +0 -129
- package/src/UnlitMaterial.ts +0 -75
- package/src/VegetationFixtures.ts +0 -314
- package/src/VertexBuffer.ts +0 -120
- package/src/VertexFormat.ts +0 -171
- package/src/VoxelWorldFixtures.ts +0 -280
- package/src/WeatherFixtures.ts +0 -223
- package/src/WebGL2Device.ts +0 -2280
- package/src/WebGL2StateCache.ts +0 -330
- package/src/WebGPUDevice.ts +0 -2877
- package/src/WebGPURenderToTextureProof.ts +0 -139
- package/src/advanced-runtime/AdvancedRenderer.ts +0 -73
- package/src/advanced-runtime/index.ts +0 -9
- package/src/animation/AnimationMaterialStyle.ts +0 -32
- package/src/animation/AnimationRenderPreset.ts +0 -45
- package/src/animation/AnimationToonMaterial.ts +0 -387
- package/src/animation/AnimationVisualQuality.ts +0 -71
- package/src/animation/applyAnimationRenderPreset.ts +0 -180
- package/src/animation/index.ts +0 -5
- package/src/cinematic/BloomPass.ts +0 -26
- package/src/cinematic/CinematicDepthComposition.ts +0 -30
- package/src/cinematic/CinematicEvidence.ts +0 -123
- package/src/cinematic/CinematicLightingRig.ts +0 -144
- package/src/cinematic/CinematicMaterialPresets.ts +0 -130
- package/src/cinematic/CinematicPostProcess.ts +0 -83
- package/src/cinematic/DepthHazePass.ts +0 -30
- package/src/cinematic/EmissivePracticalLightSystem.ts +0 -45
- package/src/cinematic/FilmGrainPass.ts +0 -24
- package/src/cinematic/FogVolumeSystem.ts +0 -30
- package/src/cinematic/GlowCardSystem.ts +0 -44
- package/src/cinematic/RainParticleSystem.ts +0 -151
- package/src/cinematic/VignettePass.ts +0 -25
- package/src/cinematic/WetReflectionApproximation.ts +0 -27
- package/src/cinematic/index.ts +0 -14
- package/src/effects/CollisionModule.ts +0 -64
- package/src/effects/ColorModule.ts +0 -60
- package/src/effects/ForceModule.ts +0 -25
- package/src/effects/GPUParticleBackend.ts +0 -569
- package/src/effects/Particle.ts +0 -108
- package/src/effects/ParticleDiagnostics.ts +0 -224
- package/src/effects/ParticleEffectPresets.ts +0 -147
- package/src/effects/ParticleEmitter.ts +0 -326
- package/src/effects/ParticleModule.ts +0 -26
- package/src/effects/ParticleRenderPass.ts +0 -117
- package/src/effects/ParticleRenderer.ts +0 -132
- package/src/effects/ParticleSystem.ts +0 -333
- package/src/effects/SizeModule.ts +0 -56
- package/src/effects/TrailModule.ts +0 -72
- package/src/effects/VelocityModule.ts +0 -75
- package/src/effects/index.ts +0 -15
- package/src/index.ts +0 -925
- package/src/materials/AlphaSorting.ts +0 -30
- package/src/materials/MaterialExtensions.ts +0 -42
- package/src/materials/PhysicalMaterial.ts +0 -133
- package/src/materials/TransmissionPass.ts +0 -51
- package/src/performance/BVH.ts +0 -18
- package/src/performance/Batcher.ts +0 -2
- package/src/performance/FrustumCuller.ts +0 -9
- package/src/performance/LOD.ts +0 -20
- package/src/performance/Octree.ts +0 -10
- package/src/performance/RenderItemSorting.ts +0 -170
- package/src/performance/RendererStats.ts +0 -43
- package/src/performance/ResourceBudget.ts +0 -44
- package/src/postprocess/BloomPass.ts +0 -28
- package/src/postprocess/CinematicDiagnostics.ts +0 -642
- package/src/postprocess/ColorGradingPass.ts +0 -24
- package/src/postprocess/DepthOfFieldPass.ts +0 -12
- package/src/postprocess/EffectComposer.ts +0 -349
- package/src/postprocess/SSAOPass.ts +0 -20
- package/src/postprocess/index.ts +0 -34
- package/src/production-runtime/AnimationControlsPipeline.ts +0 -77
- package/src/production-runtime/PBRHDRPipeline.ts +0 -381
- package/src/production-runtime/ProductionEffectsPipeline.ts +0 -85
- package/src/production-runtime/ProductionRendererTypes.ts +0 -136
- package/src/production-runtime/ProductionRuntimeRenderer.ts +0 -172
- package/src/production-runtime/ProductionWebGL2Renderer.ts +0 -313
- package/src/production-runtime/ProductionWebGPURenderer.ts +0 -396
- package/src/production-runtime/TransmissionBackdropCapture.ts +0 -130
- package/src/production-runtime/animation/MorphTargetRenderer.ts +0 -2
- package/src/production-runtime/animation/SkinningRenderer.ts +0 -2
- package/src/production-runtime/backends/RendererBackend.ts +0 -17
- package/src/production-runtime/backends/WebGL2RendererBackend.ts +0 -30
- package/src/production-runtime/backends/WebGPURendererBackend.ts +0 -24
- package/src/production-runtime/backends/webgl2/WebGL2Buffer.ts +0 -2
- package/src/production-runtime/backends/webgl2/WebGL2Capabilities.ts +0 -2
- package/src/production-runtime/backends/webgl2/WebGL2RenderTarget.ts +0 -2
- package/src/production-runtime/backends/webgl2/WebGL2Shader.ts +0 -2
- package/src/production-runtime/backends/webgl2/WebGL2StateCache.ts +0 -1
- package/src/production-runtime/backends/webgl2/WebGL2Texture.ts +0 -2
- package/src/production-runtime/backends/webgpu/WebGPUBuffer.ts +0 -2
- package/src/production-runtime/backends/webgpu/WebGPUCapabilities.ts +0 -2
- package/src/production-runtime/backends/webgpu/WebGPURenderTarget.ts +0 -2
- package/src/production-runtime/backends/webgpu/WebGPUShader.ts +0 -2
- package/src/production-runtime/backends/webgpu/WebGPUTexture.ts +0 -2
- package/src/production-runtime/color/ColorManagement.ts +0 -3
- package/src/production-runtime/color/ToneMapping.ts +0 -7
- package/src/production-runtime/diagnostics/FrameCapture.ts +0 -2
- package/src/production-runtime/diagnostics/GPUCapabilities.ts +0 -2
- package/src/production-runtime/diagnostics/RendererStats.ts +0 -2
- package/src/production-runtime/environment/EnvironmentMap.ts +0 -1
- package/src/production-runtime/environment/HDRLoader.ts +0 -57
- package/src/production-runtime/environment/PMREMGenerator.ts +0 -713
- package/src/production-runtime/framegraph/FrameGraph.ts +0 -18
- package/src/production-runtime/framegraph/RenderPass.ts +0 -15
- package/src/production-runtime/geometry/ProjectedDecalGeometry.ts +0 -439
- package/src/production-runtime/index.ts +0 -127
- package/src/production-runtime/lights/LightManager.ts +0 -7
- package/src/production-runtime/lights/ShadowMapRenderer.ts +0 -5
- package/src/production-runtime/materials/GLTFMaterialAdapter.ts +0 -6
- package/src/production-runtime/materials/GLTFPBRMaterialAdapter.ts +0 -2
- package/src/production-runtime/materials/MaterialCompiler.ts +0 -7
- package/src/production-runtime/materials/MaterialTextureBindings.ts +0 -5
- package/src/production-runtime/materials/PBRMaterial.ts +0 -2
- package/src/production-runtime/materials/PBRShaderFeatures.ts +0 -2
- package/src/production-runtime/passes/ContactShadowPass.ts +0 -184
- package/src/production-runtime/passes/DepthPrepass.ts +0 -7
- package/src/production-runtime/passes/OpaquePass.ts +0 -7
- package/src/production-runtime/passes/ShadowPass.ts +0 -7
- package/src/production-runtime/passes/SkyboxPass.ts +0 -7
- package/src/production-runtime/passes/ToneMappingPass.ts +0 -7
- package/src/production-runtime/passes/TransparentPass.ts +0 -7
- package/src/production-runtime/postprocess/BloomPass.ts +0 -51
- package/src/production-runtime/postprocess/ColorGradingPass.ts +0 -49
- package/src/production-runtime/postprocess/DOFPass.ts +0 -47
- package/src/production-runtime/postprocess/FXAAPass.ts +0 -53
- package/src/production-runtime/postprocess/ProductionEffectComposer.ts +0 -78
- package/src/production-runtime/postprocess/ProductionPostProcessTypes.ts +0 -174
- package/src/production-runtime/postprocess/SSAOPass.ts +0 -45
- package/src/production-runtime/resources/GPUBuffer.ts +0 -2
- package/src/production-runtime/resources/GPUTexture.ts +0 -2
- package/src/production-runtime/resources/RenderTarget.ts +0 -3
- package/src/production-runtime/resources/ResourceCache.ts +0 -7
- package/src/production-runtime/scene/Camera.ts +0 -1
- package/src/production-runtime/scene/Lights.ts +0 -2
- package/src/production-runtime/scene/RenderableMesh.ts +0 -2
- package/src/production-runtime/scene/RenderablePrimitive.ts +0 -1
- package/src/production-runtime/scene/RenderableScene.ts +0 -4
- package/src/production-runtime/shaders/ShaderProgramLibrary.ts +0 -7
- package/src/production-runtime/shaders/chunks/brdf.glsl +0 -2
- package/src/production-runtime/shaders/chunks/ibl.glsl +0 -3
- package/src/production-runtime/shaders/chunks/pbr.frag.glsl +0 -47
- package/src/production-runtime/shaders/chunks/pbr.vert.glsl +0 -8
- package/src/production-runtime/shaders/chunks/shadows.glsl +0 -2
- package/src/production-runtime/shaders/wgsl/pbr.wgsl +0 -3
- package/src/production-runtime/shaders/wgsl/postprocess.wgsl +0 -2
- package/src/production-runtime/shaders/wgsl/skybox.wgsl +0 -2
- package/src/shaders/depth.frag.glsl +0 -5
- package/src/shaders/depth.vert.glsl +0 -8
- package/src/shaders/pbr-direct.frag.glsl +0 -687
- package/src/shaders/pbr-direct.vert.glsl +0 -18
- package/src/shaders/unlit.frag.glsl +0 -18
- package/src/shaders/unlit.vert.glsl +0 -13
- package/src/shadows/CascadedShadowPipeline.ts +0 -53
- package/src/shadows/ContactShadows.ts +0 -106
- package/src/shadows/ShadowDebugViews.ts +0 -46
- package/src/threejs-compatibility/InstancingSystem.ts +0 -17
- package/src/threejs-compatibility/LightingSystem.ts +0 -22
- package/src/threejs-compatibility/MaterialSystem.ts +0 -9
- package/src/threejs-compatibility/RenderTargetSystem.ts +0 -35
- package/src/threejs-compatibility/RendererDiagnostics.ts +0 -61
- package/src/threejs-compatibility/SceneRenderer.ts +0 -34
- package/src/threejs-compatibility/ShadowSystem.ts +0 -19
- package/src/threejs-compatibility/TextureSystem.ts +0 -19
- package/src/threejs-compatibility/ThreeCompatRenderer.ts +0 -90
- package/src/threejs-compatibility/TransparencySystem.ts +0 -19
- package/src/threejs-compatibility/index.ts +0 -29
- package/src/threejs-compatibility/performance/BVH.ts +0 -14
- package/src/threejs-compatibility/performance/FrustumCulling.ts +0 -10
- package/src/threejs-compatibility/performance/Instancing.ts +0 -4
- package/src/threejs-compatibility/performance/LODSystem.ts +0 -16
- package/src/threejs-compatibility/performance/OcclusionCulling.ts +0 -6
- package/src/threejs-compatibility/performance/RaycastAcceleration.ts +0 -12
- package/src/threejs-compatibility/performance/RendererProfiler.ts +0 -19
- package/src/threejs-compatibility/performance/TextureStreaming.ts +0 -4
- package/src/threejs-compatibility/performance/index.ts +0 -12
- package/src/threejs-compatibility/postprocess/BloomPass.ts +0 -16
- package/src/threejs-compatibility/postprocess/ColorGradingPass.ts +0 -16
- package/src/threejs-compatibility/postprocess/DepthOfFieldPass.ts +0 -21
- package/src/threejs-compatibility/postprocess/EffectComposer.ts +0 -14
- package/src/threejs-compatibility/postprocess/FXAAPass.ts +0 -15
- package/src/threejs-compatibility/postprocess/MotionBlurPass.ts +0 -20
- package/src/threejs-compatibility/postprocess/OutlinePass.ts +0 -21
- package/src/threejs-compatibility/postprocess/PostProcessTypes.ts +0 -169
- package/src/threejs-compatibility/postprocess/RenderPass.ts +0 -9
- package/src/threejs-compatibility/postprocess/SMAAPass.ts +0 -15
- package/src/threejs-compatibility/postprocess/SSAOPass.ts +0 -21
- package/src/threejs-compatibility/postprocess/ShaderPass.ts +0 -7
- package/src/threejs-compatibility/postprocess/TAAPass.ts +0 -15
- package/src/threejs-compatibility/postprocess/VignettePass.ts +0 -16
- package/src/threejs-compatibility/postprocess/index.ts +0 -15
- package/src/threejs-compatibility/shaders/NodeMaterial.ts +0 -21
- package/src/threejs-compatibility/shaders/RawShaderMaterial.ts +0 -6
- package/src/threejs-compatibility/shaders/ShaderDiagnostics.ts +0 -17
- package/src/threejs-compatibility/shaders/ShaderMaterial.ts +0 -18
- package/src/threejs-compatibility/shaders/ThreeCompatShaderChunks.ts +0 -6
- package/src/threejs-compatibility/shaders/Uniforms.ts +0 -18
- package/src/threejs-compatibility/shaders/index.ts +0 -9
- package/src/threejs-compatibility/vfx/GPUPointCloud.ts +0 -7
- package/src/threejs-compatibility/vfx/LineRenderer.ts +0 -13
- package/src/threejs-compatibility/vfx/ParticleSystem.ts +0 -23
- package/src/threejs-compatibility/vfx/SpriteSystem.ts +0 -14
- package/src/threejs-compatibility/vfx/TrailRenderer.ts +0 -8
- package/src/threejs-compatibility/vfx/VFXDiagnostics.ts +0 -23
- package/src/threejs-compatibility/vfx/index.ts +0 -9
- package/src/threejs-example-parity/index.ts +0 -205
- package/src/webgpu/WebGPUBuffer.ts +0 -1
- package/src/webgpu/WebGPUCompute.ts +0 -2
- package/src/webgpu/WebGPUPipelineCache.ts +0 -15
- package/src/webgpu/WebGPUPostProcess.ts +0 -2
- package/src/webgpu/WebGPUTexture.ts +0 -2
- package/tsconfig.json +0 -26
- 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
|
-
}
|