@hology/webgpu-renderer 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as three from 'three';
-import { Color, Vector2, Vector3, Vector4, Matrix3, Matrix4, Material, Texture, MaterialParameters, Object3D, PerspectiveCamera, OrthographicCamera, Scene, DirectionalLight } from 'three';
+import { Color, Vector2, Vector3, Vector4, Matrix3, Matrix4, Material, Texture, MaterialParameters, DirectionalLight, Object3D, PerspectiveCamera, OrthographicCamera, Scene } from 'three';
 export { AmbientLight, BackSide, BatchedMesh, Bone, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, Color, CompressedArrayTexture, CompressedCubeTexture, CompressedTexture, CompressedArrayTexture as CompressedTextureArray, CubeTexture, Data3DTexture, DataArrayTexture, DataTexture, DepthTexture, DirectionalLight, DoubleSide, FrontSide, Group, HemisphereLight, InstancedMesh, MathUtils, Matrix4, Mesh, Object3D, OrthographicCamera, PerspectiveCamera, PlaneGeometry, PointLight, RepeatWrapping, Scene, Skeleton, SkinnedMesh, SphereGeometry, SpotLight, Texture, Vector2, Vector3, Vector4 } from 'three';
 
 interface ComputeKernelDescriptor {
@@ -177,6 +177,97 @@ declare class RenderGraph {
     private resolveExecutionOrder;
 }
 
+interface TextureResource {
+    version: number;
+    width: number;
+    height: number;
+    depthOrArrayLayers: number;
+    format: GPUTextureFormat;
+    textureDimension: GPUTextureDimension;
+    viewDimension: GPUTextureViewDimension;
+    sampleType: GPUTextureSampleType;
+    samplerBindingType: GPUSamplerBindingType;
+    mipLevelCount: number;
+    texture: GPUTexture;
+    view: GPUTextureView;
+    sampler: GPUSampler;
+}
+interface ExtractedLightState {
+    ambient: Vector4;
+    hemisphere: ExtractedHemisphereLight | null;
+    directionals: ExtractedDirectionalLight[];
+    points: ExtractedPointLight[];
+    spots: ExtractedSpotLight[];
+    directional: ExtractedDirectionalLight | null;
+    point: ExtractedPointLight | null;
+    spot: ExtractedSpotLight | null;
+}
+interface ExtractedHemisphereLight {
+    direction: Vector3;
+    skyColor: Vector3;
+    groundColor: Vector3;
+    intensity: number;
+}
+interface ExtractedDirectionalLight {
+    sourceLight: DirectionalLight | null;
+    position: Vector3;
+    target: Vector3;
+    direction: Vector3;
+    color: Vector3;
+    intensity: number;
+    volumetricIntensity: number;
+    castShadow: boolean;
+    shadowBias: number;
+    shadowNormalBias: number;
+    shadowRadius: number;
+    shadowIntensity: number;
+    shadowMapSize: number;
+    shadowCameraLeft: number;
+    shadowCameraRight: number;
+    shadowCameraTop: number;
+    shadowCameraBottom: number;
+    shadowCameraNear: number;
+    shadowCameraFar: number;
+}
+interface ExtractedPointLight {
+    position: Vector3;
+    color: Vector3;
+    intensity: number;
+    volumetricIntensity: number;
+    range: number;
+    decay: number;
+    castShadow: boolean;
+    shadowBias: number;
+    shadowNormalBias: number;
+    shadowRadius: number;
+    shadowIntensity: number;
+    shadowMapSize: number;
+    shadowCameraNear: number;
+    shadowCameraFar: number;
+}
+interface ExtractedSpotLight {
+    position: Vector3;
+    direction: Vector3;
+    color: Vector3;
+    intensity: number;
+    volumetricIntensity: number;
+    range: number;
+    angle: number;
+    penumbra: number;
+    decay: number;
+    castShadow: boolean;
+    shadowBias: number;
+    shadowNormalBias: number;
+    shadowRadius: number;
+    shadowIntensity: number;
+    shadowMapSize: number;
+    shadowCameraNear: number;
+    shadowCameraFar: number;
+    shadowCameraFov: number;
+}
+
+/** Camera-visible lights collected during the renderer's scene extraction. */
+type RendererExtractedLightState = ExtractedLightState;
 /**
  * Resolves a scene-authored Three material to a renderer-native WGSL material
  * without mutating the scene's material slots. Return `undefined` to use the
@@ -231,6 +322,11 @@ interface RendererGraphBuilderContext {
      * extraction. Passing this list to volumetric fog avoids another scene walk.
      */
     readonly fogVolumeObjects: readonly Object3D[];
+    /**
+     * Camera-visible lights collected during ordinary scene extraction. The
+     * ordering matches the renderer's shadow-array layers.
+     */
+    readonly extractedLights: RendererExtractedLightState;
     addDirectionalShadowPass(): void;
     addPointShadowPass(): void;
     addSpotShadowPass(): void;
@@ -512,6 +608,11 @@ interface VolumetricFogInputs {
      * list is authoritative and avoids traversing the scene for volumes.
      */
     readonly volumeObjects?: readonly Object3D[];
+    /**
+     * Lights already collected by the renderer. When supplied, this list is
+     * authoritative and avoids traversing the scene for lights.
+     */
+    readonly lights?: RendererExtractedLightState;
 }
 /**
  * Compute-driven froxel fog. Add it after opaque rendering and before the late
@@ -533,6 +634,7 @@ declare class VolumetricFogEffect {
     private readonly viewProjectionInverse;
     private explicitVolumes;
     private volumeObjects;
+    private extractedLights;
     private cascadeDirectionalLights;
     private compositePass;
     private readonly blurPassCache;
@@ -550,8 +652,11 @@ declare class VolumetricFogEffect {
     private writeVolume;
     private lightColor;
     private writeDirectional;
+    private writeExtractedDirectional;
     private writePoint;
+    private writeExtractedPoint;
     private writeSpot;
+    private writeExtractedSpot;
     private getResources;
 }
 /** WGSL appended to a material that calls rendererApplyVolumetricFog(). */
@@ -559,22 +664,6 @@ declare const VOLUMETRIC_FOG_MATERIAL_WGSL = "\nfn rendererSampleIntegratedFog(u
 /** Adds the froxel input; append VOLUMETRIC_FOG_MATERIAL_WGSL and call its helper in fsMain. */
 declare function configureVolumetricFogMaterial(material: WGSLShaderMaterial, resource?: string, boundsResource?: string): WGSLShaderMaterial;
 
-interface TextureResource {
-    version: number;
-    width: number;
-    height: number;
-    depthOrArrayLayers: number;
-    format: GPUTextureFormat;
-    textureDimension: GPUTextureDimension;
-    viewDimension: GPUTextureViewDimension;
-    sampleType: GPUTextureSampleType;
-    samplerBindingType: GPUSamplerBindingType;
-    mipLevelCount: number;
-    texture: GPUTexture;
-    view: GPUTextureView;
-    sampler: GPUSampler;
-}
-
 interface WebGpuPMREMGeneratorContext {
     device: GPUDevice;
     getTextureResource(texture: Texture): TextureResource;
@@ -719,6 +808,7 @@ declare class WebGpuRenderer {
     private readonly colorFormatsValueCache;
     private nextColorFormatsId;
     private readonly renderBundleScratch;
+    private readonly indirectMaterialResourcesScratch;
     private readonly directBundleDrawStatsScratch;
     private readonly sortedOpaqueBatchesScratch;
     private readonly opaqueBatchPool;
@@ -908,6 +998,7 @@ declare class WebGpuRenderer {
     private getIndirectStreamKey;
     private getOrCreateStaticIndirectSubmissionStreams;
     private getOrCreateIndirectForwardBundle;
+    private submitIndirectStreamDirect;
     private setRetainedIndirectBundleState;
     private getIndirectBundleHash;
     private getColorFormatsId;