@aura3d/rendering 3.0.0 → 4.0.0

package/dist/output/HdrTarget.js

@@ -0,0 +1,48 @@
+/**
+ * `output/HdrTarget.ts` (PRD-01 §6.4/§8.4, C-05) — the linear-HDR scene target
+ * under `A3D_QR_CORE_OUTPUT`: color attachment 0 is the probed HDR format
+ * (`rgba16f` when the `hdr-render-targets` capability exists; the
+ * `r11f_g11f_b10f` middle rung of the contract probe is not representable by
+ * `RenderTargetDescriptor.colorAttachments`, so the probe collapses to
+ * `rgba16f`/`rgba8`), depth as a sampleable `depthTexture`, optional MSAA
+ * `sampleCount`, and — when `backgroundCoverage` is on — a second `rgba8`
+ * attachment at location 1 written by generated programs (`outCoverage`).
+ * The target is resized lazily to the render-scale dimensions.
+ */
+import { probeHdrTargetFormat } from "../contracts/output.js";
+export function createHdrTarget(device, options) {
+    const format = probeHdrTargetFormat(device);
+    const coverage = options.coverage === true;
+    return device.createRenderTarget({
+        label: "prd01-hdr-scene",
+        width: Math.max(1, Math.floor(options.width)),
+        height: Math.max(1, Math.floor(options.height)),
+        format: "rgba8", // overridden per-attachment by colorAttachments[0]
+        colorAttachments: coverage
+            ? [{ format: format === "r11f_g11f_b10f" ? "rgba16f" : format }, { format: "rgba8" }]
+            : [{ format: format === "r11f_g11f_b10f" ? "rgba16f" : format }],
+        depth: "texture",
+        sampleCount: Math.max(1, Math.floor(options.sampleCount ?? 1))
+    });
+}
+/**
+ * Cached-per-call-site helper: returns `current` unchanged when it already
+ * matches the requested size/options, else disposes and recreates it.
+ */
+export function ensureHdrTarget(device, current, options) {
+    const width = Math.max(1, Math.floor(options.width));
+    const height = Math.max(1, Math.floor(options.height));
+    const sampleCount = Math.max(1, Math.floor(options.sampleCount ?? 1));
+    const coverage = options.coverage === true;
+    const matches = current !== null &&
+        !current.disposed &&
+        current.width === width &&
+        current.height === height &&
+        (current.sampleCount ?? 1) === sampleCount &&
+        (current.colorTextures?.length ?? 1) === (coverage ? 2 : 1);
+    if (matches)
+        return current;
+    current?.dispose();
+    return createHdrTarget(device, { ...options, width, height, coverage, sampleCount });
+}
+//# sourceMappingURL=HdrTarget.js.map

package/dist/output/HdrTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HdrTarget.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/output/HdrTarget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAW3D,MAAM,UAAU,eAAe,CAAC,MAAoB,EAAE,OAAyB;IAC7E,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC3C,OAAO,MAAM,CAAC,kBAAkB,CAAC;QAC/B,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,mDAAmD;QACpE,gBAAgB,EAAE,QAAQ;YACxB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YACrF,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClE,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAoB,EACpB,OAA4B,EAC5B,OAAyB;IAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC3C,MAAM,OAAO,GACX,OAAO,KAAK,IAAI;QAChB,CAAC,OAAO,CAAC,QAAQ;QACjB,OAAO,CAAC,KAAK,KAAK,KAAK;QACvB,OAAO,CAAC,MAAM,KAAK,MAAM;QACzB,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,WAAW;QAC1C,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AACvF,CAAC"}

package/dist/output/OutputPass.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `output/OutputPass.ts` (PRD-01 §8.6, C-05) — the single encode point under
+ * `A3D_QR_CORE_OUTPUT`. Reads the linear-HDR scene target (`u_scene`), applies
+ * `u_exposure`, the selected tone-map operator (`TONE_MAP` define), optional
+ * BACKGROUND_COVERAGE mix (`u_coverage`, R8), triangular dither
+ * (`u_dither > 0.5`, one LSB of 8-bit), and the C-05 juice overlay — then writes
+ * sRGB-encoded LDR to the canvas (or an LDR target). Programs are cached per
+ * variant key `{toneMapping, coverage, overlay}` per device.
+ */
+import type { OutputPassLike, OutputPassOptions } from "../contracts/output.js";
+import type { DisposableResource, RenderDevice, RenderTarget } from "../RenderDevice.js";
+export declare class OutputPass implements OutputPassLike, DisposableResource {
+    private readonly device;
+    private readonly modules;
+    private readonly drawCache;
+    disposed: boolean;
+    constructor(device: RenderDevice);
+    /**
+     * @param input   linear-HDR scene target (attachment 0).
+     * @param coverage BACKGROUND_COVERAGE source — either `input` itself (MRT
+     *                 attachment 1 is sampled) or a single-attachment rgba8 target.
+     * @param output  `"canvas"` presents to the default framebuffer.
+     */
+    execute(input: RenderTarget, coverage: RenderTarget | null, options: OutputPassOptions, output: RenderTarget | "canvas"): void;
+    private moduleFor;
+    dispose(): void;
+}
+//# sourceMappingURL=OutputPass.d.ts.map

package/dist/output/OutputPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/output/OutputPass.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAGV,cAAc,EACd,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAgB,MAAM,iBAAiB,CAAC;AAmDpG,qBAAa,UAAW,YAAW,cAAc,EAAE,kBAAkB;IAKvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyF;IAC5G,QAAQ,UAAS;gBAEK,MAAM,EAAE,YAAY;IAEjD;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;IAmD9H,OAAO,CAAC,SAAS;IAmBjB,OAAO,IAAI,IAAI;CAQhB"}

