@driftengine/core 4.8.4 → 4.8.6

package/dist/render/backend/webgpu/renderer.d.ts

@@ -8,6 +8,8 @@ import type { RendererApi } from '../api.ts';
 import { GpuTimestamps } from './gpuTimestamps.ts';
 import type { Environment, FilmOptions, InsetRect, LightVolumeDrawOptions, SkyColors, TranslucentMeshOptions } from '../webgl2/renderer.ts';
 import type { IncrementalMeshHandle, MeshOptions } from '../api.ts';
+import type { LightmapPage } from '../../lightmap.ts';
+import { type BloomResponse } from '../../bloomChain.ts';
 import type { WaterBody } from '../../waterRenderer.ts';
 import type { WindStreakOptions } from '../../windStreakRenderer.ts';
 import type { WindField } from '../../windField.ts';
@@ -33,7 +35,7 @@ import type { CausticSheet } from '../../causticsRenderer.ts';
 import { type GpuCaustics } from './causticsPass.ts';
 import type { BoltSegments } from '../../boltPool.ts';
 import type { LineSegments } from '../../linePoints.ts';
-import type { ParticleBatchOptions } from '../../particleBatch.ts';
+import { type ParticleBatchOptions } from '../../particleBatch.ts';
 import type { ParticleInstances } from '../../particlePool.ts';
 import type { PlumeOptions, PlumePlacement } from '../../plumeRenderer.ts';
 import type { InstanceData } from '../../instancedMesh.ts';
