Skip to content

Commit 7b0a269

Browse files
TMHSDigitalclaude
andcommitted
fix: wooden-barrel quality pass, boarded heads, stave tone and iron hoops
Heads are four boards cut from the croze outline, with a head-board budget (exit 17, --one-piece-head). Per-stave tone and grain, rusted iron hoops, the temp glb removed after measuring, and the gallery alt fixed (it said three hoops; there are four). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
1 parent 4aa6b6c commit 7b0a269

8 files changed

Lines changed: 529 additions & 65 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
111111
<p align="center">
112112
<a href="showcase/shipping-crate/"><img src="showcase/shipping-crate/preview.webp" width="24%" alt="Shipping crate: a wooden slat crate with iron corner brackets on a dark studio floor, warm wedge on the back wall" /></a>
113113
<a href="showcase/stone-well/"><img src="showcase/stone-well/preview.webp" width="24%" alt="Stone well: a round brick well with a shingled pyramid roof on posts, rope and bucket, on a dark studio floor" /></a>
114-
<a href="showcase/wooden-barrel/"><img src="showcase/wooden-barrel/preview.webp" width="24%" alt="Wooden barrel: a 20-stave wine-cask with croze-seated heads, chord-lofted iron hoops, and a bung on a dark studio floor" /></a>
114+
<a href="showcase/wooden-barrel/"><img src="showcase/wooden-barrel/preview.webp" width="24%" alt="Wooden barrel: a 20-stave wine-cask with a head of four boards, chord-lofted iron hoops, and a bung on a dark studio floor" /></a>
115115
<a href="showcase/campfire/"><img src="showcase/campfire/preview.webp" width="24%" alt="Campfire: a two-course stone fire ring with a tripod of logs on a dark studio floor, warm wedge on the back wall" /></a>
116116
<a href="showcase/market-stall/"><img src="showcase/market-stall/preview.webp" width="24%" alt="Market stall: a timber frame with post feet, slatted counter, rafters, and a striped awning on a dark studio floor, warm wedge on the back wall" /></a>
117117
<a href="showcase/street-lantern/"><img src="showcase/street-lantern/preview.webp" width="24%" alt="Street lantern: an iron post with brass collars, a braced arm, and a muntined amber cage on a dark studio floor" /></a>
@@ -143,7 +143,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
143143

144144
[`stone-well`](showcase/stone-well/) — procedural round stone well, shingled roof, windlass, rope and bucket through the same pipeline. Falsifier `--skip-decimate` exits 9.
145145

146-
[`wooden-barrel`](showcase/wooden-barrel/) — procedural 20-stave wine-cask with croze-seated heads and chord-lofted hoops through the same pipeline. Falsifier `--round-band` exits 18.
146+
[`wooden-barrel`](showcase/wooden-barrel/) — procedural 20-stave wine-cask with boarded, croze-seated heads and chord-lofted hoops through the same pipeline. Falsifiers `--round-band` exits 18, `--one-piece-head` exits 17.
147147

148148
[`campfire`](showcase/campfire/) — procedural cobble ring, logs, and ash through the same pipeline. Falsifier `--skip-decimate` exits 9.
149149

7.57 KB
Loading
158 Bytes
Loading

‎docs/gallery/wooden-barrel/index.html‎

Lines changed: 260 additions & 34 deletions
Large diffs are not rendered by default.

‎showcase/gallery.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@
3535
{
3636
"name": "wooden-barrel",
3737
"dir": "showcase/wooden-barrel",
38-
"teaches": "A procedural wine-cask with croze-seated heads and chord-lofted hoops through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.",
39-
"alt": "A wooden stave barrel bound by three metal hoops.",
40-
"witnessesFix": "Recomputed: 7216 tris, two materials with 2512 wood and 1440 metal faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.722×0.714×0.880 m, 20 grounded staves, hoop bite 0.003 m, head-croze gap 0.007 m, LOD ratios in band, convex collider 238 tris, non-empty glTF. --skip-decimate exits 9; --round-band exits 18 on the hoop-seat budget.",
38+
"teaches": "A procedural wine-cask with boarded, croze-seated heads and chord-lofted hoops through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.",
39+
"alt": "A wooden stave barrel bound by four iron hoops, its head made of boards.",
40+
"witnessesFix": "Recomputed: 7312 tris, two materials with 2584 wood and 1440 metal faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.722×0.714×0.880 m, 20 grounded staves, hoop bite 0.003 m, head-croze gap 0.007 m, four boards per head with 1.5 mm seams, LOD ratios in band, convex collider 238 tris, non-empty glTF. --skip-decimate exits 9; --round-band exits 18 on the hoop-seat budget; --one-piece-head exits 17 on the head-board budget.",
4141
"hero": "docs/gallery/assets/wooden-barrel-hero.webp",
4242
"preview": "showcase/wooden-barrel/preview.webp",
4343
"tags": [

‎showcase/wooden-barrel/README.md‎

Lines changed: 25 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,18 @@
11
# Wooden barrel
22

33
A showcase piece, not an example. Procedural wine-cask (20 staves with
4-
seeded width jitter, heads seated in a croze below a chime, iron hoops
5-
lofted on the stave faces, a bung) then the shipped pipeline: unique-cell
4+
seeded width jitter, heads of four boards seated in a croze below a
5+
chime, iron hoops lofted on the stave faces, a bung) then the shipped pipeline: unique-cell
66
UVs, Cycles high-to-low normal bake, LOD chain, convex collider, Unity
77
glTF export.
88

99
Hoops evaluate the same `host_outer_r` chord as the stave flats.
1010
`--round-band` is the falsifier: a circle of `radius_at(z)` instead of
1111
the chord, which is what made the old capped cylinder float off every
1212
face. Heads follow the inner stave polygon, not a circle, so they fill
13-
the croze instead of leaving triangular slots at every joint.
13+
the croze instead of leaving triangular slots at every joint. Each head
14+
is that outline cut across into four boards with a 1.5 mm seam, so the
15+
seat is unchanged and the head no longer reads as a lid.
1416

1517
It asserts **budget conformance** of the generated result. It does not
1618
witness an API contract. "It rendered without error" is not a check.
@@ -28,18 +30,19 @@ materials, UVs, evaluated LOD, collider, or export file.
2830

2931
| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) |
3032
| --- | --- | --- |
31-
| Base triangles | 6000–8500 | 7216 / 7216 / 7216 |
33+
| Base triangles | 6000–8500 | 7312 / 7312 / 7312 |
3234
| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 |
33-
| LOD2 ratio | 0.10–0.35 of base | 0.2198 / 0.2198 / 0.2198 |
34-
| Materials | exactly 2 distinct; ≥400 wood, ≥200 metal faces | 2 slots; 2512 / 1440 |
35+
| LOD2 ratio | 0.10–0.35 of base | 0.2199 / 0.2199 / 0.2199 |
36+
| Materials | exactly 2 distinct; ≥400 wood, ≥200 metal faces | 2 slots; 2584 / 1440 |
3537
| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 |
3638
| Outer AABB | (0.722, 0.714, 0.880) m ± 0.015 | (0.7220, 0.7142, 0.8800), zmin 0 |
3739
| Collider tris | ≤ 400 | 238 |
38-
| Export | written, size > 0 | 544140 / 544140 / 544124 bytes |
40+
| Export | written, size > 0 | 552456 / 552456 / 552440 bytes |
3941

