@@ -645,7 +645,7 @@ A slotted-actions Z-rotation turntable keyed through the cross-version channelba
 </tr>
 <tr>
 <td width="46%" valign="middle">
-<a href="examples/driver-wave/"><img src="examples/driver-wave/preview.webp" alt="Driver wave: sixteen orange columns whose heights form a sine skyline on a dark studio floor, each driven by a driver_namespace function" /></a>
+<a href="examples/driver-wave/"><img src="examples/driver-wave/preview.webp" alt="Driver wave: sixteen orange columns seen from above whose heights form a sine wave on a dark studio floor, each driven by a driver_namespace function" /></a>
 </td>
 <td valign="middle">
 
 
@@ -16,13 +16,13 @@
   <meta property="og:image" content="https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/assets/driver-wave-hero.webp" />
   <meta property="og:image:width" content="1280" />
   <meta property="og:image:height" content="720" />
-  <meta property="og:image:alt" content="A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends." />
+  <meta property="og:image:alt" content="A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor." />
   <meta property="og:site_name" content="Blender Developer Tools" />
   <meta name="twitter:card" content="summary_large_image" />
   <meta name="twitter:title" content="driver-wave — Examples — Blender Developer Tools" />
   <meta name="twitter:description" content="A driver_namespace function driving sixteen column heights through SCRIPTED drivers — the sine skyline is entirely driver-evaluated." />
   <meta name="twitter:image" content="https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/assets/driver-wave-hero.webp" />
