Skip to content

Commit 27a755b

Browse files
fix(showcase): wall-torch visual quality pass
Rebuild the sconce from named plate and cup stations so it reads as a wall torch: running-bond ashlar, a round arm into an upward bowl, plaque zmin at 0. Hygiene 15-19 and joint-fit budgets lock the contacts. Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 87931e7 commit 27a755b

9 files changed

Lines changed: 1066 additions & 468 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -149,7 +149,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
149149

150150
[`wooden-bucket`](showcase/wooden-bucket/) — procedural coopered pail with a round bail through the ear rings through the same pipeline. Falsifier `--float-handle` exits 17.
151151

152-
[`wall-torch`](showcase/wall-torch/) — procedural wall-mounted torch sconce with a stone plaque, iron bracket, and flame through the same pipeline. Falsifier `--skip-decimate` exits 9.
152+
[`wall-torch`](showcase/wall-torch/) — procedural wall-mounted torch sconce with a stone plaque, iron bracket, and flame through the same pipeline. Falsifiers `--skip-decimate` (9), `--stray-vert` (15), `--float-arm` (17).
153153

154154
[`tavern-stool`](showcase/tavern-stool/) — procedural tavern stool with turned legs, stretchers, and iron ferrules through the same pipeline. Falsifier `--skip-decimate` exits 9.
155155

16.8 KB
Loading
20.4 KB
Loading

‎docs/gallery/index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1123,7 +1123,7 @@ <h2><a href="wooden-bucket/">wooden-bucket</a></h2>
11231123
<div class="card-body">
11241124
<h2><a href="wall-torch/">wall-torch</a></h2>
11251125
<p class="teaches">A procedural wall-mounted torch sconce with a dressed stone plaque, iron bracket, wooden haft, and emissive flame through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.</p>
1126-
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 848 tris, four materials with 162 stone, 134 metal, and 44 flame faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.384×0.360×0.670 m, LOD ratios in band (5.2 COLLAPSE 8 tris leaner on LOD2), convex collider 92 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.</p>
1126+
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 1528 tris, four materials with 540 stone, 228 metal and 78 flame faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.304×0.293×0.424 m at zmin 0, LOD ratios in band, convex collider 60 tris, non-empty glTF. Hygiene all zero. Arm-to-cup gap 0.87 mm, plate-to-plaque gap 4 mm, plaque width 0.280 m. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-arm 17; --float-plate 18; --skinny-plaque 19.</p>
11271127
<a class="card-link" href="wall-torch/">View example <span aria-hidden="true">&rarr;</span></a>
11281128
</div>
11291129
</article>

‎docs/gallery/wall-torch/index.html‎

Lines changed: 502 additions & 228 deletions
Large diffs are not rendered by default.

