@adobe/data-gpu 0.9.75 → 0.9.77

package/dist/graphics/rendering/pbr-render/pbr-factor-render-plugin.js

@@ -0,0 +1,189 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { pbrIblRender } from "../ibl-render/ibl-render-plugin.js";
+import { materialPaletteGpu } from "../material-palette-gpu/material-palette-gpu-plugin.js";
+import { displayTransform } from "../display-transform-plugin.js";
+import { SceneUniforms } from "../../scene/scene-uniforms/scene-uniforms.js";
+import { StandardVertex } from "../standard-vertex/standard-vertex.js";
+import { createFactorPaletteBindGroupLayout } from "../material-palette-gpu/palette-bind-group.js";
+import { buildPbrFactorShader } from "./pbr-factor-shader.wgsl.js";
+import { composeTrs, createIblBindGroupLayout, DRAWABLE, DRAWABLE_DIRECT, DRAWABLE_INTERP, PREFILTERED_MIP_COUNT, PRIMITIVE, } from "./primitive-render-shared.js";
+/**
+ * pbrFactorRender — instanced primitive PBR from material factors only (no map
+ * sampling). Extends `pbrIblRender` for IBL + skybox + optional glTF draws.
+ * Pairs with `materialPaletteGpu` (`_paletteIndex` on factor materials).
+ *
+ * Pairs with `materialPaletteGpu` (`_paletteIndex`). Idle when no factor materials or drawables exist.
+ */
+export const pbrFactorRender = Database.Plugin.create({
+    extends: Database.Plugin.combine(pbrIblRender, materialPaletteGpu, displayTransform),
+    systems: {
+        pbrFactorPrimitiveRenderSystem: {
+            schedule: { during: ["render"], after: ["beginRenderPass", "pbrIblRenderSystem"], before: ["endRenderPass"] },
+            create: db => {
+                let pipeline = null;
+                let sceneLayout = null;
+                let iblLayout = null;
+                let instanceLayout = null;
+                let iblSampler = null;
+                let sceneBindGroup = null;
+                let iblBindGroup = null;
+                let cachedSceneBuffer = null;
+                let cachedIrradiance = null;
+                const matIndex = new Map();
+                let matCount = -1;
+                const instCache = new Map();
+                let matScratch = new Float32Array(16);
+                let indexScratch = new Uint32Array(1);
+                let mats = new Float32Array(64 * 16);
+                const batches = new Map();
+                return () => {
+                    const { device, renderPassEncoder, canvasFormat, depthFormat, _sceneUniformsBuffer, _factorPaletteBindGroup, _iblIrradiance, _iblPrefiltered, _iblBrdfLut, } = db.store.resources;
+                    if (!device || !renderPassEncoder || !_sceneUniformsBuffer || !_factorPaletteBindGroup)
+                        return;
+                    if (!_iblIrradiance || !_iblPrefiltered || !_iblBrdfLut)
+                        return;
+                    if (!sceneLayout)
+                        sceneLayout = SceneUniforms.createBindGroupLayout(device);
+                    if (!iblLayout)
+                        iblLayout = createIblBindGroupLayout(device);
+                    if (!instanceLayout)
+                        instanceLayout = device.createBindGroupLayout({
+                            entries: [
+                                { binding: 0, visibility: GPUShaderStage.VERTEX, buffer: { type: "read-only-storage" } },
+                                { binding: 1, visibility: GPUShaderStage.VERTEX, buffer: { type: "read-only-storage" } },
+                            ],
+                        });
+                    if (!iblSampler)
+                        iblSampler = device.createSampler({
+                            magFilter: "linear", minFilter: "linear", mipmapFilter: "linear",
+                            addressModeU: "clamp-to-edge", addressModeV: "clamp-to-edge", addressModeW: "clamp-to-edge",
+                        });
+                    if (!pipeline) {
+                        const module = device.createShaderModule({ code: buildPbrFactorShader({ prefilteredMipCount: PREFILTERED_MIP_COUNT }) });
+                        pipeline = device.createRenderPipeline({
+                            layout: device.createPipelineLayout({
+                                bindGroupLayouts: [sceneLayout, createFactorPaletteBindGroupLayout(device), iblLayout, instanceLayout],
+                            }),
+                            vertex: { module, entryPoint: "vs_main", buffers: [StandardVertex.layout] },
+                            fragment: { module, entryPoint: "fs_main", targets: [{ format: canvasFormat }] },
+                            primitive: { topology: "triangle-list", cullMode: "back" },
+                            depthStencil: { format: depthFormat, depthWriteEnabled: true, depthCompare: "less" },
+                        });
+                    }
+                    if (_sceneUniformsBuffer !== cachedSceneBuffer || !sceneBindGroup) {
+                        sceneBindGroup = device.createBindGroup({ layout: sceneLayout, entries: [{ binding: 0, resource: { buffer: _sceneUniformsBuffer } }] });
+                        cachedSceneBuffer = _sceneUniformsBuffer;
+                    }
+                    if (_iblIrradiance !== cachedIrradiance || !iblBindGroup) {
+                        iblBindGroup = device.createBindGroup({
+                            layout: iblLayout,
+                            entries: [
+                                { binding: 0, resource: _iblIrradiance.createView({ dimension: "cube" }) },
+                                { binding: 1, resource: _iblPrefiltered.createView({ dimension: "cube" }) },
+                                { binding: 2, resource: _iblBrdfLut.createView() },
+                                { binding: 3, resource: iblSampler },
+                            ],
+                        });
+                        cachedIrradiance = _iblIrradiance;
+                    }
+                    let mc = 0;
+                    for (const arch of db.store.queryArchetypes(["_paletteIndex"]))
+                        mc += arch.rowCount;
+                    if (mc !== matCount) {
+                        matIndex.clear();
+                        for (const arch of db.store.queryArchetypes(["_paletteIndex"])) {
+                            const id = arch.columns.id, pi = arch.columns._paletteIndex;
+                            for (let i = 0; i < arch.rowCount; i++)
+                                matIndex.set(id.get(i), pi.get(i));
+                        }
+                        matCount = mc;
+                    }
+                    for (const b of batches.values()) {
+                        b.off.length = 0;
+                        b.materialIndex.length = 0;
+                    }
+                    let drawCount = 0;
+                    const gather = (rowCount, vis, meshCol, mat, posArr, rotArr, sclArr) => {
+                        for (let i = 0; i < rowCount; i++) {
+                            if (!vis.get(i))
+                                continue;
+                            const paletteIndex = matIndex.get(mat.get(i));
+                            if (paletteIndex === undefined)
+                                continue;
+                            if ((drawCount + 1) * 16 > mats.length) {
+                                const grown = new Float32Array(mats.length * 2);
+                                grown.set(mats);
+                                mats = grown;
+                            }
+                            composeTrs(mats, drawCount * 16, posArr, i * 3, rotArr, i * 4, sclArr, i * 3);
+                            const g = meshCol.get(i);
+                            let b = batches.get(g);
+                            if (!b) {
+                                b = { off: [], materialIndex: [] };
+                                batches.set(g, b);
+                            }
+                            b.off.push(drawCount);
+                            b.materialIndex.push(paletteIndex);
+                            drawCount++;
+                        }
+                    };
+                    for (const arch of db.store.queryArchetypes(DRAWABLE_INTERP)) {
+                        gather(arch.rowCount, arch.columns.visible, arch.columns.mesh, arch.columns.material, arch.columns._renderPosition.getTypedArray(), arch.columns._renderRotation.getTypedArray(), arch.columns.scale.getTypedArray());
+                    }
+                    for (const arch of db.store.queryArchetypes(DRAWABLE, DRAWABLE_DIRECT)) {
+                        gather(arch.rowCount, arch.columns.visible, arch.columns.mesh, arch.columns.material, arch.columns.position.getTypedArray(), arch.columns.rotation.getTypedArray(), arch.columns.scale.getTypedArray());
+                    }
+                    if (drawCount === 0)
+                        return;
+                    renderPassEncoder.setPipeline(pipeline);
+                    renderPassEncoder.setBindGroup(0, sceneBindGroup);
+                    renderPassEncoder.setBindGroup(1, _factorPaletteBindGroup);
+                    renderPassEncoder.setBindGroup(2, iblBindGroup);
+                    for (const arch of db.store.queryArchetypes(PRIMITIVE)) {
+                        const vbs = arch.columns._vertexBuffer, ibs = arch.columns._indexBuffer;
+                        const counts = arch.columns._indexCount, formats = arch.columns._indexFormat;
+                        const meshRefs = arch.columns._mesh, primIds = arch.columns.id;
+                        for (let i = 0; i < arch.rowCount; i++) {
+                            const b = batches.get(meshRefs.get(i));
+                            if (!b || b.off.length === 0)
+                                continue;
+                            const n = b.off.length;
+                            const primId = primIds.get(i);
+                            let entry = instCache.get(primId);
+                            if (!entry || entry.capacity < n) {
+                                entry?.buffer.destroy();
+                                entry?.indexBuffer.destroy();
+                                const buffer = device.createBuffer({ size: Math.max(n * 64, 64), usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST });
+                                const indexBuffer = device.createBuffer({ size: Math.max(n * 4, 4), usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST });
+                                const bindGroup = device.createBindGroup({
+                                    layout: instanceLayout,
+                                    entries: [{ binding: 0, resource: { buffer } }, { binding: 1, resource: { buffer: indexBuffer } }],
+                                });
+                                entry = { buffer, indexBuffer, bindGroup, capacity: n };
+                                instCache.set(primId, entry);
+                            }
+                            if (matScratch.length < n * 16)
+                                matScratch = new Float32Array(n * 16);
+                            if (indexScratch.length < n)
+                                indexScratch = new Uint32Array(n);
+                            for (let j = 0; j < n; j++) {
+                                const src = b.off[j] * 16, dst = j * 16;
+                                for (let k = 0; k < 16; k++)
+                                    matScratch[dst + k] = mats[src + k];
+                                indexScratch[j] = b.materialIndex[j];
+                            }
+                            device.queue.writeBuffer(entry.buffer, 0, matScratch, 0, n * 16);
+                            device.queue.writeBuffer(entry.indexBuffer, 0, indexScratch, 0, n);
+                            renderPassEncoder.setBindGroup(3, entry.bindGroup);
+                            renderPassEncoder.setVertexBuffer(0, vbs.get(i));
+                            renderPassEncoder.setIndexBuffer(ibs.get(i), formats.get(i));
+                            renderPassEncoder.drawIndexed(counts.get(i), n);
+                        }
+                    }
+                };
+            },
+        },
+    },
+});
+//# sourceMappingURL=pbr-factor-render-plugin.js.map

