@hology/webgpu-renderer 0.1.8 → 0.1.10

package/dist/index.d.ts

@@ -281,7 +281,7 @@ type RendererExtractedLightState = ExtractedLightState;
  * without mutating the scene's material slots. Return `undefined` to use the
  * renderer fallback material, or `null` to intentionally skip the draw.
  */
-type RendererMaterialResolver = (material: Material, pass?: 'opaque' | 'late') => WGSLShaderMaterial | null | undefined;
+type RendererMaterialResolver = (material: Material, pass?: 'opaque' | 'late' | 'outline') => WGSLShaderMaterial | null | undefined;
 interface RendererOptions {
     canvas: HTMLCanvasElement;
     /** Linear-sRGB clear color. Presentation converts it to display sRGB. */
@@ -616,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. */
@@ -669,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;
@@ -695,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;
@@ -735,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;
 
@@ -766,6 +778,10 @@ type ToonOutlineParameters = {
     thickness?: number;
     /** Linear RGB outline color. Defaults to black. */
     color?: readonly [number, number, number] | readonly number[];
+    /** Outline color source. Missing values preserve the legacy fixed-color behavior. */
+    colorMode?: "fixed" | "darkenedAlbedo";
+    /** Linear albedo darkening from 0 (unchanged) to 1 (black). Defaults to 0.65. */
+    darkening?: number;
     /** Defaults to the source material's opacity. */
     alpha?: number;
     /** Set to false to suppress the otherwise enabled outline. */