Original HDR environment inputs
This slice contains 24 authored Radiance RGBE inputs, each 1024 × 512.
The files contain linear relative radiance, including values above one where
the recipe calls for bright sources. They are generated from original analytic
functions and are ready for resource-adapter development. Their application
binding and rendered reference validation remain pending (authored_unbound,
runtime_ready: false).
These are synthetic directional lighting fields. An ENV reference identifies
the intended context; it does not assert that the catalog's room, terrain,
geometry or complete scene has been implemented. No captured panorama, commercial
material library, AI beauty image, facility scan or measured photometry is used.
Authority and regeneration
- source/recipes.json is the editable parameter authority.
- ../tools/environments.py is the original authoring
and verification tool. Its version is
1.0.0. - exports/ contains the required HDR derivatives at one resolution.
- manifest.json records file SHA-256, encoded bytes, dimensions, color interpretation, source/generator hashes and relative-energy statistics.
- ../tools/test_environments.py checks analytic invariants, the format's published RGBE byte example and invalid inputs.
From the repository root, with Python 3.11+, NumPy and Pillow installed:
python3 -B assets/render/starter/tools/environments.py build
python3 -B assets/render/starter/tools/environments.py validate --reproducible
python3 -B assets/render/starter/tools/test_environments.py
python3 -B assets/render/starter/tools/environments.py preview
If the independent ffmpeg executable is installed, also run:
python3 -B assets/render/starter/tools/environments.py validate --reproducible --independent-decode
That optional check invokes the executable to decode each HDR as planar float RGB, then compares every decoded channel with the local stream check. It does not link, ship or inspect an external implementation. The authoring tools are development dependencies only; they are not application runtime dependencies.
The preview command writes its fixed-exposure, Reinhard-mapped contact sheet
only under ignored target/render-starter-review/environments/. It is a view of
the authored radiance fields, not a screenshot or render from SolidCraft.
Interpretation contract
| Property | Declaration |
|---|---|
| Projection | 2:1 equirectangular, pixel-center samples |
| Coordinates | Right-handed; +Z up; azimuth from +X toward +Y |
| Longitude | phi = 2*pi*(u-0.5) |
| Colatitude | theta = pi*v |
| Direction | (sin(theta)*cos(phi), sin(theta)*sin(phi), cos(theta)) |
| Cardinal longitudes | u=0/-X, u=0.25/-Y, u=0.5/+X, u=0.75/+Y |
| Sampling | Repeat U, clamp V; no duplicated seam column |
| File orientation | Radiance -Y +X |
| Channels | Linear RGB; no sRGB transfer curve is baked into the HDR |
| Chromaticities | Explicit sRGB primaries and D65 white in PRIMARIES |
| Header corrections | EXPOSURE=1, COLORCORR=1 1 1, PIXASPECT=1 |
| Intensity | Authored relative radiance; neither lux nor radiometric SI units |
| Randomness | None; seed: 0 records an analytic deterministic construction |
| Solar disk | Absent from every file |
The importer must map this coordinate convention explicitly. The format
decoder's -Y +X byte ordering does not establish the application's world axes.
The color-space declaration must also be checked before working-space conversion.
See the current bounded HDR input contract.
The upper/lower hemisphere values and smooth rectangular directional patches describe an authored field at infinity. The patches are not finite-distance area emitters: they do not supply parallax, distance falloff, hardware dimensions, occlusion, contact shadows or room interreflection. Their soft borders are part of the lighting design. Engine-native area lights remain a separate resource.
One energy owner: the nonblack maps own their ambient field and bright patches. A corresponding analytic rig must replace those contributions or use a separately authored compatible map. Adding equivalent lamps on top would duplicate illumination. The catalog's original separation of environment and rig remains unchanged; these are explicitly standalone illumination variants.
HDR-024 contributes exactly zero energy. Any Sun, work light, reflected light,
stars or Earth contribution must come from separately owned scene resources.
Automatic sky fill, fake stars and exposure compensation are not part of this
vacuum input. A scene with no other source will correctly remain dark.
Included resources
| ID | Resource | Context |
|---|---|---|
| HDR-001 | Neutral side softbox | ENV-001 |
| HDR-002 | White enveloping studio | ENV-002 |
| HDR-003 | Black metal strips | ENV-003 |
| HDR-004 | Hangar skylight pattern | ENV-007 |
| HDR-005 | Neutral comparison field | ENV-008 |
| HDR-006 | Warm table window | ENV-021 |
| HDR-007 | Showroom ribbons | ENV-034 |
| HDR-008 | Mechanical bay windows | ENV-071 |
| HDR-009 | CNC overhead lanes | ENV-072 |
| HDR-010 | Woodshop broad window | ENV-073 |
| HDR-011 | Garage doorway field | ENV-075 |
| HDR-012 | Makerspace worklights | ENV-079 |
| HDR-013 | Home workbench window | ENV-080 |
| HDR-014 | Electronics bench neutral | ENV-082 |
| HDR-015 | Sun-free diffuse overcast | ENV-182 |
| HDR-016 | Automotive turntable ribbons | ENV-201 |
| HDR-017 | Paint inspection bands | ENV-206 |
| HDR-018 | Assembly bench soft | ENV-211 |
| HDR-019 | Rework offset strips | ENV-212 |
| HDR-020 | FDM neutral inspection | ENV-214 |
| HDR-021 | Printed-part photography | ENV-217 |
| HDR-022 | Robot LED editorial | ENV-218 |
| HDR-023 | Spacecraft clean-bay field | ENV-231 |
| HDR-024 | Vacuum zero-ambient field | ENV-244 |
The colored accents in HDR-022 are explicitly editorial RGB illumination. The recipe does not claim a spectral LED model, color temperature or measured emitter. HDR-015 is a generic sun-free sky-like gradient, not a weather observation or physical sky model. HDR-005 is an exactly uniform unit-radiance analytic reference.
Numeric and visual checks
The validator checks strict recipe fields, duplicate JSON keys and IDs, concept references, finite/channel bounds, path-safe identifiers, bounded dimensions, RGBE framing and runs, metadata corrections, hashes, file inventory and the zero-energy vacuum invariant. Reproducibility mode regenerates each HDR in memory and compares the bytes. The independent decoder mode checks all pixels.
Quantization checks bound each channel's error by one RGBE step relative to that
pixel's largest channel. Exact latitude-cell solid angles are used for mean
radiance; the six hemisphere cosine integrals use the pixel-center direction and
are explicitly numeric estimates. Tests compare an independent uniform-field
expectation, E = pi * L, against those integrals. They also check cardinal source
orientation, unit direction vectors and invalid metadata/stream rejection.
The source is continuous across longitude wrap. Opposite-edge pixel centers are neighboring samples, so they are not incorrectly required to have equal pixel values. The export has no baked tone mapping or clipped [0,1] radiance.
The first authored set was inspected in the generated contact sheet for source shape, orientation, continuity and unintended bands. This is authoring review; native CPU/GPU consumption, diffuse/conductor/glass reference scenes, UI previews and platform parity still need the resource integration work. Repository gates are recorded in the parent pack's validation record.
Provenance
Original SolidCraft contribution, MIT OR Apache-2.0, authored 2026-10-21 for
the personal rendering fork. No external binary asset is bundled. Exact rows for
all shipped files and development tools are maintained in root ATTRIBUTION.md.
Public format references consulted for byte/header meaning:
The encoder is original authoring code. No routines from those pages were adapted. These references do not convert relative authored radiance into a calibrated light probe.