CLI, along with several examples, plus model downloading

examples/models/boxwing.gltf

@@ -0,0 +1,317 @@
+{
+ "asset": {
+  "version": "2.0",
+  "generator": "resolved scripts/make-example-model.py"
+ },
+ "scene": 0,
+ "scenes": [
+  {
+   "nodes": [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+   ]
+  }
+ ],
+ "nodes": [
+  {
+   "name": "bus",
+   "mesh": 0
+  },
+  {
+   "name": "radiator",
+   "mesh": 1
+  },
+  {
+   "name": "boom +y",
+   "mesh": 2
+  },
+  {
+   "name": "boom -y",
+   "mesh": 3
+  },
+  {
+   "name": "array +y",
+   "mesh": 4
+  },
+  {
+   "name": "array -y",
+   "mesh": 5
+  }
+ ],
+ "meshes": [
+  {
+   "name": "bus",
+   "primitives": [
+    {
+     "attributes": {
+      "POSITION": 0
+     },
+     "material": 0
+    }
+   ]
+  },
+  {
+   "name": "radiator",
+   "primitives": [
+    {
+     "attributes": {
+      "POSITION": 1
+     },
+     "material": 1
+    }
+   ]
+  },
+  {
+   "name": "boom +y",
+   "primitives": [
+    {
+     "attributes": {
+      "POSITION": 2
+     },
+     "material": 2
+    }
+   ]
+  },
+  {
+   "name": "boom -y",
+   "primitives": [
+    {
+     "attributes": {
+      "POSITION": 3
+     },
+     "material": 3
+    }
+   ]
+  },
+  {
+   "name": "array +y",
+   "primitives": [
+    {
+     "attributes": {
+      "POSITION": 4
+     },
+     "material": 4
+    }
+   ]
+  },
+  {
+   "name": "array -y",
+   "primitives": [
+    {
+     "attributes": {
+      "POSITION": 5
+     },
+     "material": 5
+    }
+   ]
+  }
+ ],
+ "materials": [
+  {
+   "name": "bus",
+   "pbrMetallicRoughness": {
+    "baseColorFactor": [
+     0.8,
+     0.6,
+     0.2,
+     1.0
+    ]
+   }
+  },
+  {
+   "name": "radiator",
+   "pbrMetallicRoughness": {
+    "baseColorFactor": [
+     0.85,
+     0.85,
+     0.85,
+     1.0
+    ]
+   }
+  },
+  {
+   "name": "boom +y",
+   "pbrMetallicRoughness": {
+    "baseColorFactor": [
+     0.3,
+     0.3,
+     0.3,
+     1.0
+    ]
+   }
+  },
+  {
+   "name": "boom -y",
+   "pbrMetallicRoughness": {
+    "baseColorFactor": [
+     0.3,
+     0.3,
+     0.3,
+     1.0
+    ]
+   }
+  },
+  {
+   "name": "array +y",
+   "pbrMetallicRoughness": {
+    "baseColorFactor": [
+     0.05,
+     0.08,
+     0.2,
+     1.0
+    ]
+   }
+  },
+  {
+   "name": "array -y",
+   "pbrMetallicRoughness": {
+    "baseColorFactor": [
+     0.05,
+     0.08,
+     0.2,
+     1.0
+    ]
+   }
+  }
+ ],
+ "accessors": [
+  {
+   "bufferView": 0,
+   "componentType": 5126,
+   "count": 36,
+   "type": "VEC3",
+   "min": [
+    -0.5,
+    -0.5,
+    -0.75
+   ],
+   "max": [
+    0.5,
+    0.5,
+    0.75
+   ]
+  },
+  {
+   "bufferView": 1,
+   "componentType": 5126,
+   "count": 6,
+   "type": "VEC3",
+   "min": [
+    -0.45,
+    -0.45,
+    -0.76
+   ],
+   "max": [
+    0.45,
+    0.45,
+    -0.76
+   ]
+  },
+  {
+   "bufferView": 2,
+   "componentType": 5126,
+   "count": 36,
+   "type": "VEC3",
+   "min": [
+    -0.025,
+    0.5,
+    -0.025
+   ],
+   "max": [
+    0.025,
+    1.0,
+    0.025
+   ]
+  },
+  {
+   "bufferView": 3,
+   "componentType": 5126,
+   "count": 36,
+   "type": "VEC3",
+   "min": [
+    -0.025,
+    -1.0,
+    -0.025
+   ],
+   "max": [
+    0.025,
+    -0.5,
+    0.025
+   ]
+  },
+  {
+   "bufferView": 4,
+   "componentType": 5126,
+   "count": 6,
+   "type": "VEC3",
+   "min": [
+    0,
+    1.0,
+    -0.5
+   ],
+   "max": [
+    0,
+    4.0,
+    0.5
+   ]
+  },
+  {
+   "bufferView": 5,
+   "componentType": 5126,
+   "count": 6,
+   "type": "VEC3",
+   "min": [
+    0,
+    -4.0,
+    -0.5
+   ],
+   "max": [
+    0,
+    -1.0,
+    0.5
+   ]
+  }
+ ],
+ "bufferViews": [
+  {
+   "buffer": 0,
+   "byteOffset": 0,
+   "byteLength": 432
+  },
+  {
+   "buffer": 0,
+   "byteOffset": 432,
+   "byteLength": 72
+  },
+  {
+   "buffer": 0,
+   "byteOffset": 504,
+   "byteLength": 432
+  },
+  {
+   "buffer": 0,
+   "byteOffset": 936,
+   "byteLength": 432
+  },
+  {
+   "buffer": 0,
+   "byteOffset": 1368,
+   "byteLength": 72
+  },
+  {
+   "buffer": 0,
+   "byteOffset": 1440,
+   "byteLength": 72
+  }
+ ],
+ "buffers": [
+  {
+   "byteLength": 1512,
+   "uri": "data:application/octet-stream;base64,AAAAvwAAAL8AAEC/AAAAvwAAAD8AAEC/AAAAPwAAAD8AAEC/AAAAvwAAAL8AAEC/AAAAPwAAAD8AAEC/AAAAPwAAAL8AAEC/AAAAvwAAAL8AAEA/AAAAPwAAAL8AAEA/AAAAPwAAAD8AAEA/AAAAvwAAAL8AAEA/AAAAPwAAAD8AAEA/AAAAvwAAAD8AAEA/AAAAvwAAAL8AAEC/AAAAPwAAAL8AAEC/AAAAPwAAAL8AAEA/AAAAvwAAAL8AAEC/AAAAPwAAAL8AAEA/AAAAvwAAAL8AAEA/AAAAvwAAAD8AAEC/AAAAvwAAAD8AAEA/AAAAPwAAAD8AAEA/AAAAvwAAAD8AAEC/AAAAPwAAAD8AAEA/AAAAPwAAAD8AAEC/AAAAvwAAAL8AAEC/AAAAvwAAAL8AAEA/AAAAvwAAAD8AAEA/AAAAvwAAAL8AAEC/AAAAvwAAAD8AAEA/AAAAvwAAAD8AAEC/AAAAPwAAAL8AAEC/AAAAPwAAAD8AAEC/AAAAPwAAAD8AAEA/AAAAPwAAAL8AAEC/AAAAPwAAAD8AAEA/AAAAPwAAAL8AAEA/ZmbmvmZm5r5cj0K/ZmbmvmZm5j5cj0K/ZmbmPmZm5j5cj0K/ZmbmvmZm5r5cj0K/ZmbmPmZm5j5cj0K/ZmbmPmZm5r5cj0K/zczMvAAAAD/NzMy8zczMvAAAgD/NzMy8zczMPAAAgD/NzMy8zczMvAAAAD/NzMy8zczMPAAAgD/NzMy8zczMPAAAAD/NzMy8zczMvAAAAD/NzMw8zczMPAAAAD/NzMw8zczMPAAAgD/NzMw8zczMvAAAAD/NzMw8zczMPAAAgD/NzMw8zczMvAAAgD/NzMw8zczMvAAAAD/NzMy8zczMPAAAAD/NzMy8zczMPAAAAD/NzMw8zczMvAAAAD/NzMy8zczMPAAAAD/NzMw8zczMvAAAAD/NzMw8zczMvAAAgD/NzMy8zczMvAAAgD/NzMw8zczMPAAAgD/NzMw8zczMvAAAgD/NzMy8zczMPAAAgD/NzMw8zczMPAAAgD/NzMy8zczMvAAAAD/NzMy8zczMvAAAAD/NzMw8zczMvAAAgD/NzMw8zczMvAAAAD/NzMy8zczMvAAAgD/NzMw8zczMvAAAgD/NzMy8zczMPAAAAD/NzMy8zczMPAAAgD/NzMy8zczMPAAAgD/NzMw8zczMPAAAAD/NzMy8zczMPAAAgD/NzMw8zczMPAAAAD/NzMw8zczMvAAAgL/NzMy8zczMvAAAAL/NzMy8zczMPAAAAL/NzMy8zczMvAAAgL/NzMy8zczMPAAAAL/NzMy8zczMPAAAgL/NzMy8zczMvAAAgL/NzMw8zczMPAAAgL/NzMw8zczMPAAAAL/NzMw8zczMvAAAgL/NzMw8zczMPAAAAL/NzMw8zczMvAAAAL/NzMw8zczMvAAAgL/NzMy8zczMPAAAgL/NzMy8zczMPAAAgL/NzMw8zczMvAAAgL/NzMy8zczMPAAAgL/NzMw8zczMvAAAgL/NzMw8zczMvAAAAL/NzMy8zczMvAAAAL/NzMw8zczMPAAAAL/NzMw8zczMvAAAAL/NzMy8zczMPAAAAL/NzMw8zczMPAAAAL/NzMy8zczMvAAAgL/NzMy8zczMvAAAgL/NzMw8zczMvAAAAL/NzMw8zczMvAAAgL/NzMy8zczMvAAAAL/NzMw8zczMvAAAAL/NzMy8zczMPAAAgL/NzMy8zczMPAAAAL/NzMy8zczMPAAAAL/NzMw8zczMPAAAgL/NzMy8zczMPAAAAL/NzMw8zczMPAAAgL/NzMw8AAAAAAAAgD8AAAC/AAAAAAAAgEAAAAC/AAAAAAAAgEAAAAA/AAAAAAAAgD8AAAC/AAAAAAAAgEAAAAA/AAAAAAAAgD8AAAA/AAAAAAAAgMAAAAC/AAAAAAAAgL8AAAC/AAAAAAAAgL8AAAA/AAAAAAAAgMAAAAC/AAAAAAAAgL8AAAA/AAAAAAAAgMAAAAA/"
+  }
+ ]
+}

