@hology/webgpu-renderer 0.1.14 → 0.1.16

package/dist/index.d.ts

@@ -292,6 +292,8 @@ interface RendererOptions {
     pointShadowMapSize?: number;
     sampleCount?: number;
     hiZOcclusionCulling?: boolean;
+    /** 16x16 GPU point-light masks for opaque graph materials. Defaults to true. */
+    tiledLighting?: boolean;
     /**
      * Uses Chromium's experimental multi-draw-indirect command for GPU-culled
      * static draw sets when the adapter supports it. Defaults to true.
@@ -314,6 +316,15 @@ interface RendererOptions {
         readonly presentationHeight: number;
         present(sourceView: GPUTextureView): void;
     }) => void;
+    /** Records UI/debug overlays onto the native-resolution surface after all upscaling. */
+    presentationOverlay?: (context: {
+        readonly device: GPUDevice;
+        readonly encoder: GPUCommandEncoder;
+        readonly targetView: GPUTextureView;
+        readonly targetFormat: GPUTextureFormat;
+        readonly presentationWidth: number;
+        readonly presentationHeight: number;
+    }) => void;
     /** Material used when a mesh does not already use WGSLShaderMaterial. */
     fallbackMaterial?: WGSLShaderMaterial;
     /** Optional bridge for graph/material systems layered on top of Three. */
@@ -820,6 +831,8 @@ declare class WebGpuRenderer {
     private multiDrawIndirectEnabled;
     private dynamicBatchingEnabled;
     private multiDrawIndirectSupported;
+    private tiledPointLights;
+    private tiledLightingEnabled;
     private renderGraphProfilingEnabled;
     private indirectFirstInstanceSupported;
     private timestampQuerySupported;
@@ -886,6 +899,8 @@ declare class WebGpuRenderer {
     private readonly textureManager;
     private readonly renderGraph;
     private readonly nativePostSubmit;
+    private readonly presentationOverlay;
+    private readonly presentationOverlayContext;
     private readonly directionalShadowCameras;
     private readonly pointShadowCameras;
     private readonly spotShadowCameras;
@@ -1044,6 +1059,8 @@ declare class WebGpuRenderer {
     getHiZOcclusionCullingActive(): boolean;
     setMultiDrawIndirectEnabled(enabled: boolean): void;
     getMultiDrawIndirectEnabled(): boolean;
+    /** Toggle without recompiling materials, for scene-specific GPU comparisons. */
+    setTiledLightingEnabled(enabled: boolean): void;
     setDynamicBatchingEnabled(enabled: boolean): void;
     getDynamicBatchingEnabled(): boolean;
     getMultiDrawIndirectSupported(): boolean;
@@ -1071,6 +1088,7 @@ declare class WebGpuRenderer {
     createStaticDrawSet(root: Object3D, options?: StaticDrawSetOptions): StaticDrawSet;
     private disposeStaticDrawSetResource;
     private renderFrame;
+    private recordPresentationOverlay;
     destroy(): void;
     private createStaticPipelines;
     private recreateShadowResources;
@@ -1258,6 +1276,7 @@ declare class WebGpuRenderer {
     private getDepthPassMaterialResourceAsync;
     private getMaterialResource;
     private getMaterialResourceAsync;
+    private ensureTiledLightingSize;
     private updateCameraUniforms;
     private updateTemporalVisibilityUniforms;
     private commitTemporalHiZHistory;