@aura3d/rendering 3.0.1 → 4.0.2

package/dist/probes/Prd02ProbesContributor.d.ts

@@ -0,0 +1,53 @@
+import type { FrameContributorContext, FrameContributor } from "../contracts/frameGraph.js";
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+import type { RenderSource } from "../contracts/renderSource.js";
+import { type ReflectionFaceRenderer } from "./ReflectionProbeSystem.js";
+export declare const PROBES_SUB_FLAG = "A3D_QR_LIGHTING_PROBES";
+export declare const PROBE_SELECTION_BLACKBOARD_KEY = "prd02.probeSelection";
+export declare const IRRADIANCE_VOLUME_BLACKBOARD_KEY = "prd02.irradianceVolume";
+export declare const PROBE_RENDER_FACE_KEY = "prd02.probeRenderFace";
+/** PRD-03 SSR seam (§6.6 hand-off): dominant specular env for the frame. */
+export declare const ENV_SPECULAR_BLACKBOARD_KEY = "prd02.envSpecular";
+/** PRD-03 SSR seam: roughness → probe mip LOD. */
+export declare const ROUGHNESS_TO_LOD_BLACKBOARD_KEY = "prd02.roughnessToLod";
+/**
+ * 02-S12: per-item `a3d_prd02_probe_box` uniforms (Map<RenderItem, bindings>)
+ * for the forward consumer — lane 01's per-item env override reads this.
+ */
+export declare const PROBE_BINDINGS_BLACKBOARD_KEY = "prd02.probeBindings";
+/** The frame host (production runtime) installs the scene's face renderer —
+ *  the same closure C-09 `EnvironmentCaptureRequest.renderFace` delegates to. */
+export declare function installPrd02ProbeRenderer(fn: ReflectionFaceRenderer | null): void;
+interface AuraProbeNodeLike {
+    readonly kind: "probe";
+    readonly probe: "reflection" | "irradiance-volume";
+    readonly name: string;
+    readonly options: Record<string, unknown>;
+}
+/** Probe nodes compiled by the lane's C-36 handler land on the source as
+ *  `prd02.probes.<name>`. */
+export declare function probeNodesFromSource(ctx: Pick<FrameContributorContext, "source">): readonly AuraProbeNodeLike[];
+/** Lane-01 Renderer surface the pre-frame capture uses (#1115 `renderProbeFace`). */
+export interface Prd02ProbeCaptureRenderer {
+    readonly device: RenderDevice;
+    renderProbeFace(source: RenderSource, face: 0 | 1 | 2 | 3 | 4 | 5, target: RenderTarget, viewProjection: Float32Array): unknown;
+}
+/**
+ * 02-S12 pre-frame driver: call BEFORE `Renderer.render` (frame host hook,
+ * #1113). Registers the source's reflection/irradiance probe nodes and
+ * advances dirty captures through lane 01's `renderProbeFace`, which owns its
+ * own device frame and private graph (so this must not run inside a frame).
+ */
+export declare function prd02BeforeFrame(renderer: Prd02ProbeCaptureRenderer, source: RenderSource, flags: FrameContributorContext["flags"]): readonly string[];
+/**
+ * Collect phase: each item inside a captured probe's influence gets that
+ * probe's specular cube as its per-draw `environmentCube` (lane 01 #1115
+ * legacy override). The legacy shader binds one cube without parallax
+ * correction, so the dominant probe wins; box projection + 2-probe blending
+ * come with the `a3d_prd02_probe_box` chunk on the generator path.
+ */
+export declare function applyProbeEnvironmentCubes(items: readonly RenderItem[], device: RenderDevice): RenderItem[];
+export declare function createPrd02ProbesContributor(): FrameContributor;
+export {};
+//# sourceMappingURL=Prd02ProbesContributor.d.ts.map

