@meimu/mutracer 0.2.0 → 0.3.1

package/lib/renderer/caustics.js

@@ -0,0 +1,93 @@
+import { computeGeometryBounds } from './geometryBvhBounds.js';
+import { matrixStorage } from '../math/storage.js';
+import { read, write } from '../math/access.js';
+import { meshInstanceCount, meshInstanceTransform } from './meshInstances.js';
+import { mat4, vec3 } from '../math.js';
+import { resolveMaterialAlphaMode } from '../scene/MaterialState.js';
+export const CAUSTIC_ROUGHNESS_MAX = 0.1;
+/** Material-only classification, shared by caster collection and GPU estimators. */
+export function isCausticSpecular(m) {
+    return m.baseWeight * (1 - m.baseMetalness) * (1 - m.transmissionWeight) <= 1e-6 &&
+        m.subsurfaceWeight <= 0 && m.fuzzWeight <= 0 && m.coatWeight <= 0 && m.specularRoughness <= CAUSTIC_ROUGHNESS_MAX;
+}
+const casterBounds = new WeakMap();
+function localCasterBounds(geometry) {
+    const cached = casterBounds.get(geometry), positions = geometry.position.array;
+    if (cached && cached.version === geometry.version && cached.positions === positions)
+        return cached.bounds;
+    const value = computeGeometryBounds(geometry), bounds = [matrixStorage(value[0]), matrixStorage(value[1])];
+    casterBounds.set(geometry, { version: geometry.version, positions, bounds });
+    return bounds;
+}
+/** One conservative world-space sphere per smooth mesh instance. */
+export function causticCasterSpheres(meshes) {
+    const spheres = [];
+    const matrix = mat4.create(), point = vec3.create();
+    for (const mesh of meshes) {
+        if (!mesh.materials.some(isCausticSpecular))
+            continue;
+        // Geometry.boundingBox is optional caller metadata and starts at zero.
+        // Caster collection must also work for a raw public Geometry descriptor.
+        const bounds = localCasterBounds(mesh.geometry), minCorner = bounds[0], maxCorner = bounds[1];
+        if (!Number.isFinite(minCorner[0]) || !Number.isFinite(maxCorner[0]))
+            continue;
+        let expansion = 0;
+        for (const material of mesh.materials)
+            if (isCausticSpecular(material))
+                expansion = Math.max(expansion, Math.abs(material.displacementBias) + (material.displacementMap ? Math.abs(material.displacementScale) : 0));
+        for (let instance = 0; instance < meshInstanceCount(mesh); instance++) {
+            const min = [Infinity, Infinity, Infinity], max = [-Infinity, -Infinity, -Infinity];
+            meshInstanceTransform(mesh, instance, matrix);
+            for (let corner = 0; corner < 8; corner++) {
+                for (let axis = 0; axis < 3; axis++)
+                    write(point, axis, ((corner & (1 << axis)) ? maxCorner[axis] + expansion : minCorner[axis] - expansion));
+                vec3.transformMat4(point, point, matrix);
+                for (let axis = 0; axis < 3; axis++) {
+                    min[axis] = Math.min(min[axis], read(point, axis));
+                    max[axis] = Math.max(max[axis], read(point, axis));
+                }
+            }
+            spheres.push([(min[0] + max[0]) * .5, (min[1] + max[1]) * .5, (min[2] + max[2]) * .5, Math.hypot(max[0] - min[0], max[1] - min[1], max[2] - min[2]) * .501]);
+        }
+    }
+    return spheres;
+}
+/** Conservative sphere enclosing the caster mixture. */
+export function causticCasterSphere(meshes) {
+    const spheres = causticCasterSpheres(meshes);
+    if (!spheres.length)
+        return [0, 0, 0, 0];
+    const min = [Infinity, Infinity, Infinity], max = [-Infinity, -Infinity, -Infinity];
+    for (const s of spheres) {
+        const components = [s[0], s[1], s[2]];
+        for (let i = 0; i < 3; i++) {
+            min[i] = Math.min(min[i], components[i] - s[3]);
+            max[i] = Math.max(max[i], components[i] + s[3]);
+        }
+    }
+    const center = min.map((v, i) => (v + max[i]) * .5);
+    let radius = 0;
+    for (const s of spheres)
+        radius = Math.max(radius, Math.hypot(s[0] - center[0], s[1] - center[1], s[2] - center[2]) + s[3]);
+    return [center[0], center[1], center[2], radius];
+}
+/** CPU reference for the solid-angle mixture, including overlapping cones. */
+export function casterDirectionPdf(origin, direction, spheres, weights = []) {
+    let total = 0, overlaps = 0;
+    for (const [index, s] of spheres.entries()) {
+        const weight = weights[index] ?? 1;
+        const d = Math.hypot(s[0] - origin[0], s[1] - origin[1], s[2] - origin[2]);
+        const cosine = d > s[3] ? Math.sqrt(Math.max(0, 1 - (s[3] / d) ** 2)) : -1;
+        total += 2 * Math.PI * (1 - cosine) * weight;
+        if (d <= s[3] || ((s[0] - origin[0]) * direction[0] + (s[1] - origin[1]) * direction[1] + (s[2] - origin[2]) * direction[2]) / d >= cosine)
+            overlaps += weight;
+    }
+    return total > 0 ? overlaps / total : 0;
+}
+/** Stochastic smooth coverage currently disagrees with PT energy.
+ * Keep those scenes on PT until transport and endpoint weights are verified.
+ */
+export function hasStochasticCausticCaster(meshes) {
+    return meshes.some(mesh => mesh.materials.some(m => isCausticSpecular(m) && resolveMaterialAlphaMode(m) === 'blend'));
+}
+//# sourceMappingURL=caustics.js.map

