ADR-0037: Enhanced composes the default sky; Automatic and Manual expose it photographically

3,631 words

Status: accepted · 7 Sep 2026; amended 30 Oct 2026, the air in front of the sky is part of what Enhanced compresses, and Enhanced opens up for the daylight left in a darkening sky. Camera policy, processing and surface-light separation are implemented and verified. The camera plan records image and runtime acceptance, including the limits of each measurement. Supersedes the default-image preservation requirement in ADR-0031, the ordinary-view daylight omission policy in ADR-0032, and the bible's two-mode camera direction. Their implementation measurements remain valid for the responses they tested.

Context

The default camera needs to show detailed bright worlds against a visible star field and diffuse Milky Way. Natural preserves a production calibration and integrated star sprites, but its ordinary daylight response hides the diffuse galaxy. The engine consequently omits that volume in daylight views.

The M4 comparison makes the conflict concrete. A 2,400 s exposure reveals the galaxy and clips Earth; 1/40,000 s preserves Earth and loses the faint field at the same pose, aperture and ISO. The 26.5165-stop separation is useful evidence for a photographic camera. It does not satisfy the default art direction.

The requested reference is SpaceEngine's distinction between HDR, Auto and Manual. Its 2017 rendering explanation describes an HDR view with planets and stars visible together, alongside two photographic modes that differ in who sets exposure. This decision adopts that visual distinction, without prescribing SpaceEngine's rendering technique.

Decision

Enhanced is the default HDR composite; Automatic meters one photographic exposure, and Manual gives that exposure to the player.

Enhanced deliberately compresses the brightness differences between bright surfaces, stars and faint extended emission. Its normal Earth-orbit view shows planetary detail and recognizable galactic structure together, within the display's limits. Dark lanes stay dark relative to neighboring star clouds; bright stars retain their hierarchy; the planet remains the foreground subject. The result needs no long-shutter setup or galaxy-instrument preset.

Automatic and Manual share physical source brightness, lighting, optics and a bounded photographic response. Automatic meters scene light and adapts within the player's comfort limits. Manual uses aperture, shutter and ISO without meter-driven gain. Neither applies Enhanced's selective visibility treatment. Exposing for sunlit Earth or Luna suppresses faint stars. A view with little bright light permits Automatic to reveal them; Manual requires a change of settings. A night-side coordinate alone does not decide exposure. Bright limbs, planetshine, atmospheric scattering and glare can still affect the image.

There are three separate choices:

  • Camera mode determines exposure and composite behavior.
  • A tone curve determines the rendering of that mode's image. Changing a curve does not change metering, source light, or which mode is active. The controls expose one authored Enhanced look and the shared neutral photographic look. Imported Gentle and Crisp settings retain their explicit photographic shoulders.
  • Display output determines gamut and available luminance headroom. Enhanced works on ordinary SDR sRGB displays. Display P3 is a gamut, and extended luminance is a separate capability, as distinguished by CSS Color HDR.

The interface calls the default Enhanced, with HDR composite in its description. HDR output names the separate display setting. Automatic's readout states metered exposure; Manual states the lens exposure; Enhanced states its composite processing instead of claiming one physical EV describes the whole image. A fixed diagnostic or cinematic exposure identifies its override in the readout.

resolveCameraPolicy in packages/rendering resolves selected mode, response style, effective exposure control and any staging override. ExposureMeter reports effective EV, gain relative to the lens, compensation and the override. A positive compensation brightens Automatic; it cannot add gain to Manual. Enhanced holds the 30,000 cd/m² surface calibration and declares its separate sky processing. Display peak and output negotiation do not select a mode.

Standing inside an atmosphere, Enhanced meters. In space the calibration is the point: the sun is the same sun wherever the ship is. On the ground the light itself goes away. Measured air puts a civil-dusk zenith near 0.65 cd/m², thirteen stops under a noon one, and at the calibration that sky drew black where a camera or an eye has opened by some ten stops. No figure for the light at the eye says what the frame holds: keyed on the zenith and the direct sun, Enhanced opened 4.1 stops on Mars with the sun 2.6° under the surface's horizon, where the zenith was dark and the horizon, still sunlit from 7.7 km up, was not, and the sky drew white. So inside the air Enhanced takes the meter Automatic takes, at Automatic's rates and within its comfort range, with no compensation: the exposure is the calibration above the air, the meter a fifth of the way into it, and a blend between (meteredShare). On the ground Enhanced and Automatic agree about the light; what Enhanced adds there is its staging. A pinned or staged exposure ignores the meter. What Enhanced stages rather than measures is held at its display level while the exposure is away from the calibration (stagedLight): the composed galaxy, the three-percent night fill, the lens flare, and the near field's key, fill and ambient, alongside the integrated stars, which already carried the inverse.