package/dist/probes/Prd02ProbesContributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02ProbesContributor.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/probes/Prd02ProbesContributor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAKjC,eAAO,MAAM,eAAe,2BAA2B,CAAC;AACxD,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AACrE,eAAO,MAAM,gCAAgC,2BAA2B,CAAC;AACzE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAC/D,kDAAkD;AAClD,eAAO,MAAM,+BAA+B,yBAAyB,CAAC;AACtE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAUnE;iFACiF;AACjF,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAGjF;AAgBD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,mBAAmB,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;6BAC6B;AAC7B,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAW/G;AAsCD,qFAAqF;AACrF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,GAAG,OAAO,CAAC;CACjI;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,yBAAyB,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,MAAM,EAAE,CAmBtJ;AAoBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,EAAE,CAkB3G;AA2CD,wBAAgB,4BAA4B,IAAI,gBAAgB,CAmB/D"}

package/dist/probes/Prd02ProbesContributor.js

@@ -0,0 +1,241 @@
+// PRD-02 §6.6 — `prd02.probes` frame contributor (phase `shadows`, flag
+// `A3D_QR_LIGHTING`, sub-flag `A3D_QR_LIGHTING_PROBES`). Drives
+// ReflectionProbeSystem captures and IrradianceVolume bakes from probe nodes
+// compiled into the RenderSource (`prd02.probes.<name>` contributions), then
+// publishes per-item probe assignments on the blackboard for the shading
+// seam (`prd02.probeSelection`) plus `prd02.irradianceVolume`.
+// The scene-side `renderFace` callback arrives through the blackboard —
+// `prd02.probeRenderFace` (the frame host supplies the C-09 capture seam).
+import { BaseRenderPass } from "../RenderPass.js";
+import { Sampler } from "../Sampler.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { ReflectionProbeSystem } from "./ReflectionProbeSystem.js";
+import { IrradianceVolumeSystem } from "./IrradianceVolume.js";
+import { prd02CaptureDirtyProbes, prd02ProbeBindings } from "./ProbeBoxProjection.js";
+import { prd02SubFlagOff, readPrd02KillSwitches, SUB_FLAG_PROBES } from "../passes/Prd02SubFlags.js";
+export const PROBES_SUB_FLAG = "A3D_QR_LIGHTING_PROBES";
+export const PROBE_SELECTION_BLACKBOARD_KEY = "prd02.probeSelection";
+export const IRRADIANCE_VOLUME_BLACKBOARD_KEY = "prd02.irradianceVolume";
+export const PROBE_RENDER_FACE_KEY = "prd02.probeRenderFace";
+/** PRD-03 SSR seam (§6.6 hand-off): dominant specular env for the frame. */
+export const ENV_SPECULAR_BLACKBOARD_KEY = "prd02.envSpecular";
+/** PRD-03 SSR seam: roughness → probe mip LOD. */
+export const ROUGHNESS_TO_LOD_BLACKBOARD_KEY = "prd02.roughnessToLod";
+/**
+ * 02-S12: per-item `a3d_prd02_probe_box` uniforms (Map<RenderItem, bindings>)
+ * for the forward consumer — lane 01's per-item env override reads this.
+ */
+export const PROBE_BINDINGS_BLACKBOARD_KEY = "prd02.probeBindings";
+const systems = new WeakMap();
+let pendingRenderer = null;
+/** The frame host (production runtime) installs the scene's face renderer —
+ *  the same closure C-09 `EnvironmentCaptureRequest.renderFace` delegates to. */
+export function installPrd02ProbeRenderer(fn) {
+    pendingRenderer = fn;
+    if (!fn)
+        systemsResetAll();
+}
+function systemsResetAll() { }
+function stateFor(device, renderer) {
+    let state = systems.get(device);
+    if (!state) {
+        state = {
+            reflections: new ReflectionProbeSystem(device, renderer),
+            irradiance: new IrradianceVolumeSystem(device, renderer)
+        };
+        systems.set(device, state);
+    }
+    return state;
+}
+/** Probe nodes compiled by the lane's C-36 handler land on the source as
+ *  `prd02.probes.<name>`. */
+export function probeNodesFromSource(ctx) {
+    const source = ctx.source;
+    const out = [];
+    for (const key of Object.keys(source)) {
+        if (!key.startsWith("prd02.probes."))
+            continue;
+        const node = source[key];
+        if (node && typeof node === "object" && node.kind === "probe") {
+            out.push(node);
+        }
+    }
+    return out;
+}
+function specFromNode(node) {
+    const o = node.options;
+    const position = (o.position ?? [0, 0, 0]);
+    const half = (o.boxHalfExtents ?? o.extent ?? [2, 2, 2]);
+    const update = o.update === "on-demand" ? "on-demand"
+        : o.update === "every-n-frames" ? "every-n-frames" : "once";
+    const resolution = o.resolution === 256 ? 256 : 128;
+    return {
+        name: node.name,
+        position,
+        boxHalfExtents: half,
+        blendDistance: typeof o.blendDistance === "number" ? o.blendDistance : 1,
+        ...(typeof o.priority === "number" ? { priority: o.priority } : {}),
+        ...(typeof o.intensity === "number" ? { intensity: o.intensity } : {}),
+        update,
+        resolution,
+        ...(typeof o.near === "number" ? { near: o.near } : {}),
+        ...(typeof o.far === "number" ? { far: o.far } : {})
+    };
+}
+function irradianceSpecFromNode(node) {
+    const o = node.options;
+    const min = (o.min ?? [-2, -2, -2]);
+    const max = (o.max ?? [2, 2, 2]);
+    const res = Array.isArray(o.resolution) ? o.resolution : o.density;
+    return {
+        name: node.name,
+        min,
+        max,
+        ...(Array.isArray(res) ? { resolution: res } : {}),
+        ...(typeof o.intensity === "number" ? { intensity: o.intensity } : {}),
+        update: o.update === "on-demand" ? "on-demand" : "once"
+    };
+}
+/** Source the capture renders (updated every frame before captures run). */
+const captureSources = new WeakMap();
+/** Devices whose probes were captured pre-frame this frame (the pass then only publishes). */
+const capturedPreFrame = new WeakSet();
+/**
+ * 02-S12 pre-frame driver: call BEFORE `Renderer.render` (frame host hook,
+ * #1113). Registers the source's reflection/irradiance probe nodes and
+ * advances dirty captures through lane 01's `renderProbeFace`, which owns its
+ * own device frame and private graph (so this must not run inside a frame).
+ */
+export function prd02BeforeFrame(renderer, source, flags) {
+    if (prd02SubFlagOff(flags, SUB_FLAG_PROBES) || !readPrd02KillSwitches(source).probes)
+        return [];
+    const nodes = probeNodesFromSource({ source });
+    if (nodes.length === 0)
+        return [];
+    let slot = captureSources.get(renderer.device);
+    if (!slot) {
+        slot = { source: null };
+        captureSources.set(renderer.device, slot);
+    }
+    slot.source = source;
+    const holder = slot;
+    const state = stateFor(renderer.device, (face, target, viewProjection) => {
+        if (holder.source)
+            renderer.renderProbeFace(holder.source, face, target, viewProjection);
+    });
+    registerProbeNodes(state, nodes);
+    const changed = prd02CaptureDirtyProbes(state.reflections);
+    state.irradiance.update();
+    capturedPreFrame.add(renderer.device);
+    return changed;
+}
+function registerProbeNodes(state, nodes) {
+    for (const node of nodes) {
+        if (node.probe === "reflection") {
+            const spec = specFromNode(node);
+            if (spec)
+                state.reflections.register(spec);
+        }
+        else {
+            state.irradiance.configure(irradianceSpecFromNode(node));
+        }
+    }
+}
+const PROBE_CUBE_SAMPLER = new Sampler({
+    minFilter: "linear-mipmap-linear",
+    magFilter: "linear",
+    addressU: "clamp-to-edge",
+    addressV: "clamp-to-edge"
+});
+/**
+ * Collect phase: each item inside a captured probe's influence gets that
+ * probe's specular cube as its per-draw `environmentCube` (lane 01 #1115
+ * legacy override). The legacy shader binds one cube without parallax
+ * correction, so the dominant probe wins; box projection + 2-probe blending
+ * come with the `a3d_prd02_probe_box` chunk on the generator path.
+ */
+export function applyProbeEnvironmentCubes(items, device) {
+    const state = systems.get(device);
+    if (!state || state.reflections.probes().length === 0)
+        return [...items];
+    return items.map((item) => {
+        const assignment = state.reflections.assign(item);
+        const dominant = assignment.a;
+        if (!dominant || dominant.weight < assignment.globalWeight)
+            return item;
+        return {
+            ...item,
+            environmentCube: new TextureBinding({
+                name: "u_environmentCubeMapTexture",
+                texture: dominant.probe.specularCube,
+                required: false,
+                sampler: PROBE_CUBE_SAMPLER
+            }),
+            environmentCubeMip: dominant.probe.mipCount
+        };
+    });
+}
+class Prd02ProbesRenderPass extends BaseRenderPass {
+    ctx;
+    constructor(ctx) {
+        super("prd02.probes", [], []);
+        this.ctx = ctx;
+    }
+    execute(_context) {
+        const ctx = this.ctx;
+        let state;
+        if (capturedPreFrame.has(ctx.device)) {
+            // 02-S12: prd02BeforeFrame already captured outside the frame.
+            capturedPreFrame.delete(ctx.device);
+            state = systems.get(ctx.device);
+        }
+        else {
+            const renderer = (ctx.blackboard.get(PROBE_RENDER_FACE_KEY) ?? pendingRenderer);
+            if (!renderer)
+                return;
+            state = stateFor(ctx.device, renderer);
+            registerProbeNodes(state, probeNodesFromSource(ctx));
+            state.reflections.update();
+            state.irradiance.update();
+        }
+        if (!state)
+            return;
+        const assignments = new Map();
+        const bindings = new Map();
+        for (const item of ctx.items) {
+            const assignment = state.reflections.assign(item);
+            assignments.set(item, assignment);
+            if (assignment.a || assignment.b)
+                bindings.set(item, prd02ProbeBindings(assignment));
+        }
+        ctx.blackboard.set(PROBE_SELECTION_BLACKBOARD_KEY, assignments);
+        ctx.blackboard.set(PROBE_BINDINGS_BLACKBOARD_KEY, bindings);
+        if (state.irradiance.get())
+            ctx.blackboard.set(IRRADIANCE_VOLUME_BLACKBOARD_KEY, state.irradiance.get());
+        // §6.6 hand-off for PRD-03 SSR: the dominant captured env (first probe,
+        // else null) + the roughness→LOD map against its mip chain.
+        const dominant = state.reflections.probes()[0] ?? null;
+        ctx.blackboard.set(ENV_SPECULAR_BLACKBOARD_KEY, dominant ? dominant.specularCube : null);
+        const mips = dominant ? dominant.mipCount : 1;
+        ctx.blackboard.set(ROUGHNESS_TO_LOD_BLACKBOARD_KEY, (roughness) => Math.min(Math.max(roughness, 0), 1) * (mips - 1));
+    }
+}
+export function createPrd02ProbesContributor() {
+    return {
+        id: "prd02.probes",
+        owner: "prd02",
+        flag: "A3D_QR_LIGHTING",
+        phases: ["collect", "shadows"],
+        order: -1, // capture before the shadow pass consumes probe-relevant state
+        collect: (items, ctx) => !prd02SubFlagOff(ctx.flags, SUB_FLAG_PROBES) && readPrd02KillSwitches(ctx.source).probes
+            ? applyProbeEnvironmentCubes(items, ctx.device)
+            : items,
+        passes: (phase, ctx) => phase === "shadows"
+            && !prd02SubFlagOff(ctx.flags, SUB_FLAG_PROBES)
+            && readPrd02KillSwitches(ctx.source).probes
+            && probeNodesFromSource(ctx).length > 0
+            ? [new Prd02ProbesRenderPass(ctx)]
+            : []
+    };
+}
+//# sourceMappingURL=Prd02ProbesContributor.js.map

