@hology/core 0.0.274 → 0.0.276

package/dist/rendering/webgpu-experimental-backend.d.ts

@@ -4,8 +4,8 @@ import type { WorldEnvironmentState } from './environment.js';
 import type { RenderingBackendDriver } from './rendering-backend.js';
 import type { PostProcessEffectStage } from './post-process-effect.js';
 import type { DlssQualityMode } from './upscaling-pass.js';
-import type { BloomOptions, ColorGradingOptions, DepthOfFieldOptions, FXAAOptions, FrameGraphBuilder, GTAOOptions, GTAOQuality, OutlineOptions, OutlineInstanceSelection, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, SSROptions, RendererFrameProfile, RendererSceneCapture, SMAAOptions, TemporalAAOptions, VolumetricFogOptions, VolumetricFogQuality } from '@hology/webgpu-renderer';
-export type { RendererFrameProfile, RendererSceneCapture, RendererSceneCaptureOptions, RendererSceneCapturePostProcessContext, GTAOOptions, GTAOQuality, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, VolumetricFogOptions, VolumetricFogQuality } from '@hology/webgpu-renderer';
+import type { BloomOptions, ColorGradingOptions, DepthOfFieldOptions, FXAAOptions, FrameGraphBuilder, GTAOOptions, GTAOQuality, OutlineOptions, OutlineInstanceSelection, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, SSROptions, SDFGIOptions, SDFGIStats, RendererFrameProfile, RendererSceneCapture, SMAAOptions, TemporalAAOptions, VolumetricFogOptions, VolumetricFogQuality } from '@hology/webgpu-renderer';
+export type { SDFGICascadeOptions, SDFGIOptions, SDFGIStats, RendererFrameProfile, RendererSceneCapture, RendererSceneCaptureOptions, RendererSceneCapturePostProcessContext, GTAOOptions, GTAOQuality, SSROptions, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, VolumetricFogOptions, VolumetricFogQuality } from '@hology/webgpu-renderer';
 type SupportedCamera = THREE.PerspectiveCamera | THREE.OrthographicCamera;
 export type AntiAliasingMode = 'off' | 'fxaa' | 'smaa' | 'taa';
 export type ExperimentalWebGpuRenderGraphExtension = ((graph: FrameGraphBuilder, color: string) => void) & {
@@ -23,6 +23,8 @@ export type WebGpuPresentationExtensionContext = {
 };
 export type WebGpuPresentationExtension = (context: WebGpuPresentationExtensionContext) => void;
 export interface ExperimentalWebGpuPostProcessingOptions {
+    /** Experimental world-space indirect diffuse lighting. Disabled by default. */
+    readonly sdfgi?: false | SDFGIOptions;
     /** Request native DLSS-SR when supported by the host. Falls back to TAA. */
     readonly nativeUpscaling?: false | {
         readonly method: 'dlss';
@@ -73,6 +75,7 @@ export interface ExperimentalWebGpuStaticDrawSet {
     readonly label: string;
     readonly drawCount: number;
     readonly instanceCount: number;
+    updateTransforms(): void;
     dispose(): void;
 }
 export interface WebGpuSceneCapabilitySummary {
@@ -111,6 +114,8 @@ export declare class ExperimentalWebGpuBackend implements RenderingBackendDriver
     private readonly antiAliasingState;
     private readonly directionalShadowState;
     private readonly nativeDlss;
+    private sdfgi;
+    private readonly createSDFGI;
     readonly kind: "webgpu";
     readonly canvas: HTMLCanvasElement;
     private renderScale;
@@ -138,6 +143,9 @@ export declare class ExperimentalWebGpuBackend implements RenderingBackendDriver
     setPresentationExtensions(extensions: Iterable<WebGpuPresentationExtension>): void;
     setEnableOutlines(enabled: boolean): void;
     setTiledLightingEnabled(enabled: boolean): void;
+    setSDFGIOptions(options: SDFGIOptions): void;
+    invalidateSDFGI(): void;
+    getSDFGIStats(): Readonly<SDFGIStats> | null;
     setDynamicBatchingEnabled(enabled: boolean): void;
     setSelectedObjects(objects: Iterable<THREE.Object3D>): void;
     setSelectedObjectInstances(selections: Iterable<OutlineInstanceSelection>): void;
@@ -156,10 +164,13 @@ export declare class ExperimentalWebGpuBackend implements RenderingBackendDriver
      */
     resetViewHistory(): void;
     compile(scene: THREE.Scene, camera: SupportedCamera): Promise<void>;
-    createStaticDrawSet(root: THREE.Object3D, label: string, allowUnsortedLateDraws?: boolean, onUnsupported?: 'throw' | 'skip'): ExperimentalWebGpuStaticDrawSet | null;
+    createStaticDrawSet(root: THREE.Object3D, label: string, allowUnsortedLateDraws?: boolean, onUnsupported?: 'throw' | 'skip', mutableTransforms?: boolean): ExperimentalWebGpuStaticDrawSet | null;
     registerStaticSpatialObject(root: THREE.Object3D): import('@hology/webgpu-renderer').StaticSpatialObject;
     render(scene: THREE.Scene, camera: SupportedCamera, timeSeconds: number): void;
+    prepareSceneGeometry(scene: THREE.Scene, camera: SupportedCamera): Promise<void>;
+    renderPresentationOnly(extensions: Iterable<WebGpuPresentationExtension>): void;
     setMotionBlurOptions(options: MotionBlurOptions): void;
+    setSSROptions(options: SSROptions): void;
     setGTAOOptions(options: GTAOOptions): void;
     setAntiAliasingMode(mode: AntiAliasingMode): void;
     setGTAOQuality(quality: GTAOQuality): void;

package/dist/rendering/webgpu-experimental-backend.js

@@ -1,4 +1,4 @@
-import*as e from"three";import{NodeMaterialWebGpuResolver as t}from"./node-material-webgpu-resolver.js";import{configureWebGpuRuntimeBindings as i}from"./webgpu-runtime-bridge.js";import{float as n,varyingTransformed as r,vec4 as a}from"three-shader-graph";import{NodeShaderMaterial as o}from"../shader-nodes/index.js";import{sceneMapUniformName as s}from"../shader-nodes/scene-sample.js";import{depthUniformName as l}from"../shader-nodes/depth.js";import{MATERIAL_FLAG_ALPHA_TEST as d,MATERIAL_FLAG_RECEIVE_DECALS as c}from"../shader-nodes/material-flags.js";import{createMotionVectorOutput as h}from"./motion-vector-node.js";export class ExperimentalWebGpuBackend{constructor(e,t,i,n,r,a,o,s,l,d,c,h,u,p,m,g,f,v,S,b,P,x){this.renderer=e,this.fallbackMaterial=t,this.nodeMaterialResolver=i,this.gBufferFallbackSource=n,this.bloom=r,this.fxaa=a,this.smaa=o,this.gtao=s,this.ssr=l,this.taa=d,this.motionBlur=c,this.volumetricFog=h,this.colorGrading=u,this.depthOfField=p,this.outline=m,this.postProcessEffects=g,this.renderGraphExtensions=f,this.presentationExtensions=v,this.antiAliasingState=S,this.directionalShadowState=b,this.nativeDlss=P,this.kind="webgpu",this.renderScale=1,this.pmremGenerator=null,this.pmremResults=new WeakMap,this.ownedPmremResults=new Set,this.warnedUnsupportedPostProcessStages=new Set,this.secondaryMotionPrepared=!1,this.canvas=x}static async probeAvailability(){if("undefined"==typeof navigator||!("gpu"in navigator))return{available:!1,reason:"The runtime does not expose navigator.gpu."};try{const e=await navigator.gpu.requestAdapter({powerPreference:"high-performance"});return null==e?{available:!1,reason:"No WebGPU adapter is available."}:{available:!0,adapter:e}}catch(e){return{available:!1,reason:`Requesting a WebGPU adapter failed: ${e instanceof Error?e.message:String(e)}`}}}static async create(m={},g){const f=await import("@hology/webgpu-renderer");i({registerPipelineDiagnosticOrigin:f.registerPipelineDiagnosticOrigin,createComputeKernel:(e,t)=>new f.ComputeKernel(e,t),buildParticleLightingShaderHeader:f.buildParticleLightingShaderHeader});const v=document.createElement("canvas");v.dataset.hologyRenderer="webgpu-experimental";const S=new f.WGSLShaderMaterial({vertexShader:u,fragmentShader:p}),b=!1!==m.nativeUpscaling&&"dlss"===m.nativeUpscaling?.method,P=b?(await import("./native-dlss-upscaler.js")).createNativeDlssUpscaler(m.nativeUpscaling?.mode??"quality"):null,x=null!=P;S.side=f.DoubleSide;const w=f,y=null!=m.motionBlur&&!1!==m.motionBlur,D=!1!==m.gtao&&(null==m.gtao||!1!==m.gtao.temporal),M=!1!==m.volumetricFog&&(null==m.volumetricFog||!1!==m.volumetricFog.temporal),O=x?"off":b?"taa":null!=(E=m).antiAliasing?E.antiAliasing:null!=E.taa&&!1!==E.taa?"taa":null!=E.smaa&&!1!==E.smaa?"smaa":null!=E.fxaa&&!1!==E.fxaa?"fxaa":!1===E.taa?"off":"taa";var E;const F=null!=m.antiAliasing,C=y||D||M||(F||"taa"===O)||x;let L=null;const G=new t(w,(e,t)=>"opaque"===t?[e.outputColor.xyz.rgba(n(e.alphaTest>0?d:0).add(!1===e.userData.receiveDecals?0:c)),a((e.outputNormal??r.normal).multiplyScalar(.5).addScalar(.5),e.outputRoughness??n(1)),...C?[h(e)]:[]]:void 0,e=>L?.getEnvironmentTexture(e)??e),R=new e.MeshStandardMaterial({color:8688803,roughness:1});if(null==G.resolve(R,"opaque"))throw S.dispose(),R.dispose(),new Error("Failed to compile the WebGPU G-buffer fallback material.");const T=!1===m.gtao?null:new f.GTAOEffect({normalSpace:"view",...f.GTAO_PRESETS.high,...m.gtao??{}}),A=!1===m.ssr||null==m.ssr?null:new f.SSREffect({normalSpace:"view",resolutionScale:.5,...m.ssr??{}}),B=!1===m.bloom?null:new f.BloomEffect({threshold:1,strength:.9,radius:.2,...m.bloom??{}}),U=F||!1!==m.fxaa&&"fxaa"===O?new f.FXAAEffect(!1===m.fxaa?{}:m.fxaa):null,W=F||!1!==m.smaa&&"smaa"===O?new f.SMAAEffect(!1===m.smaa?{}:m.smaa):null,k=x||F||!1!==m.taa&&"taa"===O?new f.TemporalAAEffect({renderScale:1,...!1===m.taa?{}:m.taa}):null,V={mode:O},I=!1===m.motionBlur||null==m.motionBlur?null:new f.MotionBlurEffect(m.motionBlur),j=m.volumetricFog||void 0,N=!1===m.volumetricFog?null:new f.VolumetricFogEffect(void 0,{...f.VOLUMETRIC_FOG_PRESETS.high,maxDistance:64,spatialJitter:!0,scatteringIntensity:Math.PI,...j,temporal:!1!==j?.temporal&&{...f.VOLUMETRIC_FOG_PRESETS.high.temporal,...j?.temporal},blur:!1!==j?.blur&&{...!1===f.VOLUMETRIC_FOG_PRESETS.high.blur?{}:f.VOLUMETRIC_FOG_PRESETS.high.blur,depthAwareUpsample:!0,...j?.blur}}),H=!1===m.colorGrading?null:new f.ColorGradingEffect({enabled:!1,...m.colorGrading??{}}),$=!1===m.depthOfField?null:new f.DepthOfFieldEffect({enabled:!1,...m.depthOfField??{}}),_=!1===m.outline?null:new f.OutlineEffect({enabled:!1,...m.outline??{}}),q=[],z=new WeakMap,J=new Set,K=[],Z=[],Q=(e,t,i)=>{let n=i;const r=q.filter(e=>e.enabled&&e.stage===t).sort((e,t)=>e.priority-t.priority||e.id-t.id);for(const t of r){if(!(t.material instanceof o)){const e=`${t.id}:material`;J.has(e)||(J.add(e),console.warn(`[Hology WebGPU experiment] Skipping custom post-process effect ${t.id}: only NodeShaderMaterial effects are supported.`));continue}try{let i=z.get(t.material);null!=i&&i.version===t.material.version||(i={version:t.material.version,shader:G.compileFullscreen(t.material),diagnosticOrigin:{key:"post-process:"+String(t.material.userData.assetId??(t.material.name||t.material.uuid)),material:{name:t.material.name,uuid:t.material.uuid,version:t.material.version,assetId:t.material.userData.assetId,assetName:t.material.userData.assetName}}},z.set(t.material,i));const r=e.createColorTarget(`hologyCustomPostProcess${t.id}`);e.addNodeFullscreenPass({name:`HologyCustomPostProcess${t.id}`,diagnosticOrigin:i.diagnosticOrigin,shader:i.shader,inputOverrides:{[s]:n},outputs:r}),n=r}catch(e){const i=`${t.id}:compile:${t.material.version}`;J.has(i)||(J.add(i),console.warn(`[Hology WebGPU experiment] Skipping custom post-process effect ${t.id}: ${e instanceof Error?e.message:String(e)}`,e))}}return n},X={enabled:!0},Y=new f.WebGpuRenderer({canvas:v,fallbackMaterial:S,materialResolver:(e,t)=>G.resolve(e,t),invokeObjectRenderCallbacks:!1,hiZOcclusionCulling:!0,renderGraphProfiling:!1,sampleCount:1,multiDrawIndirect:!1,nativePostSubmit:P?.postSubmit,presentationOverlay:e=>{for(const t of Z)t(e)}});Y.setRenderScale("taa"===O?k?.renderScale??1:1),Y.setRenderGraphBuilder((e,t)=>{const i=new f.FrameGraphBuilder(t),n=i.createColorTarget("hologyNormalRoughness",{format:"rgba8unorm"}),r=C?i.createColorTarget("hologyMotionVectors",{format:"rgba16float"}):null;for(const e of K)"beforeScene"===e.stage&&e(i,i.sceneColor);X.enabled&&i.addDirectionalShadowPass(),i.addPointShadowPass(),i.addSpotShadowPass(),i.addDepthPrepass(),i.addHiZPasses(),i.addVisibilityPass(),i.addMaterialPass({name:"OpaqueGBufferPass",outputs:null==r?[i.sceneColor,n]:[i.sceneColor,n,r],drawStage:"opaque",loadDepth:!0}),i.addHiZHistoryPass("OpaqueGBufferPass");let a=i.sceneColor;if(T?.enabled){const e=T.addPasses(i,{depth:i.mainDepth,normal:n,velocity:r??void 0});a=T.addCompositePass(i,a,e)}null!=A&&(a=A.addPasses(i,{sceneColor:a,depth:i.mainDepth,normalRoughness:n}));const o=new Set(K.flatMap(e=>e.getSceneTextureReads?.()??[]));i.addSceneTextureCopyPass(a,{sceneColor:o.has("sceneColorSnapshot"),sceneDepth:o.has("sceneDepthSnapshot")||q.some(e=>e.enabled&&null!=e.material.uniforms[l])}),i.addLatePass(a);for(const e of K)null!=e.stage&&"afterScene"!==e.stage||e(i,a);a=Q(i,"beforeFog",a),null!=N&&(a=N.addPasses(i,{sceneColor:a,depth:i.mainDepth,velocity:r??void 0,volumeObjects:t.fogVolumeObjects,lights:t.extractedLights})),null!=I&&null!=r&&(a=I.addPass(i,a,r,i.mainDepth)),null!=B&&(a=B.addPass(i,a)),a=Q(i,"beforeOutline",a),null!=_&&(a=_.addPass(i,a)),a=Q(i,"beforeDepthOfField",a),null!=$&&(a=$.addPass(i,a,i.mainDepth)),a=Q(i,"beforeColorAdjustment",a),null!=H&&(a=H.addPass(i,a)),a=Q(i,"beforeAntiAliasing",a);let s="taa"===V.mode&&null!=k?k.addPass(i,a,i.mainDepth,r??void 0):a;"smaa"===V.mode&&null!=W?s=W.addPass(i,s):"fxaa"===V.mode&&null!=U&&(s=U.addPass(i,s)),s=Q(i,"beforeOutput",s);for(const e of K)"beforePresent"===e.stage&&e(i,s);!0===P?.enabled&&null!=r?P.addInputPass(i,s,r):i.present(s)});try{return await Y.initialize(g),L=new ExperimentalWebGpuBackend(Y,S,G,R,B,U,W,T,A,k,I,N,H,$,_,q,K,Z,V,X,P,v),L}catch(e){throw Y.destroy(),S.dispose(),G.dispose(),R.dispose(),T?.dispose(),W?.dispose(),I?.dispose(),N?.dispose(),_?.dispose(),e}}static supportsCamera(t){return t instanceof e.PerspectiveCamera||t instanceof e.OrthographicCamera}setSize(e,t,i,n=1){const r=this.canvas.width,a=this.canvas.height;let o=Math.min(1,Math.max(.25,n));if(!0===this.nativeDlss?.enabled){const n=Math.max(1,Math.floor(e*i)),r=Math.max(1,Math.floor(t*i));o=this.nativeDlss.getRenderScale(n,r)}const s=o!==this.renderScale;this.renderScale=o,this.renderer.setRenderScale(o),this.taa?.setRenderScale(o),this.renderer.setSize(e,t,i),(s||this.canvas.width!==r||this.canvas.height!==a)&&this.resetViewHistory()}initTexture(e){this.renderer.initTexture(e)}setPostProcessEffects(e){this.postProcessEffects.splice(0,this.postProcessEffects.length,...e);for(const t of e){if("beforeLut"!==t.stage)continue;const e=`${t.id}:${t.stage}`;this.warnedUnsupportedPostProcessStages.has(e)||(this.warnedUnsupportedPostProcessStages.add(e),console.warn(`[Hology WebGPU experiment] Skipping custom post-process effect ${t.id}: stage "${t.stage}" has no native WebGPU anchor.`))}}getDevice(){return this.renderer.getDevice()}createSceneCapture(e,t,i){return this.renderer.createSceneCapture(e,t,i)}setRenderGraphExtensions(e){this.renderGraphExtensions.length=0;for(const t of e)this.renderGraphExtensions.push(t)}setPresentationExtensions(e){this.presentationExtensions.length=0;for(const t of e)this.presentationExtensions.push(t)}setEnableOutlines(e){null!=this.outline&&(this.outline.enabled=e)}setTiledLightingEnabled(e){this.renderer.setTiledLightingEnabled(e)}setDynamicBatchingEnabled(e){this.renderer.setDynamicBatchingEnabled(e)}setSelectedObjects(e){this.outline?.setSelectedObjects(e)}setSelectedObjectInstances(e){this.outline?.setSelectedInstances(e)}setCascadedShadowRanges(e,t=[]){this.renderer.setCascadedShadowRanges(e,t),this.volumetricFog?.setCascadedDirectionalLights(t)}setDirectionalShadowUpdateOptions(e){this.renderer.setDirectionalShadowUpdateOptions(e)}invalidateDirectionalShadows(){this.renderer.invalidateDirectionalShadows()}setDirectionalShadowOptions(e,t){this.directionalShadowState.enabled=e,this.renderer.setDirectionalShadowsEnabled(e),this.renderer.setDirectionalShadowMapSize(t)}setWorldEnvironment(e){if(null==e)return void this.nodeMaterialResolver.setWorldEnvironment(null);const t=this.getEnvironmentTexture(e.source);this.nodeMaterialResolver.setWorldEnvironment({texture:t,intensity:e.intensity})}getEnvironmentTexture(t){if(t.mapping===e.CubeUVReflectionMapping)return t;let i=this.pmremResults.get(t);return null==i&&(this.pmremGenerator??(this.pmremGenerator=this.renderer.createPMREMGenerator()),i=this.pmremGenerator.fromEquirectangular(t),this.pmremResults.set(t,i),this.ownedPmremResults.add(i)),i.texture}resetViewHistory(){this.renderer.resetViewHistory(),this.taa?.reset(),this.motionBlur?.reset(),this.gtao?.reset(),this.volumetricFog?.reset(),this.nativeDlss?.reset()}async compile(e,t){if(!this.secondaryMotionPrepared){let t=!1;e.traverse(e=>{const i=e.userData.secondaryMotion?.regions;Array.isArray(i)&&i.some(e=>e.enabled)&&(t=!0)});const i=this.renderer.getDevice();if(t&&i){const{prepareSecondaryMotionRuntime:e}=await import("../secondary-motion/runtime.js");e(i),this.secondaryMotionPrepared=!0}}await this.renderer.compileAsync(e,t)}createStaticDrawSet(e,t,i=!1,n="skip"){this.renderer.setHiZOcclusionCullingEnabled(!0);const r=this.renderer.createStaticDrawSet(e,{label:t,onUnsupported:n,allowUnsortedLateDraws:i});return 0===r.drawCount?(r.dispose(),null):r}registerStaticSpatialObject(e){return this.renderer.registerStaticSpatialObject(e)}render(e,t,i){const n="taa"===this.antiAliasingState.mode?this.taa:null;this.volumetricFog?.setScene(e),this.renderer.setMotionVectorProjection(t.projectionMatrix),this.motionBlur?.prepareCamera(t,this.canvas.width,this.canvas.height,i),this.motionBlur?.requiresRendererHistoryReset()&&(this.renderer.resetViewHistory(),this.gtao?.reset(),this.volumetricFog?.reset()),n?.prepareCamera(t,this.canvas.width,this.canvas.height),this.nativeDlss?.prepareFrame(t);const r=!0===this.nativeDlss?.enabled?this.nativeDlss.jitter:null;this.motionBlur?.setJitterUv(n?.currentJitterUv.x??(null==r?0:r.x/Math.max(1,this.canvas.width*this.renderScale)),n?.currentJitterUv.y??(null==r?0:-r.y/Math.max(1,this.canvas.height*this.renderScale))),null!=r&&this.renderer.setProjectionJitter(r.x,r.y);let a=!1;try{this.renderer.render(e,t,i),a=!0}finally{null!=r&&this.renderer.clearProjectionJitter(),n?.finishCamera(t),a&&this.motionBlur?.commitCamera(),a&&this.nativeDlss?.finishFrame(t)}}setMotionBlurOptions(e){null!=this.motionBlur&&Object.assign(this.motionBlur.options,e)}setGTAOOptions(e){this.gtao?.setOptions(e)}setAntiAliasingMode(e){e!==this.antiAliasingState.mode&&("taa"===e&&null==this.taa||"smaa"===e&&null==this.smaa||"fxaa"===e&&null==this.fxaa?console.warn(`[Hology WebGPU experiment] Anti-aliasing mode "${e}" was not initialized. Set webgpuPostProcessing.antiAliasing in the initial rendering configuration to enable runtime switching.`):(this.antiAliasingState.mode=e,this.resetTemporalHistory()))}setGTAOQuality(e){this.gtao?.applyPreset(e)}setVolumetricFogOptions(e){this.volumetricFog?.setOptions(e)}setVolumetricFogQuality(e){this.volumetricFog?.applyPreset(e)}pushMotionBlurOverride(e){return this.motionBlur?.pushOverride(e)??null}invalidateObjectMotion(e){this.renderer.invalidateObjectMotion(e)}getLastFrameProfile(){return this.renderer.getLastFrameProfile()}setPostProcessState(e){null!=this.colorGrading&&(Object.assign(this.colorGrading.options,e??{enabled:!1}),this.colorGrading.options.enabled=!0===e?.enabled),null!=this.depthOfField&&(this.depthOfField.options.enabled=null!=e?.depthFocus||null!=e?.depthAperture||null!=e?.depthMaxBlur,this.depthOfField.options.focus=e?.depthFocus,this.depthOfField.options.aperture=e?.depthAperture,this.depthOfField.options.maxBlur=e?.depthMaxBlur)}setProfilingEnabled(e){this.renderer.setRenderGraphProfilingEnabled(e)}resetTemporalHistory(){this.taa?.reset(),this.motionBlur?.reset(),this.gtao?.reset(),this.volumetricFog?.reset(),this.renderer.resetViewHistory(),this.nativeDlss?.reset()}inspect(e,t){return inspectWebGpuScene(e,t,this.nodeMaterialResolver)}destroy(){this.nativeDlss?.dispose(),this.nodeMaterialResolver.dispose(),this.gBufferFallbackSource.dispose(),this.gtao?.dispose(),this.smaa?.dispose(),this.motionBlur?.dispose(),this.volumetricFog?.dispose();for(const e of this.ownedPmremResults)e.dispose();this.ownedPmremResults.clear(),this.renderer.destroy(),this.fallbackMaterial.dispose()}}export function inspectWebGpuScene(e,t,i){const n={meshes:0,skinnedMeshes:0,instancedMeshes:0,batchedMeshes:0,sprites:0,points:0,lines:0,missingPositionGeometry:0,transparentMaterials:0,shaderMaterialsReplaced:0,materialsReplaced:0,unsupportedCamera:ExperimentalWebGpuBackend.supportsCamera(t)?0:1};return e.traverse(e=>{if(e.isSprite)return void n.sprites++;if(e.isPoints)return void n.points++;if(e.isLine)return void n.lines++;if(!e.isMesh)return;const t=e;t.isBatchedMesh?n.batchedMeshes++:t.isInstancedMesh?n.instancedMeshes++:t.isSkinnedMesh?n.skinnedMeshes++:n.meshes++,null==t.geometry?.getAttribute("position")&&n.missingPositionGeometry++;const r=Array.isArray(t.material)?t.material:[t.material];for(const e of r){if(null==e)continue;e.transparent&&n.transparentMaterials++;const t=!0===e.isWGSLShaderMaterial||!0===e.isLineMaterial,r=!t&&!0===i?.canResolve(e);t||r||(n.materialsReplaced++,e.isShaderMaterial&&n.shaderMaterialsReplaced++)}}),n}export function formatWebGpuSceneCapabilitySummary(e){return`[Hology WebGPU experiment] ${JSON.stringify(e)}`}const u="\nstruct VertexInput {\n  @location(0) position: vec3<f32>,\n  @location(1) normal: vec3<f32>,\n  @location(2) uv: vec2<f32>,\n  @location(3) color: vec4<f32>,\n#ifdef USE_SKINNING\n  @location(4) skinIndex: vec4<u32>,\n  @location(5) skinWeight: vec4<f32>,\n#endif\n  @builtin(instance_index) instanceIndex: u32,\n};\n\nstruct VertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) worldPosition: vec3<f32>,\n  @location(1) worldNormal: vec3<f32>,\n  @location(2) color: vec4<f32>,\n};\n\n@vertex\nfn vsMain(input: VertexInput) -> VertexOutput {\n  var output: VertexOutput;\n#ifdef USE_SKINNING\n  let localPosition = rendererSkinPosition(input.position, input.skinIndex, input.skinWeight);\n  let localNormal = rendererSkinNormal(input.normal, input.skinIndex, input.skinWeight);\n#else\n  let localPosition = input.position;\n  let localNormal = input.normal;\n#endif\n  let world = rendererWorldPosition(localPosition, input.instanceIndex);\n  output.position = rendererClipPosition(localPosition, input.instanceIndex);\n  output.worldPosition = world.xyz;\n  output.worldNormal = rendererWorldNormal(localNormal, input.instanceIndex);\n  output.color = input.color * rendererObjectColor(input.instanceIndex);\n  return output;\n}\n",p="\nstruct VertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) worldPosition: vec3<f32>,\n  @location(1) worldNormal: vec3<f32>,\n  @location(2) color: vec4<f32>,\n};\n\nfn distanceAttenuation(distanceToLight: f32, cutoffDistance: f32, decayExponent: f32) -> f32 {\n  var distanceFalloff = 1.0 / max(pow(distanceToLight, decayExponent), 0.01);\n  if (cutoffDistance > 0.0) {\n    let ratio = distanceToLight / cutoffDistance;\n    let cutoff = clamp(1.0 - ratio * ratio * ratio * ratio, 0.0, 1.0);\n    distanceFalloff *= cutoff * cutoff;\n  }\n  return distanceFalloff;\n}\n\n@fragment\nfn fsMain(input: VertexOutput) -> @location(0) vec4<f32> {\n  let normal = normalize(input.worldNormal);\n  let normalTint = normal * 0.5 + vec3<f32>(0.5);\n  let base = mix(vec3<f32>(0.52, 0.58, 0.64), normalTint, 0.22) * input.color.rgb;\n  var lighting = rendererIndirectDiffuse(normal) + vec3<f32>(0.08);\n  var directionalLighting = vec3<f32>(0.0);\n  let directionalCount = rendererDirectionalLightCount();\n\n  for (var index: u32 = 0u; index < directionalCount; index = index + 1u) {\n    let lightDirection = rendererDirectionalLightDirectionForLight(index);\n    let shadow = rendererSampleDirectionalShadowForLightWithNormal(index, input.worldPosition, normal);\n    directionalLighting += rendererDirectionalLightColorForLight(index) * max(dot(normal, lightDirection), 0.0) * shadow;\n  }\n  if (directionalCount > 0u) {\n    lighting += directionalLighting / f32(directionalCount);\n  }\n\n  for (var index: u32 = 0u; index < rendererPointLightCount(); index = index + 1u) {\n    let lightVector = rendererPointLightPositionForLight(index) - input.worldPosition;\n    let distanceToLight = length(lightVector);\n    let lightDirection = normalize(lightVector);\n    let shadow = rendererSamplePointShadowForLightWithNormal(index, input.worldPosition, normal);\n    lighting += rendererPointLightColorForLight(index) * max(dot(normal, lightDirection), 0.0) * distanceAttenuation(distanceToLight, rendererPointLightRangeForLight(index), rendererPointLightDecayForLight(index)) * shadow;\n  }\n\n  for (var index: u32 = 0u; index < rendererSpotLightCount(); index = index + 1u) {\n    let lightVector = rendererSpotLightPositionForLight(index) - input.worldPosition;\n    let distanceToLight = length(lightVector);\n    let lightDirection = normalize(lightVector);\n    let angleCos = dot(-lightDirection, rendererSpotLightDirectionForLight(index));\n    let cone = smoothstep(rendererSpotLightConeCosForLight(index), rendererSpotLightPenumbraCosForLight(index), angleCos);\n    let shadow = rendererSampleSpotShadowForLightWithNormal(index, input.worldPosition, normal);\n    lighting += rendererSpotLightColorForLight(index) * max(dot(normal, lightDirection), 0.0) * cone * distanceAttenuation(distanceToLight, rendererSpotLightRangeForLight(index), rendererSpotLightDecayForLight(index)) * shadow;\n  }\n\n  return vec4<f32>(base * max(lighting, vec3<f32>(0.08)), input.color.a);\n}\n";/*
+import*as e from"three";import{NodeMaterialWebGpuResolver as t}from"./node-material-webgpu-resolver.js";import{configureWebGpuRuntimeBindings as i}from"./webgpu-runtime-bridge.js";import{float as n,varyingTransformed as r,vec4 as s}from"three-shader-graph";import{NodeShaderMaterial as a}from"../shader-nodes/index.js";import{sceneMapUniformName as o}from"../shader-nodes/scene-sample.js";import{surfaceReflectionStepsUniformName as l}from"../shader-nodes/surface-reflection.js";import{depthUniformName as d}from"../shader-nodes/depth.js";import{MATERIAL_FLAG_ALPHA_TEST as c,MATERIAL_FLAG_RECEIVE_DECALS as h}from"../shader-nodes/material-flags.js";import{createMotionVectorOutput as u}from"./motion-vector-node.js";export class ExperimentalWebGpuBackend{constructor(e,t,i,n,r,s,a,o,l,d,c,h,u,p,m,g,f,S,v,b,P,w,x,y){this.renderer=e,this.fallbackMaterial=t,this.nodeMaterialResolver=i,this.gBufferFallbackSource=n,this.bloom=r,this.fxaa=s,this.smaa=a,this.gtao=o,this.ssr=l,this.taa=d,this.motionBlur=c,this.volumetricFog=h,this.colorGrading=u,this.depthOfField=p,this.outline=m,this.postProcessEffects=g,this.renderGraphExtensions=f,this.presentationExtensions=S,this.antiAliasingState=v,this.directionalShadowState=b,this.nativeDlss=P,this.sdfgi=w,this.createSDFGI=x,this.kind="webgpu",this.renderScale=1,this.pmremGenerator=null,this.pmremResults=new WeakMap,this.ownedPmremResults=new Set,this.warnedUnsupportedPostProcessStages=new Set,this.secondaryMotionPrepared=!1,this.canvas=y}static async probeAvailability(){if("undefined"==typeof navigator||!("gpu"in navigator))return{available:!1,reason:"The runtime does not expose navigator.gpu."};try{const e=await navigator.gpu.requestAdapter({powerPreference:"high-performance"});return null==e?{available:!1,reason:"No WebGPU adapter is available."}:{available:!0,adapter:e}}catch(e){return{available:!1,reason:`Requesting a WebGPU adapter failed: ${e instanceof Error?e.message:String(e)}`}}}static async create(g={},f){const S=await import("@hology/webgpu-renderer");i({registerPipelineDiagnosticOrigin:S.registerPipelineDiagnosticOrigin,createComputeKernel:(e,t)=>new S.ComputeKernel(e,t),buildParticleLightingShaderHeader:S.buildParticleLightingShaderHeader});const v=document.createElement("canvas");v.dataset.hologyRenderer="webgpu-experimental";const b=new S.WGSLShaderMaterial({vertexShader:p,fragmentShader:m}),P=!1!==g.nativeUpscaling&&"dlss"===g.nativeUpscaling?.method,w=P?(await import("./native-dlss-upscaler.js")).createNativeDlssUpscaler(g.nativeUpscaling?.mode??"quality"):null,x=null!=w;b.side=S.DoubleSide;const y=S,D=null!=g.motionBlur&&!1!==g.motionBlur,F=!1!==g.gtao&&(null==g.gtao||!1!==g.gtao.temporal),O=!1!==g.volumetricFog&&(null==g.volumetricFog||!1!==g.volumetricFog.temporal),M=x?"off":P?"taa":null!=(C=g).antiAliasing?C.antiAliasing:null!=C.taa&&!1!==C.taa?"taa":null!=C.smaa&&!1!==C.smaa?"smaa":null!=C.fxaa&&!1!==C.fxaa?"fxaa":!1===C.taa?"off":"taa";var C;const E=null!=g.antiAliasing,G=D||F||O||(E||"taa"===M)||x;let L=null;const R=new t(y,(e,t)=>"opaque"===t?[e.outputColor.xyz.rgba(n(e.alphaTest>0?c:0).add(!1===e.userData.receiveDecals?0:h)),s((e.outputNormal??r.normal).multiplyScalar(.5).addScalar(.5),e.outputRoughness??n(1)),...G?[u(e)]:[]]:void 0,e=>L?.getEnvironmentTexture(e)??e),T=new e.MeshStandardMaterial({color:8688803,roughness:1});if(null==R.resolve(T,"opaque"))throw b.dispose(),T.dispose(),new Error("Failed to compile the WebGPU G-buffer fallback material.");const A=!1===g.gtao?null:new S.GTAOEffect({normalSpace:"view",...S.GTAO_PRESETS.high,...g.gtao??{}}),I=new S.SSREffect({normalSpace:"view",enabled:null!=g.ssr&&!1!==g.ssr,...g.ssr||{}}),B=!1===g.bloom?null:new S.BloomEffect({threshold:1,strength:.9,radius:.2,...g.bloom??{}}),U=E||!1!==g.fxaa&&"fxaa"===M?new S.FXAAEffect(!1===g.fxaa?{}:g.fxaa):null,k=E||!1!==g.smaa&&"smaa"===M?new S.SMAAEffect(!1===g.smaa?{}:g.smaa):null,V=x||E||!1!==g.taa&&"taa"===M?new S.TemporalAAEffect({renderScale:1,...!1===g.taa?{}:g.taa}):null,W={mode:M},j=!1===g.motionBlur||null==g.motionBlur?null:new S.MotionBlurEffect(g.motionBlur),N=g.volumetricFog||void 0,H=!1===g.volumetricFog?null:new S.VolumetricFogEffect(void 0,{...S.VOLUMETRIC_FOG_PRESETS.high,maxDistance:64,spatialJitter:!0,scatteringIntensity:Math.PI,...N,temporal:!1!==N?.temporal&&{...S.VOLUMETRIC_FOG_PRESETS.high.temporal,...N?.temporal},blur:!1!==N?.blur&&{...!1===S.VOLUMETRIC_FOG_PRESETS.high.blur?{}:S.VOLUMETRIC_FOG_PRESETS.high.blur,depthAwareUpsample:!0,...N?.blur}}),$=!1===g.colorGrading?null:new S.ColorGradingEffect({enabled:!1,...g.colorGrading??{}}),_=!1===g.depthOfField?null:new S.DepthOfFieldEffect({enabled:!1,...g.depthOfField??{}}),q=!1===g.outline?null:new S.OutlineEffect({enabled:!1,...g.outline??{}}),z=[],J=new WeakMap,K=new Set,Z=[],Q=[],X=(e,t,i)=>{let n=i;const r=z.filter(e=>e.enabled&&e.stage===t).sort((e,t)=>e.priority-t.priority||e.id-t.id);for(const t of r){if(!(t.material instanceof a)){const e=`${t.id}:material`;K.has(e)||(K.add(e),console.warn(`[Hology WebGPU experiment] Skipping custom post-process effect ${t.id}: only NodeShaderMaterial effects are supported.`));continue}try{let i=J.get(t.material);null!=i&&i.version===t.material.version||(i={version:t.material.version,shader:R.compileFullscreen(t.material),diagnosticOrigin:{key:"post-process:"+String(t.material.userData.assetId??(t.material.name||t.material.uuid)),material:{name:t.material.name,uuid:t.material.uuid,version:t.material.version,assetId:t.material.userData.assetId,assetName:t.material.userData.assetName}}},J.set(t.material,i));const r=e.createColorTarget(`hologyCustomPostProcess${t.id}`);e.addNodeFullscreenPass({name:`HologyCustomPostProcess${t.id}`,diagnosticOrigin:i.diagnosticOrigin,shader:i.shader,inputOverrides:{[o]:n},outputs:r}),n=r}catch(e){const i=`${t.id}:compile:${t.material.version}`;K.has(i)||(K.add(i),console.warn(`[Hology WebGPU experiment] Skipping custom post-process effect ${t.id}: ${e instanceof Error?e.message:String(e)}`,e))}}return n},Y={enabled:!0};let ee=null;const te=e=>{if(null!=ee)return ee;const t=g.sdfgi||{},i=new S.SDFGI(ie.getDevice(),{...t,...e});try{i.setSurfaceCaptureFactory(e=>new S.SDFGISurfaceCapture(ie,e,e=>R.resolveSDFGISurface(e)??null,e!==i))}catch(e){throw i.dispose(),e}return ee=i,i},ie=new S.WebGpuRenderer({canvas:v,fallbackMaterial:b,materialResolver:(e,t)=>{const i=R.resolve(e,t);if(null!=i&&"outline"!==t&&!0!==e.userData.isSky&&ee?.configureMaterial(i),null!=i){const e=i,t=e.uniforms[l];null!=t&&t.value!==I.surfaceRaySteps&&(t.value=I.surfaceRaySteps,e.uniformValuesNeedsUpdate=!0)}return i},invokeObjectRenderCallbacks:!1,hiZOcclusionCulling:!0,renderGraphProfiling:!1,sampleCount:1,multiDrawIndirect:!1,nativePostSubmit:w?.postSubmit,presentationOverlay:e=>{for(const t of Q)t(e)}});ie.setRenderScale("taa"===M?V?.renderScale??1:1),ie.setRenderGraphBuilder((e,t)=>{const i=new S.FrameGraphBuilder(t),n=i.createColorTarget("hologyNormalRoughness",{format:"rgba8unorm"}),r=G?i.createColorTarget("hologyMotionVectors",{format:"rgba16float"}):null;for(const e of Z)"beforeScene"===e.stage&&e(i,i.sceneColor);const s=ee?.addPasses(i)??!1;Y.enabled&&i.addDirectionalShadowPass(),i.addPointShadowPass(),i.addSpotShadowPass(),i.addDepthPrepass(),i.addHiZPasses(),i.addVisibilityPass(),i.addMaterialPass({name:"OpaqueGBufferPass",dependsOn:s?["SDFGIUpdate"]:void 0,outputs:null==r?[i.sceneColor,n]:[i.sceneColor,n,r],drawStage:"opaque",loadDepth:!0}),i.addHiZHistoryPass("OpaqueGBufferPass");let a=i.sceneColor;if(A?.enabled){const e=A.addPasses(i,{depth:i.mainDepth,normal:n,velocity:r??void 0});a=A.addCompositePass(i,a,e)}I.enabled&&(a=I.addPasses(i,{sceneColor:a,depth:i.mainDepth,normalRoughness:n}));const o=new Set(Z.flatMap(e=>e.getSceneTextureReads?.()??[]));i.addSceneTextureCopyPass(a,{sceneColor:o.has("sceneColorSnapshot"),sceneDepth:o.has("sceneDepthSnapshot")||z.some(e=>e.enabled&&null!=e.material.uniforms[d])}),i.addLatePass(a);for(const e of Z)null!=e.stage&&"afterScene"!==e.stage||e(i,a);a=X(i,"beforeFog",a),null!=H&&(a=H.addPasses(i,{sceneColor:a,depth:i.mainDepth,velocity:r??void 0,volumeObjects:t.fogVolumeObjects,lights:t.extractedLights})),null!=j&&null!=r&&(a=j.addPass(i,a,r,i.mainDepth)),null!=B&&(a=B.addPass(i,a)),a=X(i,"beforeOutline",a),null!=q&&(a=q.addPass(i,a)),a=X(i,"beforeDepthOfField",a),null!=_&&(a=_.addPass(i,a,i.mainDepth)),a=X(i,"beforeColorAdjustment",a),null!=$&&(a=$.addPass(i,a)),a=X(i,"beforeAntiAliasing",a);let l="taa"===W.mode&&null!=V?V.addPass(i,a,i.mainDepth,r??void 0):a;"smaa"===W.mode&&null!=k?l=k.addPass(i,l):"fxaa"===W.mode&&null!=U&&(l=U.addPass(i,l)),l=X(i,"beforeOutput",l);for(const e of Z)"beforePresent"===e.stage&&e(i,l);!0===w?.enabled&&null!=r?w.addInputPass(i,l,r):i.present(l)});try{return await ie.initialize(f),null!=g.sdfgi&&!1!==g.sdfgi&&te(g.sdfgi),L=new ExperimentalWebGpuBackend(ie,b,R,T,B,U,k,A,I,V,j,H,$,_,q,z,Z,Q,W,Y,w,ee,te,v),L}catch(e){throw ee?.dispose(),ie.destroy(),b.dispose(),R.dispose(),T.dispose(),A?.dispose(),k?.dispose(),j?.dispose(),H?.dispose(),q?.dispose(),e}}static supportsCamera(t){return t instanceof e.PerspectiveCamera||t instanceof e.OrthographicCamera}setSize(e,t,i,n=1){const r=this.canvas.width,s=this.canvas.height;let a=Math.min(1,Math.max(.25,n));if(!0===this.nativeDlss?.enabled){const n=Math.max(1,Math.floor(e*i)),r=Math.max(1,Math.floor(t*i));a=this.nativeDlss.getRenderScale(n,r)}const o=a!==this.renderScale;this.renderScale=a,this.renderer.setRenderScale(a),this.taa?.setRenderScale(a),this.renderer.setSize(e,t,i),(o||this.canvas.width!==r||this.canvas.height!==s)&&this.resetViewHistory()}initTexture(e){this.renderer.initTexture(e)}setPostProcessEffects(e){this.postProcessEffects.splice(0,this.postProcessEffects.length,...e);for(const t of e){if("beforeLut"!==t.stage)continue;const e=`${t.id}:${t.stage}`;this.warnedUnsupportedPostProcessStages.has(e)||(this.warnedUnsupportedPostProcessStages.add(e),console.warn(`[Hology WebGPU experiment] Skipping custom post-process effect ${t.id}: stage "${t.stage}" has no native WebGPU anchor.`))}}getDevice(){return this.renderer.getDevice()}createSceneCapture(e,t,i){return this.renderer.createSceneCapture(e,t,i)}setRenderGraphExtensions(e){this.renderGraphExtensions.length=0;for(const t of e)this.renderGraphExtensions.push(t)}setPresentationExtensions(e){this.presentationExtensions.length=0;for(const t of e)this.presentationExtensions.push(t)}setEnableOutlines(e){null!=this.outline&&(this.outline.enabled=e)}setTiledLightingEnabled(e){this.renderer.setTiledLightingEnabled(e)}setSDFGIOptions(e){null==this.sdfgi&&!0===e.enabled&&(this.sdfgi=this.createSDFGI(e),this.renderer.invalidateMaterialResolution()),this.sdfgi?.setOptions(e)}invalidateSDFGI(){this.sdfgi?.invalidate()}getSDFGIStats(){return this.sdfgi?.stats??null}setDynamicBatchingEnabled(e){this.renderer.setDynamicBatchingEnabled(e)}setSelectedObjects(e){this.outline?.setSelectedObjects(e)}setSelectedObjectInstances(e){this.outline?.setSelectedInstances(e)}setCascadedShadowRanges(e,t=[]){this.renderer.setCascadedShadowRanges(e,t),this.volumetricFog?.setCascadedDirectionalLights(t),this.sdfgi?.setCascadedDirectionalLights(t)}setDirectionalShadowUpdateOptions(e){this.renderer.setDirectionalShadowUpdateOptions(e)}invalidateDirectionalShadows(){this.renderer.invalidateDirectionalShadows()}setDirectionalShadowOptions(e,t){this.directionalShadowState.enabled=e,this.renderer.setDirectionalShadowsEnabled(e),this.renderer.setDirectionalShadowMapSize(t)}setWorldEnvironment(e){if(null==e)return void this.nodeMaterialResolver.setWorldEnvironment(null);const t=this.getEnvironmentTexture(e.source);this.nodeMaterialResolver.setWorldEnvironment({texture:t,intensity:e.intensity})}getEnvironmentTexture(t){if(t.mapping===e.CubeUVReflectionMapping)return t;let i=this.pmremResults.get(t);return null==i&&(this.pmremGenerator??(this.pmremGenerator=this.renderer.createPMREMGenerator()),i=this.pmremGenerator.fromEquirectangular(t),this.pmremResults.set(t,i),this.ownedPmremResults.add(i)),i.texture}resetViewHistory(){this.renderer.resetViewHistory(),this.taa?.reset(),this.motionBlur?.reset(),this.gtao?.reset(),this.volumetricFog?.reset(),this.nativeDlss?.reset()}async compile(e,t){if(!this.secondaryMotionPrepared){let t=!1;e.traverse(e=>{const i=e.userData.secondaryMotion?.regions;Array.isArray(i)&&i.some(e=>e.enabled)&&(t=!0)});const i=this.renderer.getDevice();if(t&&i){const{prepareSecondaryMotionRuntime:e}=await import("../secondary-motion/runtime.js");e(i),this.secondaryMotionPrepared=!0}}await this.renderer.compileAsync(e,t)}createStaticDrawSet(e,t,i=!1,n="skip",r=!1){this.renderer.setHiZOcclusionCullingEnabled(!0);const s=this.renderer.createStaticDrawSet(e,{label:t,onUnsupported:n,allowUnsortedLateDraws:i,mutableTransforms:r});if(0===s.drawCount)return s.dispose(),null;if(null==this.sdfgi)return s;let a=this.sdfgi.registerStaticDrawRoot(e);return{label:s.label,drawCount:s.drawCount,instanceCount:s.instanceCount,updateTransforms:()=>{s.updateTransforms(),a(),a=this.sdfgi.registerStaticDrawRoot(e)},dispose:()=>{a(),s.dispose()}}}registerStaticSpatialObject(e){return this.renderer.registerStaticSpatialObject(e)}render(e,t,i){this.sdfgi?.prepare(e,t);const n="taa"===this.antiAliasingState.mode?this.taa:null;this.volumetricFog?.setScene(e),this.renderer.setMotionVectorProjection(t.projectionMatrix),this.motionBlur?.prepareCamera(t,this.canvas.width,this.canvas.height,i),this.motionBlur?.requiresRendererHistoryReset()&&(this.renderer.resetViewHistory(),this.gtao?.reset(),this.volumetricFog?.reset()),n?.prepareCamera(t,this.canvas.width,this.canvas.height),this.nativeDlss?.prepareFrame(t);const r=!0===this.nativeDlss?.enabled?this.nativeDlss.jitter:null;this.motionBlur?.setJitterUv(n?.currentJitterUv.x??(null==r?0:r.x/Math.max(1,this.canvas.width*this.renderScale)),n?.currentJitterUv.y??(null==r?0:-r.y/Math.max(1,this.canvas.height*this.renderScale))),null!=r&&this.renderer.setProjectionJitter(r.x,r.y);let s=!1;try{this.renderer.render(e,t,i),s=!0}finally{null!=r&&this.renderer.clearProjectionJitter(),n?.finishCamera(t),s&&this.motionBlur?.commitCamera(),s&&this.nativeDlss?.finishFrame(t)}}prepareSceneGeometry(e,t){return this.renderer.prepareSceneGeometryAsync(e,t)}renderPresentationOnly(e){this.setPresentationExtensions(e),this.renderer.renderPresentationOnly()}setMotionBlurOptions(e){null!=this.motionBlur&&Object.assign(this.motionBlur.options,e)}setSSROptions(e){this.ssr?.setOptions(e)}setGTAOOptions(e){this.gtao?.setOptions(e)}setAntiAliasingMode(e){e!==this.antiAliasingState.mode&&("taa"===e&&null==this.taa||"smaa"===e&&null==this.smaa||"fxaa"===e&&null==this.fxaa?console.warn(`[Hology WebGPU experiment] Anti-aliasing mode "${e}" was not initialized. Set webgpuPostProcessing.antiAliasing in the initial rendering configuration to enable runtime switching.`):(this.antiAliasingState.mode=e,this.resetTemporalHistory()))}setGTAOQuality(e){this.gtao?.applyPreset(e)}setVolumetricFogOptions(e){this.volumetricFog?.setOptions(e)}setVolumetricFogQuality(e){this.volumetricFog?.applyPreset(e)}pushMotionBlurOverride(e){return this.motionBlur?.pushOverride(e)??null}invalidateObjectMotion(e){this.renderer.invalidateObjectMotion(e)}getLastFrameProfile(){return this.renderer.getLastFrameProfile()}setPostProcessState(e){null!=this.colorGrading&&(Object.assign(this.colorGrading.options,e??{enabled:!1}),this.colorGrading.options.enabled=!0===e?.enabled),null!=this.depthOfField&&(this.depthOfField.options.enabled=null!=e?.depthFocus||null!=e?.depthAperture||null!=e?.depthMaxBlur,this.depthOfField.options.focus=e?.depthFocus,this.depthOfField.options.aperture=e?.depthAperture,this.depthOfField.options.maxBlur=e?.depthMaxBlur)}setProfilingEnabled(e){this.renderer.setRenderGraphProfilingEnabled(e)}resetTemporalHistory(){this.taa?.reset(),this.motionBlur?.reset(),this.gtao?.reset(),this.volumetricFog?.reset(),this.renderer.resetViewHistory(),this.nativeDlss?.reset()}inspect(e,t){return inspectWebGpuScene(e,t,this.nodeMaterialResolver)}destroy(){this.sdfgi?.dispose(),this.nativeDlss?.dispose(),this.nodeMaterialResolver.dispose(),this.gBufferFallbackSource.dispose(),this.gtao?.dispose(),this.smaa?.dispose(),this.motionBlur?.dispose(),this.volumetricFog?.dispose();for(const e of this.ownedPmremResults)e.dispose();this.ownedPmremResults.clear(),this.renderer.destroy(),this.fallbackMaterial.dispose()}}export function inspectWebGpuScene(e,t,i){const n={meshes:0,skinnedMeshes:0,instancedMeshes:0,batchedMeshes:0,sprites:0,points:0,lines:0,missingPositionGeometry:0,transparentMaterials:0,shaderMaterialsReplaced:0,materialsReplaced:0,unsupportedCamera:ExperimentalWebGpuBackend.supportsCamera(t)?0:1};return e.traverse(e=>{if(e.isSprite)return void n.sprites++;if(e.isPoints)return void n.points++;if(e.isLine)return void n.lines++;if(!e.isMesh)return;const t=e;t.isBatchedMesh?n.batchedMeshes++:t.isInstancedMesh?n.instancedMeshes++:t.isSkinnedMesh?n.skinnedMeshes++:n.meshes++,null==t.geometry?.getAttribute("position")&&n.missingPositionGeometry++;const r=Array.isArray(t.material)?t.material:[t.material];for(const e of r){if(null==e)continue;e.transparent&&n.transparentMaterials++;const t=!0===e.isWGSLShaderMaterial||!0===e.isLineMaterial,r=!t&&!0===i?.canResolve(e);t||r||(n.materialsReplaced++,e.isShaderMaterial&&n.shaderMaterialsReplaced++)}}),n}export function formatWebGpuSceneCapabilitySummary(e){return`[Hology WebGPU experiment] ${JSON.stringify(e)}`}const p="\nstruct VertexInput {\n  @location(0) position: vec3<f32>,\n  @location(1) normal: vec3<f32>,\n  @location(2) uv: vec2<f32>,\n  @location(3) color: vec4<f32>,\n#ifdef USE_SKINNING\n  @location(4) skinIndex: vec4<u32>,\n  @location(5) skinWeight: vec4<f32>,\n#endif\n  @builtin(instance_index) instanceIndex: u32,\n};\n\nstruct VertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) worldPosition: vec3<f32>,\n  @location(1) worldNormal: vec3<f32>,\n  @location(2) color: vec4<f32>,\n};\n\n@vertex\nfn vsMain(input: VertexInput) -> VertexOutput {\n  var output: VertexOutput;\n#ifdef USE_SKINNING\n  let localPosition = rendererSkinPosition(input.position, input.skinIndex, input.skinWeight);\n  let localNormal = rendererSkinNormal(input.normal, input.skinIndex, input.skinWeight);\n#else\n  let localPosition = input.position;\n  let localNormal = input.normal;\n#endif\n  let world = rendererWorldPosition(localPosition, input.instanceIndex);\n  output.position = rendererClipPosition(localPosition, input.instanceIndex);\n  output.worldPosition = world.xyz;\n  output.worldNormal = rendererWorldNormal(localNormal, input.instanceIndex);\n  output.color = input.color * rendererObjectColor(input.instanceIndex);\n  return output;\n}\n",m="\nstruct VertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) worldPosition: vec3<f32>,\n  @location(1) worldNormal: vec3<f32>,\n  @location(2) color: vec4<f32>,\n};\n\nfn distanceAttenuation(distanceToLight: f32, cutoffDistance: f32, decayExponent: f32) -> f32 {\n  var distanceFalloff = 1.0 / max(pow(distanceToLight, decayExponent), 0.01);\n  if (cutoffDistance > 0.0) {\n    let ratio = distanceToLight / cutoffDistance;\n    let cutoff = clamp(1.0 - ratio * ratio * ratio * ratio, 0.0, 1.0);\n    distanceFalloff *= cutoff * cutoff;\n  }\n  return distanceFalloff;\n}\n\n@fragment\nfn fsMain(input: VertexOutput) -> @location(0) vec4<f32> {\n  let normal = normalize(input.worldNormal);\n  let normalTint = normal * 0.5 + vec3<f32>(0.5);\n  let base = mix(vec3<f32>(0.52, 0.58, 0.64), normalTint, 0.22) * input.color.rgb;\n  var lighting = rendererIndirectDiffuse(normal) + vec3<f32>(0.08);\n  var directionalLighting = vec3<f32>(0.0);\n  let directionalCount = rendererDirectionalLightCount();\n\n  for (var index: u32 = 0u; index < directionalCount; index = index + 1u) {\n    let lightDirection = rendererDirectionalLightDirectionForLight(index);\n    let shadow = rendererSampleDirectionalShadowForLightWithNormal(index, input.worldPosition, normal);\n    directionalLighting += rendererDirectionalLightColorForLight(index) * max(dot(normal, lightDirection), 0.0) * shadow;\n  }\n  if (directionalCount > 0u) {\n    lighting += directionalLighting / f32(directionalCount);\n  }\n\n  for (var index: u32 = 0u; index < rendererPointLightCount(); index = index + 1u) {\n    let lightVector = rendererPointLightPositionForLight(index) - input.worldPosition;\n    let distanceToLight = length(lightVector);\n    let lightDirection = normalize(lightVector);\n    let shadow = rendererSamplePointShadowForLightWithNormal(index, input.worldPosition, normal);\n    lighting += rendererPointLightColorForLight(index) * max(dot(normal, lightDirection), 0.0) * distanceAttenuation(distanceToLight, rendererPointLightRangeForLight(index), rendererPointLightDecayForLight(index)) * shadow;\n  }\n\n  for (var index: u32 = 0u; index < rendererSpotLightCount(); index = index + 1u) {\n    let lightVector = rendererSpotLightPositionForLight(index) - input.worldPosition;\n    let distanceToLight = length(lightVector);\n    let lightDirection = normalize(lightVector);\n    let angleCos = dot(-lightDirection, rendererSpotLightDirectionForLight(index));\n    let cone = smoothstep(rendererSpotLightConeCosForLight(index), rendererSpotLightPenumbraCosForLight(index), angleCos);\n    let shadow = rendererSampleSpotShadowForLightWithNormal(index, input.worldPosition, normal);\n    lighting += rendererSpotLightColorForLight(index) * max(dot(normal, lightDirection), 0.0) * cone * distanceAttenuation(distanceToLight, rendererSpotLightRangeForLight(index), rendererSpotLightDecayForLight(index)) * shadow;\n  }\n\n  return vec4<f32>(base * max(lighting, vec3<f32>(0.08)), input.color.a);\n}\n";/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/rendering.d.ts

@@ -1,31 +1,28 @@
+import type { DetailCullingSettings, DirectionalShadowUpdateOptions } from "@hology/webgpu-renderer";
 import * as THREE from "three";
-import type { DirectionalShadowUpdateOptions } from "@hology/webgpu-renderer";
-export type { DirectionalShadowUpdateOptions } from "@hology/webgpu-renderer";
-import type { DetailCullingSettings } from "@hology/webgpu-renderer";
-export type { DetailCullingSettings } from "@hology/webgpu-renderer";
-import { Camera, Object3D, WebGLRenderer, WebGLRenderTarget, Texture } from 'three';
-import { ShaderPass } from "three-stdlib";
-import { IRgbNode, RgbaNode } from 'three-shader-graph';
-import { CSM } from "three/examples/jsm/csm/CSM.js";
-import { type RenderingStatsStyle } from './utils/three/frame-stats.js';
+import { Camera, Object3D, Texture, WebGLRenderer } from 'three';
+import { type SceneSDFGISettings } from './rendering/sdfgi-settings.js';
+export type { DetailCullingSettings, DirectionalShadowUpdateOptions } from "@hology/webgpu-renderer";
+export type { SceneSDFGISettings } from './rendering/sdfgi-settings.js';
+export { FogNode, isObjectInFrustum } from './rendering/webgl-backend.js';
 export type { RenderingStatsStyle } from './utils/three/frame-stats.js';
-import { GTAOPass } from "three/examples/jsm/postprocessing/GTAOPass.js";
-import { OutlinePass } from './utils/three/outline-pass.js';
-import { type PostProcessSettings, type PostProcessVolume } from "./gameplay/actors/builtin/post-process-volume-actor.js";
+import { CSM } from "three/examples/jsm/csm/CSM.js";
+import type { VfxBackendPreference } from './effects/vfx/gpu-sprite-compiler.js';
 import type { WaterPostProcessVolume } from './gameplay/actors/builtin/components/water-post-process-settings.js';
-import { type PostProcessEffect, type PostProcessEffectOptions } from "./rendering/post-process-effect.js";
+import { type PostProcessSettings, type PostProcessVolume } from "./gameplay/actors/builtin/post-process-volume-actor.js";
 import { Cluster } from "./rendering/cluster-generator.js";
-import { LightVolume } from "./rendering/light-probes/light-volume-capture.js";
-import { type PostProcessMaterialSource } from "./shader/post-process-shader.js";
-import { type UpscalingOptions } from "./rendering/upscaling-pass.js";
-import { type AntiAliasingMode, type ExperimentalWebGpuPostProcessingOptions, type GTAOOptions, type GTAOQuality, type MotionBlurOptions, type MotionBlurOverride, type MotionBlurOverrideHandle, type RendererFrameProfile, type ExperimentalWebGpuRenderGraphExtension, type WebGpuPresentationExtension, type RendererSceneCapture, type VolumetricFogOptions, type VolumetricFogQuality } from './rendering/webgpu-experimental-backend.js';
 import type { WorldEnvironmentState } from './rendering/environment.js';
-import type { VfxBackendPreference } from './effects/vfx/gpu-sprite-compiler.js';
 import { type GraphicsRuntime } from './rendering/graphics-runtime.js';
+import { LightVolume } from "./rendering/light-probes/light-volume-capture.js";
+import { type PostProcessEffect, type PostProcessEffectOptions } from "./rendering/post-process-effect.js";
+import { type UpscalingOptions } from "./rendering/upscaling-pass.js";
+import { WebGlBackend } from './rendering/webgl-backend.js';
+import { type AntiAliasingMode, type ExperimentalWebGpuPostProcessingOptions, type ExperimentalWebGpuRenderGraphExtension, type GTAOOptions, type GTAOQuality, type MotionBlurOptions, type MotionBlurOverride, type MotionBlurOverrideHandle, type RendererFrameProfile, type RendererSceneCapture, type SDFGIOptions, type SDFGIStats, type SSROptions, type VolumetricFogOptions, type VolumetricFogQuality, type WebGpuPresentationExtension } from './rendering/webgpu-experimental-backend.js';
+import { type PostProcessMaterialSource } from "./shader/post-process-shader.js";
+import { type RenderingStatsStyle } from './utils/three/frame-stats.js';
 export { GraphicsRuntime } from './rendering/graphics-runtime.js';
 export type { UpscalingOptions } from "./rendering/upscaling-pass.js";
-export type { AntiAliasingMode, ExperimentalWebGpuPostProcessingOptions, ExperimentalWebGpuRenderGraphExtension, WebGpuPresentationExtension, WebGpuPresentationExtensionContext, RendererSceneCapture, RendererSceneCaptureOptions, RendererSceneCapturePostProcessContext } from './rendering/webgpu-experimental-backend.js';
-export type { GTAOOptions, GTAOQuality, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, VolumetricFogOptions, VolumetricFogQuality } from './rendering/webgpu-experimental-backend.js';
+export type { AntiAliasingMode, ExperimentalWebGpuPostProcessingOptions, ExperimentalWebGpuRenderGraphExtension, GTAOOptions, GTAOQuality, MotionBlurOptions, MotionBlurOverride, MotionBlurOverrideHandle, RendererSceneCapture, RendererSceneCaptureOptions, RendererSceneCapturePostProcessContext, SDFGICascadeOptions, SDFGIOptions, SDFGIStats, SSROptions, VolumetricFogOptions, VolumetricFogQuality, WebGpuPresentationExtension, WebGpuPresentationExtensionContext } from './rendering/webgpu-experimental-backend.js';
 /** Renderer requested by a view. `webgpu-experimental` is a deprecated alias. */
 export type RenderingBackend = 'webgl' | 'webgpu' | 'webgpu-experimental';
 export type ActiveRenderingBackend = 'webgl' | 'webgpu';
@@ -36,6 +33,10 @@ export interface DirectionalShadowOptions {
     maxDistance: number;
 }
 export type MotionBlurObjectMode = 'disabled' | 'cameraOnly' | 'objectAndCamera' | 'forceObjectBlur';
+/** Callable disposer with an explicit resident-data refresh. */
+export type StaticDrawSetRegistrationHandle = (() => void) & {
+    updateTransforms(): void;
+};
 export type DynamicResolutionOptions = {
     enabled?: boolean;
     /**
@@ -176,7 +177,7 @@ export declare class RenderingView {
      * initialized. The source remains visible until its static draw set exists,
      * so WebGL fallback continues to render the normal Three.js objects.
      */
-    registerExperimentalStaticDrawSet(root: THREE.Object3D, label: string, allowUnsortedLateDraws?: boolean, onUnsupported?: 'throw' | 'skip'): () => void;
+    registerExperimentalStaticDrawSet(root: THREE.Object3D, label: string, allowUnsortedLateDraws?: boolean, onUnsupported?: 'throw' | 'skip', mutableTransforms?: boolean): StaticDrawSetRegistrationHandle;
     /** @deprecated Use registerWebGpuRenderGraphExtension. */
     registerExperimentalWebGpuRenderGraphExtension(extension: ExperimentalWebGpuRenderGraphExtension): () => void;
     private isIntersecting;
@@ -187,25 +188,30 @@ export declare class RenderingView {
     camera: THREE.Camera;
     windowVisible: boolean;
     /** @deprecated WebGL-specific escape hatch. Use webGlRenderer and backend-neutral RenderingView APIs. */
-    renderer: WebGLRenderer;
+    get renderer(): WebGLRenderer;
+    /** Legacy WebGL resources remain accessible through the facade. */
+    get rendererDepth(): WebGlBackend['rendererDepth'];
+    set rendererDepth(value: WebGlBackend['rendererDepth']);
+    get outlinePass(): WebGlBackend['outlinePass'];
+    set outlinePass(value: WebGlBackend['outlinePass']);
+    get fxaaPass(): WebGlBackend['fxaaPass'];
+    set fxaaPass(value: WebGlBackend['fxaaPass']);
+    get aoMaskDepthRenderTarget(): WebGlBackend['aoMaskDepthRenderTarget'];
+    set aoMaskDepthRenderTarget(value: WebGlBackend['aoMaskDepthRenderTarget']);
+    get depthRenderTarget(): WebGlBackend['depthRenderTarget'];
+    set depthRenderTarget(value: WebGlBackend['depthRenderTarget']);
+    get sceneColorRenderTarget(): WebGlBackend['sceneColorRenderTarget'];
+    set sceneColorRenderTarget(value: WebGlBackend['sceneColorRenderTarget']);
+    get sceneDepthRenderTarget(): WebGlBackend['sceneDepthRenderTarget'];
+    set sceneDepthRenderTarget(value: WebGlBackend['sceneDepthRenderTarget']);
+    get aoPass(): WebGlBackend['aoPass'];
+    set aoPass(value: WebGlBackend['aoPass']);
     /** Returns the WebGL renderer only when the active backend is WebGL. */
     get webGlRenderer(): WebGLRenderer | null;
     registerWebGpuRenderGraphExtension(extension: ExperimentalWebGpuRenderGraphExtension): () => void;
-    rendererDepth: WebGLRenderer;
-    private composer;
-    private bloomComposer;
-    outlinePass: OutlinePass;
-    fxaaPass: ShaderPass;
-    /** Copy pass is to copy the forward rendered result into the effect composer */
-    private copyPass;
     scene: THREE.Scene;
-    private queryScene;
     running: boolean;
     paused: boolean;
-    aoMaskDepthRenderTarget: WebGLRenderTarget;
-    depthRenderTarget: WebGLRenderTarget;
-    sceneColorRenderTarget: WebGLRenderTarget;
-    sceneDepthRenderTarget: WebGLRenderTarget;
     csm: CSM | null;
     private _fpsCap;
     private fpsCapRevision;
@@ -220,42 +226,18 @@ export declare class RenderingView {
     baseToneMapping: THREE.ToneMapping;
     baseToneMappingExposure: number;
     /** Tracks last update time (ms) for each CSM cascade. */
-    private csmCascadeLastUpdate?;
-    private csmUpdateInvervals;
     private webgpuDirectionalShadowUpdateOptions;
     private webgpuDirectionalShadowOptions;
-    aoPass: GTAOPass;
-    private bloomPass;
-    private colorPass;
-    private dofPass;
-    private lutPass;
-    private outputPass;
-    private ssrPass;
-    private volumetricFogPass;
     private postProcessEffectId;
     private postProcessEffects;
-    private postProcessEffectResolution;
-    private postProcessEffectUniformState;
-    private transmissionColorRenderTarget?;
-    private transmissionCopyQuad?;
-    private fquadCopySceneColor;
-    private fquadCopySceneDepth;
-    private occlusionClusters;
     simulationTime: number;
     simulationTimeScale: number;
     lightVolume: LightVolume;
     lightProbeIntensity: number;
-    /**
-     * This should be used to multiply the AO with the opaque color.
-     *
-     * The reason for using an MRT for this is to be able to render the transparent
-     * pass and add to the samt MRT for bloom and other effects.
-     *
-     * An altnerative could be to have multiple bloom texture outputs that are
-     * additively combined. Normals as well could simply be overwritten for SSR.
-     */
-    private fquadBlendAO;
-    private createAoblendQuad;
+    addCluster(cluster: Cluster): void;
+    addOverlayCamera(camera: Camera): void;
+    clearOverlayCameras(): void;
+    removeOverlayCamera(camera: Camera): void;
     setPaused(value: boolean): void;
     resolutionScale: number;
     maxPixelRatio: number;
@@ -263,19 +245,7 @@ export declare class RenderingView {
     private dynamicResolutionFrameTimeAverage;
     private dynamicResolutionFrameSamples;
     private dynamicResolutionLastAdjustmentAt;
-    private upscaleOutputPass;
     setResolutionScale(scale: number | undefined): void;
-    private readonly unjitteredProjectionMatrix;
-    private readonly temporalJitter;
-    private readonly temporalJitterUv;
-    private readonly currentUnjitteredViewProjectionMatrix;
-    private readonly currentViewProjectionMatrix;
-    private readonly currentViewProjectionMatrixInverse;
-    private readonly previousViewProjectionMatrix;
-    private readonly temporalUpscalingFrameState;
-    private temporalUpscalingFrameIndex;
-    private hasPreviousTemporalViewProjection;
-    private projectionJitterApplied;
     get currentResolutionScale(): number;
     get currentRenderPixelRatio(): number;
     get currentPresentationPixelRatio(): number;
@@ -283,10 +253,7 @@ export declare class RenderingView {
     /** CSS-pixel viewport size captured by resizeRender(). */
     getClientSize(target?: THREE.Vector2): THREE.Vector2;
     private isUpscalingEnabled;
-    private isTemporalUpscalingEnabled;
     resetUpscalingHistory(): void;
-    private prepareUpscalingFrame;
-    private finishUpscalingFrame;
     private getBasePixelRatio;
     private getBaseResolutionScale;
     private getDynamicResolutionMinScale;
@@ -308,22 +275,10 @@ export declare class RenderingView {
     removePostProcessVolume(volume: PostProcessVolume): void;
     addPostProcessEffect(source: PostProcessMaterialSource, options?: PostProcessEffectOptions): PostProcessEffect;
     private syncExperimentalWebGpuPostProcessEffects;
-    private getPostProcessEffectStageAnchorPass;
     private onVisiblityChane;
-    private isDepthTextureExtensionSupported;
-    private outlineEffect;
-    private gRenderTarget;
-    private phasedRenderPass;
-    private webGlInitialized;
-    private setupWebGlPipeline;
+    private get webGlInitialized();
     constructor(container: HTMLElement, options?: RenderingViewOptions);
-    addCluster(cluster: Cluster): void;
-    /**
-     * This finds the most relevant occlusion clusters to query.
-     * Optimizing this is a balance between minimizing the number of queries
-     * and reducing pop in.
-     */
-    private updateRenderedOcclusionClusters;
+    private setupWebGlPipeline;
     private fixStatsStyle;
     setEnableOutlines(enabled: boolean): void;
     registerWebGpuPresentationExtension(extension: WebGpuPresentationExtension): () => void;
@@ -339,7 +294,17 @@ export declare class RenderingView {
     setDirectionalShadowUpdateOptions(options: DirectionalShadowUpdateOptions): void;
     invalidateDirectionalShadows(): void;
     setDirectionalShadowOptions(options: DirectionalShadowOptions): void;
+    setSSROptions(options: SSROptions): void;
     setGTAOOptions(options: GTAOOptions): void;
+    private sdfgiRuntimeOptions;
+    private sceneSDFGISettings;
+    /** Runtime/player quality overrides, combined with the scene's authored lighting. */
+    setSDFGIOptions(options: SDFGIOptions): void;
+    /** Null restores project defaults when a scene's World Environment is removed. */
+    setSceneSDFGISettings(settings: SceneSDFGISettings | null): void;
+    private syncSDFGISettings;
+    invalidateSDFGI(): void;
+    getSDFGIStats(): Readonly<SDFGIStats> | null;
     configureAmbientOcclusion(enabled: boolean, blendIntensity?: number, options?: Record<string, unknown>): void;
     invalidateShadows(): void;
     initTexture(texture: Texture): void;
@@ -363,12 +328,6 @@ export declare class RenderingView {
         object: Object3D;
         instanceIndex: number;
     }[]): void;
-    private static createDepthRenderTarget;
-    /**  */
-    private static createAOMaskDepthRenderTarget;
-    private createSceneColorRenderTarget;
-    private createSceneDepthRenderTarget;
-    private createGRenderTarget;
     private setupEventListeners;
     stop(dispose?: boolean): void;
     /** Stops frame scheduling without releasing the renderer, GPU device, or presentation surface. */
@@ -405,53 +364,7 @@ export declare class RenderingView {
     private requireInitializedBackend;
     private activateExperimentalStaticDrawSets;
     private disposeExperimentalStaticDrawSets;
-    private applyEnvMap;
     setWorldEnvironment(environment: WorldEnvironmentState | null): void;
-    private applyWorldEnvironmentToWebGl;
-    private hideOccluded;
-    private setupCsm;
-    private gbufferMaterialCache;
-    private gbufferDepthPrepassMaterialCache;
-    private tbufferMaterialCache;
-    private depthPrepassMaterialCache;
-    private depthPrepassCachedMaterials;
-    private depthPrepassCachedVisibility;
-    /**
-     * If the material such as a standard material has updated properties, then we need to update
-     * the corresponding g buffer material
-     * @param source
-     * @param target
-     */
-    private updateMaterialProperties;
-    /**
-     * Updates uniform values from source material to target material.
-     * Optimized for hot path execution in rendering loop.
-     */
-    private updateUniformValues;
-    /**
-     * Creates target-local uniform wrapper objects for any source uniforms that the
-     * derived material does not already declare. We keep the underlying value
-     * references instead of deep-cloning them so render-target textures and other
-     * runtime-owned resources are not duplicated or warned about.
-     */
-    private inheritCustomUniformBindings;
-    private updateMaterialCommonProperties;
-    /**
-     * After rendering the opaque scene, we will also calculate lights which updates uniforms.
-     * These need to be present on the gbuffer materials so we need to copy them afterward.
-     */
-    private updateLightUniformValues;
-    private createGBufferMaterial;
-    private isDepthPrepassEnabled;
-    private usesSceneFeedbackUniforms;
-    private usesShaderUniform;
-    private isDepthPrepassEligibleMaterial;
-    private isDepthPrepassEligibleMesh;
-    private createDepthPrepassMaterial;
-    private applyDepthPrepassMaterials;
-    private unapplyDepthPrepassMaterials;
-    private renderDepthPrepass;
-    private updateCsm;
     /**
      * three.js CSM splits are normalized against CSM.maxFar. The shared WGSL
      * material graph measures linear depth against the camera clip range, so
@@ -459,23 +372,6 @@ export declare class RenderingView {
      */
     private syncExperimentalWebGpuCascades;
     loop(onFrame: (deltaTime: number) => any, showStats?: boolean, onInputFrame?: (inactive: boolean) => void): void;
-    private frameGBufferMeshes;
-    private frameGBufferPhaseMasks;
-    private frameUnsupportedGBufferObjects;
-    private frameGBufferExcludedObjects;
-    private appliedGBufferMeshes;
-    private originalGBufferMaterials;
-    private originalGBufferOnBeforeRender;
-    private hiddenGBufferObjects;
-    private gBufferPhaseMaskCache;
-    private gBufferMaterialArrayCache;
-    private gBufferShadowUpdaterCache;
-    private collectGBufferRenderables;
-    private getGBufferPhaseMask;
-    private getGBufferMaterialArray;
-    private applyGBufferMaterials;
-    private unapplyGBufferMaterials;
-    private applyGBufferShadowUniformUpdater;
     initTextures(scene?: THREE.Scene): void;
     /**
      * Initializes scene textures without monopolizing the host event loop.
@@ -500,57 +396,9 @@ export declare class RenderingView {
     private releaseExperimentalWebGpuBackend;
     private applyExperimentalWebGpuViewState;
     private syncWebGpuOutlineState;
-    private depthMaterialCachedMaterials;
-    private applyDepthMaterial;
-    private unapplyDepthMaterial;
-    private renderScene;
     getEnvTexture(texture: Texture): Texture;
     private applyPostProcessSettings;
-    private updatePostProcessEffectUniforms;
-    private insetHeight;
-    private insetWidth;
-    private insetOffsetY;
-    private insetMargin;
-    private maxInsetCameras;
-    private overlayCameras;
-    private renderOverlay;
-    addOverlayCamera(camera: Camera): void;
-    clearOverlayCameras(): void;
-    removeOverlayCamera(camera: Camera): void;
-    private prevClearColor;
-    private hadBloom;
     render(deltaTime?: number): void;
-    private bloomStoredMaterials;
-    private bloomHidden;
-    private hasBloom;
-    private usesSceneColorUniform;
-    private initSceneColorUniform;
-    private initDepthUniform;
-    private initNormalUniform;
-    private initShadowUniform;
-    private initLightVolumeUniform;
-    private initResolutionUniform;
-    private initAoUniform;
-    private initCustomDepthMaterial;
-    private _customDepthMaterialCache;
 }
 export declare function setRenderingPaused(value: boolean): void;
-/**
- * Checks if a given 3D object is within the camera's frustum.
- *
- * @param object - The 3D object to check.
- * @param camera - The camera to check against.
- * @returns `true` if the object is in the camera's frustum, `false` otherwise.
- */
-export declare function isObjectInFrustum(object: THREE.Object3D, frustum: THREE.Frustum): boolean;
-export declare class FogNode extends RgbaNode {
-    private readonly source;
-    private readonly fogColor;
-    constructor(source: RgbaNode, fogColor?: IRgbNode);
-    compile(c: any): {
-        pars: string;
-        chunk: string;
-        out: string;
-    };
-}
 //# sourceMappingURL=rendering.d.ts.map