package/lib/renderer/caustics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caustics.js","sourceRoot":"","sources":["../../src/renderer/caustics.ts"],"names":[],"mappings":"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","sourcesContent":["import {computeGeometryBounds} from './geometryBvhBounds.js';\nimport type Geometry from '../scene/Geometry.js';\nimport {matrixStorage} from '../math/storage.js';\nimport {read,write} from '../math/access.js';\nimport type Mesh from '../scene/MeshState.js';\nimport {meshInstanceCount,meshInstanceTransform} from './meshInstances.js';\nimport {mat4,vec3} from '../math.js';\nimport type OpenPBRMaterial from '../scene/MaterialState.js';\nimport {resolveMaterialAlphaMode} from '../scene/MaterialState.js';\n\nexport const CAUSTIC_ROUGHNESS_MAX = 0.1;\n/** Material-only classification, shared by caster collection and GPU estimators. */\nexport function isCausticSpecular(m: Pick<OpenPBRMaterial, 'baseWeight' | 'baseMetalness' | 'transmissionWeight' | 'subsurfaceWeight' | 'fuzzWeight' | 'coatWeight' | 'specularRoughness'>) {\n  return m.baseWeight * (1 - m.baseMetalness) * (1 - m.transmissionWeight) <= 1e-6 &&\n    m.subsurfaceWeight <= 0 && m.fuzzWeight <= 0 && m.coatWeight <= 0 && m.specularRoughness <= CAUSTIC_ROUGHNESS_MAX;\n}\n\nexport type CasterSphere = [number,number,number,number];\nconst casterBounds=new WeakMap<Geometry,{version:number;positions:Float32Array;bounds:[Float64Array,Float64Array]}>();\nfunction localCasterBounds(geometry:Geometry){\n const cached=casterBounds.get(geometry),positions=geometry.position.array;\n if(cached&&cached.version===geometry.version&&cached.positions===positions)return cached.bounds;\n const value=computeGeometryBounds(geometry),bounds:[Float64Array,Float64Array]=[matrixStorage(value[0]),matrixStorage(value[1])];\n casterBounds.set(geometry,{version:geometry.version,positions,bounds});return bounds;\n}\n/** One conservative world-space sphere per smooth mesh instance. */\nexport function causticCasterSpheres(meshes: readonly Mesh[]): CasterSphere[] {\n  const spheres:CasterSphere[]=[];\n  const matrix=mat4.create(),point=vec3.create();\n  for(const mesh of meshes) {\n    if(!mesh.materials.some(isCausticSpecular))continue;\n    // Geometry.boundingBox is optional caller metadata and starts at zero.\n    // Caster collection must also work for a raw public Geometry descriptor.\n    const bounds=localCasterBounds(mesh.geometry),minCorner=bounds[0],maxCorner=bounds[1];\n    if(!Number.isFinite(minCorner[0])||!Number.isFinite(maxCorner[0]))continue;\n    let expansion=0;\n    for(const material of mesh.materials)if(isCausticSpecular(material))expansion=Math.max(expansion,\n      Math.abs(material.displacementBias)+(material.displacementMap?Math.abs(material.displacementScale):0));\n    for(let instance=0;instance<meshInstanceCount(mesh);instance++) {\n      const min=[Infinity,Infinity,Infinity],max=[-Infinity,-Infinity,-Infinity];\n      meshInstanceTransform(mesh,instance,matrix);\n      for(let corner=0;corner<8;corner++) {\n        for(let axis=0;axis<3;axis++)write(point,axis,((corner&(1<<axis))?maxCorner[axis]+expansion:minCorner[axis]-expansion));\n        vec3.transformMat4(point,point,matrix);\n        for(let axis=0;axis<3;axis++){min[axis]=Math.min(min[axis],read(point,axis));max[axis]=Math.max(max[axis],read(point,axis));}\n      }\n      spheres.push([(min[0]+max[0])*.5,(min[1]+max[1])*.5,(min[2]+max[2])*.5,Math.hypot(max[0]-min[0],max[1]-min[1],max[2]-min[2])*.501]);\n    }\n  }\n  return spheres;\n}\n/** Conservative sphere enclosing the caster mixture. */\nexport function causticCasterSphere(meshes:readonly Mesh[]):CasterSphere {\n  const spheres=causticCasterSpheres(meshes);if(!spheres.length)return [0,0,0,0];\n  const min=[Infinity,Infinity,Infinity],max=[-Infinity,-Infinity,-Infinity];\n  for(const s of spheres){const components:number[]=[s[0],s[1],s[2]];for(let i=0;i<3;i++){min[i]=Math.min(min[i],components[i]-s[3]);max[i]=Math.max(max[i],components[i]+s[3]);}}\n  const center=min.map((v,i)=>(v+max[i])*.5);\n  let radius=0;for(const s of spheres)radius=Math.max(radius,Math.hypot(s[0]-center[0],s[1]-center[1],s[2]-center[2])+s[3]);\n  return [center[0],center[1],center[2],radius];\n}\n/** CPU reference for the solid-angle mixture, including overlapping cones. */\nexport function casterDirectionPdf(origin:readonly number[],direction:readonly number[],spheres:readonly CasterSphere[],weights:readonly number[]=[]) {\n  let total=0,overlaps=0;\n  for(const [index,s] of spheres.entries()){const weight=weights[index]??1;const d=Math.hypot(s[0]-origin[0],s[1]-origin[1],s[2]-origin[2]);\n    const cosine=d>s[3]?Math.sqrt(Math.max(0,1-(s[3]/d)**2)):-1;\n    total+=2*Math.PI*(1-cosine)*weight;\n    if(d<=s[3]||((s[0]-origin[0])*direction[0]+(s[1]-origin[1])*direction[1]+(s[2]-origin[2])*direction[2])/d>=cosine)overlaps+=weight;\n  }\n  return total>0?overlaps/total:0;\n}\n\n/** Stochastic smooth coverage currently disagrees with PT energy.\n * Keep those scenes on PT until transport and endpoint weights are verified.\n */\nexport function hasStochasticCausticCaster(meshes:readonly Mesh[]){\n return meshes.some(mesh=>mesh.materials.some(m=>isCausticSpecular(m)&&resolveMaterialAlphaMode(m)==='blend'));\n}\n"]}

package/lib/renderer/compactVertices.d.ts

@@ -0,0 +1,14 @@
+import type Geometry from '../scene/Geometry.js';
+export declare function compactVertexLayout(geometries: readonly Geometry[], normalFloat?: boolean): {
+    stride: number;
+    offsets: number[];
+    constants: Record<string, number | boolean>;
+};
+export declare function encodeNormal(x: number, y: number, z: number): number;
+export declare function encodeTangent(x: number, y: number, z: number, w: number): number;
+/** CPU decoder for layout/precision checks and backend-independent encoding consumers. */
+export declare function decodeDirection(word: number, tangent?: boolean): [number, number, number];
+/** Writes source geometry directly into its resident packed vertex region. */
+export declare function packCompactVertices(geometry: Geometry, output: Uint32Array, stride: number, offsets: readonly number[], first: number, count: number, outputFirst?: number, deformationOnly?: boolean, colorFloat?: boolean, normalFloat?: boolean): void;
+/** Optional material plane, indexed by BVH triangle record. Unused node entries are never read. */
+export declare function packTriangleMaterials(geometry: Geometry, materialIndices: readonly number[], bvh: ArrayBuffer, output: Uint32Array, offset: number): void;

package/lib/renderer/compactVertices.js

@@ -0,0 +1,124 @@
+import { localMaterialIndex } from './materialIndices.js';
+import { hasGeneratedVertexTangents } from '../util/geometry.js';
+// Word offsets, not vec4 slots. Positions and both UV sets remain f32.
+// An absent secondary UV aliases the primary UV without duplicating its storage.
+export function compactVertexLayout(geometries, normalFloat = false) {
+    const has = (name) => geometries.some(g => !!g[name]);
+    let colorFloat = false;
+    for (const g of geometries)
+        if (g.color) {
+            for (const value of g.color.array)
+                if (!(value >= 0 && value <= 1)) {
+                    colorFloat = true;
+                    break;
+                }
+        }
+    let stride = normalFloat ? 6 : 4;
+    const offsets = [0, 3, stride, stride, stride, stride, -1];
+    if (has('uv') || has('uv1'))
+        stride += 2;
+    offsets[3] = has('uv1') ? stride : offsets[2];
+    if (has('uv1'))
+        stride += 2;
+    offsets[4] = stride;
+    if (has('color'))
+        stride += colorFloat ? 3 : 1;
+    offsets[5] = stride;
+    if (has('tangent'))
+        stride++;
+    const names = ['POSITION', 'NORMAL', 'UV', 'UV1', 'COLOR', 'TANGENT'];
+    const constants = { ATTR_STRIDE: stride, USE_UV: has('uv') || has('uv1'),
+        USE_VERTEX_COLOR: has('color'), COLOR_FLOAT: colorFloat, NORMAL_FLOAT: normalFloat, HAS_VERTEX_UV: has('uv') || has('uv1'),
+        HAS_VERTEX_TANGENT: has('tangent'), HAS_TRIANGLE_MATERIAL: has('materialIndex'), MATERIALINDEX_OFF: 0 };
+    names.forEach((name, i) => { constants[name + '_OFF'] = offsets[i]; });
+    return { stride, offsets, constants };
+}
+function oct(x, y, z, maximum, bits) {
+    const length = Math.abs(x) + Math.abs(y) + Math.abs(z);
+    if (!length)
+        return (1 << (bits - 1)) | (1 << (bits * 2 - 1));
+    x /= length;
+    y /= length;
+    if (z < 0) {
+        const oldX = x;
+        x = (1 - Math.abs(y)) * (oldX < 0 ? -1 : 1);
+        y = (1 - Math.abs(oldX)) * (y < 0 ? -1 : 1);
+    }
+    const mask = (1 << bits) - 1;
+    return ((Math.round(x * maximum) & mask) | ((Math.round(y * maximum) & mask) << bits)) >>> 0;
+}
+export function encodeNormal(x, y, z) { return oct(x, y, z, 32767, 16); }
+export function encodeTangent(x, y, z, w) {
+    const sign = w > 1.5 ? 3 : w < 0 ? 2 : w > 0 ? 1 : 0;
+    return (oct(x, y, z, 16383, 15) | (sign << 30)) >>> 0;
+}
+/** CPU decoder for layout/precision checks and backend-independent encoding consumers. */
+export function decodeDirection(word, tangent = false) {
+    const bits = tangent ? 15 : 16, shift = 32 - bits, maximum = (1 << (bits - 1)) - 1;
+    const a = (word << shift) >> shift, b = (word << (32 - 2 * bits)) >> shift;
+    if (a === -maximum - 1 && b === -maximum - 1)
+        return [0, 0, 0];
+    let x = a / maximum, y = b / maximum;
+    const z = 1 - Math.abs(x) - Math.abs(y);
+    if (z < 0) {
+        const oldX = x;
+        x = (1 - Math.abs(y)) * (oldX < 0 ? -1 : 1);
+        y = (1 - Math.abs(oldX)) * (y < 0 ? -1 : 1);
+    }
+    const length = Math.hypot(x, y, z);
+    return [x / length, y / length, z / length];
+}
+/** Writes source geometry directly into its resident packed vertex region. */
+export function packCompactVertices(geometry, output, stride, offsets, first, count, outputFirst = first, deformationOnly = false, colorFloat = false, normalFloat = false) {
+    const floats = new Float32Array(output.buffer, output.byteOffset, output.length);
+    const p = geometry.position.array, n = geometry.normal.array, tangent = geometry.tangent;
+    const uv = geometry.uv, uv1 = geometry.uv1 ?? uv, color = geometry.color;
+    const tangentArray = tangent?.array, tangentSize = tangent?.itemSize ?? 0;
+    const tangentSign = tangentSize === 4 ? 0 : hasGeneratedVertexTangents(geometry) ? 0 : 2;
+    const uvArray = uv?.array, uv1Array = uv1?.array, colorArray = color?.array;
+    const uvOffset = offsets[2], uv1Offset = offsets[3], colorOffset = offsets[4], tangentOffset = offsets[5];
+    for (let i = first, end = first + count, d = outputFirst * stride; i < end; i++, d += stride) {
+        floats[d] = p[i * 3];
+        floats[d + 1] = p[i * 3 + 1];
+        floats[d + 2] = p[i * 3 + 2];
+        if (normalFloat) {
+            floats[d + 3] = n[i * 3];
+            floats[d + 4] = n[i * 3 + 1];
+            floats[d + 5] = n[i * 3 + 2];
+        }
+        else
+            output[d + 3] = encodeNormal(n[i * 3], n[i * 3 + 1], n[i * 3 + 2]);
+        if (tangentOffset < stride) {
+            const t = i * tangentSize;
+            output[d + tangentOffset] = tangentArray ? encodeTangent(tangentArray[t], tangentArray[t + 1], tangentArray[t + 2], tangentSize === 4 ? tangentArray[t + 3] : tangentSign) : encodeTangent(0, 0, 0, 0);
+        }
+        if (deformationOnly)
+            continue;
+        if (uvOffset < colorOffset) {
+            floats[d + uvOffset] = uvArray?.[i * 2] ?? 0;
+            floats[d + uvOffset + 1] = uvArray?.[i * 2 + 1] ?? 0;
+            floats[d + uv1Offset] = uv1Array?.[i * 2] ?? 0;
+            floats[d + uv1Offset + 1] = uv1Array?.[i * 2 + 1] ?? 0;
+        }
+        if (colorOffset < tangentOffset) {
+            const r = colorArray?.[i * 3] ?? 1, g = colorArray?.[i * 3 + 1] ?? 1, b = colorArray?.[i * 3 + 2] ?? 1;
+            if (colorFloat) {
+                floats[d + colorOffset] = r;
+                floats[d + colorOffset + 1] = g;
+                floats[d + colorOffset + 2] = b;
+            }
+            else
+                output[d + colorOffset] = (Math.round(r * 255) | Math.round(g * 255) << 8 | Math.round(b * 255) << 16 | 0xff000000) >>> 0;
+        }
+    }
+}
+/** Optional material plane, indexed by BVH triangle record. Unused node entries are never read. */
+export function packTriangleMaterials(geometry, materialIndices, bvh, output, offset) {
+    const words = new Uint32Array(bvh);
+    for (let record = 0; record < words.length / 4; record++) {
+        const vertex = words[record * 4];
+        output[offset + record] = geometry.materialIndex && vertex < geometry.vertexCount
+            ? (materialIndices[localMaterialIndex(geometry, vertex, materialIndices.length)] ?? 0) + 1 : 0;
+    }
+}
+//# sourceMappingURL=compactVertices.js.map

package/lib/renderer/compactVertices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactVertices.js","sourceRoot":"","sources":["../../src/renderer/compactVertices.ts"],"names":[],"mappings":"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","sourcesContent":["import {localMaterialIndex} from './materialIndices.js';\nimport type Geometry from '../scene/Geometry.js';\nimport {hasGeneratedVertexTangents} from '../util/geometry.js';\n\n// Word offsets, not vec4 slots. Positions and both UV sets remain f32.\n// An absent secondary UV aliases the primary UV without duplicating its storage.\nexport function compactVertexLayout(geometries: readonly Geometry[], normalFloat = false) {\n  const has = (name: 'uv' | 'uv1' | 'color' | 'tangent' | 'materialIndex') => geometries.some(g => !!g[name]);\n  let colorFloat = false;\n  for (const g of geometries) if (g.color) {\n    for (const value of g.color.array) if (!(value >= 0 && value <= 1)) {colorFloat = true; break;}\n  }\n  let stride = normalFloat ? 6 : 4;\n  const offsets = [0, 3, stride, stride, stride, stride, -1];\n  if (has('uv') || has('uv1')) stride += 2;\n  offsets[3] = has('uv1') ? stride : offsets[2];\n  if (has('uv1')) stride += 2;\n  offsets[4] = stride;\n  if (has('color')) stride += colorFloat ? 3 : 1;\n  offsets[5] = stride;\n  if (has('tangent')) stride++;\n  const names = ['POSITION', 'NORMAL', 'UV', 'UV1', 'COLOR', 'TANGENT'];\n  const constants: Record<string, boolean | number> = {ATTR_STRIDE: stride, USE_UV: has('uv') || has('uv1'),\n    USE_VERTEX_COLOR: has('color'), COLOR_FLOAT: colorFloat, NORMAL_FLOAT: normalFloat, HAS_VERTEX_UV: has('uv') || has('uv1'),\n    HAS_VERTEX_TANGENT: has('tangent'), HAS_TRIANGLE_MATERIAL: has('materialIndex'), MATERIALINDEX_OFF: 0};\n  names.forEach((name, i) => {constants[name + '_OFF'] = offsets[i];});\n  return {stride, offsets, constants};\n}\n\nfunction oct(x: number, y: number, z: number, maximum: number, bits: number) {\n  const length = Math.abs(x) + Math.abs(y) + Math.abs(z);\n  if (!length) return (1 << (bits - 1)) | (1 << (bits * 2 - 1));\n  x /= length; y /= length;\n  if (z < 0) {\n    const oldX = x;\n    x = (1 - Math.abs(y)) * (oldX < 0 ? -1 : 1);\n    y = (1 - Math.abs(oldX)) * (y < 0 ? -1 : 1);\n  }\n  const mask = (1 << bits) - 1;\n  return ((Math.round(x * maximum) & mask) | ((Math.round(y * maximum) & mask) << bits)) >>> 0;\n}\n\nexport function encodeNormal(x: number, y: number, z: number) {return oct(x, y, z, 32767, 16);}\nexport function encodeTangent(x: number, y: number, z: number, w: number) {\n  const sign = w > 1.5 ? 3 : w < 0 ? 2 : w > 0 ? 1 : 0;\n  return (oct(x, y, z, 16383, 15) | (sign << 30)) >>> 0;\n}\n\n/** CPU decoder for layout/precision checks and backend-independent encoding consumers. */\nexport function decodeDirection(word: number, tangent = false): [number, number, number] {\n  const bits = tangent ? 15 : 16, shift = 32 - bits, maximum = (1 << (bits - 1)) - 1;\n  const a = (word << shift) >> shift, b = (word << (32 - 2 * bits)) >> shift;\n  if (a === -maximum - 1 && b === -maximum - 1) return [0, 0, 0];\n  let x = a / maximum, y = b / maximum;\n  const z = 1 - Math.abs(x) - Math.abs(y);\n  if (z < 0) {\n    const oldX = x;\n    x = (1 - Math.abs(y)) * (oldX < 0 ? -1 : 1);\n    y = (1 - Math.abs(oldX)) * (y < 0 ? -1 : 1);\n  }\n  const length = Math.hypot(x, y, z);\n  return [x / length, y / length, z / length];\n}\n\n/** Writes source geometry directly into its resident packed vertex region. */\nexport function packCompactVertices(geometry: Geometry, output: Uint32Array, stride: number, offsets: readonly number[],\n  first: number, count: number, outputFirst = first, deformationOnly = false, colorFloat = false, normalFloat = false) {\n  const floats = new Float32Array(output.buffer, output.byteOffset, output.length);\n  const p = geometry.position.array, n = geometry.normal.array, tangent = geometry.tangent;\n  const uv = geometry.uv, uv1 = geometry.uv1 ?? uv, color = geometry.color;\n  const tangentArray = tangent?.array, tangentSize = tangent?.itemSize ?? 0;\n  const tangentSign = tangentSize === 4 ? 0 : hasGeneratedVertexTangents(geometry) ? 0 : 2;\n  const uvArray = uv?.array, uv1Array = uv1?.array, colorArray = color?.array;\n  const uvOffset = offsets[2], uv1Offset = offsets[3], colorOffset = offsets[4], tangentOffset = offsets[5];\n  for (let i = first, end = first + count, d = outputFirst * stride; i < end; i++, d += stride) {\n    floats[d] = p[i * 3]; floats[d + 1] = p[i * 3 + 1]; floats[d + 2] = p[i * 3 + 2];\n    if (normalFloat) {\n      floats[d + 3] = n[i * 3]; floats[d + 4] = n[i * 3 + 1]; floats[d + 5] = n[i * 3 + 2];\n    } else output[d + 3] = encodeNormal(n[i * 3], n[i * 3 + 1], n[i * 3 + 2]);\n    if (tangentOffset < stride) {\n      const t = i * tangentSize;\n      output[d + tangentOffset] = tangentArray ? encodeTangent(tangentArray[t], tangentArray[t + 1], tangentArray[t + 2],\n        tangentSize === 4 ? tangentArray[t + 3] : tangentSign) : encodeTangent(0, 0, 0, 0);\n    }\n    if (deformationOnly) continue;\n    if (uvOffset < colorOffset) {\n      floats[d + uvOffset] = uvArray?.[i * 2] ?? 0; floats[d + uvOffset + 1] = uvArray?.[i * 2 + 1] ?? 0;\n      floats[d + uv1Offset] = uv1Array?.[i * 2] ?? 0; floats[d + uv1Offset + 1] = uv1Array?.[i * 2 + 1] ?? 0;\n    }\n    if (colorOffset < tangentOffset) {\n      const r = colorArray?.[i * 3] ?? 1, g = colorArray?.[i * 3 + 1] ?? 1, b = colorArray?.[i * 3 + 2] ?? 1;\n      if (colorFloat) {floats[d + colorOffset] = r; floats[d + colorOffset + 1] = g; floats[d + colorOffset + 2] = b;}\n      else output[d + colorOffset] = (Math.round(r * 255) | Math.round(g * 255) << 8 | Math.round(b * 255) << 16 | 0xff000000) >>> 0;\n    }\n  }\n}\n\n/** Optional material plane, indexed by BVH triangle record. Unused node entries are never read. */\nexport function packTriangleMaterials(geometry: Geometry, materialIndices: readonly number[], bvh: ArrayBuffer,\n  output: Uint32Array, offset: number) {\n  const words = new Uint32Array(bvh);\n  for (let record = 0; record < words.length / 4; record++) {\n    const vertex = words[record * 4];\n    output[offset + record] = geometry.materialIndex && vertex < geometry.vertexCount\n      ? (materialIndices[localMaterialIndex(geometry, vertex, materialIndices.length)] ?? 0) + 1 : 0;\n  }\n}\n"]}

package/lib/renderer/easu.d.ts

@@ -0,0 +1,11 @@
+import type { PostProcess } from '../Display.js';
+/** createEasuPass options. */
+export interface EasuOptions {
+    /** Recover surface texture detail from the displayed render's diffuseColor, specularColor and depth AOVs, traced with aovResolution 'display'. Default false. Warns once when the displayed render lacks that configuration; frames whose AOVs are not ready or do not match the output size use EASU alone. Unsupported surfaces and silhouettes receive no compensation. */ albedoDetail?: boolean;
+}
+/** A display pass with optional scratch images. Dispose after unregistering; it may be used again. */
+export type EasuPass = PostProcess & {
+    dispose(): void;
+};
+/** Creates an edge-adaptive display-space upscale pass (AMD FSR 1 EASU), without sharpening. Register with outputSize: (_, display) => display. WebGPU only; supports rgba8unorm and extended-range rgba16float, including alpha. Copies inputs that already have the output size and area-averages larger ones. Default EASU alone. */
+export declare function createEasuPass(options?: EasuOptions): EasuPass;

package/lib/renderer/easu.js

@@ -0,0 +1,156 @@
+import { areaDownsampleShader, easuShader } from './wgsl/easu.wgsl.js';
+import { albedoDownsampleShader, easuDetailShader, guidedCoefficientShader, toneLutShader, EASU_DETAIL, TONE_LUT_SIZE } from './wgsl/easuDetail.wgsl.js';
+import { borrowedAovRevision } from './WGPUAov.js';
+import { TONE_MAPPING_MODES } from './wgsl/compose.frag.wgsl.js';
+/** Creates an edge-adaptive display-space upscale pass (AMD FSR 1 EASU), without sharpening. Register with outputSize: (_, display) => display. WebGPU only; supports rgba8unorm and extended-range rgba16float, including alpha. Copies inputs that already have the output size and area-averages larger ones. Default EASU alone. */
+export function createEasuPass(options = {}) { return createEasuPassImpl({ albedoDetail: options.albedoDetail }); }
+const DETAIL_AOVS = ['diffuseColor', 'specularColor', 'depth'];
+/** @internal Plain albedo ratios (guided false), the separate-lobe approximation and depth-guided silhouettes are retained for comparisons; not package exports. */
+export function createEasuPassImpl(options = {}, separate = false, silhouettes = false, guided = true) {
+    const detailEnabled = options.albedoDetail ?? false;
+    let warnedConfiguration = false;
+    const [min, max] = options.ratioRange ?? EASU_DETAIL.ratioRange;
+    const depth = options.depthThreshold ?? EASU_DETAIL.depthThreshold, coverage = options.coverageThreshold ?? EASU_DETAIL.coverageThreshold;
+    if (![min, max, depth, coverage].every(Number.isFinite) || min <= 0 || max < min || depth <= 0 || coverage <= 0 || coverage > 1)
+        throw new RangeError('Invalid EASU detail compensation options.');
+    const devices = new Map();
+    const retire = (device, resources) => {
+        // This callback's encoder is submitted after it returns.
+        void Promise.resolve().then(() => device.queue.onSubmittedWorkDone()).catch(() => { }).then(() => resources.forEach(resource => resource.destroy()));
+    };
+    const guideFormats = silhouettes ? ['rgba16float', 'rgba16float', 'rg32float'] : ['rgba16float', 'rgba16float'];
+    const owned = (state) => [...(state.scratch ?? []), ...(state.tone ? [state.tone] : []), ...(state.fit ?? [])];
+    const pass = ctx => {
+        const { device, encoder, input, output, render } = ctx;
+        // Nothing to upscale, for example a full-resolution render beside a reduced preview.
+        if (input.width === output.width && input.height === output.height) {
+            encoder.copyTextureToTexture({ texture: input }, { texture: output }, [input.width, input.height]);
+            return;
+        }
+        for (const [previous, old] of devices)
+            if (previous !== device) {
+                retire(previous, owned(old));
+                devices.delete(previous);
+            }
+        let state = devices.get(device);
+        if (!state) {
+            state = { pipelines: new Map() };
+            devices.set(device, state);
+        }
+        const pipeline = (key, code, formats) => {
+            let value = state.pipelines.get(key);
+            if (!value) {
+                const module = device.createShaderModule({ label: key, code });
+                value = device.createRenderPipeline({ label: key, layout: 'auto', vertex: { module, entryPoint: 'vertex' },
+                    fragment: { module, entryPoint: 'fragment', targets: formats.map(format => ({ format })) } });
+                state.pipelines.set(key, value);
+            }
+            return value;
+        };
+        const buffer = (values) => {
+            const value = device.createBuffer({ size: 16, usage: GPUBufferUsage.UNIFORM, mappedAtCreation: true });
+            new Float32Array(value.getMappedRange()).set(values);
+            value.unmap();
+            retire(device, [value]);
+            return value;
+        };
+        if (input.width >= output.width && input.height >= output.height) {
+            // EASU is an enlargement filter; larger renders are area averaged instead.
+            const down = pipeline(`Area downsample ${output.format}`, areaDownsampleShader, [output.format]);
+            const group = device.createBindGroup({ layout: down.getBindGroupLayout(0), entries: [{ binding: 0, resource: input.createView() }, { binding: 1, resource: { buffer: buffer([output.width, output.height, 0, 0]) } }] });
+            const draw = encoder.beginRenderPass({ label: 'Area downsample', colorAttachments: [{ view: output.createView(), loadOp: 'clear', storeOp: 'store' }] });
+            draw.setPipeline(down);
+            draw.setBindGroup(0, group);
+            draw.draw(3);
+            draw.end();
+            return;
+        }
+        if (detailEnabled && !warnedConfiguration && (render.aovResolution !== 'display' || !DETAIL_AOVS.every(kind => render.aovs.includes(kind)))) {
+            warnedConfiguration = true;
+            console.warn("EASU albedoDetail needs the displayed render to enable diffuseColor, specularColor and depth AOVs with aovResolution 'display'; upscaling without detail.");
+        }
+        const aovs = detailEnabled ? DETAIL_AOVS.map(kind => render.getAovTexture(kind)) : [];
+        const detail = aovs.length === 3 && aovs.every(image => image && image.width === output.width && image.height === output.height);
+        const entries = [{ binding: 0, resource: input.createView() }, { binding: 1, resource: { buffer: buffer([output.width, output.height, min, max]) } }];
+        if (detail) {
+            // Cached images are recorded on their own submission so a failed chain cannot leave them stale.
+            let cache;
+            const cached = () => cache ??= device.createCommandEncoder({ label: 'EASU cache' });
+            if (!state.scratch || state.scratch.length !== guideFormats.length || state.scratch[0].width !== input.width || state.scratch[0].height !== input.height) {
+                if (state.scratch)
+                    retire(device, state.scratch);
+                // Low diffuse and specular albedo, then (for silhouettes) nearest hit depth with hit coverage.
+                state.scratch = guideFormats.map((format, index) => device.createTexture({ label: `EASU low guide ${index}`, size: [input.width, input.height], format, usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT }));
+                state.key = undefined;
+            }
+            // Low albedo depends only on the AOV contents and beauty size; reuse it across presents.
+            const key = [state.scratch[0], ...aovs, ...aovs.map(image => borrowedAovRevision.get(image))];
+            if (!state.key || key.some((value, index) => value !== state.key[index])) {
+                const down = pipeline(`Albedo area downsample ${silhouettes}`, albedoDownsampleShader(silhouettes), guideFormats);
+                const group = device.createBindGroup({ layout: down.getBindGroupLayout(0), entries: [
+                        { binding: 0, resource: aovs[0].createView() }, { binding: 1, resource: aovs[1].createView() },
+                        { binding: 2, resource: { buffer: buffer([input.width, input.height, 0, 0]) } }, { binding: 3, resource: aovs[2].createView() }
+                    ] });
+                const draw = cached().beginRenderPass({ label: 'Albedo area downsample', colorAttachments: state.scratch.map(image => ({ view: image.createView(), loadOp: 'clear', storeOp: 'store' })) });
+                draw.setPipeline(down);
+                draw.setBindGroup(0, group);
+                draw.draw(3);
+                draw.end();
+                state.key = key;
+            }
+            aovs.forEach((image, index) => entries.push({ binding: 2 + index, resource: image.createView() }));
+            entries.push({ binding: 5, resource: state.scratch[0].createView() }, { binding: 6, resource: state.scratch[1].createView() });
+            if (silhouettes)
+                entries.push({ binding: 10, resource: state.scratch[2].createView() });
+            entries.push({ binding: 7, resource: { buffer: buffer([EASU_DETAIL.minimumAlbedo, coverage, depth, EASU_DETAIL.depthTolerance]) } });
+            // The ratio is applied through the same grading and tone mapping as the composed image,
+            // tabulated once per display setting.
+            const display = render._engine.display, extended = output.format === 'rgba16float';
+            const tone = [TONE_MAPPING_MODES[display.toneMapping] ?? 0, extended ? 16 : 1, display.toneMappingExposure, extended ? 1 : 0];
+            const grading = [display.contrast, display.saturation, display.temperature, display.tint];
+            const toneKey = [...tone, ...grading].join(',');
+            state.tone ??= device.createTexture({ label: 'EASU tone table', size: [TONE_LUT_SIZE, 2], format: 'rgba32float', usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT });
+            if (state.toneKey !== toneKey) {
+                const build = pipeline('EASU tone table', toneLutShader, ['rgba32float']);
+                const group = device.createBindGroup({ layout: build.getBindGroupLayout(0), entries: [{ binding: 0, resource: { buffer: buffer(tone) } }, { binding: 1, resource: { buffer: buffer(grading) } }] });
+                const draw = cached().beginRenderPass({ label: 'EASU tone table', colorAttachments: [{ view: state.tone.createView(), loadOp: 'clear', storeOp: 'store' }] });
+                draw.setPipeline(build);
+                draw.setBindGroup(0, group);
+                draw.draw(3);
+                draw.end();
+                state.toneKey = toneKey;
+            }
+            const toneEntries = [{ binding: 8, resource: state.tone.createView() }, { binding: 9, resource: { buffer: buffer([tone[1], EASU_DETAIL.guidedEpsilon, 0, 0]) } }];
+            entries.push(...toneEntries);
+            if (cache)
+                device.queue.submit([cache.finish()]);
+            if (guided) {
+                // The local albedo-radiance fit depends on this frame's image, so it runs on every present.
+                if (!state.fit || state.fit[0].width !== input.width || state.fit[0].height !== input.height) {
+                    if (state.fit)
+                        retire(device, state.fit);
+                    state.fit = ['slope', 'offset'].map(name => device.createTexture({ label: `EASU albedo ${name}`, size: [input.width, input.height], format: 'rgba16float', usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT }));
+                }
+                const fit = pipeline('EASU albedo fit', guidedCoefficientShader, ['rgba16float', 'rgba16float']);
+                const group = device.createBindGroup({ layout: fit.getBindGroupLayout(0), entries: [{ binding: 0, resource: input.createView() },
+                        { binding: 1, resource: state.scratch[0].createView() }, { binding: 2, resource: state.scratch[1].createView() }, ...toneEntries] });
+                const draw = encoder.beginRenderPass({ label: 'EASU albedo fit', colorAttachments: state.fit.map(image => ({ view: image.createView(), loadOp: 'clear', storeOp: 'store' })) });
+                draw.setPipeline(fit);
+                draw.setBindGroup(0, group);
+                draw.draw(3);
+                draw.end();
+                entries.push({ binding: 11, resource: state.fit[0].createView() }, { binding: 12, resource: state.fit[1].createView() });
+            }
+        }
+        const upscale = pipeline(`FSR 1 EASU ${detail ? `detail ${separate} ${silhouettes} ${guided}` : 'color'} ${output.format}`, detail ? easuDetailShader(separate, silhouettes, guided) : easuShader, [output.format]);
+        const group = device.createBindGroup({ layout: upscale.getBindGroupLayout(0), entries });
+        const draw = encoder.beginRenderPass({ label: 'FSR 1 EASU', colorAttachments: [{ view: output.createView(), loadOp: 'clear', storeOp: 'store' }] });
+        draw.setPipeline(upscale);
+        draw.setBindGroup(0, group);
+        draw.draw(3);
+        draw.end();
+    };
+    return Object.assign(pass, { dispose() { for (const [device, state] of devices)
+            retire(device, owned(state)); devices.clear(); } });
+}
+//# sourceMappingURL=easu.js.map

package/lib/renderer/easu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easu.js","sourceRoot":"","sources":["../../src/renderer/easu.ts"],"names":[],"mappings":"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","sourcesContent":["import type {PostProcess} from '../Display.js';\nimport {areaDownsampleShader, easuShader} from './wgsl/easu.wgsl.js';\nimport {albedoDownsampleShader, easuDetailShader, guidedCoefficientShader, toneLutShader, EASU_DETAIL, TONE_LUT_SIZE} from './wgsl/easuDetail.wgsl.js';\nimport {borrowedAovRevision} from './WGPUAov.js';\nimport {TONE_MAPPING_MODES} from './wgsl/compose.frag.wgsl.js';\n\n/** createEasuPass options. */\nexport interface EasuOptions {\n  /** Recover surface texture detail from the displayed render's diffuseColor, specularColor and depth AOVs, traced with aovResolution 'display'. Default false. Warns once when the displayed render lacks that configuration; frames whose AOVs are not ready or do not match the output size use EASU alone. Unsupported surfaces and silhouettes receive no compensation. */ albedoDetail?: boolean;\n}\n/** @internal Detail tuning kept for comparisons; not package options. */\nexport interface EasuTuning extends EasuOptions {\n  /** Per-channel linear compensation bounds, positive finite min <= max. Default [0.7, 1.43]. */ ratioRange?: readonly [number, number];\n  /** Relative departure of neighboring inverse depth from a plane that marks a silhouette, positive finite. Default 0.02. */ depthThreshold?: number;\n  /** Minimum valid AOV coverage in (0,1]. Default 0.95. */ coverageThreshold?: number;\n}\n/** A display pass with optional scratch images. Dispose after unregistering; it may be used again. */\nexport type EasuPass = PostProcess & {dispose(): void};\n/** Creates an edge-adaptive display-space upscale pass (AMD FSR 1 EASU), without sharpening. Register with outputSize: (_, display) => display. WebGPU only; supports rgba8unorm and extended-range rgba16float, including alpha. Copies inputs that already have the output size and area-averages larger ones. Default EASU alone. */\nexport function createEasuPass(options: EasuOptions = {}): EasuPass { return createEasuPassImpl({albedoDetail: options.albedoDetail}); }\n\nconst DETAIL_AOVS = ['diffuseColor', 'specularColor', 'depth'] as const;\n\n/** @internal Plain albedo ratios (guided false), the separate-lobe approximation and depth-guided silhouettes are retained for comparisons; not package exports. */\nexport function createEasuPassImpl(options: EasuTuning = {}, separate = false, silhouettes = false, guided = true): EasuPass {\n  const detailEnabled = options.albedoDetail ?? false;\n  let warnedConfiguration = false;\n  const [min, max] = options.ratioRange ?? EASU_DETAIL.ratioRange;\n  const depth = options.depthThreshold ?? EASU_DETAIL.depthThreshold, coverage = options.coverageThreshold ?? EASU_DETAIL.coverageThreshold;\n  if (![min,max,depth,coverage].every(Number.isFinite) || min <= 0 || max < min || depth <= 0 || coverage <= 0 || coverage > 1) throw new RangeError('Invalid EASU detail compensation options.');\n  const devices = new Map<GPUDevice, {pipelines: Map<string, GPURenderPipeline>; scratch?: GPUTexture[]; key?: unknown[]; tone?: GPUTexture; toneKey?: string; fit?: GPUTexture[]}>();\n  const retire = (device: GPUDevice, resources: (GPUTexture | GPUBuffer)[]) => {\n    // This callback's encoder is submitted after it returns.\n    void Promise.resolve().then(() => device.queue.onSubmittedWorkDone()).catch(() => {}).then(() => resources.forEach(resource => resource.destroy()));\n  };\n  const guideFormats: GPUTextureFormat[] = silhouettes ? ['rgba16float','rgba16float','rg32float'] : ['rgba16float','rgba16float'];\n  const owned = (state: {scratch?: GPUTexture[]; tone?: GPUTexture; fit?: GPUTexture[]}) => [...(state.scratch ?? []), ...(state.tone ? [state.tone] : []), ...(state.fit ?? [])];\n  const pass: PostProcess = ctx => {\n    const {device, encoder, input, output, render} = ctx;\n    // Nothing to upscale, for example a full-resolution render beside a reduced preview.\n    if (input.width === output.width && input.height === output.height) {\n      encoder.copyTextureToTexture({texture: input}, {texture: output}, [input.width, input.height]);\n      return;\n    }\n    for (const [previous, old] of devices) if (previous !== device) {retire(previous,owned(old));devices.delete(previous);}\n    let state = devices.get(device);\n    if (!state) {state = {pipelines: new Map()}; devices.set(device, state);}\n    const pipeline = (key: string, code: string, formats: GPUTextureFormat[]) => {\n      let value = state!.pipelines.get(key);\n      if (!value) {\n        const module = device.createShaderModule({label: key, code});\n        value = device.createRenderPipeline({label: key, layout: 'auto', vertex: {module,entryPoint:'vertex'},\n          fragment: {module,entryPoint:'fragment',targets:formats.map(format => ({format}))}});\n        state!.pipelines.set(key, value);\n      }\n      return value;\n    };\n    const buffer = (values: number[]) => {\n      const value = device.createBuffer({size:16,usage:GPUBufferUsage.UNIFORM,mappedAtCreation:true});\n      new Float32Array(value.getMappedRange()).set(values);value.unmap();retire(device,[value]);return value;\n    };\n    if (input.width >= output.width && input.height >= output.height) {\n      // EASU is an enlargement filter; larger renders are area averaged instead.\n      const down = pipeline(`Area downsample ${output.format}`,areaDownsampleShader,[output.format]);\n      const group = device.createBindGroup({layout:down.getBindGroupLayout(0),entries:[{binding:0,resource:input.createView()},{binding:1,resource:{buffer:buffer([output.width,output.height,0,0])}}]});\n      const draw = encoder.beginRenderPass({label:'Area downsample',colorAttachments:[{view:output.createView(),loadOp:'clear',storeOp:'store'}]});\n      draw.setPipeline(down);draw.setBindGroup(0,group);draw.draw(3);draw.end();\n      return;\n    }\n    if (detailEnabled && !warnedConfiguration && (render.aovResolution !== 'display' || !DETAIL_AOVS.every(kind => render.aovs.includes(kind)))) {\n      warnedConfiguration = true;\n      console.warn(\"EASU albedoDetail needs the displayed render to enable diffuseColor, specularColor and depth AOVs with aovResolution 'display'; upscaling without detail.\");\n    }\n    const aovs = detailEnabled ? DETAIL_AOVS.map(kind => render.getAovTexture(kind)) : [];\n    const detail = aovs.length === 3 && aovs.every(image => image && image.width === output.width && image.height === output.height);\n    const entries: GPUBindGroupEntry[] = [{binding:0,resource:input.createView()}, {binding:1,resource:{buffer:buffer([output.width,output.height,min,max])}}];\n    if (detail) {\n      // Cached images are recorded on their own submission so a failed chain cannot leave them stale.\n      let cache: GPUCommandEncoder | undefined;\n      const cached = () => cache ??= device.createCommandEncoder({label: 'EASU cache'});\n      if (!state.scratch || state.scratch.length !== guideFormats.length || state.scratch[0].width !== input.width || state.scratch[0].height !== input.height) {\n        if(state.scratch)retire(device,state.scratch);\n        // Low diffuse and specular albedo, then (for silhouettes) nearest hit depth with hit coverage.\n        state.scratch = guideFormats.map((format, index) => device.createTexture({label:`EASU low guide ${index}`,size:[input.width,input.height],format,usage:GPUTextureUsage.TEXTURE_BINDING|GPUTextureUsage.RENDER_ATTACHMENT}));\n        state.key = undefined;\n      }\n      // Low albedo depends only on the AOV contents and beauty size; reuse it across presents.\n      const key = [state.scratch[0], ...aovs, ...aovs.map(image => borrowedAovRevision.get(image!))];\n      if (!state.key || key.some((value, index) => value !== state.key![index])) {\n        const down = pipeline(`Albedo area downsample ${silhouettes}`,albedoDownsampleShader(silhouettes),guideFormats);\n        const group = device.createBindGroup({layout:down.getBindGroupLayout(0),entries:[\n          {binding:0,resource:aovs[0]!.createView()},{binding:1,resource:aovs[1]!.createView()},\n          {binding:2,resource:{buffer:buffer([input.width,input.height,0,0])}},{binding:3,resource:aovs[2]!.createView()}\n        ]});\n        const draw = cached().beginRenderPass({label:'Albedo area downsample',colorAttachments:state.scratch.map(image=>({view:image.createView(),loadOp:'clear',storeOp:'store'}))});\n        draw.setPipeline(down);draw.setBindGroup(0,group);draw.draw(3);draw.end();\n        state.key = key;\n      }\n      aovs.forEach((image,index)=>entries.push({binding:2+index,resource:image!.createView()}));\n      entries.push({binding:5,resource:state.scratch[0].createView()},{binding:6,resource:state.scratch[1].createView()});\n      if (silhouettes) entries.push({binding:10,resource:state.scratch[2].createView()});\n      entries.push({binding:7,resource:{buffer:buffer([EASU_DETAIL.minimumAlbedo,coverage,depth,EASU_DETAIL.depthTolerance])}});\n      // The ratio is applied through the same grading and tone mapping as the composed image,\n      // tabulated once per display setting.\n      const display = render._engine.display, extended = output.format === 'rgba16float';\n      const tone = [TONE_MAPPING_MODES[display.toneMapping] ?? 0, extended ? 16 : 1, display.toneMappingExposure, extended ? 1 : 0];\n      const grading = [display.contrast, display.saturation, display.temperature, display.tint];\n      const toneKey = [...tone, ...grading].join(',');\n      state.tone ??= device.createTexture({label:'EASU tone table',size:[TONE_LUT_SIZE,2],format:'rgba32float',usage:GPUTextureUsage.TEXTURE_BINDING|GPUTextureUsage.RENDER_ATTACHMENT});\n      if (state.toneKey !== toneKey) {\n        const build = pipeline('EASU tone table',toneLutShader,['rgba32float']);\n        const group = device.createBindGroup({layout:build.getBindGroupLayout(0),entries:[{binding:0,resource:{buffer:buffer(tone)}},{binding:1,resource:{buffer:buffer(grading)}}]});\n        const draw = cached().beginRenderPass({label:'EASU tone table',colorAttachments:[{view:state.tone.createView(),loadOp:'clear',storeOp:'store'}]});\n        draw.setPipeline(build);draw.setBindGroup(0,group);draw.draw(3);draw.end();\n        state.toneKey = toneKey;\n      }\n      const toneEntries: GPUBindGroupEntry[] = [{binding:8,resource:state.tone.createView()},{binding:9,resource:{buffer:buffer([tone[1],EASU_DETAIL.guidedEpsilon,0,0])}}];\n      entries.push(...toneEntries);\n      if (cache) device.queue.submit([cache.finish()]);\n      if (guided) {\n        // The local albedo-radiance fit depends on this frame's image, so it runs on every present.\n        if (!state.fit || state.fit[0].width !== input.width || state.fit[0].height !== input.height) {\n          if (state.fit) retire(device, state.fit);\n          state.fit = ['slope','offset'].map(name => device.createTexture({label:`EASU albedo ${name}`,size:[input.width,input.height],format:'rgba16float',usage:GPUTextureUsage.TEXTURE_BINDING|GPUTextureUsage.RENDER_ATTACHMENT}));\n        }\n        const fit = pipeline('EASU albedo fit',guidedCoefficientShader,['rgba16float','rgba16float']);\n        const group = device.createBindGroup({layout:fit.getBindGroupLayout(0),entries:[{binding:0,resource:input.createView()},\n          {binding:1,resource:state.scratch[0].createView()},{binding:2,resource:state.scratch[1].createView()},...toneEntries]});\n        const draw = encoder.beginRenderPass({label:'EASU albedo fit',colorAttachments:state.fit.map(image=>({view:image.createView(),loadOp:'clear',storeOp:'store'}))});\n        draw.setPipeline(fit);draw.setBindGroup(0,group);draw.draw(3);draw.end();\n        entries.push({binding:11,resource:state.fit[0].createView()},{binding:12,resource:state.fit[1].createView()});\n      }\n    }\n    const upscale = pipeline(`FSR 1 EASU ${detail ? `detail ${separate} ${silhouettes} ${guided}` : 'color'} ${output.format}`,detail ? easuDetailShader(separate, silhouettes, guided) : easuShader,[output.format]);\n    const group = device.createBindGroup({layout:upscale.getBindGroupLayout(0),entries});\n    const draw = encoder.beginRenderPass({label:'FSR 1 EASU',colorAttachments:[{view:output.createView(),loadOp:'clear',storeOp:'store'}]});\n    draw.setPipeline(upscale);draw.setBindGroup(0,group);draw.draw(3);draw.end();\n  };\n  return Object.assign(pass, {dispose() {for(const [device,state] of devices) retire(device,owned(state));devices.clear();}});\n}\n"]}

package/lib/renderer/geometryUpdateState.d.ts

@@ -18,6 +18,7 @@ export interface GeometryUpdateRegion {
 }
 export interface GeometryUpdateState<M extends GeometryUpdateMesh = GeometryUpdateMesh> {
     geometry: Geometry;
+    mergedAttributes?: boolean;
     geometries: Geometry[];
     geometryRegions: Map<Geometry, GeometryUpdateRegion>;
     geometryStates: Map<Geometry, {

package/lib/renderer/geometryUpdateState.js.map

@@ -1 +1 @@
-{"version":3,"file":"geometryUpdateState.js","sourceRoot":"","sources":["../../src/renderer/geometryUpdateState.ts"],"names":[],"mappings":"","sourcesContent":["import type Geometry from '../scene/Geometry.js';\nimport type MaterialState from '../scene/MaterialState.js';\nimport type { vec3 } from '../math.js';\nimport type { FlattendBVH } from './bvhAccel.js';\n\n// The update algorithm needs no renderer resources or browser scene facade.\nexport interface GeometryUpdateMesh { geometry: Geometry; materials: MaterialState[]; }\nexport interface GeometryUpdateBinding<M extends GeometryUpdateMesh = GeometryUpdateMesh> {\n  mesh: M;\n  geometry: Geometry;\n  bvhBounds: [vec3.Vec3Array, vec3.Vec3Array];\n}\nexport interface GeometryUpdateRegion { vertexOffset: number; indexOffset: number; materialIndices: number[]; }\nexport interface GeometryUpdateState<M extends GeometryUpdateMesh = GeometryUpdateMesh> {\n  geometry: Geometry;\n  geometries: Geometry[];\n  geometryRegions: Map<Geometry, GeometryUpdateRegion>;\n  geometryStates: Map<Geometry, {topologyVersion: number; indices: Geometry['indices']['array']; indexCount: number}>;\n  instanceBindings: GeometryUpdateBinding<M>[];\n  blases: {bvh: FlattendBVH}[];\n}\n"]}
+{"version":3,"file":"geometryUpdateState.js","sourceRoot":"","sources":["../../src/renderer/geometryUpdateState.ts"],"names":[],"mappings":"","sourcesContent":["import type Geometry from '../scene/Geometry.js';\nimport type MaterialState from '../scene/MaterialState.js';\nimport type { vec3 } from '../math.js';\nimport type { FlattendBVH } from './bvhAccel.js';\n\n// The update algorithm needs no renderer resources or browser scene facade.\nexport interface GeometryUpdateMesh { geometry: Geometry; materials: MaterialState[]; }\nexport interface GeometryUpdateBinding<M extends GeometryUpdateMesh = GeometryUpdateMesh> {\n  mesh: M;\n  geometry: Geometry;\n  bvhBounds: [vec3.Vec3Array, vec3.Vec3Array];\n}\nexport interface GeometryUpdateRegion { vertexOffset: number; indexOffset: number; materialIndices: number[]; }\nexport interface GeometryUpdateState<M extends GeometryUpdateMesh = GeometryUpdateMesh> {\n  geometry: Geometry;\n  mergedAttributes?: boolean;\n  geometries: Geometry[];\n  geometryRegions: Map<Geometry, GeometryUpdateRegion>;\n  geometryStates: Map<Geometry, {topologyVersion: number; indices: Geometry['indices']['array']; indexCount: number}>;\n  instanceBindings: GeometryUpdateBinding<M>[];\n  blases: {bvh: FlattendBVH}[];\n}\n"]}

package/lib/renderer/geometryUpdates.js

@@ -107,9 +107,10 @@ export function updatePreparedGeometries(prepared, changed, options = {}) {
                 blases.push({ blas: bvh, offset });
             }
             geometry.version = source.version;
-            copyRegion(source, prepared.geometry, region, topologyChanged, deformationOnly);
+            if (prepared.mergedAttributes !== false)
+                copyRegion(source, prepared.geometry, region, topologyChanged, deformationOnly);
             const count = source.vertexCount, previousVertices = vertices[vertices.length - 1];
-            if (previousVertices && previousVertices.first + previousVertices.count === region.vertexOffset && previousVertices.topologyChanged === topologyChanged && previousVertices.deformationOnly === deformationOnly)
+            if (prepared.mergedAttributes !== false && previousVertices && previousVertices.first + previousVertices.count === region.vertexOffset && previousVertices.topologyChanged === topologyChanged && previousVertices.deformationOnly === deformationOnly)
                 previousVertices.count += count;
             else
                 vertices.push({ first: region.vertexOffset, count, topologyChanged, deformationOnly });