Skip to content

Commit 174f05b

Browse files
fix(showcase): signpost visual quality pass
Axis-align the boards, cut finger tips from the board section, and wrap the shoe as a closed collar so it reads as a fingerpost. Hygiene 15-19 plus orthogonal-board and named-shoe budgets lock the joints. Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 27a755b commit 174f05b

9 files changed

Lines changed: 1019 additions & 440 deletions

File tree

‎README.md‎

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

144144
[`hand-pump`](showcase/hand-pump/) — procedural cast-iron village hand pump through the same pipeline. Falsifier `--skip-decimate` exits 9.
145145

146-
[`signpost`](showcase/signpost/) — procedural timber fingerboard signpost through the same pipeline. Falsifier `--skip-decimate` exits 9.
146+
[`signpost`](showcase/signpost/) — procedural timber fingerboard signpost through the same pipeline. Falsifiers `--skip-decimate` (9), `--stray-vert` (15), `--yaw-boards` (19).
147147

148148
[`chopping-block`](showcase/chopping-block/) — procedural hooped timber stump with an embedded axe through the same pipeline. Falsifier `--skip-decimate` exits 9.
149149

-398 Bytes
Loading
6.85 KB
Loading

‎docs/gallery/index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1090,7 +1090,7 @@ <h2><a href="hand-pump/">hand-pump</a></h2>
10901090
<div class="card-body">
10911091
<h2><a href="signpost/">signpost</a></h2>
10921092
<p class="teaches">A procedural timber fingerboard signpost through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.</p>
1093-
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 504 tris, three materials with 66 metal and 24 board faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.368×0.201×1.566 m, LOD ratios in band (5.2 COLLAPSE more aggressive on LOD2), convex collider 56 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.</p>
1093+
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 376 tris, three materials with 108 metal, 22 board and 60 wood faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.260×0.142×1.551 m at zmin 0, LOD ratios in band (5.2 COLLAPSE leaner on LOD1/LOD2), convex collider 52 tris, non-empty glTF. Hygiene all zero. Board-to-post gap 5 mm, strap gap 3 mm, board AABB Y 28 mm. --skip-decimate exits 9; --stray-vert 15; --lift-z / --short-shoe 16; --gap-board 17; --float-strap 18; --yaw-boards 19.</p>
10941094
<a class="card-link" href="signpost/">View example <span aria-hidden="true">&rarr;</span></a>
10951095
</div>
10961096
</article>

‎docs/gallery/signpost/index.html‎

