Added the gallery

readme.md

@@ -104,7 +104,9 @@ assert!(frame.dn_at(960, 540, 1) > 1000);
 observer, Sun and Moon positions (or an epoch, with the `astrokit` feature) and
 targets with their models. `examples/scenes/` has commented examples:
 `boxwing.toml` uses a small generated model that is in the repository, `lunar-eclipse.toml` and `solar-eclipse.toml` show two
-real eclipses at lighting L1, `full-moon.toml` the Moon's map, and the rest use NASA spacecraft models
+real eclipses at lighting L1, `full-moon.toml` the Moon's map, `earthrise.toml`
+and `moonrise.toml` put Earth, the Moon and a spacecraft in one view (from lunar
+orbit and from geostationary height), and the rest use NASA spacecraft models
 (Landsat 8, ICESat-2, OSTM/Jason-2, an SSL-1300 and ACE) that
 `scripts/fetch-models.sh` downloads into `examples/models/nasa/`. That script needs Node (for `npx`),
 because most NASA models are Draco-compressed and are decoded on the way in.
@@ -125,7 +127,7 @@ cargo run --release -p resolved-cli -- render \
 ```
 
 `scripts/make-gallery.sh` renders every example scene at L0 and L1 into
-`gallery/`, skipping any whose model or data is missing, and
+`gallery/` with `--pretty`, skipping any whose model or data is missing, and
 `scripts/serve-gallery.py` serves the result as a web page on port 8000 of
 every interface, each scene captioned from its file.
 
@@ -133,7 +135,12 @@ every interface, each scene captioned from its file.
   cameras usually store them: a 12-bit DN is the stored value divided by 16.
   It is linear, so it looks dark next to the preview.
 - `--preview` writes an 8-bit sRGB image for looking at, with the bias as
-  black and saturation as white.
+  black and saturation as white. It is the signal as recorded, so a scene
+  exposed to keep its brightest parts unsaturated looks dark.
+- `--pretty` makes the preview look like a photograph instead: white balanced
+  to sunlight, with a tone curve that brightens shadows and midtones by up to
+  3 times and rolls highlights off to white at saturation. `--out` is the same
+  either way.
 - `--timings N` renders N frames and reports setup and per-frame times.
 - `--lighting L0|L1` and `--camera C0` pick the fidelity tiers (default L0
   and C0). A tier the scene or the data cannot support stops with an error