package/dist/output/OutputPass.js

@@ -0,0 +1,142 @@
+/**
+ * `output/OutputPass.ts` (PRD-01 §8.6, C-05) — the single encode point under
+ * `A3D_QR_CORE_OUTPUT`. Reads the linear-HDR scene target (`u_scene`), applies
+ * `u_exposure`, the selected tone-map operator (`TONE_MAP` define), optional
+ * BACKGROUND_COVERAGE mix (`u_coverage`, R8), triangular dither
+ * (`u_dither > 0.5`, one LSB of 8-bit), and the C-05 juice overlay — then writes
+ * sRGB-encoded LDR to the canvas (or an LDR target). Programs are cached per
+ * variant key `{toneMapping, coverage, overlay}` per device.
+ */
+import { DEFAULT_TONE_MAPPING } from "../contracts/output.js";
+import { Geometry } from "../Geometry.js";
+import { DEFAULT_RENDER_STATE } from "../Material.js";
+import { RenderPipeline } from "../RenderPipeline.js";
+import { ShaderModule } from "../ShaderModule.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { VertexBuffer } from "../VertexBuffer.js";
+import { VertexFormat } from "../VertexFormat.js";
+import { OUTPUT_VERTEX_GLSL, outputFragmentGlsl, TONE_MAP_OPERATOR_FUNCTIONS } from "./ToneMappingOperators.glsl.js";
+/** Q-01-1 (PRD 09 §8): CPU gates the overlay when every amount is below ~0.002. */
+const OVERLAY_AMOUNT_FLOOR = 1 / 512;
+const OUTPUT_RENDER_STATE = {
+    ...DEFAULT_RENDER_STATE,
+    blend: false,
+    depthTest: false,
+    depthWrite: false,
+    cullMode: "none"
+};
+function variantCacheKey(key) {
+    return `${key.toneMapping}|${key.coverage ? 1 : 0}|${key.overlay ? 1 : 0}`;
+}
+function createFullscreenTriangleGeometry() {
+    const vertices = new VertexBuffer(VertexFormat.P3, 3);
+    vertices.setAttribute(0, "position", [-1, -1, 0]);
+    vertices.setAttribute(1, "position", [3, -1, 0]);
+    vertices.setAttribute(2, "position", [-1, 3, 0]);
+    return new Geometry(vertices, null, "triangles", { min: [-1, -1, 0], max: [3, 3, 0] });
+}
+/** The overlay runs when any amount clears the floor; else `shape.w` is 0 (idle branch → bit-identical). */
+function overlayEnabledAmounts(overlay) {
+    return overlay.flash[3] >= OVERLAY_AMOUNT_FLOOR
+        || overlay.vignette[3] >= OVERLAY_AMOUNT_FLOOR
+        || overlay.fade[3] >= OVERLAY_AMOUNT_FLOOR;
+}
+function overlayUniforms(overlay, aspect, enabled, uniforms) {
+    uniforms.set("u_overlayFlash", [...overlay.flash]);
+    uniforms.set("u_overlayVignette", [...overlay.vignette]);
+    uniforms.set("u_overlayShape", [overlay.shape[0], overlay.shape[1], aspect, enabled ? 1 : 0]);
+    uniforms.set("u_overlayFade", [...overlay.fade]);
+}
+export class OutputPass {
+    device;
+    modules = new Map();
+    drawCache = new Map();
+    disposed = false;
+    constructor(device) {
+        this.device = device;
+    }
+    /**
+     * @param input   linear-HDR scene target (attachment 0).
+     * @param coverage BACKGROUND_COVERAGE source — either `input` itself (MRT
+     *                 attachment 1 is sampled) or a single-attachment rgba8 target.
+     * @param output  `"canvas"` presents to the default framebuffer.
+     */
+    execute(input, coverage, options, output) {
+        const toneMapping = options.toneMapping ?? DEFAULT_TONE_MAPPING;
+        const useCoverage = options.backgroundCoverage && coverage !== null;
+        const overlay = options.overlay ?? null;
+        const overlayActive = overlay !== null && overlayEnabledAmounts(overlay);
+        const key = { toneMapping, coverage: useCoverage, overlay: overlay !== null };
+        const cacheKey = variantCacheKey(key);
+        const shader = this.moduleFor(key).compile(this.device);
+        const uniforms = new Map();
+        uniforms.set("u_scene", new TextureBinding({ name: "u_scene", texture: input.colorTexture, required: true }));
+        if (useCoverage && coverage) {
+            const coverageTexture = coverage.colorTextures?.[1] ?? coverage.colorTexture;
+            uniforms.set("u_coverage", new TextureBinding({ name: "u_coverage", texture: coverageTexture, required: true }));
+        }
+        uniforms.set("u_exposure", options.exposure);
+        uniforms.set("u_dither", options.dithering ? 1 : 0);
+        if (overlay) {
+            overlayUniforms(overlay, input.width / Math.max(1, input.height), overlayActive, uniforms);
+        }
+        // Phase 6: persistent fullscreen geometry + pipeline per variant — zero
+        // RenderPipeline constructions and zero buffer creates in steady state.
+        let cached = this.drawCache.get(cacheKey);
+        if (!cached || cached.pipeline.shader !== shader) {
+            cached?.geometry.dispose();
+            const geometry = createFullscreenTriangleGeometry();
+            const pipeline = new RenderPipeline({
+                label: "prd01-output",
+                shader,
+                vertexFormat: geometry.vertexBuffer.format,
+                topology: geometry.topology,
+                renderState: OUTPUT_RENDER_STATE
+            });
+            cached = { geometry, pipeline };
+            this.drawCache.set(cacheKey, cached);
+        }
+        const command = cached.pipeline.createDrawCommand({
+            label: "prd01-output",
+            vertexBuffer: cached.geometry.vertexBuffer.upload(this.device),
+            vertexCount: cached.geometry.vertexBuffer.vertexCount,
+            uniforms
+        });
+        // T0-04: restore the previously bound target — rebinding `input` leaves
+        // the HDR source bound and misroutes every subsequent draw/capture.
+        const previousTarget = this.device.getRenderTarget?.() ?? null;
+        this.device.setRenderTarget(output === "canvas" ? null : output);
+        this.device.draw(command);
+        this.device.setRenderTarget(previousTarget);
+    }
+    moduleFor(key) {
+        const cacheKey = variantCacheKey(key);
+        let module = this.modules.get(cacheKey);
+        if (!module) {
+            module = new ShaderModule({
+                label: `prd01-output-${cacheKey}`,
+                marker: "a3d.output",
+                vertex: OUTPUT_VERTEX_GLSL,
+                fragment: outputFragmentGlsl({
+                    toneMapping: TONE_MAP_OPERATOR_FUNCTIONS[key.toneMapping] ? key.toneMapping : DEFAULT_TONE_MAPPING,
+                    backgroundCoverage: key.coverage,
+                    overlay: key.overlay
+                })
+            });
+            this.modules.set(cacheKey, module);
+        }
+        return module;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const module of this.modules.values())
+            module.dispose();
+        this.modules.clear();
+        for (const cached of this.drawCache.values())
+            cached.geometry.dispose();
+        this.drawCache.clear();
+    }
+}
+//# sourceMappingURL=OutputPass.js.map