-  <meta name="twitter:image:alt" content="A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends." />
+  <meta name="twitter:image:alt" content="A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor." />
   <style>
     /* fonts are deployed by the landing build (docs/fonts/) */
     @font-face { font-family: 'Barlow Condensed'; font-weight: 600; font-display: swap;
@@ -268,8 +268,8 @@ <h1>driver-wave</h1>
     <p>A driver_namespace function driving sixteen column heights through SCRIPTED drivers — the sine skyline is entirely driver-evaluated.</p>
   </header>
   <main id="main">
-    <button class="detail-hero" id="heroZoom" type="button" aria-label="View full size: A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends.">
-      <img src="../assets/driver-wave-hero.webp" alt="A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends." width="1280" height="720" />
+    <button class="detail-hero" id="heroZoom" type="button" aria-label="View full size: A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor.">
+      <img src="../assets/driver-wave-hero.webp" alt="A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor." width="1280" height="720" />
     </button>
     <p class="zoom-hint">Rendered headless by the example itself — click to zoom.</p>
     <div class="callout"><span class="tag">witnesses</span> Driven values appear after a view-layer update in two places that must agree: the evaluated copy and the original datablock the animation system flushes for display.</div>
@@ -281,6 +281,8 @@ <h1>driver-wave</h1>
 <p>A runnable example that drives sixteen column heights from a custom function registered in <code>bpy.app.driver_namespace</code> — the pattern from <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/skills/drivers-and-app-handlers/SKILL.md"><code>drivers-and-app-handlers</code></a>. Each column gets a SCRIPTED driver on Z scale whose expression calls <code>wave_scale(i)</code>, producing a sine skyline.</p>
 <p><strong>What it witnesses:</strong> the driver evaluation contract. Driven values appear only after a view-layer update, and they land in <strong>two</strong> places that must agree: the depsgraph-evaluated copy (<code>evaluated_get(dg).scale</code>) and the original datablock, which the animation system flushes for display. The check asserts both against the closed-form profile.</p>
 <p>Note for real add-ons: <code>driver_namespace</code> entries do <strong>not</strong> persist in <code>.blend</code> files — re-register them from a <code>load_post</code> handler, or every driver that calls them fails on file open. Headless, registering before driver creation (as here) is enough.</p>
+<h2>Staging</h2>
+<p>The camera is raised to look down about 18 degrees, so the column tops and their shadows read as a wave. From nearly level (86 degrees) the skyline flattened into a bar chart. Render path only.</p>
 <h2>Run</h2>
 <pre><code># Cheap correctness check (no render) — the CI check:
 blender --background --python driver_wave.py --
@@ -457,8 +459,10 @@ <h2>Source</h2>
     <span class="c"># the frame with a small margin -- the skyline must not clip</span>
     cam_data = bpy.data.cameras.new(<span class="s">&quot;Cam&quot;</span>); cam_data.lens = <span class="n">42.0</span>
     cam = bpy.data.objects.new(<span class="s">&quot;Cam&quot;</span>, cam_data)
-    cam.location = (<span class="n">0.0</span>, -<span class="n">15.0</span>, <span class="n">2.0</span>)
-    cam.rotation_euler = (math.radians(<span class="n">86</span>), <span class="n">0.0</span>, <span class="n">0.0</span>)
+    <span class="c"># raised so the column tops and their shadows read as a wave; from</span>
+    <span class="c"># nearly level (86 deg) it flattened into a bar chart</span>
+    cam.location = (<span class="n">0.0</span>, -<span class="n">14.2</span>, <span class="n">5.6</span>)
+    cam.rotation_euler = (math.radians(<span class="n">72</span>), <span class="n">0.0</span>, <span class="n">0.0</span>)
     scene.collection.objects.link(cam)
     scene.camera = cam
 
@@ -528,7 +532,7 @@ <h2>Source</h2>
   </main>
   <dialog class="lightbox" id="lightbox" aria-label="Full-size render">
     <button class="lightbox-close" type="button" autofocus>Close</button>
-    <img src="../assets/driver-wave-hero.webp" alt="A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends." />
+    <img src="../assets/driver-wave-hero.webp" alt="A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor." />
   </dialog>
   <footer>
     <div class="statusbar">
 
@@ -398,7 +398,7 @@ <h2><a href="wave-displace/">wave-displace</a></h2>
       </article>
       <article class="card" data-tags="drivers animation">
         <a class="card-media" href="driver-wave/" tabindex="-1" aria-hidden="true">
-          <img src="assets/driver-wave-hero.webp" alt="A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends." loading="lazy" decoding="async" />
+          <img src="assets/driver-wave-hero.webp" alt="A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor." loading="lazy" decoding="async" />
         </a>
         <div class="card-body">
           <h2><a href="driver-wave/">driver-wave</a></h2>
@@ -1069,12 +1069,12 @@ <h2><a href="water-trough/">water-trough</a></h2>
       </article>
       <article class="card" data-tags="mesh export showcase">
         <a class="card-media" href="hitching-post/" tabindex="-1" aria-hidden="true">
-          <img src="assets/hitching-post-hero.webp" alt="A tall wooden hitching post with a pointed cap, a crossbar and two iron rings." loading="lazy" decoding="async" />
+          <img src="assets/hitching-post-hero.webp" alt="A tall wooden hitching post with a pointed cap, a crossbar, two iron bands wrapped around the post and two iron rings." loading="lazy" decoding="async" />
         </a>
         <div class="card-body">
           <h2><a href="hitching-post/">hitching-post</a></h2>
           <p class="teaches">A procedural hitching post (eaved cap, one rail, cup shoe, rings hung through eyes) through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.</p>
-          <p class="witnesses"><span class="tag">witnesses</span> Recomputed: 1680 tris, two materials with 114 wood and 742 metal faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.500×0.149×1.246 m, zmin 0, hygiene and coplanar pairs 0, post seated at z 0.010, ring centerline error 0, LOD ratios in band, convex collider 80 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert and --twin-sole exit 15; --lift-z exits 16; --clip-ring exits 18; --short-post exits 19.</p>
+          <p class="witnesses"><span class="tag">witnesses</span> Recomputed: 1680 tris, two materials with 114 wood and 742 metal faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.500×0.149×1.246 m, zmin 0, hygiene and coplanar pairs 0, post seated at z 0.010, ring centerline error 0, bands 6.5 mm proud of the post, LOD ratios in band, convex collider 80 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert and --twin-sole exit 15; --lift-z exits 16; --clip-ring and --sunk-bands exit 18; --short-post exits 19.</p>
           <a class="card-link" href="hitching-post/">View showcase piece<span class="sr-only"> hitching-post</span> <span aria-hidden="true">&rarr;</span></a>
         </div>
       </article>
@@ -1091,7 +1091,7 @@ <h2><a href="grindstone/">grindstone</a></h2>
       </article>
       <article class="card" data-tags="mesh export showcase">
         <a class="card-media" href="hand-pump/" tabindex="-1" aria-hidden="true">
-          <img src="assets/hand-pump-hero.webp" alt="A dark iron village hand pump with a curved spout and lever handle on a square wooden plinth." loading="lazy" decoding="async" />
+          <img src="assets/hand-pump-hero.webp" alt="A matte black cast-iron village hand pump with a curved spout and lever handle on a stepped wooden plinth." loading="lazy" decoding="async" />
         </a>
         <div class="card-body">
           <h2><a href="hand-pump/">hand-pump</a></h2>
 
@@ -15,6 +15,12 @@ Note for real add-ons: `driver_namespace` entries do **not** persist in `.blend`
 re-register them from a `load_post` handler, or every driver that calls them fails on file
 open. Headless, registering before driver creation (as here) is enough.
 
+## Staging
+
+The camera is raised to look down about 18 degrees, so the column tops
+and their shadows read as a wave. From nearly level (86 degrees) the
+skyline flattened into a bar chart. Render path only.
+
 ## Run
 
 ```bash
 
@@ -153,8 +153,10 @@ def render_still(objs, path, engine):
     # the frame with a small margin -- the skyline must not clip
     cam_data = bpy.data.cameras.new("Cam"); cam_data.lens = 42.0
     cam = bpy.data.objects.new("Cam", cam_data)
-    cam.location = (0.0, -15.0, 2.0)
-    cam.rotation_euler = (math.radians(86), 0.0, 0.0)
+    # raised so the column tops and their shadows read as a wave; from
+    # nearly level (86 deg) it flattened into a bar chart
+    cam.location = (0.0, -14.2, 5.6)
+    cam.rotation_euler = (math.radians(72), 0.0, 0.0)
     scene.collection.objects.link(cam)
     scene.camera = cam
 
 
@@ -73,7 +73,7 @@
       "name": "driver-wave",
       "dir": "examples/driver-wave",
       "teaches": "A driver_namespace function driving sixteen column heights through SCRIPTED drivers — the sine skyline is entirely driver-evaluated.",
-      "alt": "A row of orange bars whose heights rise and fall in a wave, low in the middle and tall at both ends.",
+      "alt": "A row of orange bars seen from above, their heights rising and falling in a wave, low in the middle and tall at both ends, each casting a shadow on the floor.",
       "witnessesFix": "Driven values appear after a view-layer update in two places that must agree: the evaluated copy and the original datablock the animation system flushes for display.",
       "hero": "docs/gallery/assets/driver-wave-hero.webp",
       "preview": "examples/driver-wave/preview.webp",