‎showcase/gallery.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,7 @@
261261
"name": "wall-torch",
262262
"dir": "showcase/wall-torch",
263263
"teaches": "A procedural wall-mounted torch sconce with a dressed stone plaque, iron bracket, wooden haft, and emissive flame through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.",
264-
"witnessesFix": "Recomputed: 848 tris, four materials with 162 stone, 134 metal, and 44 flame faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.384×0.360×0.670 m, LOD ratios in band (5.2 COLLAPSE 8 tris leaner on LOD2), convex collider 92 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.",
264+
"witnessesFix": "Recomputed: 1528 tris, four materials with 540 stone, 228 metal and 78 flame faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.304×0.293×0.424 m at zmin 0, LOD ratios in band, convex collider 60 tris, non-empty glTF. Hygiene all zero. Arm-to-cup gap 0.87 mm, plate-to-plaque gap 4 mm, plaque width 0.280 m. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-arm 17; --float-plate 18; --skinny-plaque 19.",
265265
"hero": "docs/gallery/assets/wall-torch-hero.webp",
266266
"preview": "showcase/wall-torch/preview.webp",
267267
"tags": [

‎showcase/wall-torch/README.md‎

Lines changed: 84 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,16 @@
11
# Wall torch
22

33
A showcase piece, not an example. Procedural wall-mounted torch sconce
4-
(dressed stone plaque, iron bracket and cup, wooden haft, emissive flame)
5-
then the shipped pipeline: unique-cell UVs, Cycles high-to-low normal
6-
bake, LOD chain, convex collider, Unity glTF export.
4+
(running-bond dressed stone plaque, iron plate and arm from named
5+
stations, bowl cup, wooden haft, emissive flame) then the shipped
6+
pipeline: unique-cell UVs, Cycles high-to-low normal bake, LOD chain,
7+
convex collider, Unity glTF export.
8+
9+
The plaque back sits on the wall plane Y=0 with zmin at 0. The iron
10+
arm is a tube from the plate station to the cup wall, not a pair of
11+
square bars aimed at a funnel. The bowl opens upward and holds the
12+
haft. Hygiene family 15–19: `--stray-vert`, `--lift-z`, `--float-arm`,
13+
`--float-plate`, `--skinny-plaque`.
714

815
It asserts **budget conformance** of the generated result. It does not
916
witness an API contract. "It rendered without error" is not a check.
@@ -14,6 +21,11 @@ witness an API contract. "It rendered without error" is not a check.
1421
`bake_normal_high_to_low.py`, `setup_bake_target_image.py`,
1522
`lod_chain.py` / `decimate_to_budget.py`, `convex_hull_collider.py`,
1623
`export_preset_unity.py` (helpers copied, not imported as a package).
24+
Hygiene combinatorics match `examples/mesh-hygiene-audit` (copied, not
25+
imported).
26+
27+
Intended size: 0.28 m plaque width, 0.40 m plaque height, bowl
28+
projecting 0.24 m from the wall; outer AABB 0.304 × 0.293 × 0.424 m.
1729

1830
## Budgets
1931

@@ -22,38 +34,87 @@ materials, UVs, evaluated LOD, collider, or export file.
2234

2335
| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) |
2436
| --- | --- | --- |
25-
| Base triangles | 800–920 | 848 / 848 / 848 |
37+
| Base triangles | 1400–1700 | 1528 / 1528 / 1528 |
2638
| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 |
27-
| LOD2 ratio | 0.10–0.35 of base | 0.2193 / 0.2193 / 0.2099 |
28-
| Materials | exactly 4 distinct, ≥24 stone, ≥24 metal, ≥8 flame | 4 slots, 162 stone, 134 metal, 44 flame |
39+
| LOD2 ratio | 0.10–0.35 of base | 0.2199 / 0.2199 / 0.2199 |
40+
| Materials | exactly 4 distinct, ≥24 stone, ≥24 metal, ≥8 flame | 4 slots, 540 stone, 228 metal, 78 flame |
2941
| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 |
30-
| Outer AABB | (0.384, 0.360, 0.670) m ± 0.01 | (0.3840, 0.3600, 0.6700), zmin 0.140 |
31-
| Collider tris | ≤ 120 | 92 |
32-
| Export | written, size > 0 | 69060 / 69060 / 69048 bytes |
42+
| Outer AABB | (0.304, 0.293, 0.424) m ± 0.015 | (0.3040, 0.2930, 0.4240), zmin 0 |
43+
| Collider tris | ≤ 180 | 60 |
44+
| Export | written, size > 0 | 124608 / 124608 / 124584 bytes |
45+
46+
Base triangles rose from **848 to 1528** in the quality pass: one
47+
mailbox slab became four courses of running-bond ashlar plus a round
48+
arm and a triangulated bowl. Outer AABB tightened from 0.384 × 0.360 ×
49+
0.670 m (and zmin 0.140) to 0.304 × 0.293 × 0.424 m at zmin 0.
50+
51+
DECIMATE COLLAPSE triangle counts are **not** identical across series.
52+
The gate is a ratio band, not an exact count. Bake pixels are
53+
stochastic; the gate is `has_data` plus operator `FINISHED`, not
54+
byte-identity. Construction uses no RNG. Export byte counts differ by
55+
24 B on 5.2.1 (glTF serializer), not a gated axis.
56+
57+
### Hygiene
58+
59+
Recomputed from the generated mesh, not asserted about the script.
60+
61+
| Axis | Declared | Measured (all three) |
62+
| --- | --- | --- |
63+
| Non-manifold edges | 0 | 0 |
64+
| Loose verts / edges | 0 / 0 | 0 / 0 |
65+
| Doubles merged at 1e-5 | 0 | 0 |
66+
| Zero-area faces | 0 | 0 |
67+
| N-gons | 0 | 0 |
68+
| Coplanar disjoint face pairs | 0 | 0 |
69+
| Grounded: `zmin` | within 1e-4 of 0 | 0.0000 |
70+
71+
### Joint fit and plaque size
72+
73+
| Axis | Declared | Measured (all three) |
74+
| --- | --- | --- |
75+
| Arm-to-cup BVH gap | ≤ 0.008 m | 0.00087 |
76+
| Plate-to-plaque BVH gap | ≤ 0.008 m | 0.00400 |
77+
| Plaque width vs `WALL_W` | ± 0.04 m | 0.2800 vs 0.280 |
3378

