@hology/webgpu-renderer 0.1.7 → 0.1.9

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as three from 'three';
-import { Color, Vector2, Vector3, Vector4, Matrix3, Matrix4, Material, Texture, MaterialParameters, DirectionalLight, PointLight, SpotLight, Object3D, PerspectiveCamera, OrthographicCamera, Scene } from 'three';
+import { Color, Vector2, Vector3, Vector4, Matrix3, Matrix4, Material, Texture, MaterialParameters, DirectionalLight, PointLight, SpotLight, Object3D, PerspectiveCamera, OrthographicCamera, BufferGeometry, Scene } from 'three';
 export { AmbientLight, BackSide, BatchedMesh, Bone, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, Color, CompressedArrayTexture, CompressedCubeTexture, CompressedTexture, CompressedArrayTexture as CompressedTextureArray, CubeTexture, Data3DTexture, DataArrayTexture, DataTexture, DepthTexture, DirectionalLight, DoubleSide, FrontSide, Group, HemisphereLight, InstancedMesh, MathUtils, Matrix4, Mesh, Object3D, OrthographicCamera, PerspectiveCamera, PlaneGeometry, PointLight, RepeatWrapping, Scene, Skeleton, SkinnedMesh, SphereGeometry, SpotLight, Texture, Vector2, Vector3, Vector4 } from 'three';
 
 interface ComputeKernelDescriptor {
@@ -380,6 +380,8 @@ interface RendererMaterialPassDescriptor {
     readonly drawStage?: "all" | "opaque" | "late";
     /** Preserve existing attachment contents instead of clearing them. */
     readonly loadColor?: boolean;
+    /** Color used when clearing the attachments. Defaults to the renderer clear color. */
+    readonly clearColor?: readonly [number, number, number, number];
     /** Preserve depth written by an earlier pass. Defaults to clear. */
     readonly loadDepth?: boolean;
     /** Draw only objects accepted by this predicate. Intended for selection/mask passes. */
@@ -422,6 +424,8 @@ interface RendererCustomPassContext {
         view: GPUTextureView;
         sampler: GPUSampler;
     };
+    /** Resolves the current renderer-owned vertex buffer for a geometry. */
+    getGeometryVertexBuffer(geometry: BufferGeometry, attribute: "position" | "normal"): GPUBuffer;
     getColorFormat(name: string): GPUTextureFormat;
     getShadowMapDebugInfo(): RendererShadowMapDebugInfo;
     /** Shared light uniforms and shadow arrays used by the forward renderer. */
@@ -527,6 +531,7 @@ interface FrameGraphMaterialPassDescriptor {
     readonly outputs?: FrameGraphTextureHandle | readonly FrameGraphTextureHandle[];
     readonly drawStage?: "all" | "opaque" | "late";
     readonly loadColor?: boolean;
+    readonly clearColor?: readonly [number, number, number, number];
     readonly loadDepth?: boolean;
     readonly objectFilter?: (object: Object3D | null) => boolean;
     readonly overrideMaterial?: WGSLShaderMaterial | ((source: WGSLShaderMaterial, skinned: boolean) => WGSLShaderMaterial);
@@ -611,8 +616,8 @@ interface VolumetricFogOptions {
     /** Temporal sub-froxel jitter accumulated by fog history and optionally TAA. */
     readonly temporalJitter?: boolean;
     /**
-     * Fog-local temporal reconstruction. Unlike temporalJitter, this retains a
-     * resolved fog history and permits cheaper current-frame sampling.
+     * Fog-local temporal reconstruction of the 3D scattering/extinction grid.
+     * This history is accumulated before front-to-back integration.
      */
     readonly temporal?: false | VolumetricFogTemporalOptions;
     /** Stable per-ray depth jitter. Breaks slice bands without animated noise. */
@@ -664,6 +669,8 @@ declare class VolumetricFogEffect {
     private scene;
     readonly integratedVolume: FrameGraphTextureHandle;
     readonly columnDepthBounds: FrameGraphTextureHandle;
+    readonly scatteringHistoryA: FrameGraphTextureHandle;
+    readonly scatteringHistoryB: FrameGraphTextureHandle;
     private readonly options;
     private readonly resources;
     private readonly uniformStorage;
@@ -690,6 +697,16 @@ declare class VolumetricFogEffect {
     private readonly projectionInverse;
     private readonly viewProjectionInverse;
     private readonly previousTemporalViewProjection;
+    private readonly previousFroxelViewProjection;
+    private readonly previousFroxelCameraPosition;
+    private previousFroxelNear;
+    private previousFroxelFar;
+    private previousFroxelWidth;
+    private previousFroxelHeight;
+    private froxelHistoryValid;
+    private froxelHistoryWriteIndex;
+    private activeHistoryRead;
+    private activeHistoryWrite;
     private explicitVolumes;
     private volumeObjects;
     private extractedLights;
@@ -730,7 +747,7 @@ declare class VolumetricFogEffect {
     private getResources;
 }
 /** WGSL appended to a material that calls rendererApplyVolumetricFog(). */
-declare const VOLUMETRIC_FOG_MATERIAL_WGSL = "\nfn rendererSampleIntegratedFog(uv: vec2<f32>, normalizedDepth: f32) -> vec4<f32> {\n  let sliceCount = f32(textureDimensions(volumetricFogTexture).z);\n  let slicePosition = clamp(normalizedDepth, 0.0, 1.0) * sliceCount;\n  let textureZ = clamp((slicePosition - 0.5) / sliceCount, 0.0, 1.0);\n  let integrated = textureSampleLevel(volumetricFogTexture, volumetricFogSampler, vec3<f32>(uv, textureZ), 0.0);\n  // The volume stores slice endpoints but has no texel for the near-plane\n  // identity value. Reconstruct that missing endpoint for the first slice.\n  return mix(vec4<f32>(0.0, 0.0, 0.0, 1.0), integrated, min(slicePosition, 1.0));\n}\nfn rendererApplyVolumetricFog(color: vec4<f32>, worldPosition: vec3<f32>) -> vec4<f32> {\n  let clip = rendererCamera.viewProj * vec4<f32>(worldPosition, 1.0);\n  let uv = clip.xy / clip.w * vec2<f32>(0.5, -0.5) + vec2<f32>(0.5);\n  let distance = length(worldPosition - rendererCamera.cameraPosition.xyz);\n  let bounds = textureSampleLevel(volumetricFogBoundsTexture, volumetricFogBoundsSampler, uv, 0.0).rg;\n  let z = clamp((distance - bounds.x) / max(bounds.y - bounds.x, 0.001), 0.0, 1.0);\n  let fog = rendererSampleIntegratedFog(uv, z);\n  return vec4<f32>(fog.rgb + color.rgb * fog.a, color.a);\n}";
+declare const VOLUMETRIC_FOG_MATERIAL_WGSL = "\nfn rendererSampleIntegratedFogRaw(uv: vec2<f32>, normalizedDepth: f32) -> vec4<f32> {\n  let sliceCount = f32(textureDimensions(volumetricFogTexture).z);\n  let slicePosition = clamp(normalizedDepth, 0.0, 1.0) * sliceCount;\n  let textureZ = clamp((slicePosition - 0.5) / sliceCount, 0.0, 1.0);\n  let integrated = textureSampleLevel(volumetricFogTexture, volumetricFogSampler, vec3<f32>(uv, textureZ), 0.0);\n  // The volume stores slice endpoints but has no texel for the near-plane\n  // identity value. Reconstruct that missing endpoint for the first slice.\n  return mix(vec4<f32>(0.0, 0.0, 0.0, 1.0), integrated, min(slicePosition, 1.0));\n}\nfn rendererSampleIntegratedFog(uv: vec2<f32>, normalizedDepth: f32) -> vec4<f32> {\n  return rendererSampleIntegratedFogRaw(uv, normalizedDepth);\n}\nfn rendererApplyVolumetricFog(color: vec4<f32>, worldPosition: vec3<f32>) -> vec4<f32> {\n  let clip = rendererCamera.viewProj * vec4<f32>(worldPosition, 1.0);\n  let uv = clip.xy / clip.w * vec2<f32>(0.5, -0.5) + vec2<f32>(0.5);\n  let distance = length(worldPosition - rendererCamera.cameraPosition.xyz);\n  let bounds = textureSampleLevel(volumetricFogBoundsTexture, volumetricFogBoundsSampler, uv, 0.0).rg;\n  let z = clamp(log(max(distance, bounds.x) / bounds.x) / max(log(bounds.y / bounds.x), 0.0001), 0.0, 1.0);\n  let fog = rendererSampleIntegratedFog(uv, z);\n  return vec4<f32>(fog.rgb + color.rgb * fog.a, color.a);\n}";
 /** Adds the froxel input; append VOLUMETRIC_FOG_MATERIAL_WGSL and call its helper in fsMain. */
 declare function configureVolumetricFogMaterial(material: WGSLShaderMaterial, resource?: string, boundsResource?: string): WGSLShaderMaterial;
 
@@ -1126,6 +1143,8 @@ declare class WebGpuRenderer {
     private clearSpotShadow;
     private drawDepthLike;
     private getGeometryResource;
+    /** Upload changed standard BufferAttributes without replacing their buffers. */
+    private updateDynamicGeometryAttributes;
     private getSkinnedGeometryResource;
     private getSkinningPalette;
     private refreshSkinningPalette;
@@ -1617,6 +1636,8 @@ interface OutlineOptions {
     readonly edgeStrength?: number;
     /** Outline radius in physical render pixels. */
     readonly edgeThickness?: number;
+    /** Width of the outline's antialiased falloff in physical render pixels. */
+    readonly edgeSoftness?: number;
     readonly targetPrefix?: string;
 }
 interface OutlineInputs {
@@ -1638,6 +1659,7 @@ declare class OutlineEffect {
     visibleEdgeColor: [number, number, number];
     edgeStrength: number;
     edgeThickness: number;
+    edgeSoftness: number;
     readonly selectedObjects: Set<Object3D<three.Object3DEventMap>>;
     readonly selectedInstances: OutlineInstanceSelection[];
     private readonly targetPrefix;
@@ -1649,6 +1671,7 @@ declare class OutlineEffect {
     setSelectedObjects(objects: Iterable<Object3D>): void;
     setSelectedInstances(selections: Iterable<OutlineInstanceSelection>): void;
     addPass(graph: FrameGraphBuilder, source: FrameGraphTextureHandle): FrameGraphTextureHandle;
+    private addCachedPass;
     dispose(): void;
 }