@hology/webgpu-renderer 0.1.13 → 0.1.15

package/dist/index.d.ts

@@ -302,6 +302,27 @@ interface RendererOptions {
     renderGraphProfiling?: boolean;
     /** Internal scene resolution relative to the presentation resolution. Defaults to 1. */
     renderScale?: number;
+    /**
+     * Experimental native bridge invoked after the scene command buffer is
+     * submitted. The callback may enqueue native work and a final presentation
+     * command buffer using the retained surface view.
+     */
+    nativePostSubmit?: (context: {
+        readonly device: GPUDevice;
+        readonly presentationView: GPUTextureView;
+        readonly presentationWidth: number;
+        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. */
@@ -873,6 +894,9 @@ declare class WebGpuRenderer {
     private readonly defaultInstanceAttributeBuffers;
     private readonly textureManager;
     private readonly renderGraph;
+    private readonly nativePostSubmit;
+    private readonly presentationOverlay;
+    private readonly presentationOverlayContext;
     private readonly directionalShadowCameras;
     private readonly pointShadowCameras;
     private readonly spotShadowCameras;
@@ -981,7 +1005,7 @@ declare class WebGpuRenderer {
     private resolveLineBasicMaterial;
     private resolveSkinnedMaterial;
     private hasRenderCallbacks;
-    initialize(): Promise<void>;
+    initialize(providedAdapter?: GPUAdapter): Promise<void>;
     createComputeKernel(descriptor: ComputeKernelDescriptor): ComputeKernel;
     getDevice(): GPUDevice | null;
     setRenderGraphBuilder(builder: RendererGraphBuilder): void;
@@ -1058,6 +1082,7 @@ declare class WebGpuRenderer {
     createStaticDrawSet(root: Object3D, options?: StaticDrawSetOptions): StaticDrawSet;
     private disposeStaticDrawSetResource;
     private renderFrame;
+    private recordPresentationOverlay;
     destroy(): void;
     private createStaticPipelines;
     private recreateShadowResources;