@aura3d/rendering 1.4.4 → 1.5.0

package/dist/ForwardPass.d.ts

@@ -39,7 +39,33 @@ export type RenderMaterial = Material | MaterialInstance;
 export interface SkinningPaletteBinding {
     readonly jointCount: number;
     readonly matrices: Float32Array;
+    /**
+     * Second influence set for eight-influence skinning. Only meaningful when the
+     * geometry carries `joints1`/`weights1` attributes and the material uses an
+     * eight-influence shader.
+     */
+    readonly extraInfluences?: boolean;
 }
+/** Which GPU path carried the joint palette for a submission. */
+export type SkinningPalettePath = "uniform-array" | "data-texture";
+export interface SkinningPaletteDiagnostics {
+    readonly submissions: number;
+    readonly jointsUploaded: number;
+    readonly maxJointCount: number;
+    readonly uniformArraySubmissions: number;
+    readonly dataTextureSubmissions: number;
+    readonly eightInfluenceSubmissions: number;
+    readonly maxUniformJoints: number;
+}
+/** Joints addressable through the uniform-array palette. Re-exported for shaders. */
+export declare const MAX_UNIFORM_SKINNING_JOINTS = 96;
+/**
+ * Upper bound on joints per skin, using the data-texture palette path.
+ *
+ * Chosen to stay well inside a 1024-wide RGBA32F texture (1024 joints = 4096 texels =
+ * a 1024x4 texture) while covering rigs far beyond anything the uniform path allows.
+ */
+export declare const MAX_SKINNING_JOINTS = 1024;
 export declare const MAX_GPU_MORPH_VERTICES = 64;
 export declare const MAX_GPU_MORPH_TARGETS = 4;
 export declare const MAX_GPU_INSTANCES = 64;
@@ -51,6 +77,8 @@ export interface ForwardPassOptions {
     readonly inputColorResource?: string;
     readonly shadowMap?: ForwardShadowMapOptions;
     readonly cameraPosition?: readonly [number, number, number];
+    readonly cameraViewMatrix?: Float32Array | readonly number[];
+    readonly cameraViewProjectionMatrix?: Float32Array | readonly number[];
     readonly outputColorSpace?: "linear" | "srgb";
     readonly shaderLibrary?: ShaderLibrary;
 }