examples/scenes/ace.toml

@@ -0,0 +1,20 @@
+# The Advanced Composition Explorer (26k triangles). The real ACE sits at the
+# Sun-Earth L1 point; here it is put in low orbit, in an isometric view with
+# Earth's limb behind it. Generated by scripts/make-example-scenes.py; the model
+# comes from scripts/fetch-models.sh.
+#
+#   resolved render --scene examples/scenes/ace.toml --preview ace.png
+
+sun = [111172883513, -100100513931, 0]
+moon = [0, 0, -3.844e8]
+
+[observer]
+position = [7000036.38, -73.51, 0.00]
+look_at = [7000000.00, 0.00, 0.00]
+up = [1, 0, 0]
+
+[[target]]
+model = "../models/nasa/ace.glb"
+scale = 0.00485
+position = [7000000.0000, 0.0000, 0.0000]
+attitude = [0.218913627, -0.630230282, 0.320639661, -0.672366584]

examples/scenes/boxwing-epoch.toml

@@ -0,0 +1,18 @@
+# The same view at a real epoch, with the Sun, Moon and Earth's orientation from
+# astrokit's ephemerides (needs the astrokit feature and its kernels). The geometry of
+# boxwing.toml is rotated as a whole so its Sun direction matches the real Sun's at
+# this epoch: same limb, same isometric view, same lighting.
+#
+#   resolved render --scene examples/scenes/boxwing-epoch.toml --preview epoch.png
+
+epoch = "2026-10-14T12:00:00 UTC"
+
+[observer]
+position = [-3309620.6, -6112901.3, -824149.4]
+look_at = [-3309561.3, -6112904.1, -824140.5]
+up = [-0.472794, -0.873272, -0.117734]
+
+[[target]]
+model = "../models/boxwing.gltf"
+position = [-3309561.3, -6112904.1, -824140.5]
+attitude = [0.411662751, 0.017111321, -0.752389012, 0.51395696]

