fix(examples): redesign gltf-export-roundtrip as one crate under its re-imported wire cage (#273)

The review found two identical crates labelled AUTHORED and ROUND-TRIP
in small floor text. Nothing differed between them, so the eye had
nothing to find.

The hero is now one crate. The solid crate is the authored one. Laid
over it is the actual re-imported mesh (the file's own triangles), drawn
as a thin amber wire cage through a render-only Weld + Wireframe display
stack, and masked to the right of a vertical cut. Neither object is
moved: both keep the identity transform that check 13 proves, and the
camera does the turning. The cage lands on every bevel, rivet and vent
slat only because the importer undid the +Y-up bake exactly. A probe
that puts back the missing quarter turn drops the cage through the
floor, and the framing gate fails too (bottom margin 0.000).

The crate grows from 35 to 43 box shells: vent slats under each carry
handle and stiffening ribs across the lid. The trim is a lighter
gunmetal and the paint a warmer olive. On the render path only, the
authored copy gets noise-mottled paint and trim. The check logic is
unchanged; its closed-form counts follow PARTS (344 cage verts, 9,288
evaluated loops).

The render path now also runs gallery_asset_quality on the authored
crate, with its 11 remapped to 23. The bevel is baked into the display
mesh first, because the edge measure reads Object.data, which is still
the square cage. The floor text is gone. read_gltf now opens the JSON
with encoding="utf-8". scripts/asset_sheet.py gains a SELECT row.

Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: TMHSDigital

README.md

@@ -832,7 +832,7 @@ portable path is `radius`.
 <table>
 <tr>
 <td width="46%" valign="middle">
-<a href="examples/gltf-export-roundtrip/"><img src="examples/gltf-export-roundtrip/preview.webp" alt="glTF export round-trip: two identical olive-drab sci-fi supply crates turned three-quarter on a dark studio floor - authored beside re-imported - with teal status strips, riveted panels, and corner armor, proving the export/import round-trip preserves the asset" /></a>
+<a href="examples/gltf-export-roundtrip/"><img src="examples/gltf-export-roundtrip/preview.webp" alt="glTF export round-trip: one olive-drab sci-fi supply crate on a dark studio floor, its right half traced by an amber wire cage of the re-imported glTF triangles that lands exactly on every bevel, rivet and vent slat, proving the export/import round-trip preserves the asset" /></a>
 </td>
 <td valign="middle">
 

docs/gallery/asset-sheets/gltf-export-roundtrip.webp

@@ -607,7 +607,7 @@ <h2><a href="vse-cut-list/">vse-cut-list</a></h2>
       </article>
       <article class="card" data-tags="export uv">
         <a class="card-media" href="gltf-export-roundtrip/" tabindex="-1" aria-hidden="true">
-          <img src="assets/gltf-export-roundtrip-hero.webp" alt="Two identical olive equipment crates with cyan light strips, both turned to show a side, labelled AUTHORED and ROUND-TRIP." loading="lazy" decoding="async" />
+          <img src="assets/gltf-export-roundtrip-hero.webp" alt="One olive sci-fi supply crate with a cyan light strip, its right half traced by an amber wire cage of the re-imported glTF triangles that lands exactly on every bevel, rivet and vent slat." loading="lazy" decoding="async" />
         </a>
         <div class="card-body">
           <h2><a href="gltf-export-roundtrip/">gltf-export-roundtrip</a></h2>

docs/gallery/assets/gltf-export-roundtrip-hero.webp

@@ -329,7 +329,7 @@
       "name": "gltf-export-roundtrip",
       "dir": "examples/gltf-export-roundtrip",
       "teaches": "A sci-fi supply crate exported to glTF and re-imported, verifying the round-trip against the depsgraph-evaluated mesh within float tolerances. Positions, loop normals, box-mapped UVs, and per-triangle material bindings must all survive; the on-disk JSON proves the +Y-up conversion and the V-flipped UV layout.",
-      "alt": "Two identical olive equipment crates with cyan light strips, both turned to show a side, labelled AUTHORED and ROUND-TRIP.",
+      "alt": "One olive sci-fi supply crate with a cyan light strip, its right half traced by an amber wire cage of the re-imported glTF triangles that lands exactly on every bevel, rivet and vent slat.",
       "witnessesFix": "export_yup bakes (x, y, z) -> (x, z, -y) into the vertex data with no node rotation (probed identical on 4.5.11 and 5.1.2); export_apply ships the evaluated mesh, not the base cage; exporter/importer RNA is guarded so a future kwarg rename fails loudly.",
       "hero": "docs/gallery/assets/gltf-export-roundtrip-hero.webp",
       "preview": "examples/gltf-export-roundtrip/preview.webp",

docs/gallery/contact-sheets/gltf-export-roundtrip-contact-sheet.webp

@@ -1,7 +1,8 @@
 # glTF Export Round-Trip
 
-A runnable example that builds a sci-fi supply crate — 35 beveled box shells with
-three material slots and box-mapped UVs — exports it with
+A runnable example that builds a sci-fi supply crate — 43 beveled box shells (body, lid with
+stiffening ribs, corner armour, carry handles over vent slats, latches, rivets,
+a status plate with glowing pips) with three material slots and box-mapped UVs — exports it with
 `bpy.ops.export_scene.gltf`, parses the file on disk, re-imports it, and verifies
 the whole round-trip against the depsgraph-evaluated mesh, following
 [`depsgraph-and-evaluated-data`](../../skills/depsgraph-and-evaluated-data/SKILL.md)
@@ -22,9 +23,9 @@ often gets silently wrong.
   lying on its back.
 - **`export_apply=True` ships the evaluated mesh, not the base cage.** The
   crate's bevel modifier lives only in the depsgraph; with flat shading and UV
-  seams the exporter splits exactly one vertex per evaluated loop (7,560), so
+  seams the exporter splits exactly one vertex per evaluated loop (9,288), so
   the on-disk POSITION count is an exact witness. `export_apply=False` silently
-  writes the 624-vertex cage.
+  writes the 344-vertex cage.
 - **The round-trip is faithful.** Re-imported positions (bit-exact here), loop
   normals (≤2e-4), box-mapped UVs (≤3e-5), and per-triangle material bindings
   all match the evaluated mesh. UVs are V-flipped on disk (glTF texture origin
@@ -46,18 +47,31 @@ between kit-bashed shells weld loops on export (the count check catches it), and
 `read_factory_settings` mid-check frees the original mesh — touching a freed RNA
 raises `ReferenceError`, so counts are captured before the wipe.
 
-The render stages the authored crate beside the actual re-imported one — same
-bevels, same materials carried through the file itself. If the axis conversion
-broke, the right twin would lie on its side; if the modifier contract broke, its
-silhouette would lose the rounded edges. Both twins are turned 22° off
-square so each shows a side and its corner armour; dead-on, the pair read
-as two flat front elevations. The re-imported object comes back in
-`QUATERNION` rotation mode, so the render path switches it to `XYZ`
-before turning it — presentation only, after every check has run.
-
-The render path gates framing through `gallery_framing.check_framing`.
-The helper returns 10, which is already a check code here, so the call
-site remaps a framing violation to 22.
+The render shows **one** crate. The solid crate is the authored one, rebuilt
+in place after the check. Laid over it is the actual re-imported mesh — the
+file's own triangles — drawn as a thin amber wire cage (a render-only Weld +
+Wireframe display stack on the imported object) and masked to the right of a
+vertical cut, so the left half reads as the authored asset and the right half
+as the file's geometry sitting on it. Neither object is moved: both keep the
+identity transform check 13 proved, and the camera does the turning. The cage
+lands on every bevel, rivet and vent slat only because the importer undid the
++Y-up bake exactly and the file carried the evaluated (beveled) mesh. If the
+axis conversion broke, the cage would be rotated a quarter turn off the solid
+crate; a probe that re-applies that quarter turn to the imported object before
+rendering drops the cage through the floor and also fails the framing gate
+(bottom margin 0.000). If the modifier contract broke, the cage would trace
+square corners across the rounded ones.
+
+Presentation only, after every check has run: the authored crate's bevel is
+baked into its display mesh (the asset-quality edge measure reads
+`Object.data`, which is still the square cage while the bevel lives in the
+modifier stack), and its paint and trim get a noise-mottled base colour and
+roughness. The exported file only ever carried the flat Principled values.
+
+The render path gates framing through `gallery_framing.check_framing` and the
+asset floors through `gallery_asset_quality.check_asset_quality` on the
+authored crate. Both helpers' codes (10, 11) are already check codes here, so
+the call site remaps them to 22 and 23.
 
 ## Run
 
@@ -103,6 +117,7 @@ against it.
 | 20 | Per-triangle material bindings drifted |
 | 21 | `--output` produced no file |
 | 22 | Gallery framing violation (render path only; the helper's 10, remapped) |
+| 23 | Gallery asset-quality violation (render path only; the helper's 11, remapped) |
 
 The `blender-smoke` workflow runs the check on Blender 5.2 LTS and 4.5 LTS
 (5.1 on the weekly cron, the `needs-5.1` PR label, or manual dispatch).