package/dist/probes/Prd02ProbesContributor.js.map

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

package/dist/probes/ProbeBoxProjection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 02-S12 — box-projected reflection probes (PRD-02 §6.6), lane-02 pieces:
+ *
+ *  - `a3d_prd02_probe_box` chunk: parallax-corrected (box-projected) lookup
+ *    direction against a probe's influence box, plus the ≤ 2-probe blend with
+ *    the global environment weight. The CPU twin `boxProjectDirection`
+ *    mirrors the GLSL exactly (unit-tested; the browser spec compares pixels).
+ *  - `prd02ProbeBindings(assignment)`: per-item uniforms for the chunk from a
+ *    `ReflectionProbeSystem.assign` result (the `prd02.probeSelection` map).
+ *  - `prd02CaptureDirtyProbes(...)`: the pre-frame capture driver. Captures
+ *    can't run inside the frame graph (a nested Renderer.render would clear the
+ *    graph and nest beginFrame), so the frame host calls this BEFORE
+ *    `Renderer.render` with a face-render callback.
+ *
+ * Flag: A3D_QR_LIGHTING (+ sub-flag A3D_QR_LIGHTING_PROBES).
+ */
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { ShaderChunk } from "../contracts/program.js";
+import type { ProbeAssignment, ReflectionFaceRenderer } from "./ReflectionProbeSystem.js";
+export declare const PROBE_BOX_CHUNK = "a3d_prd02_probe_box";
+export declare const PROBE_BOX_CHUNK_GLSL = "\n// Probe A / B (u_prd02ProbeWeights.xy) and the global env weight (.z).\nuniform samplerCube u_prd02ProbeCubeA;\nuniform samplerCube u_prd02ProbeCubeB;\nuniform vec4 u_prd02ProbeCenterA;   // xyz center, w = 1 when bound\nuniform vec4 u_prd02ProbeHalfA;     // xyz box half-extents\nuniform vec4 u_prd02ProbeCenterB;\nuniform vec4 u_prd02ProbeHalfB;\nuniform vec4 u_prd02ProbeWeights;   // x: A, y: B, z: global, w: probe mip count\n\n// Parallax correction: intersect the ray (worldPos, R) with the probe box and\n// return the direction from the probe center to the hit point.\nvec3 a3d_boxProjectDirection(vec3 worldPos, vec3 R, vec3 center, vec3 halfExtents) {\n  vec3 boxMin = center - halfExtents;\n  vec3 boxMax = center + halfExtents;\n  vec3 invR = 1.0 / max(abs(R), vec3(1e-6)) * sign(R + vec3(1e-12));\n  vec3 tMax = (boxMax - worldPos) * invR;\n  vec3 tMin = (boxMin - worldPos) * invR;\n  vec3 tFar = max(tMax, tMin);\n  float t = min(min(tFar.x, tFar.y), tFar.z);\n  vec3 hit = worldPos + R * max(t, 0.0);\n  return hit - center;\n}\n\n// Blended probe specular radiance; the caller adds global * envRadiance.\nvec3 a3d_probeSpecular(vec3 worldPos, vec3 R, float roughness) {\n  float lod = roughness * max(u_prd02ProbeWeights.w - 1.0, 0.0);\n  vec3 sum = vec3(0.0);\n  if (u_prd02ProbeWeights.x > 0.0) {\n    vec3 d = a3d_boxProjectDirection(worldPos, R, u_prd02ProbeCenterA.xyz, u_prd02ProbeHalfA.xyz);\n    sum += u_prd02ProbeWeights.x * textureLod(u_prd02ProbeCubeA, d, lod).rgb;\n  }\n  if (u_prd02ProbeWeights.y > 0.0) {\n    vec3 d = a3d_boxProjectDirection(worldPos, R, u_prd02ProbeCenterB.xyz, u_prd02ProbeHalfB.xyz);\n    sum += u_prd02ProbeWeights.y * textureLod(u_prd02ProbeCubeB, d, lod).rgb;\n  }\n  return sum;\n}\n\nfloat a3d_probeGlobalWeight() { return u_prd02ProbeWeights.z; }\n";
+export declare const PROBE_BOX_SHADER_CHUNK: ShaderChunk;
+type Vec3 = readonly [number, number, number];
+/** CPU twin of `a3d_boxProjectDirection` (same math, same epsilons). */
+export declare function boxProjectDirection(worldPos: Vec3, R: Vec3, center: Vec3, halfExtents: Vec3): [number, number, number];
+export type ProbeUniformValue = Float32Array | number | {
+    readonly texture: unknown;
+} | null;
+/**
+ * Per-item chunk uniforms from a `ReflectionProbeSystem.assign` result. Cube
+ * values are the probes' `specularCube` textures (bound by the consumer as
+ * samplers); unbound slots get weight 0 and center.w = 0.
+ */
+export declare function prd02ProbeBindings(assignment: ProbeAssignment): Record<string, ProbeUniformValue>;
+/**
+ * Face renderer the frame host provides (lane 01 Renderer probe-capture entry
+ * point): render the scene for cube `face` with `viewProjection` into
+ * `target` (an off-viewport-size rgba16f target). Must run outside
+ * `Renderer.render`.
+ */
+export type Prd02ProbeFaceRenderer = ReflectionFaceRenderer;
+/** Minimal surface of the probe system the driver needs. */
+export interface Prd02ProbeCaptureSystem {
+    update(): readonly string[];
+}
+/**
+ * Pre-frame capture driver: advances dirty probe captures (whole cube for
+ * once/on-demand, one face for every-n-frames) using `renderFace`, BEFORE the
+ * frame's `Renderer.render`. Returns the probes that changed.
+ */
+export declare function prd02CaptureDirtyProbes(system: Prd02ProbeCaptureSystem): readonly string[];
+export type { RenderDevice, RenderTarget };
+//# sourceMappingURL=ProbeBoxProjection.d.ts.map

