threejs-image-pipeline

Image Pipeline

Build one causal image graph: one HDR scene pass with depth, selected shared signals, and one final output conversion. Add a scene traversal or attachment only when its measured alternative is worse.

Use the atomic owner for each admitted effect:

• $threejs-ambient-contact-shading for GTAO and indirect-light composition;
• $threejs-bloom for glare source selection and BloomNode controls;
• $threejs-exposure-color-grading for metering, adaptation, tone mapping, and LUT domains;
• $threejs-dynamic-surface-effects for feature-local screen history;
• $threejs-visual-validation for capture, timing, and lifecycle evidence.

1. Fix the baseline

Declare physical canvas pixels, target browser/GPU, frame budget, primary visual contract, and a readable no-post view. Initialize one WebGPURenderer, confirm renderer.backend.isWebGPUBackend, create one RenderPipeline, and make one pass(scene, camera) own scene-linear HDR plus its depth texture. Set trackTimestamp before renderer.init() when GPU timing is requested.

This step is complete when the baseline renders without optional post, the HDR and depth producers are named, and exactly one component owns presentation.

2. Inventory signals

For every candidate signal—HDR color, depth, normal, emissive, velocity, diffuse/base color, IDs, histories, exposure, and UI—record:

writer | readers | mathematical/color domain | physical format and extent
first write -> last read | history/reset owner | disable path

Treat depth as the pass depth texture rather than an MRT color output. Request only signals with a real reader.

This step is complete when every graph edge has one writer, all consumers agree on domain and extent, and every optional signal has a working disable path.

3. Admit attachments

First reject any reconstruction, attachment, or narrow-rerender candidate that cannot meet the signal's declared domain, precision/error bound, spatial coverage, temporal stability, or discard semantics. Compare the remaining correct candidates on the target graph: