@meimu/mutracer 0.2.0 → 0.3.1

package/lib/renderer/WGPURayTracePass.d.ts

@@ -1,3 +1,4 @@
+import { type SurfaceHit } from './surfaceHit.js';
 import { WGPUAov } from './WGPUAov.js';
 import { type AovKind } from './aov.js';
 import { type MaterialTextureSelection } from './wgpuBindless.js';
@@ -39,6 +40,16 @@ declare class WGPURayTracePass {
     private _width;
     private _height;
     private _meshes;
+    private _causticKey;
+    private _photonMapping;
+    private _photonMap?;
+    private _causticLight?;
+    private _causticSettings?;
+    private _causticPerspective;
+    private _causticCameraScale;
+    private _causticBounds;
+    private _transport?;
+    private _lightTracing;
     private _sceneEnvironment;
     private _rectLightTextures;
     private _analyticLights;
@@ -111,22 +122,25 @@ declare class WGPURayTracePass {
     private _skyBaker?;
     private _backgroundImageSource;
     private _backgroundTex?;
-    private _rayTracePipelineLayout?;
     private _rayTraceBindGroups?;
+    private _photonEmissionGroups?;
     private _blasLayoutMask;
-    private _compiledBlasLayoutMask;
-    private _compiledAnisotropyDirections;
-    private _compiledCoatNormals;
-    private _compiledHasAlpha;
-    private _compiledSceneHasAlpha;
     private _alphaBlendStrategy;
     private _constants;
     private _retainedShaderCapabilities?;
     private _retainedShaderStructure?;
     private _shaderCapabilities;
-    private _prevPipelineConstants;
-    private _prevDefinesCode;
-    private _prevPipelineInputs?;
+    private _targetTransport;
+    private _traceVariants;
+    private _queuedCompiles;
+    private _activeCompiles;
+    private _traceModules;
+    private _requestedVariant?;
+    private _activeVariant?;
+    private _activeInputs?;
+    private _awaitingRetirement?;
+    private _resourceError;
+    private _aovPipelinesFailed;
     private _hasTransmission;
     private _hasShadowCatcher;
     private _hasDisplacement;
@@ -136,28 +150,29 @@ declare class WGPURayTracePass {
     private _clamping?;
     private _transmissiveAlphaMin;
     private _viewProjInv;
+    private _projectionInv;
     private _cameraWorld;
     private _apertureRadius;
     private _focusDistance;
     private _needsUpdateBindGroups;
-    private _computeShaderModule?;
+    private _needsPhotonTargetBindGroups;
+    private _needsUpdateOutputBindGroup;
     private _aovPipelines;
     private _depthCompute?;
     private _depthTracePipeline?;
     private _depthPipeline?;
     private _shaderCache;
-    private _debugBVHBuffer?;
-    private _isCompilingShader;
-    private _shaderCompilationDiagnostics?;
-    private _pipelineError;
+    private _bvhCPU?;
+    private _bvhDataBytes;
     private _bakePipelineConstants;
-    private _failedPipelineSignature?;
     constructor(device: GPUDevice, _textureSelection?: MaterialTextureSelection);
     getOutputBuffer(): {
-        color: GPUBuffer;
         normal: GPUBuffer;
         albedo: GPUBuffer;
         shadowCatcher: GPUBuffer;
+        caustic?: GPUBuffer | undefined;
+        wideHdr?: boolean | undefined;
+        color: GPUBuffer;
     };
     private _ensureAdaptiveSamplingTexture;
     /**
@@ -169,16 +184,38 @@ declare class WGPURayTracePass {
     private _createPipelineLayout;
     private _updateGPUBuffer;
     private _uniformBuffer;
-    updatePipeline(): Promise<void>;
+    private _preparePhotonTarget;
+    /**
+     * Prepares the pipeline for the settings currently written to this pass.
+     * Everything except compilation runs synchronously, and compilation only
+     * writes to its own variant. Renders with different settings can therefore
+     * interleave without invalidating each other. Returns a promise while the
+     * requested state waits on the GPU; undefined means nothing is outstanding.
+     */
+    updatePipeline(): Promise<void> | undefined;
+    /** Runs only for a ready variant, without yielding, so tracing can start in this call. */
+    private _installTraceVariant;
+    /** Snapshots everything compilation needs. The task must not read mutable pass state afterwards. */
+    private _startTraceVariant;
+    /** Runs the most recently requested variants first: a dragged slider's last value is the one in use. */
+    private _pumpCompiles;
+    private _requestQueuedCompile;
     private _prepareAovPipelines;
-    prepareAovs(kinds: readonly AovKind[]): boolean;
-    renderAovs(state: WGPUAov, camera: Camera, samples: number, cap: number, kinds: readonly AovKind[]): boolean;
-    readDepthSamples(area: DepthSampleArea, aspect?: number): Promise<Float32Array | undefined>;
+    prepareAovs(kinds: readonly AovKind[], compact?: boolean): boolean;
+    renderAovs(state: WGPUAov, camera: Camera, samples: number, cap: number, kinds: readonly AovKind[], resolution?: {
+        width: number;
+        height: number;
+    }): boolean;
+    pickSurface(x: number, y: number, aspect?: number): Promise<SurfaceHit | null | undefined>;
+    readDepthSamples(area: DepthSampleArea, aspect?: number): Promise<Float32Array<ArrayBufferLike> | undefined>;
+    private _readDepthSamples;
+    /** Whether the latest request waits on GPU work that will settle on its own. */
     isCompilingShader(): boolean;
     isPipelineReady(): boolean;
+    /** Failure of the latest request. A failed variant does not affect other renders. */
     getPipelineError(): unknown;
     private _updateBindGroups;
-    createPass(encoder: GPUCommandEncoder, clear: boolean, tiles: [number, number], timing?: WGPURayTraceTimingCapture): void;
+    createPass(encoder: GPUCommandEncoder, clear: boolean, tiles: [number, number], timing?: WGPURayTraceTimingCapture): number;
     getDebugBVHData(): Promise<{
         buffer: ArrayBuffer;
     }>;
@@ -237,12 +274,15 @@ declare class WGPURayTracePass {
         height: number;
         data: Float32Array;
     }): void;
+    private _shareSpectralPrefix;
     setQuality(options: {
         bounces: number;
         bevel: boolean;
         dispersionWavelengths: 1 | 3;
         directLightCandidates: number;
+        caustics?: import('../Render.js').CausticSettings;
     }): void;
+    private _setCaustics;
     private _setEnvMap;
     setMeshes(meshes: Mesh[], update?: {
         transforms?: readonly Mesh[];
@@ -256,8 +296,12 @@ declare class WGPURayTracePass {
     private _updateLightSamplingData;
     /** Uploads the combined TLAS/BLAS buffer and the instance records. */
     private _uploadBVH;
+    private _uploadBVHBlocks;
+    private _writeBVH;
     private _updateMeshData;
     private _updateMaterialConstants;
+    private _packTriangleMaterials;
+    private _refreshTriangleMaterials;
     private _updateGeometryData;
     private _updateMaterialData;
     /** Rebuilds only instance acceleration data for a cached mesh subset. */