package/dist/output/OutputPass.js.map

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

package/dist/output/ToneMappingOperators.glsl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `output/ToneMappingOperators.glsl.ts` (PRD-01 §8.6, C-05) — the OutputPass
+ * fragment shader source. Operator bodies are three.js r185 ports with the
+ * `color *= toneMappingExposure;` line removed (OutputPass applies
+ * `hdr * u_exposure` once before the operator). `TONE_MAP` is a `#define`
+ * selecting the operator; `BACKGROUND_COVERAGE` mixes to unmapped `clamp(hdr)`
+ * outside drawn coverage (§6.5); `OUTPUT_OVERLAY` runs the C-05 juice overlay
+ * after encode (Q-01-1 reference GLSL adapted — the uniforms are the C-05
+ * `OutputOverlayUniforms`, shape packed as `[inner, softness, aspect, on]`).
+ */
+export declare const OUTPUT_VERTEX_GLSL = "#version 300 es\n// a3d.output\nlayout(location = 0) in vec3 a_position;\nout vec2 v_uv;\nvoid main() {\n  v_uv = a_position.xy * 0.5 + 0.5;\n  gl_Position = vec4(a_position, 1.0);\n}\n";
+export declare const TONE_MAPPING_OPERATORS_GLSL = "// r185 tonemapping_pars_fragment, exposure lines removed (PRD-01 \u00A78.6).\n// \"none\" is a pass-through (still clamped at the OETF); \"linear\" saturates.\nvec3 NoneToneMapping(vec3 color) { return color; }\nvec3 LinearToneMapping(vec3 color) { return saturate(color); }\n\n// source: https://www.cs.utah.edu/docs/techreports/2002/pdf/UUCS-02-001.pdf\nvec3 ReinhardToneMapping(vec3 color) {\n  return saturate( color / ( vec3( 1.0 ) + color ) );\n}\n\n// source: https://github.com/selfshadow/ltc_code/blob/master/webgl/shaders/ltc/ltc_blit.fs\nvec3 RRTAndODTFit( vec3 v ) {\n  vec3 a = v * ( v + 0.0245786 ) - 0.000090537;\n  vec3 b = v * ( 0.983729 * v + 0.4329510 ) + 0.238081;\n  return a / b;\n}\n\n// this implementation of ACES is modified to accommodate a brighter viewing environment.\n// the scale factor of 1/0.6 is subjective. see discussion in #19621.\nvec3 ACESFilmicToneMapping( vec3 color ) {\n  // sRGB => XYZ => D65_2_D60 => AP1 => RRT_SAT\n  const mat3 ACESInputMat = mat3(\n    vec3( 0.59719, 0.07600, 0.02840 ),\n    vec3( 0.35458, 0.90834, 0.13383 ),\n    vec3( 0.04823, 0.01566, 0.83777 )\n  );\n  // ODT_SAT => XYZ => D60_2_D65 => sRGB\n  const mat3 ACESOutputMat = mat3(\n    vec3(  1.60475, -0.10208, -0.00327 ),\n    vec3( -0.53108,  1.10813, -0.07276 ),\n    vec3( -0.07367, -0.00605,  1.07602 )\n  );\n  color /= 0.6; // exposure factor already applied by the caller\n  color = ACESInputMat * color;\n  color = RRTAndODTFit( color );\n  color = ACESOutputMat * color;\n  return saturate( color );\n}\n\nconst mat3 LINEAR_REC2020_TO_LINEAR_SRGB = mat3(\n  vec3( 1.6605, - 0.1246, - 0.0182 ),\n  vec3( - 0.5876, 1.1329, - 0.1006 ),\n  vec3( - 0.0728, - 0.0083, 1.1187 )\n);\nconst mat3 LINEAR_SRGB_TO_LINEAR_REC2020 = mat3(\n  vec3( 0.6274, 0.0691, 0.0164 ),\n  vec3( 0.3293, 0.9195, 0.0880 ),\n  vec3( 0.0433, 0.0113, 0.8956 )\n);\n\n// https://iolite-engine.com/blog_posts/minimal_agx_implementation\nvec3 agxDefaultContrastApprox( vec3 x ) {\n  vec3 x2 = x * x;\n  vec3 x4 = x2 * x2;\n  return + 15.5 * x4 * x2\n    - 40.14 * x4 * x\n    + 31.96 * x4\n    - 6.868 * x2 * x\n    + 0.4298 * x2\n    + 0.1191 * x\n    - 0.00232;\n}\n\n// AgX Tone Mapping implementation based on Filament, which in turn is based\n// on Blender's implementation using rec 2020 primaries.\n// Inputs and outputs are encoded as Linear-sRGB.\nvec3 AgXToneMapping( vec3 color ) {\n  const mat3 AgXInsetMatrix = mat3(\n    vec3( 0.856627153315983, 0.137318972929847, 0.11189821299995 ),\n    vec3( 0.0951212405381588, 0.761241990602591, 0.0767994186031903 ),\n    vec3( 0.0482516061458583, 0.101439036467562, 0.811302368396859 )\n  );\n  const mat3 AgXOutsetMatrix = mat3(\n    vec3( 1.1271005818144368, - 0.1413297634984383, - 0.14132976349843826 ),\n    vec3( - 0.11060664309660323, 1.157823702216272, - 0.11060664309660294 ),\n    vec3( - 0.016493938717834573, - 0.016493938717834257, 1.2519364065950405 )\n  );\n  const float AgxMinEv = - 12.47393;\n  const float AgxMaxEv = 4.026069;\n\n  color = LINEAR_SRGB_TO_LINEAR_REC2020 * color;\n  color = AgXInsetMatrix * color;\n  color = max( color, 1e-10 );\n  color = log2( color );\n  color = ( color - AgxMinEv ) / ( AgxMaxEv - AgxMinEv );\n  color = clamp( color, 0.0, 1.0 );\n  color = agxDefaultContrastApprox( color );\n  color = AgXOutsetMatrix * color;\n  color = pow( max( vec3( 0.0 ), color ), vec3( 2.2 ) );\n  color = LINEAR_REC2020_TO_LINEAR_SRGB * color;\n  return clamp( color, 0.0, 1.0 );\n}\n\n// Khronos PBR Neutral (r185 body; exposure removed).\nvec3 NeutralToneMapping( vec3 color ) {\n  const float StartCompression = 0.8 - 0.04;\n  const float Desaturation = 0.15;\n  float x = min( color.r, min( color.g, color.b ) );\n  float offset = x < 0.08 ? x - 6.25 * x * x : 0.04;\n  color -= offset;\n  float peak = max( color.r, max( color.g, color.b ) );\n  if ( peak < StartCompression ) return color;\n  float d = 1. - StartCompression;\n  float newPeak = 1. - d * d / ( peak + d - StartCompression );\n  color *= newPeak / peak;\n  float g = 1. - 1. / ( Desaturation * ( peak - newPeak ) + 1. );\n  return mix( color, vec3( newPeak ), g );\n}\n";
+export declare const OUTPUT_FRAGMENT_PROLOGUE_GLSL = "// a3d.output\nprecision highp float;\nuniform sampler2D u_scene;\n#ifdef BACKGROUND_COVERAGE\nuniform sampler2D u_coverage;\n#endif\nuniform float u_exposure;\n// float, not int: the device uploads numeric uniforms with uniform1f, and\n// glUniform1f on an int uniform is GL_INVALID_OPERATION (#1140).\nuniform float u_dither;\nin vec2 v_uv;\nlayout(location = 0) out vec4 outColor;\n#define saturate( a ) clamp( a, 0.0, 1.0 )\n";
+export declare const OUTPUT_FRAGMENT_EPILOGUE_GLSL = "vec3 a3dLinearToSRGB(vec3 c) { return mix(c * 12.92, 1.055 * pow(c, vec3(1.0/2.4)) - 0.055, step(vec3(0.0031308), c)); }\n// PRD-01 triangular output dither (\u00B11 LSB, \u00A78.4 output step): the inverse triangular CDF of\n// interleaved gradient noise (Jimenez 2014). Same TPDF as two summed uniforms,\n// but low-discrepancy, so every 16-px row window spans > 1 LSB and banding\n// runs break (white sin-hash noise left 25-27 px runs, #1249 GPU).\nfloat a3dTriangularNoise(vec2 p) {\n  float u = fract(52.9829189 * fract(dot(p, vec2(0.06711056, 0.00583715))));\n  return u < 0.5 ? sqrt(2.0 * u) - 1.0 : 1.0 - sqrt(2.0 - 2.0 * u);\n}\n#ifdef OUTPUT_OVERLAY\nuniform vec4 u_overlayFlash;    // rgb = linear color, a = amount 0..1 (additive)\nuniform vec4 u_overlayVignette; // rgb = linear color, a = amount 0..1\nuniform vec4 u_overlayShape;    // x = inner radius, y = softness, z = aspect (w/h), w = enabled 0/1\nuniform vec4 u_overlayFade;     // rgb = linear color, a = amount 0..1 (mix)\nvec3 a3dSrgbToLinear(vec3 c) {\n  return mix(c / 12.92, pow((c + 0.055) / 1.055, vec3(2.4)), step(vec3(0.04045), c));\n}\n// Q-01-1 reference (PRD 09 \u00A78): decode \u2192 flash/vignette/fade \u2192 encode once.\n// Juice amounts are perceptual, applied in display-referred linear.\nvec3 a3dApplyOutputOverlay(vec3 encoded, vec2 uv) {\n  if (u_overlayShape.w < 0.5) return encoded; // uniform branch; idle is bit-identical\n  vec3 c = a3dSrgbToLinear(encoded);\n  c += u_overlayFlash.rgb * u_overlayFlash.a;\n  vec2 d = (uv - 0.5) * vec2(u_overlayShape.z, 1.0);\n  float v = smoothstep(u_overlayShape.x, u_overlayShape.x + u_overlayShape.y, length(d));\n  c = mix(c, u_overlayVignette.rgb, v * u_overlayVignette.a);\n  c = mix(c, u_overlayFade.rgb, u_overlayFade.a);\n  return a3dLinearToSRGB(clamp(c, 0.0, 1.0));\n}\n#endif\nvoid main() {\n  vec4 scene = texture(u_scene, v_uv);\n  vec3 hdr = scene.rgb;\n  // Coverage: drawn content is tone-mapped, the clear colour is not (three\n  // r185: the clear is a raw glClear, tone mapping is per material). Without\n  // the coverage attachment, HDR alpha carries it \u2014 cleared alpha 0, drawn 1.\n#ifdef BACKGROUND_COVERAGE\n  float a3dCoverage = texture(u_coverage, v_uv).r;\n#else\n  float a3dCoverage = clamp(scene.a, 0.0, 1.0);\n#endif\n  vec3 display = mix(clamp(hdr, 0.0, 1.0), TONE_MAP(hdr * u_exposure), a3dCoverage);\n  vec3 encoded = a3dLinearToSRGB(clamp(display, 0.0, 1.0));\n  if (u_dither > 0.5) encoded += a3dTriangularNoise(gl_FragCoord.xy) / 255.0;\n#ifdef OUTPUT_OVERLAY\n  encoded = a3dApplyOutputOverlay(encoded, v_uv);\n#endif\n  outColor = vec4(encoded, 1.0);\n}\n";
+export declare const TONE_MAP_OPERATOR_FUNCTIONS: Readonly<Record<string, string>>;
+/** Compose the output fragment for one variant key. */
+export declare function outputFragmentGlsl(options: {
+    toneMapping: string;
+    backgroundCoverage: boolean;
+    overlay: boolean;
+}): string;
+//# sourceMappingURL=ToneMappingOperators.glsl.d.ts.map

