Example and docs for blooming

examples/scenes/sun-glare.toml

@@ -0,0 +1,34 @@
+# Sun glare: an inspector 170 m below Landsat 8 in its 705 km orbit, looking up at
+# it 75 degrees above the horizon, with the Sun 3 degrees above and 0.7 to the side of
+# it, about 26,000 full wells at its center. The satellite is back-lit: dark at
+# lighting L0, and at L1 lit from below by the sunlit Earth. The camera is the
+# example camera with a CCD that has no anti-blooming drain: from camera tier C1 every
+# saturated pixel's excess runs up and down its column, and the Sun's columns streak
+# through the whole frame and across the end of the solar array. Generated by
+# scripts/make-example-scenes.py; the model comes from scripts/fetch-models.sh.
+#
+#   resolved render --scene examples/scenes/sun-glare.toml --camera C1 --pretty --preview glare.png
+#   resolved render --scene examples/scenes/sun-glare.toml --lighting L1 --camera C1 --pretty --preview glare.png
+
+sun = [146324960869, 31100825002, 1827637311]
+moon = [0, 0, -3.844e8]
+
+[camera]
+exposure = 0.0004
+blooming = { column = 1.0 }
+
+[observer]
+position = [7083137.00, 0.00, 0.00]
+look_at = [7083300.98, 43.94, 0.00]
+up = [1, 0, 0]
+
+# At lighting L1, Earth's surface shows July (from scripts/fetch-earth.sh), and lights
+# the satellite's Earth-facing side.
+[appearance]
+earth_month = 7
+
+[[target]]
+model = "../models/nasa/landsat8.glb"
+scale = 1.0
+position = [7083299.7864, 48.2259, -2.6020]
+attitude = [0.381303145, 0.151452723, -0.690696802, 0.595489640]