4042
Base triangles rose from **4312 to 7216** in the quality pass: 12 identical
4143
staves with 5 mm daylight and circular hoops became 20 jittered staves,
4244
8-ring bulge, chord-seated hoops, polygonal croze heads, and a bung.
45+
Cutting each head into four boards added 96 more (7312).
4346

4447
DECIMATE COLLAPSE triangle counts are **not** identical across series —
4548
the gate is a ratio band, not an exact count. Bake pixels are
@@ -67,12 +70,13 @@ Recomputed from the generated mesh, not asserted about the script.
6770

6871
| Axis | Declared | Measured (all three) |
6972
| --- | --- | --- |
70-
| Head-croze rim BVH gap | ≤ 0.010 m | 0.00698 |
73+
| Head-croze rim BVH gap | ≤ 0.010 m | 0.00710 |
74+
| Head boards | 4 per head; every seam 0.0008–0.003 m | 4 + 4; 0.00150 |
7175
| Hoop bite (host r − inner hoop r) | 0.0012–0.008 m | 0.00300 |
7276

7377
### Falsifiers
7478

75-
Each violates one named budget. All six were run on 4.5.11, 5.1.2 and
79+
Each violates one named budget. All seven were run on 4.5.11, 5.1.2 and
7680
5.2.1 and returned the same code on each.
7781

7882
| Flag | Budget violated | Exit |
@@ -83,6 +87,16 @@ Each violates one named budget. All six were run on 4.5.11, 5.1.2 and
8387
| `--short-staves` | named stave supports at Z=0 | 16 |
8488
| `--float-head` | head-croze gap | 17 |
8589
| `--round-band` | hoop bite band | 18 |
90+
| `--one-piece-head` | head boards: 4 per head | 17 |
91+
92+
## Surface
93+
94+
The staves were one flat tone and the hoops bright polished steel. Each
95+
stave and each head board now carries a seeded `PlankTone` and a
96+
`GrainDir` (its own long axis) as face attributes. `wood_material`
97+
stretches grain along that axis, so it runs up the curved staves and
98+
across the head boards. The hoops are dark rusted iron, the same recipe as
99+
`shipping-crate`. The temp `.glb` is removed once its size is measured.
86100

87101
## Run
88102

@@ -94,6 +108,7 @@ blender --background --python wooden_barrel.py -- --lift-z
94108
blender --background --python wooden_barrel.py -- --short-staves
95109
blender --background --python wooden_barrel.py -- --float-head
96110
blender --background --python wooden_barrel.py -- --round-band
111+
blender --background --python wooden_barrel.py -- --one-piece-head
97112
blender --background --python wooden_barrel.py -- --output barrel.png
98113
```
99114

@@ -124,6 +139,6 @@ hygiene and joint-fit family.
124139
| 14 | `--output` produced no file |
125140
| 15 | Mesh hygiene: loose, non-manifold, zero-area, doubles, n-gons, z-fight |
126141
| 16 | Not grounded: bounding box `zmin` off 0, or a named stave floats |
127-
| 17 | Joint fit: head-croze gap (`--float-head`) |
142+
| 17 | Joint fit: head-croze gap (`--float-head`), or head boards and seams (`--one-piece-head`) |
128143
| 18 | Seat: hoop bite band (`--round-band`) |
129144
| 19 | Body diameter or height off the stated real-world size |
6.78 KB
Loading

0 commit comments

Comments
 (0)