From orbit, Enhanced draws the limb a second time. The physical limb is a line: Earth's gas falls off over 8.5 km, a seventh of a percent of the radius, two pixels on a disk four hundred across, and a camera's limb is that line and no more. The deep-space composite is where the bible licenses a cheat, and the bright line the home page draws on the disk's edge is one. Outside the air, the shell marches the air again as the body's own gas, without its ozone, stretched to fall off over three of its own scale heights (LIMB_STRETCH, 25 km on Earth) or a fifth of the eye's height over the datum, whichever is less (limbFalloff, LIMB_STANDOFF), so the eye is never inside the gas it draws — the same column LIMB_GAIN times over, ending at two of its fall-offs (LIMB_CEILING_FALLOFFS) or at the top of the air where that is higher, as it is on Earth, read through the body's own tables at the height the stretch maps a sample to, and drawn LIMB_BRIGHTNESS times over (marchLimb in render/air.ts, ADR-0056 for the physics). At four fall-offs the crown, lit clear of the reddened foot, is a periwinkle band twice the height of the orange under it, and Mars's sunset limb a broad blue-white arch where a photograph has a thin line. A multiple of the gas and not a fraction of the radius, so it is the same ring on every world; at a twenty-fifth of the radius the ring stood off Earth's disk as a halo four to seven percent of the radius wide, which the owner rejected, and a fraction small enough for Earth is under Titan's own gas. The brightness is a radiance gain because the stretched foot is optically thick along a tangent — sixteen in Earth's blue — so more column only raises the height where the ring turns opaque; at six the line is the brightest thing on the disk's edge and a sunrise from low orbit is orange under white under blue. The aerosol rides in the ring at its whole column, falls off over the gas's own scale height, and scatters without taking: what it would take is the limb's own line, while its forward lobe — fifty times its side-scatter — is the orange every photograph of a limb has toward the sun, and its gray the white between the orange and the blue. Over the gas's own height it is the lower third of the ring on every world, so the lobe stays at the foot: stretched with the gas, Mars's mixed dust and Titan's haze, three times its gas, fill the ring and paint a broad tan-white arch over a limb photographed as a thin line, and under the gas's height Earth's white is a thread and its low-orbit sunrise orange under blue. At a quarter of the column the orange is a thread too. A dust that is the whole column (aerosolSky, ADR-0056) is the exception: it rides at its whole column and takes as it scatters, because six times an opaque dust that takes nothing is a white band — Mars's sunset limb from low orbit at 219 : 192 : 191 — and taking, six times over, is six times its lit surface, a butterscotch line on the edge. A column past two of Earth's visible ones is its own ring: the lift's share falls from one to nothing between LIMB_OWN_FROM and LIMB_OWN_TO columns (limbShare), since drawn six times over on a column opaque along its tangent the ring is a hard orange rim inside a limb the physics already draws as a broad glow — Titan's, at ten. The share scales RenderBody.limb, which also clears a surface from orbit, so a deep haze's face is drawn through its measured air. The ozone stays in the physics, where it turns a twilight zenith blue from the ground; stretched up the ring and drawn six times over, its tent took the orange out of the band between the foot and the crown, so a low-orbit sunrise read orange under violet with no white between and every lit rim a blue-violet. Nothing authors a color. The ring's crown is blue because the sun reaches it clear; its foot is orange toward the sun because the table's column reddens the beam there and the lobe throws it forward; and the ring ends where the sun sets on the gas as it stands on this planet, foot first — a backlit Earth wears it all round. The ring is the shell's alone, drawn past the silhouette. The sphere, the ground and the sea take the physical air's light: the lifted gas is the same column a second time at nadir, and composed over the disk it laid a blue veil that turned a Blue Marble's Sahara magenta (143 : 125 : 137 where the physics draws 140 : 114 : 109). Under the same lift they take none of its extinction (clearedFromOrbit): from orbit the measured air dims a surface twice, on the sun's way down and the eye's way out, to about two thirds of its own light at nadir, and reddens it toward the terminator, so a half-lit Earth's day side read dark brown under a hard terminator where the composite has a pale face. Enhanced lights the surface at its own light, in the hue the beam's slant gives it over the column overhead, at half its reddening — white at the subsolar point, peach on a sunward crescent — shows it without the view path's extinction, and keeps the air's light over it, which is the haze toward the limb, lit by the beam cleared halfway so the day side brightens into a pale haze before the terminator as the composite's does. A beam the column has all but put out, under 0.3 of the overhead light, is divided by that floor rather than brought to full brightness, or it lights the air over the night side orange; the sphere, the ground and the sea take it from the one lift, and on the ground the lift is nothing. Under a sun 30° over the tangent point the shell 20 km past the edge reads within a tenth of the disk 20 km inside it, so the edge does not step there; with the sun on the tangent point's horizon the shell is nearly twice the disk, and the ring is a bright line past the edge. The ring takes no light from the limb's own line, which seen through it keeps a quarter of its blue and turns a sunrise's band gray from low orbit, nor from the stars behind it, where a stretched gas wears a dark halo wherever its own light is under a count. The lift comes in over two shell heights up from the top of the air (limbLift), full by three hundred kilometers on Earth, where the reference photographs are taken from, so a ship climbing out keeps the sky it had, and the shell mesh grows to the ring's ceiling with it (limbReach); the photographic views never see it.