@@ -518,6 +520,17 @@ export declare class WebGPURenderer implements RendererApi {
     /** Whether this frame has spread its skin: once, at its first blended draw or before its end. */
     private skinScattered;
     private readonly skinInverseProjection;
+    /** Scratch for a sprite's depth conversion, so a particle draw allocates nothing. */
+    private readonly spriteInverseProjection;
+    /** Said once: a sprite asked for a soft edge where no depth copy could be had. */
+    private warnedSpriteDepth;
+    /** Said once: more rectangles than the fixed arm shades, and no froxel table for the rest. */
+    private warnedAreaOverflow;
+    /** What a sprite's depth binding holds where no copy was taken. See `spriteDepthStandIn`. */
+    private spriteDepthEmpty;
+    /** The samplers every sprite batch binds: its image filtered, the depth copy texel for texel. */
+    private spriteLinearSampler;
+    private spriteNearestSampler;
     private sceneColorView;
     /** The multisampled twin, when the profile asks for samples. Resolved into `sceneColor`. */
     private sceneColorMsaa;
@@ -1171,6 +1184,8 @@ export declare class WebGPURenderer implements RendererApi {
     get compressedFormats(): readonly CompressedTextureFormat[];
     /** Several images of one size as an array's layers. See `RendererApi.createSurfaceTextureArray`. */
     createSurfaceTextureArray(sources: readonly SurfaceSource[], options?: SurfaceTextureOptions): GpuSurfaceTexture;
+    /** A baked lightmap page, as a `lightmapModel` material's `modelMap`. See `RendererApi`. */
+    createLightmap(page: LightmapPage): GpuSurfaceTexture;
     /**
      * GPU textures an `updateSurfaceTexture` replaced, destroyed when the next frame begins.
      *
@@ -1278,6 +1293,11 @@ export declare class WebGPURenderer implements RendererApi {
      * it is on the public surface and removing it would break four repositories to save a method.
      */
     setEnvironmentAmbient(_amount: number): void;
+    /**
+     * The ambient the following draws take, nine spherical-harmonic coefficients or null for the
+     * frame's. See `Renderer.setAmbientSH`: material state, so the next draw takes a slot of its own.
+     */
+    setAmbientSH(coefficients: ArrayLike<number> | null): void;
     /** How reflective the surfaces drawn next are. Clamped, as `renderer.ts` clamps it. */
     setSurfaceReflectivity(amount: number): void;
     /** How bright the environment the surfaces drawn next reflect is. See `renderer.ts`. */
@@ -1428,6 +1448,20 @@ export declare class WebGPURenderer implements RendererApi {
     private gradeCode;
     private gradeExposure;
     drawParticles(batch: GpuParticles, data: ParticleInstances, camera: Camera, env: Environment, timeSeconds: number): void;
+    /**
+     * A sprite's flipbook and fades into its fragment block `f`, and the bind group holding the
+     * frame's depth copy its soft edge reads — built again only when that copy is replaced.
+     *
+     * **The copy is the volume's**: `takeVolumeDepth` ends the frame's pass, resolves the opaque
+     * depth and reopens, once a frame whoever asks. Only in the frame's own picture: in a mirror or
+     * a probe's face it would be another view's depth, and the edge stays hard there, as on WebGL2.
+     * Without a composite there is no copy, and the renderer says so once.
+     */
+    private spriteFades;
+    /** A sprite's image sampler, repeating nothing and filtered, or its depth's, nearest. */
+    private spriteSampler;
+    /** A one-texel `r32float` for a sprite's depth binding where no copy was taken. */
+    private spriteDepthStandIn;
     /**
      * The bind group layout for one particle material, built on first use.
      *
@@ -2159,7 +2193,7 @@ export declare class WebGPURenderer implements RendererApi {
      * drawn. It also handed the caller a different object from the one the upload was filling.
      */
     private keyed;
-    createMesh(data: MeshData, options?: MeshOptions): GpuMesh;
+    createMesh(given: MeshData, options?: MeshOptions): GpuMesh;
     /**
      * Geometry in, handle out — but the geometry lands over as many frames as the caller gives it.
      *
@@ -2169,7 +2203,7 @@ export declare class WebGPURenderer implements RendererApi {
      * straddle one, and going on writing to a dead device would raise validation errors a consumer
      * can do nothing about. Done with `complete` still false is the signal that it was abandoned.
      */
-    createMeshIncremental(data: MeshData, options?: MeshOptions): IncrementalMeshHandle;
+    createMeshIncremental(given: MeshData, options?: MeshOptions): IncrementalMeshHandle;
     /**
      * Rewrite a mesh's positions, and its normals where the caller has them.
      *
@@ -2943,9 +2977,10 @@ export declare class WebGPURenderer implements RendererApi {
      */
     private skinSplits;
     /**
-     * A skin draw's diffuse half, kept for the spread: the frame's draw again, with the same slots,
-     * buffers and bind group, through the pipeline that writes the diffuse alone into the blur's
-     * target and tests for the depth its frame half wrote.
+     * A skin draw's diffuse and colour halves, kept for the spread: the frame's draw again, twice,
+     * with the same slots, buffers and bind group, through the pipelines that write the diffuse's
+     * light alone and its colour alone into the blur's targets and test for the depth its frame half
+     * wrote.
      */
     private keepSkinDiffuse;
     /**
@@ -3516,6 +3551,14 @@ export declare class WebGPURenderer implements RendererApi {
     /** This frame's exposure into the tone curve. Starts at the profile's own. */
     private exposure;
     private bloomScale;
+    /** The draw's own ambient, as `packAmbientSH` writes it; zeros are the frame's. */
+    private readonly ambientSH;
+    /** The ramp and each level's tint, as `resolveBloomResponse` writes them; the subtraction and white. */
+    private readonly bloomResponse;
+    /** The response before the last `setBloom`, to tell whether the blocks need writing again. */
+    private readonly bloomResponseNext;
+    /** Each level's tint as a blend constant, rewritten in place: `setBlendConstant` takes a colour. */
+    private readonly bloomConstants;
     /** In scene units, once `setBloom` has moved it; null reads the profile's. */
     private bloomThresholdSet;
     private rushStrength;
@@ -3579,7 +3622,7 @@ export declare class WebGPURenderer implements RendererApi {
      * a 3D write needs both and a wrong one silently shears the cube.
      */
     private uploadGrade;
-    setBloom(scale: number, threshold?: number): void;
+    setBloom(scale: number, threshold?: number, response?: BloomResponse | null): void;
     /**
      * How thick the air is, this frame: a global participating medium filling the whole frustum.
      *
@@ -3883,6 +3926,14 @@ export declare class WebGPURenderer implements RendererApi {
         readonly height: number;
         readonly data: Float32Array;
     }, options?: ProbeBakeOptions): boolean;
+    /** One layer of the declared grid from an image. See `Renderer.setProbeLayerImage`. */
+    setProbeLayerImage(layer: number, image: {
+        readonly width: number;
+        readonly height: number;
+        readonly data: Float32Array;
+    }, options?: ProbeBakeOptions): boolean;
+    /** An equirectangular image onto the capture cube's six faces, in the cube's own format. */
+    private uploadProbeFaces;
     /**
      * Upload the photometric profiles a consumer loaded, and rebuild the bind group that holds them.
      *