package/dist/output/ToneMappingOperators.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToneMappingOperators.glsl.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/output/ToneMappingOperators.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,kBAAkB,8LAQ9B,CAAC;AAEF,eAAO,MAAM,2BAA2B,kiIA4GvC,CAAC;AAEF,eAAO,MAAM,6BAA6B,kbAazC,CAAC;AAEF,eAAO,MAAM,6BAA6B,glFAiDzC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxE,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAc1H"}

package/dist/output/ToneMappingOperators.glsl.js

@@ -0,0 +1,217 @@
+/**
+ * `output/ToneMappingOperators.glsl.ts` (PRD-01 §8.6, C-05) — the OutputPass
+ * fragment shader source. Operator bodies are three.js r185 ports with the
+ * `color *= toneMappingExposure;` line removed (OutputPass applies
+ * `hdr * u_exposure` once before the operator). `TONE_MAP` is a `#define`
+ * selecting the operator; `BACKGROUND_COVERAGE` mixes to unmapped `clamp(hdr)`
+ * outside drawn coverage (§6.5); `OUTPUT_OVERLAY` runs the C-05 juice overlay
+ * after encode (Q-01-1 reference GLSL adapted — the uniforms are the C-05
+ * `OutputOverlayUniforms`, shape packed as `[inner, softness, aspect, on]`).
+ */
+export const OUTPUT_VERTEX_GLSL = `#version 300 es
+// a3d.output
+layout(location = 0) in vec3 a_position;
+out vec2 v_uv;
+void main() {
+  v_uv = a_position.xy * 0.5 + 0.5;
+  gl_Position = vec4(a_position, 1.0);
+}
+`;
+export const TONE_MAPPING_OPERATORS_GLSL = `// r185 tonemapping_pars_fragment, exposure lines removed (PRD-01 §8.6).
+// "none" is a pass-through (still clamped at the OETF); "linear" saturates.
+vec3 NoneToneMapping(vec3 color) { return color; }
+vec3 LinearToneMapping(vec3 color) { return saturate(color); }
+
+// source: https://www.cs.utah.edu/docs/techreports/2002/pdf/UUCS-02-001.pdf
+vec3 ReinhardToneMapping(vec3 color) {
+  return saturate( color / ( vec3( 1.0 ) + color ) );
+}
+
+// source: https://github.com/selfshadow/ltc_code/blob/master/webgl/shaders/ltc/ltc_blit.fs
+vec3 RRTAndODTFit( vec3 v ) {
+  vec3 a = v * ( v + 0.0245786 ) - 0.000090537;
+  vec3 b = v * ( 0.983729 * v + 0.4329510 ) + 0.238081;
+  return a / b;
+}
+
+// this implementation of ACES is modified to accommodate a brighter viewing environment.
+// the scale factor of 1/0.6 is subjective. see discussion in #19621.
+vec3 ACESFilmicToneMapping( vec3 color ) {
+  // sRGB => XYZ => D65_2_D60 => AP1 => RRT_SAT
+  const mat3 ACESInputMat = mat3(
+    vec3( 0.59719, 0.07600, 0.02840 ),
+    vec3( 0.35458, 0.90834, 0.13383 ),
+    vec3( 0.04823, 0.01566, 0.83777 )
+  );
+  // ODT_SAT => XYZ => D60_2_D65 => sRGB
+  const mat3 ACESOutputMat = mat3(
+    vec3(  1.60475, -0.10208, -0.00327 ),
+    vec3( -0.53108,  1.10813, -0.07276 ),
+    vec3( -0.07367, -0.00605,  1.07602 )
+  );
+  color /= 0.6; // exposure factor already applied by the caller
+  color = ACESInputMat * color;
+  color = RRTAndODTFit( color );
+  color = ACESOutputMat * color;
+  return saturate( color );
+}
+
+const mat3 LINEAR_REC2020_TO_LINEAR_SRGB = mat3(
+  vec3( 1.6605, - 0.1246, - 0.0182 ),
+  vec3( - 0.5876, 1.1329, - 0.1006 ),
+  vec3( - 0.0728, - 0.0083, 1.1187 )
+);
+const mat3 LINEAR_SRGB_TO_LINEAR_REC2020 = mat3(
+  vec3( 0.6274, 0.0691, 0.0164 ),
+  vec3( 0.3293, 0.9195, 0.0880 ),
+  vec3( 0.0433, 0.0113, 0.8956 )
+);
+
+// https://iolite-engine.com/blog_posts/minimal_agx_implementation
+vec3 agxDefaultContrastApprox( vec3 x ) {
+  vec3 x2 = x * x;
+  vec3 x4 = x2 * x2;
+  return + 15.5 * x4 * x2
+    - 40.14 * x4 * x
+    + 31.96 * x4
+    - 6.868 * x2 * x
+    + 0.4298 * x2
+    + 0.1191 * x
+    - 0.00232;
+}
+
+// AgX Tone Mapping implementation based on Filament, which in turn is based
+// on Blender's implementation using rec 2020 primaries.
+// Inputs and outputs are encoded as Linear-sRGB.
+vec3 AgXToneMapping( vec3 color ) {
+  const mat3 AgXInsetMatrix = mat3(
+    vec3( 0.856627153315983, 0.137318972929847, 0.11189821299995 ),
+    vec3( 0.0951212405381588, 0.761241990602591, 0.0767994186031903 ),
+    vec3( 0.0482516061458583, 0.101439036467562, 0.811302368396859 )
+  );
+  const mat3 AgXOutsetMatrix = mat3(
+    vec3( 1.1271005818144368, - 0.1413297634984383, - 0.14132976349843826 ),
+    vec3( - 0.11060664309660323, 1.157823702216272, - 0.11060664309660294 ),
+    vec3( - 0.016493938717834573, - 0.016493938717834257, 1.2519364065950405 )
+  );
+  const float AgxMinEv = - 12.47393;
+  const float AgxMaxEv = 4.026069;
+
+  color = LINEAR_SRGB_TO_LINEAR_REC2020 * color;
+  color = AgXInsetMatrix * color;
+  color = max( color, 1e-10 );
+  color = log2( color );
+  color = ( color - AgxMinEv ) / ( AgxMaxEv - AgxMinEv );
+  color = clamp( color, 0.0, 1.0 );
+  color = agxDefaultContrastApprox( color );
+  color = AgXOutsetMatrix * color;
+  color = pow( max( vec3( 0.0 ), color ), vec3( 2.2 ) );
+  color = LINEAR_REC2020_TO_LINEAR_SRGB * color;
+  return clamp( color, 0.0, 1.0 );
+}
+
+// Khronos PBR Neutral (r185 body; exposure removed).
+vec3 NeutralToneMapping( vec3 color ) {
+  const float StartCompression = 0.8 - 0.04;
+  const float Desaturation = 0.15;
+  float x = min( color.r, min( color.g, color.b ) );
+  float offset = x < 0.08 ? x - 6.25 * x * x : 0.04;
+  color -= offset;
+  float peak = max( color.r, max( color.g, color.b ) );
+  if ( peak < StartCompression ) return color;
+  float d = 1. - StartCompression;
+  float newPeak = 1. - d * d / ( peak + d - StartCompression );
+  color *= newPeak / peak;
+  float g = 1. - 1. / ( Desaturation * ( peak - newPeak ) + 1. );
+  return mix( color, vec3( newPeak ), g );
+}
+`;
+export const OUTPUT_FRAGMENT_PROLOGUE_GLSL = `// a3d.output
+precision highp float;
+uniform sampler2D u_scene;
+#ifdef BACKGROUND_COVERAGE
+uniform sampler2D u_coverage;
+#endif
+uniform float u_exposure;
+// float, not int: the device uploads numeric uniforms with uniform1f, and
+// glUniform1f on an int uniform is GL_INVALID_OPERATION (#1140).
+uniform float u_dither;
+in vec2 v_uv;
+layout(location = 0) out vec4 outColor;
+#define saturate( a ) clamp( a, 0.0, 1.0 )
+`;
+export const OUTPUT_FRAGMENT_EPILOGUE_GLSL = `vec3 a3dLinearToSRGB(vec3 c) { return mix(c * 12.92, 1.055 * pow(c, vec3(1.0/2.4)) - 0.055, step(vec3(0.0031308), c)); }
+// PRD-01 triangular output dither (±1 LSB, §8.4 output step): the inverse triangular CDF of
+// interleaved gradient noise (Jimenez 2014). Same TPDF as two summed uniforms,
+// but low-discrepancy, so every 16-px row window spans > 1 LSB and banding
+// runs break (white sin-hash noise left 25-27 px runs, #1249 GPU).
+float a3dTriangularNoise(vec2 p) {
+  float u = fract(52.9829189 * fract(dot(p, vec2(0.06711056, 0.00583715))));
+  return u < 0.5 ? sqrt(2.0 * u) - 1.0 : 1.0 - sqrt(2.0 - 2.0 * u);
+}
+#ifdef OUTPUT_OVERLAY
+uniform vec4 u_overlayFlash;    // rgb = linear color, a = amount 0..1 (additive)
+uniform vec4 u_overlayVignette; // rgb = linear color, a = amount 0..1
+uniform vec4 u_overlayShape;    // x = inner radius, y = softness, z = aspect (w/h), w = enabled 0/1
+uniform vec4 u_overlayFade;     // rgb = linear color, a = amount 0..1 (mix)
+vec3 a3dSrgbToLinear(vec3 c) {
+  return mix(c / 12.92, pow((c + 0.055) / 1.055, vec3(2.4)), step(vec3(0.04045), c));
+}
+// Q-01-1 reference (PRD 09 §8): decode → flash/vignette/fade → encode once.
+// Juice amounts are perceptual, applied in display-referred linear.
+vec3 a3dApplyOutputOverlay(vec3 encoded, vec2 uv) {
+  if (u_overlayShape.w < 0.5) return encoded; // uniform branch; idle is bit-identical
+  vec3 c = a3dSrgbToLinear(encoded);
+  c += u_overlayFlash.rgb * u_overlayFlash.a;
+  vec2 d = (uv - 0.5) * vec2(u_overlayShape.z, 1.0);
+  float v = smoothstep(u_overlayShape.x, u_overlayShape.x + u_overlayShape.y, length(d));
+  c = mix(c, u_overlayVignette.rgb, v * u_overlayVignette.a);
+  c = mix(c, u_overlayFade.rgb, u_overlayFade.a);
+  return a3dLinearToSRGB(clamp(c, 0.0, 1.0));
+}
+#endif
+void main() {
+  vec4 scene = texture(u_scene, v_uv);
+  vec3 hdr = scene.rgb;
+  // Coverage: drawn content is tone-mapped, the clear colour is not (three
+  // r185: the clear is a raw glClear, tone mapping is per material). Without
+  // the coverage attachment, HDR alpha carries it — cleared alpha 0, drawn 1.
+#ifdef BACKGROUND_COVERAGE
+  float a3dCoverage = texture(u_coverage, v_uv).r;
+#else
+  float a3dCoverage = clamp(scene.a, 0.0, 1.0);
+#endif
+  vec3 display = mix(clamp(hdr, 0.0, 1.0), TONE_MAP(hdr * u_exposure), a3dCoverage);
+  vec3 encoded = a3dLinearToSRGB(clamp(display, 0.0, 1.0));
+  if (u_dither > 0.5) encoded += a3dTriangularNoise(gl_FragCoord.xy) / 255.0;
+#ifdef OUTPUT_OVERLAY
+  encoded = a3dApplyOutputOverlay(encoded, v_uv);
+#endif
+  outColor = vec4(encoded, 1.0);
+}
+`;
+export const TONE_MAP_OPERATOR_FUNCTIONS = {
+    none: "NoneToneMapping",
+    linear: "LinearToneMapping",
+    reinhard: "ReinhardToneMapping",
+    aces: "ACESFilmicToneMapping",
+    agx: "AgXToneMapping",
+    neutral: "NeutralToneMapping"
+};
+/** Compose the output fragment for one variant key. */
+export function outputFragmentGlsl(options) {
+    const fn = TONE_MAP_OPERATOR_FUNCTIONS[options.toneMapping] ?? TONE_MAP_OPERATOR_FUNCTIONS["aces"];
+    const defines = [
+        `#define TONE_MAP(c) ${fn}(c)`,
+        ...(options.backgroundCoverage ? ["#define BACKGROUND_COVERAGE"] : []),
+        ...(options.overlay ? ["#define OUTPUT_OVERLAY"] : [])
+    ];
+    return [
+        "#version 300 es",
+        OUTPUT_FRAGMENT_PROLOGUE_GLSL,
+        ...defines,
+        TONE_MAPPING_OPERATORS_GLSL,
+        OUTPUT_FRAGMENT_EPILOGUE_GLSL
+    ].join("\n");
+}
+//# sourceMappingURL=ToneMappingOperators.glsl.js.map