examples/scenes/boxwing.toml

@@ -0,0 +1,29 @@
+# A box-wing satellite 7000 km from Earth's center (about 620 km up), seen from 60 m
+# with Earth's limb behind it.
+#
+# The camera looks 63.7 degrees from straight down. At this altitude the limb is
+# 65.7 degrees from straight down, so it crosses the image about 2 degrees (320 px)
+# above the center, with Earth below and space above. Image up is the local vertical.
+#
+# The satellite is turned so the camera sees it along its (+1, +1, +1) body diagonal,
+# an isometric view of the +X (array side), +Y and +Z faces, with +Z toward image up.
+# The Sun is placed to light those three faces and the Earth near the limb.
+#
+#   resolved render --scene examples/scenes/boxwing.toml --preview boxwing.png
+
+sun = [111155951345, -100085268138, 2610842842]
+moon = [0, 0, -3.844e8]
+
+# Anything left out keeps the example camera's value.
+[camera]
+exposure = 1e-4
+
+[observer]
+position = [7000026.62, -53.77, 0.0]
+look_at = [7000000.0, 0.0, 0.0]
+up = [1, 0, 0]
+
+[[target]]
+model = "../models/boxwing.gltf"
+position = [7000000.0, 0.0, 0.0]
+attitude = [0.218913627, -0.630230282, 0.320639661, -0.672366584]