package/dist/probes/ProbeBoxProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProbeBoxProjection.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/probes/ProbeBoxProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,eAAO,MAAM,oBAAoB,0xDAwChC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,WAKpC,CAAC;AAEF,KAAK,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAetH;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAmBjG;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE5D,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,MAAM,IAAI,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,SAAS,MAAM,EAAE,CAE1F;AAED,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/probes/ProbeBoxProjection.js

@@ -0,0 +1,99 @@
+export const PROBE_BOX_CHUNK = "a3d_prd02_probe_box";
+export const PROBE_BOX_CHUNK_GLSL = /* glsl */ `
+// Probe A / B (u_prd02ProbeWeights.xy) and the global env weight (.z).
+uniform samplerCube u_prd02ProbeCubeA;
+uniform samplerCube u_prd02ProbeCubeB;
+uniform vec4 u_prd02ProbeCenterA;   // xyz center, w = 1 when bound
+uniform vec4 u_prd02ProbeHalfA;     // xyz box half-extents
+uniform vec4 u_prd02ProbeCenterB;
+uniform vec4 u_prd02ProbeHalfB;
+uniform vec4 u_prd02ProbeWeights;   // x: A, y: B, z: global, w: probe mip count
+
+// Parallax correction: intersect the ray (worldPos, R) with the probe box and
+// return the direction from the probe center to the hit point.
+vec3 a3d_boxProjectDirection(vec3 worldPos, vec3 R, vec3 center, vec3 halfExtents) {
+  vec3 boxMin = center - halfExtents;
+  vec3 boxMax = center + halfExtents;
+  vec3 invR = 1.0 / max(abs(R), vec3(1e-6)) * sign(R + vec3(1e-12));
+  vec3 tMax = (boxMax - worldPos) * invR;
+  vec3 tMin = (boxMin - worldPos) * invR;
+  vec3 tFar = max(tMax, tMin);
+  float t = min(min(tFar.x, tFar.y), tFar.z);
+  vec3 hit = worldPos + R * max(t, 0.0);
+  return hit - center;
+}
+
+// Blended probe specular radiance; the caller adds global * envRadiance.
+vec3 a3d_probeSpecular(vec3 worldPos, vec3 R, float roughness) {
+  float lod = roughness * max(u_prd02ProbeWeights.w - 1.0, 0.0);
+  vec3 sum = vec3(0.0);
+  if (u_prd02ProbeWeights.x > 0.0) {
+    vec3 d = a3d_boxProjectDirection(worldPos, R, u_prd02ProbeCenterA.xyz, u_prd02ProbeHalfA.xyz);
+    sum += u_prd02ProbeWeights.x * textureLod(u_prd02ProbeCubeA, d, lod).rgb;
+  }
+  if (u_prd02ProbeWeights.y > 0.0) {
+    vec3 d = a3d_boxProjectDirection(worldPos, R, u_prd02ProbeCenterB.xyz, u_prd02ProbeHalfB.xyz);
+    sum += u_prd02ProbeWeights.y * textureLod(u_prd02ProbeCubeB, d, lod).rgb;
+  }
+  return sum;
+}
+
+float a3d_probeGlobalWeight() { return u_prd02ProbeWeights.z; }
+`;
+export const PROBE_BOX_SHADER_CHUNK = {
+    name: PROBE_BOX_CHUNK,
+    owner: "prd02",
+    stage: "fragment",
+    glsl: PROBE_BOX_CHUNK_GLSL
+};
+/** CPU twin of `a3d_boxProjectDirection` (same math, same epsilons). */
+export function boxProjectDirection(worldPos, R, center, halfExtents) {
+    const tFar = [];
+    for (let i = 0; i < 3; i += 1) {
+        const r = R[i];
+        const inv = (1 / Math.max(Math.abs(r), 1e-6)) * Math.sign(r + 1e-12);
+        const tMax = (center[i] + halfExtents[i] - worldPos[i]) * inv;
+        const tMin = (center[i] - halfExtents[i] - worldPos[i]) * inv;
+        tFar.push(Math.max(tMax, tMin));
+    }
+    const t = Math.max(Math.min(tFar[0], tFar[1], tFar[2]), 0);
+    return [
+        worldPos[0] + R[0] * t - center[0],
+        worldPos[1] + R[1] * t - center[1],
+        worldPos[2] + R[2] * t - center[2]
+    ];
+}
+/**
+ * Per-item chunk uniforms from a `ReflectionProbeSystem.assign` result. Cube
+ * values are the probes' `specularCube` textures (bound by the consumer as
+ * samplers); unbound slots get weight 0 and center.w = 0.
+ */
+export function prd02ProbeBindings(assignment) {
+    const slot = (selection) => ({
+        cube: selection ? selection.probe.specularCube : null,
+        center: new Float32Array(selection ? [...selection.spec.position, 1] : [0, 0, 0, 0]),
+        half: new Float32Array(selection ? [...selection.spec.boxHalfExtents, 0] : [0, 0, 0, 0]),
+        weight: selection ? selection.weight * (selection.spec.intensity ?? 1) : 0,
+        mips: selection ? selection.probe.mipCount : 1
+    });
+    const a = slot(assignment.a);
+    const b = slot(assignment.b);
+    return {
+        u_prd02ProbeCubeA: a.cube ? { texture: a.cube } : null,
+        u_prd02ProbeCubeB: b.cube ? { texture: b.cube } : null,
+        u_prd02ProbeCenterA: a.center,
+        u_prd02ProbeHalfA: a.half,
+        u_prd02ProbeCenterB: b.center,
+        u_prd02ProbeHalfB: b.half,
+        u_prd02ProbeWeights: new Float32Array([a.weight, b.weight, assignment.globalWeight, Math.max(a.mips, b.mips)])
+    };
+}
+/**
+ * Pre-frame capture driver: advances dirty probe captures (whole cube for
+ * once/on-demand, one face for every-n-frames) using `renderFace`, BEFORE the
+ * frame's `Renderer.render`. Returns the probes that changed.
+ */
+export function prd02CaptureDirtyProbes(system) {
+    return system.update();
+}
+//# sourceMappingURL=ProbeBoxProjection.js.map