package/dist/graphics/rendering/pbr-render/pbr-factor-render-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbr-factor-render-plugin.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/pbr-render/pbr-factor-render-plugin.ts"],"names":[],"mappings":"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"}

package/dist/graphics/rendering/pbr-render/pbr-factor-shader.wgsl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Factor-only PBR for instanced primitives — palette factors + vertex normals,
+ * no material map sampling. Used by `pbrFactorRender`.
+ */
+export declare function buildPbrFactorShader(options: {
+    prefilteredMipCount: number;
+}): string;

package/dist/graphics/rendering/pbr-render/pbr-factor-shader.wgsl.js

@@ -0,0 +1,124 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { wgslStructFields } from "@adobe/data/typed-buffer";
+import { schema as sceneUniformsSchema } from "../../scene/scene-uniforms/schema.js";
+import brdf from "../ibl-render/brdf.wgsl.js";
+/**
+ * Factor-only PBR for instanced primitives — palette factors + vertex normals,
+ * no material map sampling. Used by `pbrFactorRender`.
+ */
+export function buildPbrFactorShader(options) {
+    return /* wgsl */ `
+struct SceneUniforms {
+${wgslStructFields(sceneUniformsSchema)}
+}
+
+struct MaterialFactors {
+    baseColorFactor: vec4f,
+    emissiveMetallic: vec4f,   // emissive.rgb, metallicFactor
+    roughNormalIr: vec4f,      // roughnessFactor, normalScale, occlusionStrength, irEmission
+    emissionMeta: vec4f,       // emissionMode, _, _, _
+}
+
+@group(0) @binding(0) var<uniform> scene: SceneUniforms;
+
+@group(1) @binding(0) var<storage, read> palette: array<MaterialFactors>;
+
+@group(2) @binding(0) var iblIrradiance: texture_cube<f32>;
+@group(2) @binding(1) var iblPrefiltered: texture_cube<f32>;
+@group(2) @binding(2) var iblBrdfLut: texture_2d<f32>;
+@group(2) @binding(3) var iblSampler: sampler;
+
+@group(3) @binding(0) var<storage, read> instances: array<mat4x4<f32>>;
+@group(3) @binding(1) var<storage, read> paletteIndices: array<u32>;
+
+const PREFILTERED_MIP_COUNT: f32 = ${options.prefilteredMipCount.toFixed(1)};
+
+struct VertexInput {
+    @location(0) position: vec3f,
+    @location(1) normal: vec3f,
+    @location(2) tangent: vec4f,
+    @location(3) uv: vec2f,
+}
+
+struct VertexOutput {
+    @builtin(position) clipPosition: vec4f,
+    @location(0) worldPosition: vec3f,
+    @location(1) normal: vec3f,
+    @location(5) @interpolate(flat) paletteIndex: u32,
+}
+
+@vertex
+fn vs_main(@builtin(instance_index) instanceIndex: u32, in: VertexInput) -> VertexOutput {
+    let m = instances[instanceIndex];
+    let m3 = mat3x3<f32>(m[0].xyz, m[1].xyz, m[2].xyz);
+    let normalMat = mat3x3<f32>(
+        cross(m3[1], m3[2]),
+        cross(m3[2], m3[0]),
+        cross(m3[0], m3[1]),
+    );
+    let worldPos = m * vec4f(in.position, 1.0);
+    var out: VertexOutput;
+    out.clipPosition = scene.viewProjectionMatrix * worldPos;
+    out.worldPosition = worldPos.xyz;
+    out.normal = normalize(normalMat * in.normal);
+    out.paletteIndex = paletteIndices[instanceIndex];
+    return out;
+}
+
+${brdf}
+
+@fragment
+fn fs_main(in: VertexOutput) -> @location(0) vec4f {
+    let f = palette[in.paletteIndex];
+
+    let baseColor = f.baseColorFactor;
+    let metallic = f.emissiveMetallic.w;
+    var roughness = f.roughNormalIr.x;
+    roughness = max(roughness, MIN_ROUGHNESS);
+    let alpha = roughness * roughness;
+    let occlusion = f.roughNormalIr.z;
+    let emissionMode = f.emissionMeta.x;
+    let irEmission = f.roughNormalIr.w;
+    // 0 = UV fluorescence (no visible add); 1 = visible luminescence (emissive + IR glow).
+    let emissive = select(vec3f(0.0), f.emissiveMetallic.xyz + vec3f(irEmission), emissionMode >= 0.5);
+
+    let N = normalize(in.normal);
+    let V = normalize(scene.cameraPosition - in.worldPosition);
+    let nDotV = max(dot(N, V), 0.001);
+    let R = reflect(-V, N);
+
+    let f0 = mix(vec3f(0.04), baseColor.rgb, metallic);
+
+    let F_ibl = f_schlick_roughness(nDotV, f0, roughness);
+    let kD_ibl = (vec3f(1.0) - F_ibl) * (1.0 - metallic);
+
+    let irradiance = textureSampleLevel(iblIrradiance, iblSampler, N, 0.0).rgb;
+    let diffuseIbl = kD_ibl * irradiance * baseColor.rgb;
+
+    let mipLevel = roughness * (PREFILTERED_MIP_COUNT - 1.0);
+    let prefiltered = textureSampleLevel(iblPrefiltered, iblSampler, R, mipLevel).rgb;
+    let envBrdf = textureSampleLevel(iblBrdfLut, iblSampler, vec2f(nDotV, roughness), 0.0).rg;
+    let specularIbl = prefiltered * (F_ibl * envBrdf.x + envBrdf.y);
+
+    let ambient = (diffuseIbl + specularIbl) * occlusion;
+
+    let L = normalize(-scene.lightDirection);
+    let H = normalize(V + L);
+    let nDotL = max(dot(N, L), 0.0);
+    let nDotH = max(dot(N, H), 0.0);
+    let vDotH = max(dot(V, H), 0.0);
+    let D_d = d_ggx(nDotH, alpha);
+    let G_d = g_smith(nDotV, nDotL, alpha);
+    let F_d = f_schlick(vDotH, f0);
+    let spec_d = (D_d * G_d * F_d) / (4.0 * nDotV * nDotL + 0.0001);
+    let kD_d = (vec3f(1.0) - F_d) * (1.0 - metallic);
+    let direct = (kD_d * baseColor.rgb / PI + spec_d) * scene.lightColor * nDotL;
+
+    let color = direct + ambient + emissive;
+    let mapped = tone_map_aces(color);
+    let gamma = pow(mapped, vec3f(1.0 / 2.2));
+    return vec4f(gamma, baseColor.a);
+}
+`;
+}
+//# sourceMappingURL=pbr-factor-shader.wgsl.js.map

package/dist/graphics/rendering/pbr-render/pbr-factor-shader.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbr-factor-shader.wgsl.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/pbr-render/pbr-factor-shader.wgsl.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,IAAI,MAAM,4BAA4B,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwC;IACzE,OAAO,UAAU,CAAC;;EAEpB,gBAAgB,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;;qCAsBF,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzE,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDL,CAAC;AACF,CAAC"}