examples/scenes/icesat2.toml

@@ -0,0 +1,19 @@
+# ICESat-2 (752k triangles) in its 496 km orbit; the heavy model for benchmarks,
+# in an isometric view with Earth's limb behind it. Generated by
+# scripts/make-example-scenes.py; the model comes from scripts/fetch-models.sh.
+#
+#   resolved render --scene examples/scenes/icesat2.toml --preview icesat2.png
+
+sun = [105781668823, -105781668823, 0]
+moon = [0, 0, -3.844e8]
+
+[observer]
+position = [6874182.69, -103.11, 0.00]
+look_at = [6874137.00, 0.00, 0.00]
+up = [1, 0, 0]
+
+[[target]]
+model = "../models/nasa/icesat2.glb"
+scale = 1.0
+position = [6874133.2074, 2.1303, -1.3429]
+attitude = [0.204578316, -0.623275321, 0.333957893, -0.676866097]

examples/scenes/landsat8.toml

@@ -0,0 +1,19 @@
+# Landsat 8 (85k triangles) in its 705 km orbit, in an isometric view with
+# Earth's limb behind it. Generated by scripts/make-example-scenes.py; the model
+# comes from scripts/fetch-models.sh.
+#
+#   resolved render --scene examples/scenes/landsat8.toml --preview landsat8.png
+
+sun = [111172883513, -100100513931, 0]
+moon = [0, 0, -3.844e8]
+
+[observer]
+position = [7083216.12, -150.19, 0.00]
+look_at = [7083137.00, 0.00, 0.00]
+up = [1, 0, 0]
+
+[[target]]
+model = "../models/nasa/landsat8.glb"
+scale = 1.0
+position = [7083133.0811, -2.1094, -2.6020]
+attitude = [0.227385402, -0.634228406, 0.312656887, -0.669549012]

examples/scenes/ostm.toml

@@ -0,0 +1,19 @@
+# OSTM / Jason-2 (65k triangles) in its 1336 km orbit, in an isometric view with
+# Earth's limb behind it. Generated by scripts/make-example-scenes.py; the model
+# comes from scripts/fetch-models.sh.
+#
+#   resolved render --scene examples/scenes/ostm.toml --preview ostm.png
+
+sun = [125463331183, -81476839938, 0]
+moon = [0, 0, -3.844e8]
+
+[observer]
+position = [7714190.15, -72.55, 0.00]
+look_at = [7714137.00, 0.00, 0.00]
+up = [1, 0, 0]
+
+[[target]]
+model = "../models/nasa/ostm.glb"
+scale = 3.5
+position = [7714137.0021, -0.1237, -0.1237]
+attitude = [0.276078628, -0.655532500, 0.265098361, -0.650984325]

examples/scenes/ssl1300.toml

@@ -0,0 +1,19 @@
+# An SSL-1300 communications satellite (182k triangles) in geostationary orbit,
+# in an isometric view with Earth's limb behind it. Generated by
+# scripts/make-example-scenes.py; the model comes from scripts/fetch-models.sh.
+#
+#   resolved render --scene examples/scenes/ssl1300.toml --preview ssl1300.png
+
+sun = [144500446867, 38718778044, 0]
+moon = [0, 0, -3.844e8]
+
+[observer]
+position = [42164291.13, -34.20, 0.00]
+look_at = [42164000.00, 0.00, 0.00]
+up = [1, 0, 0]
+
+[[target]]
+model = "../models/nasa/ssl1300.glb"
+scale = 0.1
+position = [42163999.7300, 0.2428, 0.3631]
+attitude = [0.513066177, -0.706858772, -0.018726374, -0.486583084]