@aura3d/rendering 3.0.1 → 4.0.2

package/dist/post/v2Entry.js

@@ -0,0 +1,28 @@
+/**
+ * PRD-03 Phase 2 — deferred v2 post-graph module barrel.
+ *
+ * Everything the v2 GPU chain needs that flag-off renderers must never pay
+ * for: the §6.1 shader sources, the render-target pool, the `.cube` LUT
+ * parser, and the additive bloom normalization. The ONLY import of this
+ * module is `import("../post/v2Entry.js")` inside `PostprocessExecution`'s
+ * v2 branch — the esbuild split point the post-bundle-split test asserts.
+ * Never import it statically from a barrel or a device file.
+ */
+export { BLOOM_PREFILTER_GLSL, BLOOM_DOWNSAMPLE_GLSL, BLOOM_UPSAMPLE_GLSL } from "./shaders/bloom.glsl.js";
+export { COMPOSITE_GLSL, CA_PASS_GLSL } from "./shaders/composite.glsl.js";
+export { DISPLAY_GRADE_GLSL, LUT_BAKE_GLSL } from "./shaders/displayGrade.glsl.js";
+export { FINALIZE_GLSL, FINALIZE_FXAA_FUSED_GLSL } from "./shaders/finalize.glsl.js";
+export { FXAA_185_FNS_GLSL } from "./shaders/fxaa.glsl.js";
+export { PostResources } from "./PostResources.js";
+// Phase 3: S1/S2/S4 GPU stages + C-02 indirect-fraction chunk + the v2 LDR
+// tail executor. `post/chunks/` stays source-only (the feature registers in
+// lanes/prd03, not through this deferred barrel).
+export { DEPTH_LINEARIZE_GLSL, DEPTH_MINMAX_HALF_GLSL, CAMERA_VELOCITY_GLSL } from "./shaders/depthDownsample.glsl.js";
+export { GTAO_GLSL } from "./shaders/gtao.glsl.js";
+export { GTAO_DENOISE_GLSL, GTAO_APPLY_GLSL } from "./shaders/gtaoDenoise.glsl.js";
+export { GODRAYS_GLSL } from "./shaders/godrays.glsl.js";
+export { runV2HdrStages, runV2LdrTail, v2NeedsLdrTail, releaseV2Target, acquireV2Target } from "./v2Stages.js";
+export { DisplayLutCache, displayGradeKey } from "./DisplayLutCache.js";
+export { parseCubeLut } from "./CubeLut.js";
+export { bloomNormalization } from "../postprocess/NativeBloomPyramid.js";
+//# sourceMappingURL=v2Entry.js.map

package/dist/post/v2Entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2Entry.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/post/v2Entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AACpE,2EAA2E;AAC3E,4EAA4E;AAC5E,kDAAkD;AAClD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACpH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,eAAe,EAA2B,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/post/v2Stages.d.ts

