Class DemoGoldens

java.lang.Object
eu.svjatoslav.aukio.e3d.examples.goldens.DemoGoldens

public class DemoGoldens extends Object
Golden-image regression suite: renders EVERY launcher demo headlessly through Snapshot and compares against reference images committed under goldens/ in lossy JPEG XL (quality 98).

Each demo exposes a deterministic static buildScene(ShapeCollection, LightingManager, Camera) — no animation listeners, no wall-clock, seeded randomness — so the rendered frame is reproducible bit-for-bit.

Tolerance rationale: JPEG XL q98 decode differs from the exact render on at most ~0.22% of pixels at per-channel tolerance 16 (calibrated on the FO4 goldens), so tolerance 16 / maxDiffFraction 0.005 absorbs codec noise with >2x margin while any real rendering regression fails.

Usage (from the demos project root):

  java eu.svjatoslav.aukio.e3d.examples.goldens.DemoGoldens            # verify all
  java eu.svjatoslav.aukio.e3d.examples.goldens.DemoGoldens house      # verify subset
  java eu.svjatoslav.aukio.e3d.examples.goldens.DemoGoldens --update   # re-bless all
  java eu.svjatoslav.aukio.e3d.examples.goldens.DemoGoldens --update galaxy

Requires cjxl/djxl (libjpegxl-tools) on PATH.

  • Constructor Details

    • DemoGoldens

      public DemoGoldens()
  • Method Details