The neutral look keeps a light's hue through the whole curve, and over its top 5% it rolls a saturated light toward white rather than down. Mixing toward the gray of its own luminance, only as far as its brightest channel needs, keeps both the luminance and the hue angle. Scaled down instead, a 2° sun drew darker than its own aureole (0.55 against 0.79), where a camera clips the disk to a pale core. A star's darkened limb, below that top 5%, keeps the color it is drawn with.

Enhanced compresses diffuse sky luminance before the scene's half-float conversion. The owned sky target retains physical V-anchored radiance in nW m⁻² sr⁻¹; the composition reads that radiance and applies a presentation gain followed by bounded luminance compression. Uniform RGB scaling preserves chromaticity, zero remains zero, and the physical target stays available for photographic views and diagnostics. The full-resolution scene applies depth and silhouette coverage before the composed sky enters the common optics. Atmospheric transmission and modeled dust attenuation remain upstream of this visibility treatment. The lifted sky feeds glare and detector noise in Enhanced. Automatic meters only its photographic inputs.

The diffuse gain is 2^23, with a scene-luminance ceiling of 0.5 before the shared display response. The wider shoulder preserves contrast between faint background, dark lanes and bright star clouds. It changes no source radiance, physical cache or photographic exposure, and adds no passes or allocations.

The air in front of the sky is part of the sky being compressed. Standing inside an atmosphere, the eye sees the field through the air's own light, and a lift measured against the field alone draws the galactic bulge through a noon sky, brighter than the air it is seen through. Bodies publishes the luminance of the zenith over the eye as airLuminance, from the shell's own march along one radial (zenithSkyRadiance, held to the drawn zenith on the GPU), and the composition adds it, lifted by the same gain, to the compression's denominator. In a vacuum the term is zero and the field is composed as above. Under a noon sky the field keeps its physical share of the air, which is nothing a display can show, and it returns as the air darkens through twilight. Integrated stars lose the eye's response to the same sky (skyMagnitudeLoss: 2.5 · 0.59 · log₁₀(1 + B/B_night) magnitudes, fitted to a 6.5 limit under a moonless sky and −4 under a 5,000 cd/m² day). Both apply under Enhanced only; the photographic views add the air and the field physically and need neither. How bright that air is, and when it goes dark, is ADR-0056's measurement, not a camera setting.

Enhanced also owns the dark-body visibility lift, integrated star visibility and analytic solar core. Its near-field ambient and camera fill reach the hull and props. Photographic views disable both; only a script's explicit calibratedLight staging can retain them. Automatic and Manual use physical lighting and stellar flux with the same hue-preserving photographic response. A script can explicitly request calibrated lighting and the measured ACES staging look with calibratedLight; this is an authored override with a fixed exposure, and it releases when the script exits. Scripts do not rewrite the viewer's preference. Ordinary galaxy travel preserves the selected mode. Fixed photometric instruments request their stated photographic exposure explicitly.

The source model stays calibrated independently of camera mode. Catalog luminosities, geometric albedos, dust columns and emitted radiance do not change to make Enhanced attractive. Visibility processing belongs to the presentation chain and remains inspectable. It respects foreground occlusion, atmospheric transmission and dust extinction. It cannot paint a sky over a planet, restore stars hidden behind opaque dust, or manufacture illumination on an unlit body. Any dark-surface lift is an explicit Enhanced treatment.

A mapped surface takes reflectance from its texture and hue from a normalized tint. A mapless surface takes reflectance from its physical palette. The sphere, streamed ground and orbital reflectance bake share that convention; a bake contains no camera visibility gain. Enhanced applies its bounded dark-body gain once, at the scene material. Its 3% terrain and water fill is also visibility processing. Photographic modes retain modeled atmospheric scattering but apply neither that floor nor the dark-body gain.

Cloud maps remain thin weather shells. Their coverage clears continuously over the last quarter of a deck-altitude before the eye crosses the shell. One float64 eye altitude fades the entire oblate deck, including grazing rays, and follows render compression. Front-face culling cannot remove a bright veil in one frame. Distant coverage is unchanged, and every camera mode uses the same approximation. This is not a volumetric cloud model.