34-
DECIMATE COLLAPSE triangle counts are **not** identical across series —
35-
5.2.1 is 8 tris leaner on LOD2. The gate is a ratio band, not an exact
36-
count. Bake pixels are stochastic; the gate is `has_data` plus operator
37-
`FINISHED`, not byte-identity. Construction uses no RNG. Export byte
38-
counts differ by 12 B on 5.2.1 (glTF serializer), not a gated axis.
79+
### Falsifiers
80+
81+
Each violates one named budget. All were run on 4.5.11, 5.1.2 and 5.2.1
82+
and returned the same code on each.
83+
84+
| Flag | Budget violated | Exit |
85+
| --- | --- | --- |
86+
| `--skip-decimate` | LOD1 ratio band | 9 |
87+
| `--stray-vert` | loose vertex count is 0 | 15 |
88+
| `--lift-z` | bounding box `zmin` is 0 | 16 |
89+
| `--float-arm` | arm-to-cup BVH gap | 17 |
90+
| `--float-plate` | plate-to-plaque BVH gap | 18 |
91+
| `--skinny-plaque` | plaque width vs `WALL_W` | 19 |
3992

40-
`--skip-decimate` skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and
41-
exit 9 fires. That is the named budget the falsifier violates.
93+
`--float-arm` shortens the tube to 55 % of the plate-to-cup station
94+
vector; the cup stays put. `--float-plate` moves only the hang plate
95+
off the plaque; the arm still reaches the cup so 17 still passes.
96+
`--skinny-plaque` scales the back plaque and courses to 0.55 · `WALL_W`.
4297

4398
## Run
4499

45100
```bash
46101
blender --background --python wall_torch.py --
47102
blender --background --python wall_torch.py -- --skip-decimate
103+
blender --background --python wall_torch.py -- --stray-vert
104+
blender --background --python wall_torch.py -- --lift-z
105+
blender --background --python wall_torch.py -- --float-arm
106+
blender --background --python wall_torch.py -- --float-plate
107+
blender --background --python wall_torch.py -- --skinny-plaque
48108
blender --background --python wall_torch.py -- --output torch.png
49109
```
50110

51-
Smoke does not pass `--output` or `--skip-decimate`.
111+
Smoke passes no flags.
52112

53113
## Exit codes
54114

55115
File-local. `9` is a valid check code. `10` is reserved for
56-
`gallery_framing.check_framing` on the `--output` path.
116+
`gallery_framing.check_framing` on the `--output` path. `15`–`19` are the
117+
hygiene and joint-fit family.
57118

58119
| Code | Meaning |
59120
| --- | --- |
@@ -72,3 +133,8 @@ File-local. `9` is a valid check code. `10` is reserved for
72133
| 12 | Bake did not finish or image has no data |
73134
| 13 | Export file missing or empty |
74135
| 14 | `--output` produced no file |
136+
| 15 | Hygiene (`--stray-vert` lands here) |
137+
| 16 | Grounded zmin (`--lift-z`) |
138+
| 17 | Arm-to-cup gap (`--float-arm`) |
139+
| 18 | Plate-to-plaque gap (`--float-plate`) |
140+
| 19 | Plaque width (`--skinny-plaque`) |

‎showcase/wall-torch/preview.webp‎

17.7 KB
Loading

0 commit comments

Comments
 (0)