Skip to content

Commit 67fb263

Browse files
fix(showcase): rebuild campfire with seated courses and a kissing teepee
The old ring floated a mortar gap between identical boxes and ended the tripod at one point. Shared-Z courses and an overshooting apex ring are durable; per-log coordinate nudges are not. Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 23b1f1a commit 67fb263

7 files changed

Lines changed: 1334 additions & 499 deletions

File tree

8.89 KB
Loading

‎docs/gallery/campfire/index.html‎

Lines changed: 640 additions & 243 deletions
Large diffs are not rendered by default.

‎docs/gallery/index.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -925,7 +925,7 @@ <h2><a href="wooden-barrel/">wooden-barrel</a></h2>
925925
<div class="card-body">
926926
<h2><a href="campfire/">campfire</a></h2>
927927
<p class="teaches">A procedural campfire through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.</p>
928-
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 3616 tris, three materials with 100 wood and 48 ash faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.789×0.789×0.410 m, LOD ratios in band, convex collider 254 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.</p>
928+
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 2200 tris, three materials with 216 wood, 48 ash and 1304 stone faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.807×0.808×0.404 m, LOD ratios in band, convex collider 198 tris, hygiene 0, 14 grounded bottom stones, teepee kiss 0.00001 m, course seat 0, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z/--short-stones 16; --float-logs 17; --gap-courses 18.</p>
929929
<a class="card-link" href="campfire/">View example <span aria-hidden="true">&rarr;</span></a>
930930
</div>
931931
</article>
@@ -1035,7 +1035,7 @@ <h2><a href="wheelbarrow/">wheelbarrow</a></h2>
10351035
<div class="card-body">
10361036
<h2><a href="anvil/">anvil</a></h2>
10371037
<p class="teaches">A procedural blacksmith anvil on a timber stump through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.</p>
1038-
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 6616 tris, two materials with 2616 metal faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.772×0.419×0.662 m, LOD ratios in band, convex collider 190 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.</p>
1038+
<p class="witnesses"><span class="tag">witnesses</span> Recomputed: 2988 tris, two materials with 1040 wood and 822 metal faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.621×0.414×0.489 m, LOD ratios in band, convex collider 134 tris, hygiene 0, 16 grounded staves, hoop bite 0.003 m, foot-on-head gap 0.003 m, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z/--short-staves 16; --float-anvil 17; --round-band 18.</p>
10391039
<a class="card-link" href="anvil/">View example <span aria-hidden="true">&rarr;</span></a>
10401040
</div>
10411041
</article>

‎showcase/campfire/README.md‎

Lines changed: 72 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,15 @@
11
# Campfire
22

33
A showcase piece, not an example. Procedural campfire (two-course
4-
running-bond stone ring, pit-floor cobbles, ash, a log tripod, and
5-
charcoal) then the shipped pipeline: unique-cell UVs, Cycles
4+
running-bond stone ring of 14 barrelled wedges, pit-floor cobbles, ash,
5+
a kissing log tripod that overshoots a shared apex ring, floor logs,
6+
and charcoal) then the shipped pipeline: unique-cell UVs, Cycles
67
high-to-low normal bake, LOD chain, convex collider, Unity glTF export.
78

9+
Courses share a Z plane; `--gap-courses` is the falsifier. Teepee axes
10+
aim at a ring of radius `(STICK_R * 0.55) / sin(π/N)` and overshoot so
11+
the caps cross; `--float-logs` inflates that ring.
12+
813
It asserts **budget conformance** of the generated result. It does not
914
witness an API contract. "It rendered without error" is not a check.
1015

@@ -21,38 +26,83 @@ materials, UVs, evaluated LOD, collider, or export file.
2126

2227
| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) |
2328
| --- | --- | --- |
24-
| Base triangles | 3500–3750 | 3616 / 3616 / 3616 |
29+
| Base triangles | 1400–3600 | 2200 / 2200 / 2200 |
2530
| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 |
26-
| LOD2 ratio | 0.10–0.35 of base | 0.2196 / 0.2196 / 0.2196 |
27-
| Materials | exactly 3 distinct, ≥24 wood faces, ≥8 ash faces | 3 slots, 100 wood, 48 ash |
31+
| LOD2 ratio | 0.10–0.35 of base | 0.2200 / 0.2200 / 0.2200 |
32+
| Materials | exactly 3 distinct; ≥80 wood, ≥24 ash, ≥200 stone | 3 slots; 216 / 48 / 1304 |
2833
| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 |
29-
| Outer AABB | (0.789, 0.789, 0.410) m ± 0.01 | (0.7891, 0.7891, 0.4094), zmin 0 |
30-
| Collider tris | ≤ 320 | 254 |
31-
| Export | written, size > 0 | 273604 / 273604 / 273596 bytes |
34+
| Outer AABB | (0.807, 0.808, 0.404) m ± 0.015 | (0.8069, 0.8079, 0.4037), zmin 0 |
35+
| Collider tris | ≤ 360 | 198 |
36+
| Export | written, size > 0 | 206244 / 206244 / 206236 bytes |
37+
38+
Base triangles dropped from **3616 to 2200** in the quality pass: the
39+
old piece stacked identical boxes with a mortar gap and a teepee that
40+
met at one point. The rebuild is two seated courses plus crossing
41+
sticks; hidden overlapping volume went away.
3242