@@ -0,0 +1,156 @@
+/**
+ * PRD-03 Phase 3 — the transitional v2 GPU stage driver (deferred chunk:
+ * imported only through `post/v2Entry` from `PostprocessExecution`).
+ *
+ * `runV2HdrStages` runs the implemented §6.1 HDR stages that no longer have a
+ * CPU/home on the legacy chain:
+ *   S1  depth prep        (linearize → RGBA32F, half-res min/max)
+ *   S2  GTAO              (half-res → bilateral denoise H/V → joint-bilateral
+ *                          upsample + §6.3 multi-bounce apply onto HDR)
+ *   S4  god rays          (half-res radial march → additive onto HDR)
+ *   CA  chromatic aberration (the §8.12 S10 tap as a standalone pre-pass)
+ *   S1-C camera velocity  (§8.6/§8.8: depth-reprojected UV deltas → velocity target)
+ *   S5  TAA / TAAU        (§8.6 resolve against the C-14 history ping-pong)
+ *   S6  depth of field    (§8.7 half-res prefilter → near-tile → Vogel gather → composite)
+ *   S7  motion blur       (§8.8 McGuire tile-max → neighbor-max → reconstruction)
+ *
+ * `runV2LdrTail` runs the post-`presentLdrPostprocess` display stages:
+ *   S10b display grade (LUT + vignette, luma into .a for FXAA),
+ *   S11 r185 FXAA (or fused inside S12), S12 finalize (grain + RCAS + the
+ *   single triangular dither). When FXAA is selected and any S10b/S12 stage
+ *   is active, `FINALIZE_FXAA_FUSED_GLSL` collapses all three into one draw.
+ *
+ * Format note: the contract pool only has rgba8/rgba16f/rgba32f renderable
+ * formats, so the spec's R32F/RG32F/R8 surfaces land as rgba32f (≥ spec
+ * precision, .r/.rg channels) and rgba8 (R8-equivalent quantization).
+ * True single/double-channel formats are qr-request Q-11-2 (lane 11
+ * RenderDevice::resolveRenderTargetFormat).
+ */
+import type { WebGL2DeviceHost } from "../webgl2/DeviceHost.js";
+import { type RenderTarget } from "../RenderDevice.js";
+import { type PostPassDescriptor, type PostPipelineOptions } from "../contracts/post.js";
+import type { FrameCamera } from "../contracts/frameGraph.js";
+import type { RenderItem } from "../ForwardPass.js";
+import type { Texture } from "../Texture.js";
+import type { TemporalGpuBindings } from "../TemporalHistory.js";
+/**
+ * God-ray tint as an RGB triple. The engine bridge compiles
+ * `effects.volumetricFog({ color })` to a `{ r, g, b }` object, while direct
+ * callers pass `[r, g, b]`. Indexing the object as an array gave
+ * `uniform3f(undefined, …)`; the resulting NaN tint went through the additive
+ * blend and turned the whole HDR frame black (shaft-on mean luma 0 on the GPU
+ * lane, runs 38140351314 and 38141069039). Non-finite channels fall back to
+ * the default warm tint.
+ */
+export declare function godRayColor(color: unknown): [number, number, number];
+/**
+ * Inserts `#define` lines after the `#version` directive. GLSL ES 3.00
+ * requires `#version 300 es` to be the first line, so prepending defines (as
+ * the DoF ring count and motion-blur tile size did) made the shader a
+ * GLSL ES 1.00 source and the compile failed ("#version must occur first"),
+ * which aborted the whole v2 frame (black output on the GPU lane,
+ * post-quality 38138763970).
+ */
+export declare function withDefines(source: string, defines: Readonly<Record<string, string | number>>): string;
+/**
+ * §6.12: a custom pass's `fragment.glsl` is appended after the engine
+ * prelude (version, precision, the `v_uv` input, `outColor`, and the
+ * built-in uniforms `u_color`, `u_depthLinear`, `u_velocity`, `u_texelSize`,
+ * `u_time`). The pass declares only its own uniforms + a `main()`; it must
+ * NOT redeclare the built-ins, `#version`, or `precision`.
+ */
+export declare function customPassFragmentSource(glsl: string): string;
+/**
+ * Passes visible to the graph: the pipeline bag's `customPasses` first, then
+ * the C-13 registry (`app.addPostPass` registers there), deduped by id (an
+ * engine may stamp the same descriptor into both). Order = insertion order at
+ * each anchor.
+ *
+ * The registry already rejects a misplaced space at `registerPostPass`. A
+ * bag-supplied pass bypasses that, so it is validated here: a `display` pass
+ * at an HDR anchor (or `linear-hdr` after tonemap) is dropped and recorded as
+ * `POSTPROCESS_SPACE_INVALID:<id>` (T0-17: no per-frame throw; plan-time
+ * `planPostGraph`/`PostGraph.execute` still throw).
+ */
+export declare function mergedCustomPasses(pipeline: PostPipelineOptions): readonly PostPassDescriptor[];
+/**
+ * CCR-03-12 (Phase 6): the `source`/`items`/`sceneDepth` slice of the
+ * `FrameContributorContext` a C-13 custom pass's `enabled()`/`uniforms()`
+ * callback may read — stamped on `RendererPostProcessOptions.postFrameContext`
+ * and forwarded here untouched.
+ */
+export interface PostFrameContextBag {
+    readonly source: unknown;
+    readonly items: readonly RenderItem[];
+    readonly sceneDepth: {
+        readonly texture: Texture | null;
+        readonly available: boolean;
+        readonly linearize: {
+            readonly near: number;
+            readonly far: number;
+            readonly orthographic: boolean;
+        };
+    };
+}
+/**
+ * 03-S18a: settles once the in-flight SMAA area/search texture load (if any)
+ * finished, so a probe can wait for S11 to be active instead of guessing a
+ * frame count. Resolves immediately when no load was started.
+ */
+export declare function smaaTexturesSettled(): Promise<void>;
+/**
+ * Runs S1 → S2 → S4 → CA on the HDR frame. Returns the (possibly pooled)
+ * HDR target the fused present should consume. When no HDR stage is enabled
+ * the source passes through untouched.
+ */
+export declare function runV2HdrStages(host: WebGL2DeviceHost, source: RenderTarget, pipeline: PostPipelineOptions, camera: FrameCamera | null | undefined, 
+/** PRD-03 Phase 4: the flag-on TemporalHistory bindings (C-14 camera
+ * matrices + velocity/history/linZ surfaces). Absent when temporal
+ * wasn't requested or the route's geometry is unsupported. */
+temporal?: TemporalGpuBindings, 
+/** CCR-03-12 (Phase 6): C-13 custom-pass frame context (source/items/sceneDepth). */
+frameContext?: PostFrameContextBag): {
+    readonly target: RenderTarget;
+    readonly aoPending: boolean;
+    readonly skipped: readonly string[];
+};
+/**
+ * §6.3 fallback cap. Pixels without the tagged f_ind (legacy shaderKey draws,
+ * custom shaders) cannot tell direct from indirect light, so the apply darkens
+ * them by `mix(1, ao, strength)`. The authored 0.6 darkened directly lit
+ * surfaces by 4–12% luma on the L4 games (blockfall-reactor 34.5 → 30.3);
+ * capped at 0.1 an open lit surface (GTAO ao ≈ 0.9) loses ≤ ~1% luma while
+ * creases (ao ≈ 0.3) still darken ~7%. Generated-program pixels ignore it.
+ */
+export declare const AO_FALLBACK_STRENGTH_MAX = 0.1;
+export declare function aoFallbackStrength(authored: number | undefined): number;
+/**
+ * Vignette colour as a finite RGB triple. The engine post bridge emits
+ * `{ r, g, b }` (rgbField) while older callers pass `[r, g, b]`; indexing the
+ * object form gave `undefined` → NaN uniforms, and `mix(1, NaN, t)` turned the
+ * whole frame black whenever a scene authored `effects.vignette()`.
+ */
+export declare function vignetteColorRgb(color: unknown): [number, number, number];
+/** True when S10b/S11/S12 need a real LDR tail after the fused present. */
+export declare function v2NeedsLdrTail(pipeline: PostPipelineOptions): boolean;
+/**
+ * Runs S10b/S11/S12 on the fused LDR output and writes `outTarget` (or the
+ * default framebuffer when undefined). `ldr` must be an rgba8 target the
+ * fused present just wrote.
+ */
+export declare function runV2LdrTail(host: WebGL2DeviceHost, ldr: RenderTarget, pipeline: PostPipelineOptions, outTarget: RenderTarget | undefined, 
+/** CCR-03-12 (Phase 6): C-13 custom-pass frame context (source/items/sceneDepth). */
+frameContext?: PostFrameContextBag): void;
+/**
+ * Releases a pooled target a stage call returned. The caller owns the
+ * returned HDR/LDR target: `runV2HdrStages`'s output feeds the fused
+ * present, then comes back here (or to `pool.releaseAll` at frame end).
+ */
+export declare function releaseV2Target(host: WebGL2DeviceHost, target: RenderTarget): void;
+/** Acquire a pooled target from the v2 stage pool (LDR tail scratch). */
+export declare function acquireV2Target(host: WebGL2DeviceHost, key: {
+    readonly width: number;
+    readonly height: number;
+    readonly format: string;
+}): RenderTarget;
+//# sourceMappingURL=v2Stages.d.ts.map

package/dist/post/v2Stages.d.ts.map

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