@@ -95,6 +123,13 @@ export interface ForwardShadowMapOptions {
     readonly texelSize?: readonly [number, number];
     readonly filterKernel?: ShadowFilterKernel;
     readonly pointLight?: ForwardPointShadowMapOptions;
+    readonly cascades?: readonly ForwardShadowCascadeOptions[];
+}
+export interface ForwardShadowCascadeOptions {
+    readonly index: number;
+    readonly near: number;
+    readonly far: number;
+    readonly shadowMap: Omit<ForwardShadowMapOptions, "cascades">;
 }
 export interface ForwardPointShadowMapOptions {
     readonly texture: TextureBinding;
@@ -114,10 +149,12 @@ export declare class ForwardPass extends BaseRenderPass {
     private readonly materialBinding;
     private readonly shaderLibrary;
     private readonly skinningPaletteUploads;
+    private clusteredLighting;
     constructor(options: ForwardPassOptions);
     execute(context: RenderPassContext): void;
     private drawItem;
     private applyLightUniforms;
     private getShader;
 }
+export declare function selectForwardShadowMap(shadowMap: ForwardShadowMapOptions | undefined, item: RenderItem, cameraViewMatrix?: Float32Array | readonly number[], cameraPosition?: readonly [number, number, number]): ForwardShadowMapOptions | undefined;
 //# sourceMappingURL=ForwardPass.d.ts.map

package/dist/ForwardPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForwardPass.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ForwardPass.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ForwardPass.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ForwardPass.ts"],"names":[],"mappings":"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"}

package/dist/ForwardPass.js

@@ -8,12 +8,26 @@ import { applyMorphTargets } from "./MorphTarget.js";
 import { RenderDeviceError } from "./RenderDevice.js";
 import { RenderPipeline } from "./RenderPipeline.js";
 import { BaseRenderPass } from "./RenderPass.js";
+import { MAX_UNIFORM_SKINNING_JOINTS as SHADER_MAX_UNIFORM_SKINNING_JOINTS } from "./ShaderChunks.js";
 import { ShaderModule } from "./ShaderModule.js";
 import { createDefaultShaderLibrary } from "./ShaderLibrary.js";
 import { createShadowFilterKernel } from "./ShadowMap.js";
+import { Sampler } from "./Sampler.js";
+import { Texture } from "./Texture.js";
 import { TextureBinding } from "./TextureBinding.js";
 import { UnlitMaterial } from "./UnlitMaterial.js";
 import { sortRenderQueueItems } from "./performance/RenderItemSorting.js";
+import { createClusteredForwardLighting } from "./ClusteredForwardLighting.js";
+/** Joints addressable through the uniform-array palette. Re-exported for shaders. */
+export const MAX_UNIFORM_SKINNING_JOINTS = SHADER_MAX_UNIFORM_SKINNING_JOINTS;
+/**
+ * Upper bound on joints per skin, using the data-texture palette path.
+ *
+ * Chosen to stay well inside a 1024-wide RGBA32F texture (1024 joints = 4096 texels =
+ * a 1024x4 texture) while covering rigs far beyond anything the uniform path allows.
+ */
+export const MAX_SKINNING_JOINTS = 1024;
+const SKINNING_PALETTE_TEXTURE_MAX_WIDTH = 1024;
 export const MAX_GPU_MORPH_VERTICES = 64;
 export const MAX_GPU_MORPH_TARGETS = 4;
 export const MAX_GPU_INSTANCES = 64;
@@ -31,6 +45,7 @@ export class ForwardPass extends BaseRenderPass {
     materialBinding = new MaterialBinding();
     shaderLibrary;
     skinningPaletteUploads = new SkinningPaletteUploadManager();
+    clusteredLighting = null;
     constructor(options) {
         super("forward", options.inputColorResource ? [options.inputColorResource] : [], ["color"]);
         this.options = options;
@@ -38,8 +53,17 @@ export class ForwardPass extends BaseRenderPass {
     }
     execute(context) {
         this.skinningPaletteUploads.beginFrame();
-        for (const item of sortForwardRenderItems(this.options.items, this.options.cameraPosition)) {
-            this.drawItem(context.device, item);
+        this.clusteredLighting = (this.options.lights?.length ?? 0) > 16
+            ? createClusteredForwardLighting(this.options.lights ?? [], context.width, context.height, this.options.cameraViewProjectionMatrix)
+            : null;
+        try {
+            for (const item of sortForwardRenderItems(this.options.items, this.options.cameraPosition)) {
+                this.drawItem(context.device, item);
+            }
+        }
+        finally {
+            this.clusteredLighting?.dispose();
+            this.clusteredLighting = null;
         }
     }
     drawItem(device, item) {
@@ -67,9 +91,10 @@ export class ForwardPass extends BaseRenderPass {
         }
         const binding = this.materialBinding.bind(material, shader);
         const uniforms = new Map(binding.uniforms);
+        applyClusteredLightingUniforms(this.clusteredLighting, shader, uniforms);
         applyEnvironmentLightingUniforms(this.options.environmentLighting, item, shader, uniforms);
         applyEnvironmentFogUniforms(this.options.environmentFog, item, shader, uniforms);
-        applyForwardShadowMapUniforms(this.options.shadowMap, item, shader, uniforms);
+        applyForwardShadowMapUniforms(selectForwardShadowMap(this.options.shadowMap, item, this.options.cameraViewMatrix, this.options.cameraPosition), item, shader, uniforms);
         applyOutputColorSpaceUniform(this.options.outputColorSpace ?? "srgb", item, shader, uniforms);
         applyCameraUniforms(this.options.cameraPosition, item, shader, uniforms);
         applyAlphaCutoffUniform(item, shader, uniforms);
@@ -153,13 +178,42 @@ class SkinningPaletteUploadManager {
     submissions = 0;
     jointsUploaded = 0;
     maxJointCount = 0;
+    uniformArraySubmissions = 0;
+    dataTextureSubmissions = 0;
+    eightInfluenceSubmissions = 0;
     beginFrame() {
         this.submissions = 0;
         this.jointsUploaded = 0;
         this.maxJointCount = 0;
+        this.uniformArraySubmissions = 0;
+        this.dataTextureSubmissions = 0;
+        this.eightInfluenceSubmissions = 0;
+    }
+    /**
+     * Which palette paths this frame actually used. Published rather than inferred so a
+     * claim about data-texture or eight-influence skinning rests on observed submissions.
+     */
+    diagnostics() {
+        return {
+            submissions: this.submissions,
+            jointsUploaded: this.jointsUploaded,
+            maxJointCount: this.maxJointCount,
+            uniformArraySubmissions: this.uniformArraySubmissions,
+            dataTextureSubmissions: this.dataTextureSubmissions,
+            eightInfluenceSubmissions: this.eightInfluenceSubmissions,
+            maxUniformJoints: MAX_UNIFORM_SKINNING_JOINTS
+        };
     }
     bind(item, skinning, material, shader, uniforms) {
-        applySkinningUniforms(skinning, material, shader, uniforms);
+        const path = applySkinningUniforms(skinning, material, shader, uniforms);
+        if (path === "data-texture")
+            this.dataTextureSubmissions += 1;
+        else
+            this.uniformArraySubmissions += 1;
+        const eightInfluence = item.geometry.vertexBuffer.format.hasAttribute("joints1")
+            && item.geometry.vertexBuffer.format.hasAttribute("weights1");
+        if (eightInfluence)
+            this.eightInfluenceSubmissions += 1;
         const validatedJointCounts = SkinningPaletteUploadManager.validatedGeometryJointCounts.get(item.geometry) ?? new Set();
         if (!validatedJointCounts.has(skinning.jointCount)) {
             validateSkinningGeometryContract(item, skinning);
@@ -457,6 +511,37 @@ function invertMat4(matrix) {
         (a20 * b03 - a21 * b01 + a22 * b00) * invDet
     ];
 }
+export function selectForwardShadowMap(shadowMap, item, cameraViewMatrix, cameraPosition) {
+    const cascades = shadowMap?.cascades;
+    if (!shadowMap || !cascades || cascades.length === 0)
+        return shadowMap;
+    const center = renderItemWorldCenter(item);
+    const depth = cameraViewMatrix && cameraViewMatrix.length >= 16
+        ? Math.max(0, -(cameraViewMatrix[2] * center[0]
+            + cameraViewMatrix[6] * center[1]
+            + cameraViewMatrix[10] * center[2]
+            + cameraViewMatrix[14]))
+        : cameraPosition
+            ? Math.hypot(center[0] - cameraPosition[0], center[1] - cameraPosition[1], center[2] - cameraPosition[2])
+            : cascades[0].near;
+    const selected = cascades.find((cascade) => depth <= cascade.far) ?? cascades[cascades.length - 1];
+    return selected.shadowMap;
+}
+function renderItemWorldCenter(item) {
+    const local = item.boundingBoxCenter ?? [
+        (item.geometry.bounds.min[0] + item.geometry.bounds.max[0]) / 2,
+        (item.geometry.bounds.min[1] + item.geometry.bounds.max[1]) / 2,
+        (item.geometry.bounds.min[2] + item.geometry.bounds.max[2]) / 2
+    ];
+    const matrix = item.modelMatrix;
+    if (!matrix || matrix.length < 16)
+        return local;
+    return [
+        matrix[0] * local[0] + matrix[4] * local[1] + matrix[8] * local[2] + matrix[12],
+        matrix[1] * local[0] + matrix[5] * local[1] + matrix[9] * local[2] + matrix[13],
+        matrix[2] * local[0] + matrix[6] * local[1] + matrix[10] * local[2] + matrix[14]
+    ];
+}
 function applyForwardShadowMapUniforms(shadowMap, item, shader, uniforms) {
     const requiredUniforms = [
         "u_shadowMapTexture",
@@ -535,6 +620,33 @@ function applyForwardShadowMapUniforms(shadowMap, item, shader, uniforms) {
     uniforms.set("u_shadowPcfSampleCount", filterKernel.samples.length);
     uniforms.set("u_shadowPcfSamples", pcfSamples);
 }
+function applyClusteredLightingUniforms(clustered, shader, uniforms) {
+    const required = [
+        "u_clusteredLightEnabled",
+        "u_clusterGridSize",
+        "u_clusterViewportSize",
+        "u_clusterLightData",
+        "u_clusterLightIndices"
+    ];
+    if (!required.every((name) => shader.reflection.uniforms.has(name)))
+        return;
+    if (!clustered) {
+        uniforms.set("u_clusteredLightEnabled", 0);
+        uniforms.set("u_clusterGridSize", [1, 1]);
+        uniforms.set("u_clusterViewportSize", [1, 1]);
+        uniforms.set("u_clusterLightData", new TextureBinding({ name: "u_clusterLightData", required: false }));
+        uniforms.set("u_clusterLightIndices", new TextureBinding({ name: "u_clusterLightIndices", required: false }));
+        return;
+    }
+    uniforms.set("u_clusteredLightEnabled", 1);
+    uniforms.set("u_clusterGridSize", [clustered.diagnostics.gridWidth, clustered.diagnostics.gridHeight]);
+    uniforms.set("u_clusterViewportSize", [
+        clustered.diagnostics.viewportWidth,
+        clustered.diagnostics.viewportHeight
+    ]);
+    uniforms.set("u_clusterLightData", clustered.lightData);
+    uniforms.set("u_clusterLightIndices", clustered.lightIndices);
+}
 function applyForwardPointShadowMapUniforms(pointShadowMap, item, shader, uniforms) {
     const requiredUniforms = [
         "u_pointShadowMapTexture",
@@ -1242,9 +1354,11 @@ function applySkinningUniforms(skinning, material, shader, uniforms) {
             material: material.name
         });
     }
-    if (!Number.isInteger(skinning.jointCount) || skinning.jointCount <= 0 || skinning.jointCount > 96) {
-        throw new RenderDeviceError("Skinning jointCount must be an integer in [1, 96]", "INVALID_SKINNING_PALETTE", {
-            jointCount: skinning.jointCount
+    if (!Number.isInteger(skinning.jointCount) || skinning.jointCount <= 0 || skinning.jointCount > MAX_SKINNING_JOINTS) {
+        throw new RenderDeviceError(`Skinning jointCount must be an integer in [1, ${MAX_SKINNING_JOINTS}]`, "INVALID_SKINNING_PALETTE", {
+            jointCount: skinning.jointCount,
+            maxUniformJoints: MAX_UNIFORM_SKINNING_JOINTS,
+            maxJoints: MAX_SKINNING_JOINTS
         });
     }
     if (skinning.matrices.length !== skinning.jointCount * 16) {
@@ -1259,7 +1373,68 @@ function applySkinningUniforms(skinning, material, shader, uniforms) {
         });
     }
     uniforms.set("u_jointCount", skinning.jointCount);
+    // Over the uniform-array limit the palette travels as an RGBA32F data texture, four
+    // texels per matrix. A mat4 uniform costs four vec4 slots, so a uniform array cannot
+    // be grown far enough for large rigs without exhausting MAX_VERTEX_UNIFORM_VECTORS.
+    const path = skinning.jointCount > MAX_UNIFORM_SKINNING_JOINTS ? "data-texture" : "uniform-array";
+    if (path === "data-texture") {
+        if (!shader.reflection.uniforms.has("u_jointPaletteTexture") || !shader.reflection.uniforms.has("u_jointPaletteMode")) {
+            throw new RenderDeviceError(`Skinning palettes above ${MAX_UNIFORM_SKINNING_JOINTS} joints require a shader with data-texture palette uniforms`, "SKINNING_SHADER_CONTRACT", { material: material.name, jointCount: skinning.jointCount });
+        }
+        const texture = createSkinningPaletteTexture(skinning, material.name);
+        uniforms.set("u_jointPaletteMode", 1);
+        uniforms.set("u_jointPaletteTexture", new TextureBinding({
+            name: "u_jointPaletteTexture",
+            texture,
+            sampler: new Sampler({ minFilter: "nearest", magFilter: "nearest", addressU: "clamp-to-edge", addressV: "clamp-to-edge" }),
+            required: true
+        }));
+        uniforms.set("u_jointPaletteTextureSize", [texture.width, texture.height]);
+        // The uniform array is still declared by the shader, so give it a valid value.
+        uniforms.set("u_jointMatrices", new Float32Array(MAX_UNIFORM_SKINNING_JOINTS * 16));
+        return path;
+    }
+    if (shader.reflection.uniforms.has("u_jointPaletteMode")) {
+        uniforms.set("u_jointPaletteMode", 0);
+        if (shader.reflection.uniforms.has("u_jointPaletteTextureSize"))
+            uniforms.set("u_jointPaletteTextureSize", [1, 1]);
+        if (shader.reflection.uniforms.has("u_jointPaletteTexture")) {
+            uniforms.set("u_jointPaletteTexture", new TextureBinding({ name: "u_jointPaletteTexture", required: false }));
+        }
+    }
     uniforms.set("u_jointMatrices", skinning.matrices);
+    return path;
+}
+/**
+ * Packs a joint palette into an RGBA32F texture, one texel per matrix column.
+ *
+ * Width is a multiple of four so no matrix straddles a row boundary, which keeps the
+ * shader's texel addressing a simple divide and avoids per-column row recomputation.
+ */
+function createSkinningPaletteTexture(skinning, materialName) {
+    const texelsPerMatrix = 4;
+    const totalTexels = skinning.jointCount * texelsPerMatrix;
+    const width = Math.min(SKINNING_PALETTE_TEXTURE_MAX_WIDTH, Math.max(texelsPerMatrix, ceilToMultiple(Math.ceil(Math.sqrt(totalTexels)), texelsPerMatrix)));
+    const height = Math.ceil(totalTexels / width);
+    const data = new Float32Array(width * height * 4);
+    data.set(skinning.matrices.subarray(0, Math.min(skinning.matrices.length, data.length)));
+    if (skinning.matrices.length > data.length) {
+        throw new RenderDeviceError("Skinning palette does not fit the data texture", "INVALID_SKINNING_PALETTE", {
+            material: materialName,
+            jointCount: skinning.jointCount
+        });
+    }
+    return new Texture({
+        width,
+        height,
+        format: "rgba32f",
+        colorSpace: "linear",
+        label: `aura3d-skinning-palette-${skinning.jointCount}-joints`,
+        data
+    });
+}
+function ceilToMultiple(value, multiple) {
+    return Math.ceil(value / multiple) * multiple;
 }
 function validateSkinningGeometryContract(item, skinning) {
     const format = item.geometry.vertexBuffer.format;
@@ -1284,10 +1459,62 @@ function validateSkinningGeometryContract(item, skinning) {
             weightComponents: weightsAttribute.components
         });
     }
+    // Eight-influence geometry must supply both halves of the second set, and both must
+    // be vec4. A half-declared second set would silently drop influences at draw time.
+    const hasJoints1 = format.hasAttribute("joints1");
+    const hasWeights1 = format.hasAttribute("weights1");
+    if (hasJoints1 !== hasWeights1) {
+        throw new RenderDeviceError("Eight-influence skinned geometry must declare both joints1 and weights1", "SKINNING_GEOMETRY_CONTRACT", {
+            label: item.label,
+            hasJoints1,
+            hasWeights1
+        });
+    }
+    const eightInfluence = hasJoints1 && hasWeights1;
+    if (eightInfluence) {
+        const joints1Attribute = format.getAttribute("joints1");
+        const weights1Attribute = format.getAttribute("weights1");
+        if (joints1Attribute.components !== 4 || weights1Attribute.components !== 4) {
+            throw new RenderDeviceError("Eight-influence skinned geometry must use four components per second-set attribute", "SKINNING_GEOMETRY_CONTRACT", {
+                label: item.label,
+                joints1Components: joints1Attribute.components,
+                weights1Components: weights1Attribute.components
+            });
+        }
+    }
     for (let vertex = 0; vertex < item.geometry.vertexBuffer.vertexCount; vertex += 1) {
         const joints = item.geometry.vertexBuffer.getAttribute(vertex, "joints");
         const weights = item.geometry.vertexBuffer.getAttribute(vertex, "weights");
         let weightSum = 0;
+        if (eightInfluence) {
+            // Validate the second set with the same rules, and fold it into the weight sum so
+            // a vertex whose influence is split across both sets is not reported as unweighted.
+            const joints1 = item.geometry.vertexBuffer.getAttribute(vertex, "joints1");
+            const weights1 = item.geometry.vertexBuffer.getAttribute(vertex, "weights1");
+            for (let influence = 0; influence < 4; influence += 1) {
+                const joint = joints1[influence] ?? 0;
+                const weight = weights1[influence] ?? 0;
+                if (!Number.isFinite(weight) || weight < 0) {
+                    throw new RenderDeviceError("Skinned render item weights must be finite non-negative values", "SKINNING_GEOMETRY_CONTRACT", {
+                        label: item.label,
+                        jointCount: skinning.jointCount,
+                        vertex,
+                        influence: influence + 4,
+                        weight
+                    });
+                }
+                if (!Number.isInteger(joint) || joint < 0 || joint >= skinning.jointCount) {
+                    throw new RenderDeviceError("Skinned render item joint indices must reference palette joints", "SKINNING_GEOMETRY_CONTRACT", {
+                        label: item.label,
+                        jointCount: skinning.jointCount,
+                        vertex,
+                        influence: influence + 4,
+                        joint
+                    });
+                }
+                weightSum += weight;
+            }
+        }
         for (let influence = 0; influence < 4; influence += 1) {
             const joint = joints[influence] ?? 0;
             const weight = weights[influence] ?? 0;