One sensor chain and the existing camera/lens producers remain in charge. Camera settings and adaptation are presentation state, outside the canonical world and its hash. ADR-0029 continues to govern the chain; ADR-0017 governs the lens. Pre-exposure, optical resource ownership, output negotiation and the numerical evidence in ADR-0031 remain useful. Its Natural image is a reference, not a release constraint.

Enhanced makes the diffuse sky part of ordinary gameplay cost. Eligibility cannot follow the Natural daylight predicate. The owned ordinary-view cache retains physical sky radiance and bounds its updates. Cache behavior and bake/live identity belong to ADR-0038. Photographic culling needs a conservative visibility bound through the actual optics and response, including glare, rather than an exposure label alone.

Automatic samples every fourth pixel in each axis into 64 logarithmic bins. An R8 instrument mask excludes samples covered by labels, orbit traces, landing marks and other instruments. The reducer excludes empty bin zero, trims the 40th–99.9th percentile interval and weights log luminance by light. A small lit disk can then dominate faint sky without an isolated hot pixel setting exposure. Comfort limits apply to retained physical luminance with the current settings, even when adaptation is held. Holding exposure leaves the mode Automatic.

Adaptation uses the engine's accumulated presentationTime, with frame deltas bounded at 0.1 s and time constants of 0.4 s toward bright and 3.5 s toward dark. Photographic time still places bodies and controls motion and detector noise. Camera cuts, mode changes and photographic-time scrubs reset meter history; generation checks discard asynchronous results from an earlier history. Manual and pinned frames ignore meter gain and repeat at a held instant.

Camera continuity is measured in universe coordinates with the render origin and its orientation. A 4,096 m origin rebase cannot become an exposure cut. The physical displacement and recent velocity distinguish a discontinuity from continuous travel; target, lens and held-time changes also invalidate history. Motion blur bypasses origin changes, camera cuts and time discontinuities, then resumes with continuous transforms. Exposure-key changes alone preserve that transform history. Defocus readbacks require the submitted lens and viewport, independently of exposure generations changed by a photographic scrub. Automatic reports Calibrating until it has a meter reading, then Metered or Held according to the adaptation setting.

The WebGL fallback supports Enhanced SDR and lens-controlled Manual. Automatic is visibly unavailable because that backend has no supported meter readback. A requested Automatic view uses a labeled Manual fallback while retaining the selected preference. A fixed calibration is never reported as metered exposure.

The preference owner migrates valid Composite + Natural to Enhanced, the other Composite curves to Automatic, and Direct to Manual. Natural maps explicitly to the neutral photographic look; Gentle and Crisp preserve their shoulders. White balance, adaptation rate and comfort limits survive. The lens preference retains aperture, shutter and ISO. Migration is written through state/preferences.ts; malformed imports are rejected without resetting the current selection.

Alternatives considered

Rename Natural and retain its behavior. This leaves bright planets and the diffuse galaxy mutually exclusive and preserves the wrong performance premise.

Raise one global exposure or brighten the galaxy field. The first clips the foreground; the second corrupts calibration for every consumer. Enhanced needs a declared presentation response with enough precision to retain faint light until that response can use it.

Make photographic exposure the default. Scientifically useful, but it does not meet the requested composition. Automatic and Manual provide it.

Require an HDR monitor. The default composition must work in sRGB SDR. Extra display headroom improves highlights without deciding camera behavior.

Keep Direct and Composite as additional player modes. This duplicates exposure policy and tone-curve choices. Their serialized settings need an explicit migration; linear clipping can remain a developer diagnostic.

Consequences

Enhanced spends processing and cache memory to retain faint structure beside bright foregrounds. One global exposure cannot cover the 26.5165-stop M4 comparison without losing either the galaxy or surface detail. The physical field remains independently calibrated, and its diagnostics bypass Enhanced.

Version 2 pictures and shot=2 URLs record camera processing without adaptation history or display hardware. Version 1 restores Enhanced while preserving its pose, photographic time and lens; historical image equality is not promised. ADR-0033 owns that portable format.

Numerical tests establish exposure arithmetic, strict migration, histogram behavior, physical continuity and surface-light separation. Image acceptance is a separate question from instrumented timing, and both are recorded rather than asserted: sixteen matched mode triplets, two transition recordings and four descent casts are inspected in CONTEXT.md, and the complete-frame operating points, the two journeys and the optical costs are in the performance plan. Enhanced draws the sky in ordinary gameplay, so those are whole-frame figures at named points and not a claim of sustained 60 fps — dense ground at a native Retina buffer runs around 30–34 fps. The source's smooth dust morphology remains an approximation; a camera response cannot recover missing structure. ADR-0038 owns the resolved-star and diffuse-sky implementation.