package/dist/output/ToneMappingOperators.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToneMappingOperators.glsl.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/output/ToneMappingOperators.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;CAQjC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4G1C,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;CAa5C,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiD5C,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAqC;IAC3E,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,mBAAmB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,IAAI,EAAE,uBAAuB;IAC7B,GAAG,EAAE,gBAAgB;IACrB,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,uDAAuD;AACvD,MAAM,UAAU,kBAAkB,CAAC,OAA+E;IAChH,MAAM,EAAE,GAAG,2BAA2B,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACnG,MAAM,OAAO,GAAG;QACd,uBAAuB,EAAE,KAAK;QAC9B,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;IACF,OAAO;QACL,iBAAiB;QACjB,6BAA6B;QAC7B,GAAG,OAAO;QACV,2BAA2B;QAC3B,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/passes/ContactShadowPass.d.ts

@@ -0,0 +1,57 @@
+import { BaseRenderPass, type RenderPassContext } from "../RenderPass.js";
+import type { Texture } from "../Texture.js";
+import type { RenderItem } from "../ForwardPass.js";
+import { type DepthPassOptions } from "../DepthPass.js";
+export declare const CONTACT_MASK_BLACKBOARD_KEY = "prd02.contactShadowMask";
+export interface ContactShadowOptions {
+    readonly length?: number;
+    readonly thickness?: number;
+    readonly steps?: number;
+    readonly intensity?: number;
+}
+export interface ContactShadowPassInput {
+    /** Shadowed-light direction in world space (points toward the light). */
+    readonly sunDirection: readonly [number, number, number];
+    readonly camera: {
+        readonly viewMatrix: Float32Array;
+        readonly projectionMatrix: Float32Array;
+        readonly near: number;
+        readonly far: number;
+    };
+    /** C-07-IN-2: real scene depth when the C-01 prepass is provided. */
+    readonly sceneDepth?: {
+        readonly texture: Texture | null;
+        readonly available: boolean;
+        readonly linearize: {
+            readonly near: number;
+            readonly far: number;
+            readonly orthographic: boolean;
+        };
+    };
+    /** Fallback casters for the lane's own half-res depth render (C-01 stub). */
+    readonly casters?: readonly RenderItem[];
+    readonly depthPassOptions?: Omit<DepthPassOptions, "casters" | "viewProjectionMatrix">;
+    readonly options?: ContactShadowOptions;
+}
+/** @internal Contact-mask program sources (GLSL validation in unit tests). */
+export declare const CONTACT_MASK_SHADER_SOURCES: {
+    readonly vertex: "#version 300 es\n// @aura3d-shader:prd02_contact_mask\nin vec2 a_position;\nout vec2 v_uv;\nvoid main() { v_uv = a_position * 0.5 + 0.5; gl_Position = vec4(a_position, 0.0, 1.0); }\n";
+    readonly fragment: "#version 300 es\n// @aura3d-shader:prd02_contact_mask\nprecision highp float;\nin vec2 v_uv;\nlayout(location = 0) out vec4 o_vis;\n\nuniform highp sampler2D u_prd02ContactDepth;     // scene depth buffer ([0,1])\nuniform mat4 u_prd02ContactInvProj;              // clip -> view\nuniform mat4 u_prd02ContactProj;                 // view -> clip\nuniform vec3 u_prd02ContactSun;                  // shadowed-light dir, view space\nuniform vec4 u_prd02ContactParams;               // (length_m, thickness_m, steps, jitter)\nuniform vec2 u_prd02ContactNearFar;              // (near, far)\n\nfloat a3d_prd02ContactNoise(vec2 px) {\n  return fract(52.9829189 * fract(0.06711056 * px.x + 0.00583715 * px.y));\n}\n\nfloat a3d_prd02ContactLinear(float z) {\n  float n = u_prd02ContactNearFar.x;\n  float f = u_prd02ContactNearFar.y;\n  return (n * f) / (f - z * (f - n));\n}\n\nfloat a3d_contactShadow(vec2 uv) {\n  float sceneZ = texture(u_prd02ContactDepth, uv).r;\n  vec4 ndc = vec4(uv * 2.0 - 1.0, sceneZ * 2.0 - 1.0, 1.0);\n  vec4 vpos = u_prd02ContactInvProj * ndc;\n  vec3 pos = vpos.xyz / vpos.w;\n  float len = u_prd02ContactParams.x;\n  float thickness = u_prd02ContactParams.y;\n  float steps = max(u_prd02ContactParams.z, 1.0);\n  float jitter = a3d_prd02ContactNoise(gl_FragCoord.xy) * u_prd02ContactParams.w;\n  float occluded = 0.0;\n  for (int i = 1; i <= 16; i++) {\n    if (float(i) > steps) break;\n    float t = (float(i) - jitter) / steps;\n    vec3 p = pos + u_prd02ContactSun * (t * len);\n    vec4 clip = u_prd02ContactProj * vec4(p, 1.0);\n    vec3 r = clip.xyz / clip.w;\n    vec2 suv = r.xy * 0.5 + 0.5;\n    if (suv.x < 0.0 || suv.x > 1.0 || suv.y < 0.0 || suv.y > 1.0) continue;\n    float blocker = a3d_prd02ContactLinear(texture(u_prd02ContactDepth, suv).r);\n    if (blocker < -p.z - thickness) occluded = max(occluded, 1.0 - t);\n  }\n  return 1.0 - occluded;\n}\n\nvoid main() { o_vis = vec4(a3d_contactShadow(v_uv)); }\n";
+};
+export declare class ContactShadowPass extends BaseRenderPass {
+    private readonly input;
+    private mask;
+    private ownDepth;
+    private program;
+    private triBuffer;
+    private readonly depthPass;
+    private lastMask;
+    private lastDepthSource;
+    private executed;
+    constructor(input: ContactShadowPassInput);
+    maskTexture(): Texture | null;
+    depthSource(): string;
+    passExecuted(): boolean;
+    execute(context: RenderPassContext): void;
+}
+//# sourceMappingURL=ContactShadowPass.d.ts.map

package/dist/passes/ContactShadowPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactShadowPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/ContactShadowPass.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhE,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;QAClC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;QACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;SAAE,CAAC;KACrG,CAAC;IACF,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,sBAAsB,CAAC,CAAC;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAyBD,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B;;;CAAgE,CAAC;AAEzG,qBAAa,iBAAkB,SAAQ,cAAc;IAUvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IATlC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAS;gBAEI,KAAK,EAAE,sBAAsB;IAe1D,WAAW,IAAI,OAAO,GAAG,IAAI;IAC7B,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,OAAO;IAEvB,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;CAyE1C"}