3343
DECIMATE COLLAPSE triangle counts are **not** guaranteed identical across
34-
series — the gate is a ratio band, not an exact count. This mesh happened
35-
to match on 4.5.11 / 5.1.2 / 5.2.1. Bake pixels are stochastic; the gate
36-
is `has_data` plus operator `FINISHED`, not byte-identity. Construction
37-
uses no RNG. glTF byte size differs by a few bytes across series.
44+
series — the gate is a ratio band, not an exact count. Bake pixels are
45+
stochastic; the gate is `has_data` plus operator `FINISHED`, not
46+
byte-identity. Stone-width jitter uses fixed seed 17. glTF byte size
47+
differs by 8 B on 5.2.1.
48+
49+
### Hygiene
50+
51+
Recomputed from the generated mesh, not asserted about the script.
52+
53+
| Axis | Declared | Measured (all three) |
54+
| --- | --- | --- |
55+
| Non-manifold edges | 0 | 0 |
56+
| Loose verts / edges | 0 / 0 | 0 / 0 |
57+
| Doubles merged at 1e-5 | 0 | 0 |
58+
| Zero-area faces | 0 | 0 |
59+
| N-gons | 0 | 0 |
60+
| Coplanar disjoint face pairs | 0 | 0 |
61+
| Grounded: `zmin` | within 1e-4 of 0 | 0.0000 |
62+
| Named supports: 14 bottom stones | each `zmin` ≤ 0.001 | 14, stone_z 0.00000 |
63+
| Ring plan | 0.807 m dia × 0.156 m high ± 0.04 | 0.8074 × 0.1560 |
3864

39-
`--skip-decimate` skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and
40-
exit 9 fires. That is the named budget the falsifier violates.
65+
### Joint fit and seat
66+
67+
| Axis | Declared | Measured (all three) |
68+
| --- | --- | --- |
69+
| Teepee kiss (BVH nearest at caps) | ≤ 0.008 m | 0.00001 |
70+
| Course seat (upper zmin − lower zmax) | abs ≤ 0.004 m | 0.00000 |
71+
72+
### Falsifiers
73+
74+
Each violates one named budget. All six were run on 4.5.11, 5.1.2 and
75+
5.2.1 and returned the same code on each.
76+
77+
| Flag | Budget violated | Exit |
78+
| --- | --- | --- |
79+
| `--skip-decimate` | LOD1 ratio band | 9 |
80+
| `--stray-vert` | loose vertex count is 0 | 15 |
81+
| `--lift-z` | bounding box `zmin` is 0 | 16 |
82+
| `--short-stones` | named bottom-course supports at Z=0 | 16 |
83+
| `--float-logs` | teepee kiss | 17 |
84+
| `--gap-courses` | course seat | 18 |
4185

4286
## Run
4387

4488
```bash
4589
blender --background --python campfire.py --
4690
blender --background --python campfire.py -- --skip-decimate
91+
blender --background --python campfire.py -- --stray-vert
92+
blender --background --python campfire.py -- --lift-z
93+
blender --background --python campfire.py -- --short-stones
94+
blender --background --python campfire.py -- --float-logs
95+
blender --background --python campfire.py -- --gap-courses
4796
blender --background --python campfire.py -- --output campfire.png
4897
```
4998

50-
Smoke does not pass `--output` or `--skip-decimate`.
99+
Smoke passes no flags.
51100

52101
## Exit codes
53102

54103
File-local. `9` is a valid check code. `10` is reserved for
55-
`gallery_framing.check_framing` on the `--output` path.
104+
`gallery_framing.check_framing` on the `--output` path. `15`–`19` are the
105+
hygiene and joint-fit family.
56106

57107
| Code | Meaning |
58108
| --- | --- |
@@ -61,7 +111,7 @@ File-local. `9` is a valid check code. `10` is reserved for
61111
| 2 | argparse / usage |
62112
| 3 | Mesh did not build / no UV layer |
63113
| 4 | Base triangle count outside range |
64-
| 5 | Material count ≠ 3 distinct slots, or wood/ash faces missing |
114+
| 5 | Material count ≠ 3 distinct slots, or a face-count floor missed |
65115
| 6 | UVs outside 0..1 |
66116
| 7 | UV AABB overlap above tolerance |
67117
| 8 | World AABB off declared outer size |
@@ -71,3 +121,8 @@ File-local. `9` is a valid check code. `10` is reserved for
71121
| 12 | Bake did not finish or image has no data |
72122
| 13 | Export file missing or empty |
73123
| 14 | `--output` produced no file |
124+
| 15 | Mesh hygiene: loose, non-manifold, zero-area, doubles, n-gons, z-fight |
125+
| 16 | Not grounded: bounding box `zmin` off 0, or a named bottom stone floats |
126+
| 17 | Joint fit: teepee kiss (`--float-logs`) |
127+
| 18 | Seat: course gap (`--gap-courses`) |
128+
| 19 | Ring diameter or height off the stated real-world size |

0 commit comments

Comments
 (0)