package/dist/probes/ProbeBoxProjection.js.map

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

package/dist/probes/ReflectionProbeSystem.d.ts

@@ -0,0 +1,64 @@
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+import type { EnvironmentProbe } from "../contracts/environment.js";
+export type ProbeUpdateMode = "once" | "on-demand" | "every-n-frames";
+export interface ReflectionProbeSpec {
+    readonly name: string;
+    readonly position: readonly [number, number, number];
+    /** Box half-extents around `position` — the probe's influence volume. */
+    readonly boxHalfExtents: readonly [number, number, number];
+    readonly blendDistance: number;
+    readonly priority?: number;
+    readonly intensity?: number;
+    readonly update?: ProbeUpdateMode;
+    readonly resolution?: 128 | 256;
+    readonly near?: number;
+    readonly far?: number;
+}
+export interface ProbeSelection {
+    readonly probe: EnvironmentProbe;
+    readonly spec: ReflectionProbeSpec;
+    readonly weight: number;
+}
+export interface ProbeAssignment {
+    readonly a: ProbeSelection | null;
+    readonly b: ProbeSelection | null;
+    /** Weight left for the global environment (1 − sum of probe weights). */
+    readonly globalWeight: number;
+}
+export type ReflectionFaceRenderer = (face: 0 | 1 | 2 | 3 | 4 | 5, target: RenderTarget, viewProjection: Float32Array) => void;
+export declare class ReflectionProbeSystem {
+    private readonly device;
+    private readonly renderFace;
+    private readonly options;
+    private readonly entries;
+    constructor(device: RenderDevice, renderFace: ReflectionFaceRenderer, options?: {
+        readonly defaultFaceSize?: 128 | 256;
+    });
+    register(spec: ReflectionProbeSpec): void;
+    unregister(name: string): void;
+    /** `app.lighting.updateProbe(name)` — flags an on-demand probe dirty. */
+    updateProbe(name: string): void;
+    probes(): readonly EnvironmentProbe[];
+    count(): number;
+    /** Advance captures: whole 6 faces for once/on-demand; 1 face per call for
+     *  `every-n-frames` (time-sliced). Returns names whose probe changed. */
+    update(): readonly string[];
+    private captureFace;
+    private finish;
+    /**
+     * Per-item probe pick (PRD §6.6): the 2 nearest probes whose influence box
+     * overlaps the item, weighted by box distance with `blendDistance`
+     * falloff; the rest of the weight goes to the global environment.
+     * On WebGL2 at most 2 probe cubes bind per draw — selection is CPU-side.
+     */
+    assign(item: {
+        readonly position?: readonly [number, number, number];
+        readonly modelMatrix?: Float32Array | readonly number[];
+    }): ProbeAssignment;
+}
+/** Weight by box distance: 1 inside, linear falloff over `blendDistance`
+ *  metres outside the box, 0 beyond it. */
+export declare function boxWeight(spec: ReflectionProbeSpec, p: readonly [number, number, number]): number;
+/** Vertical flip of an RGBA float image (GL bottom-up → top-down rows). */
+export declare function flipRows(pixels: Float32Array, width: number, height: number): Float32Array;
+//# sourceMappingURL=ReflectionProbeSystem.d.ts.map

package/dist/probes/ReflectionProbeSystem.d.ts.map

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