Temporal fidelity
Static fidelity scores one image per renderer. Temporal techniques such as TAA, temporal upscaling, temporal denoisers and animated sampling noise cannot be judged from one frame. Their errors are blur under motion, ghosting, flicker and slow convergence, so temporal fidelity scores an animated sequence instead.
Static fidelity, temporal fidelity and performance are independent optional sections. staticFidelity: false disables the static page and its captures. A temporal-only registry can omit static fidelity entirely: an explicit temporalFidelity section defaults it to disabled. Set staticFidelity: true for mixed suites. Performance navigation appears for configured or captured performance tests.
Registry
Dynamic fidelity uses the rendering registry and the same browser session factory as render, benchmark and live mode. Three additions opt in:
{
"renderers": [
{
"id": "reference",
"name": "4×4 supersampled",
"reference": true,
"params": { "aa": "none" },
"supersample": { "factor": 4, "filter": "lanczos3" }
},
{ "id": "taa", "name": "TAA", "params": { "aa": "taa" } }
],
"scenes": [
{
"id": "spinning-fan",
"name": "Spinning fan",
"temporalFidelity": {
"width": 640,
"height": 360,
"frames": 150,
"warmup": 30,
"fps": 60,
"params": { "camera": "pan" }
}
}
],
"staticFidelity": false,
"temporalFidelity": { "reference": "reference", "output": "motion" }
}
renderers[].supersamplerenders atfactor ×the requested width and height and downsamples the capture in linear light. The filter islanczos3(default) orbox. Any renderer becomes a reference this way, for example a renderer without anti-aliasing at 4 × 4 samples per pixel.renderhonours it for static captures as well.scenes[].temporalFidelityopts a scene in. It sets the sequence size, the total frame count, the unscoredwarmupframes that let temporal history settle, and the time step1 / fps. Optionalparamsare passed to the session, for example camera motion. Optionalrendererslimits the compared renderers for this scene, for example a denoiser that only applies to scenes with ambient occlusion.temporalFidelitynames the reference renderer and the output folder of the representative frames.renderersoptionally limits the compared renderers; the default is every enabled, non-reference browser renderer.representativeFramepicks the saved frame (default: the last measured one).
scenes[].staticFidelity configures static size and settling frames. Set either scene section to false to exclude that scene. Legacy fidelity/dynamic keys and the dynamic CLI command remain aliases; canonical keys take precedence. The existing dynamic.json result format is unchanged.
Session contract
In dynamic mode the host calls draw(1 / fps) once per frame and reads back every frame after warmup. A session must therefore advance its animation by the given time step, not by wall-clock time, so that the reference and every renderer see the same scene state on each frame. Each sequence renders in a fresh page.
Capture
fidelity-kit temporal --registry registry.json --out fidelity-results
fidelity-kit temporal --registry registry.json --out fidelity-results --scenes "spin*" --renderers "taa*"
For each scene, the reference sequence is rendered first and every compared renderer is scored frame by frame on the raw captured pixels:
| Metric | Meaning |
|---|---|
| Sequence PSNR (dB) | Error of every measured frame against the reference: blur, ghosting and aliasing all lower it. |
| Temporal PSNR (dB) | Error of the frame-to-frame change, (O[t] − O[t−1]) − (R[t] − R[t−1]). It isolates flicker, shimmering and lag from a constant spatial error. |
| Sharpness | Gradient energy of the frames relative to the reference. Below 1 is blurrier, above 1 has extra edges (aliasing or noise). Compare it across renderers against the same reference: a Lanczos reference has some ringing, which adds edge energy. |
Results are written into the normal results tree:
fidelity-results/
dynamic.json summaries of every dynamic comparison
spinning-fan/
motion/
reference.avif representative frame
taa.avif
taa.temporal.json summary and per-frame curves
The representative frames are result images tagged kind: "temporal", so process indexes them without computing static comparisons. fidelity.json declares the output automatically. The viewer adds a Temporal fidelity page with a scene × renderer table (sequence PSNR, temporal PSNR and sharpness, with means per renderer). Scene detail pages show the representative captures, sequence metrics and per-frame charts independently of static results. Excluded renderer/scene combinations show “Not applicable”; expected but absent captures show “Missing result”. build exports dynamic.json and the sidecars.
Static comparisons also report sharpness next to PSNR.