Lines changed: 478 additions & 215 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
@@ -225,7 +225,7 @@
225225
"name": "signpost",
226226
"dir": "showcase/signpost",
227227
"teaches": "A procedural timber fingerboard signpost through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.",
228-
"witnessesFix": "Recomputed: 504 tris, three materials with 66 metal and 24 board faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.368×0.201×1.566 m, LOD ratios in band (5.2 COLLAPSE more aggressive on LOD2), convex collider 56 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.",
228+
"witnessesFix": "Recomputed: 376 tris, three materials with 108 metal, 22 board and 60 wood faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.260×0.142×1.551 m at zmin 0, LOD ratios in band (5.2 COLLAPSE leaner on LOD1/LOD2), convex collider 52 tris, non-empty glTF. Hygiene all zero. Board-to-post gap 5 mm, strap gap 3 mm, board AABB Y 28 mm. --skip-decimate exits 9; --stray-vert 15; --lift-z / --short-shoe 16; --gap-board 17; --float-strap 18; --yaw-boards 19.",
229229
"hero": "docs/gallery/assets/signpost-hero.webp",
230230
"preview": "showcase/signpost/preview.webp",
231231
"tags": [

‎showcase/signpost/README.md‎

Lines changed: 86 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,17 @@
11
# Signpost
22

33
A showcase piece, not an example. Procedural timber fingerboard
4-
signpost (square post, collar and pyramidal cap, two painted planks
5-
with diamond tips, iron shoe and straps) then the shipped pipeline:
6-
unique-cell UVs, Cycles high-to-low normal bake, LOD chain, convex
7-
collider, Unity glTF export.
4+
signpost (square post, pyramidal cap from the post half plus overhang,
5+
two axis-aligned painted boards with wedges cut from the board
6+
section, iron shoe collar and U-wrap straps) then the shipped
7+
pipeline: unique-cell UVs, Cycles high-to-low normal bake, LOD chain,
8+
convex collider, Unity glTF export.
9+
10+
Boards are yaw 0. Finger tips are wedges whose base is the board's own
11+
thickness×height, bitten into the board so the base face is inside it.
12+
The cap is added after the post bevel. The post stays on the origin.
13+
Hygiene family 15–19: `--stray-vert`, `--lift-z` / `--short-shoe`,
14+
`--gap-board`, `--float-strap`, `--yaw-boards`.
815

916
It asserts **budget conformance** of the generated result. It does not
1017
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: 1.48 m post, boards 0.62 m and 0.54 m, 0.118 m post
28+
stock; outer AABB 1.260 × 0.142 × 1.551 m.
1729

1830
## Budgets
1931

@@ -22,39 +34,92 @@ 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 | 430–580 | 504 / 504 / 504 |
26-
| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 |
27-
| LOD2 ratio | 0.10–0.35 of base | 0.2183 / 0.2183 / 0.1746 |
28-
| Materials | exactly 3 distinct, ≥24 metal and ≥12 board faces | 3 slots, 66 metal, 24 board |
37+
| Base triangles | 320–480 | 376 / 376 / 376 |
38+
| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.4681 |
39+
| LOD2 ratio | 0.10–0.35 of base | 0.2181 / 0.2181 / 0.1649 |
40+
| Materials | exactly 3 distinct, ≥24 metal, ≥12 board, ≥12 wood | 3 slots, 108 metal, 22 board, 60 wood |
2941
| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 |
30-
| Outer AABB | (1.368, 0.201, 1.566) m ± 0.01 | (1.3679, 0.2014, 1.5660), zmin 0 |
31-
| Collider tris | ≤ 140 | 56 |
32-
| Export | written, size > 0 | 45164 / 45164 / 45152 bytes |
42+
| Outer AABB | (1.260, 0.142, 1.551) m ± 0.015 | (1.2600, 0.1420, 1.5510), zmin 0 |
43+
| Collider tris | ≤ 180 | 52 |
44+
| Export | written, size > 0 | 35688 / 35688 / 35676 bytes |
45+
46+
Base triangles dropped from **504 to 376** in the quality pass: glued
47+
diamond cubes and a solid shoe block became wedges and a four-plate
48+
collar. Outer AABB tightened from 1.368 × 0.201 × 1.566 m.
3349

3450
DECIMATE COLLAPSE triangle counts are **not** identical across series —
35-
5.2.1 is more aggressive on LOD2. The gate is a ratio band, not an
51+
5.2.1 is leaner on LOD1 and LOD2. The gate is a ratio band, not an
3652
exact count. Bake pixels are stochastic; the gate is `has_data` plus
3753
operator `FINISHED`, not byte-identity. Construction uses no RNG.
3854
Export byte counts differ by 12 B on 5.2.1 (glTF serializer), not a
3955
gated axis.
4056

41-
`--skip-decimate` skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and
42-
exit 9 fires. That is the named budget the falsifier violates.
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+
| Named shoe plates | ≥1, each `zmin` ≤ 0.002 | 4, 0.00000 |
71+
72+
### Joint fit and orthogonal boards
73+
74+
| Axis | Declared | Measured (all three) |
75+
| --- | --- | --- |
76+
| Board-to-post BVH gap | ≤ 0.008 m | 0.00500 |
77+
| Strap-to-post BVH gap | ≤ 0.008 m | 0.00300 |
78+
| Board AABB Y (axis-aligned) | ≤ 0.055 m | 0.0280 |
79+
80+
### Falsifiers
81+
82+
Each violates one named budget. All were run on 4.5.11, 5.1.2 and 5.2.1
83+
and returned the same code on each.
84+
85+
| Flag | Budget violated | Exit |
86+
| --- | --- | --- |
87+
| `--skip-decimate` | LOD1 ratio band | 9 |
88+
| `--stray-vert` | loose vertex count is 0 | 15 |
89+
| `--lift-z` | bounding box `zmin` is 0 | 16 |
90+
| `--short-shoe` | named shoes plant at z=0 | 16 |
91+
| `--gap-board` | board-to-post BVH gap | 17 |
92+
| `--float-strap` | strap-to-post BVH gap | 18 |
93+
| `--yaw-boards` | board AABB Y (orthogonal) | 19 |
94+
95+
`--short-shoe` lifts only the iron shoe plates. After zmin snap the
96+
post is the AABB `zmin`, so the AABB gate would still pass; the named
97+
shoe stations fail. `--gap-board` moves the board inner station outside
98+
the post. `--float-strap` adds Y offset to the U-wrap so it no longer
99+
bites. `--yaw-boards` restores a 0.12 rad yaw; the AABB secondary
100+
extent exceeds the thickness bound.
43101

44102
## Run
45103

46104
```bash
47105
blender --background --python signpost.py --
48106
blender --background --python signpost.py -- --skip-decimate
107+
blender --background --python signpost.py -- --stray-vert
108+
blender --background --python signpost.py -- --lift-z
109+
blender --background --python signpost.py -- --short-shoe
110+
blender --background --python signpost.py -- --gap-board
111+
blender --background --python signpost.py -- --float-strap
112+
blender --background --python signpost.py -- --yaw-boards
49113
blender --background --python signpost.py -- --output signpost.png
50114
```
51115

52-
Smoke does not pass `--output` or `--skip-decimate`.
116+
Smoke passes no flags.
53117

54118
## Exit codes
55119

56120
File-local. `9` is a valid check code. `10` is reserved for
57-
`gallery_framing.check_framing` on the `--output` path.
121+
`gallery_framing.check_framing` on the `--output` path. `15`–`19` are the
122+
hygiene and joint-fit family.
58123

59124
| Code | Meaning |
60125
| --- | --- |
@@ -73,3 +138,8 @@ File-local. `9` is a valid check code. `10` is reserved for
73138
| 12 | Bake did not finish or image has no data |
74139
| 13 | Export file missing or empty |
75140
| 14 | `--output` produced no file |
141+
| 15 | Hygiene (`--stray-vert` lands here) |
142+
| 16 | Grounded zmin / named shoes (`--lift-z`, `--short-shoe`) |
143+
| 17 | Board-to-post gap (`--gap-board`) |
144+
| 18 | Strap-to-post gap (`--float-strap`) |
145+
| 19 | Board yaw / AABB Y (`--yaw-boards`) |

‎showcase/signpost/preview.webp‎

472 Bytes
Loading

0 commit comments

Comments
 (0)