Skip to content

Commit 99c988e

Browse files
TMHSDigitalclaude
andcommitted
fix: wooden-bucket quality pass, laid rope bail clear of the ear plates
The bail is three-strand rope and its rings now stand clear of the ear plates the old rope ran through (exit 17, --sunk-rope). The bottom is three boards (exit 17, --one-piece-bottom). OUTER_SIZE refit to the honest envelope; --float-handle now keeps the envelope still. Per-stave wood, iron hoops, temp glb removed. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
1 parent 7b0a269 commit 99c988e

8 files changed

Lines changed: 724 additions & 127 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
129129
<a href="showcase/hand-pump/"><img src="showcase/hand-pump/preview.webp" width="24%" alt="Hand pump: a cast-iron village pump on a wooden plinth with a spout and handle on a dark studio floor" /></a>
130130
<a href="showcase/signpost/"><img src="showcase/signpost/preview.webp" width="24%" alt="Signpost: a timber post with two painted fingerboards, iron straps, and a pyramidal cap on a dark studio floor" /></a>
131131
<a href="showcase/chopping-block/"><img src="showcase/chopping-block/preview.webp" width="24%" alt="Chopping block: a bark-sided log round with growth rings and drying checks on its sawn top, a riveted iron hoop, and a felling axe buried in the top, on a dark studio floor" /></a>
132-
<a href="showcase/wooden-bucket/"><img src="showcase/wooden-bucket/preview.webp" width="24%" alt="Wooden bucket: a coopered pail with a round rope bail through ear rings and chord-lofted iron hoops on a dark studio floor" /></a>
132+
<a href="showcase/wooden-bucket/"><img src="showcase/wooden-bucket/preview.webp" width="24%" alt="Wooden bucket: a coopered pail with a three-strand rope bail through iron ear rings and chord-lofted iron hoops on a dark studio floor" /></a>
133133
<a href="showcase/wall-torch/"><img src="showcase/wall-torch/preview.webp" width="24%" alt="Wall torch: a dressed stone plaque with an iron sconce, wooden haft, and flame on a dark studio floor" /></a>
134134
<a href="showcase/tavern-stool/"><img src="showcase/tavern-stool/preview.webp" width="24%" alt="Tavern stool: a round wooden seat on turned splayed legs with stretchers and iron ferrules on a dark studio floor" /></a>
135135
<a href="showcase/iron-cauldron/"><img src="showcase/iron-cauldron/preview.webp" width="24%" alt="Iron cauldron: a bulged iron pot hanging from a timber tripod on a dark studio floor" /></a>
@@ -179,7 +179,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show
179179

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

182-
[`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.
182+
[`wooden-bucket`](showcase/wooden-bucket/) — procedural coopered pail with a three-strand rope bail through the ear rings through the same pipeline. Falsifiers `--float-handle` and `--sunk-rope` exit 17.
183183

184184
[`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).
185185

4.44 KB
Loading
454 Bytes
Loading

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

Lines changed: 346 additions & 60 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
@@ -272,9 +272,9 @@
272272
{
273273
"name": "wooden-bucket",
274274
"dir": "showcase/wooden-bucket",
275-
"teaches": "A procedural coopered pail with a croze-seated floor, chord-lofted hoops, and a round bail through the ear rings through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.",
276-
"alt": "A wooden stave bucket with metal hoops and a curved wooden bail handle.",
277-
"witnessesFix": "Recomputed: 4872 tris, three materials with 1424 wood, 1020 metal, and 208 rope faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.383×0.346×0.527 m, 16 grounded staves, hoop bite 0.0025 m, bail-ear gap 0.0013 m, LOD ratios in band, convex collider 302 tris, non-empty glTF. --skip-decimate exits 9; --float-handle exits 17 on the bail-ear budget.",
275+
"teaches": "A procedural coopered pail with a boarded, croze-seated floor, chord-lofted hoops, and a three-strand rope bail through the ear rings through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.",
276+
"alt": "A wooden stave bucket with three iron hoops and a twisted rope handle through iron ear rings.",
277+
"witnessesFix": "Recomputed: 5458 tris, three materials with 1448 wood, 1020 metal, and 486 rope faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.396×0.346×0.534 m, 16 grounded staves, hoop bite 0.0025 m, bail-ear gap 0.0011 m, three bottom boards, no rope vertex inside an ear plate, LOD ratios in band, convex collider 276 tris, non-empty glTF. --skip-decimate exits 9; --float-handle exits 17 on the bail-ear budget; --sunk-rope exits 17 on the rope-clearance budget.",
278278
"hero": "docs/gallery/assets/wooden-bucket-hero.webp",
279279
"preview": "showcase/wooden-bucket/preview.webp",
280280
"tags": [

‎showcase/wooden-bucket/README.md‎

Lines changed: 53 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,20 @@
11
# Wooden bucket
22

33
A showcase piece, not an example. Procedural coopered pail (16 staves
4-
with seeded width jitter, a bottom seated in a croze above a chime,
5-
iron hoops lofted on the stave faces, ear plates and rings, a round
6-
rope bail through the rings) then the shipped pipeline: unique-cell
4+
with seeded width jitter, a bottom of three boards seated in a croze
5+
above a chime, iron hoops lofted on the stave faces, ear plates and
6+
rings, a three-strand rope bail through the rings) then the shipped pipeline: unique-cell
77
UVs, Cycles high-to-low normal bake, LOD chain, convex collider, Unity
88
glTF export.
99

1010
Hoops evaluate the same `host_outer_r` chord as the stave flats.
1111
`--round-band` is the falsifier: a circle of `radius_at(z)` instead of
1212
the chord. The floor follows the inner stave polygon. Ear plates sit on
1313
the outer stave face below the rim; the bail is a semicircle whose ends
14-
pass through the rings. `--float-handle` shrinks that semicircle so the
15-
bar sits on the ring; `--float-bottom` shrinks the floor out of the croze.
14+
pass through the rings and run on below them. `--float-handle` shrinks
15+
that semicircle and lifts it by what it lost, so the envelope stays put
16+
and only the bail-ear gap fails; `--float-bottom` shrinks the floor out
17+
of the croze.
1618

1719
It asserts **budget conformance** of the generated result. It does not
1820
witness an API contract. "It rendered without error" is not a check.
@@ -30,26 +32,27 @@ materials, UVs, evaluated LOD, collider, or export file.
3032

3133
| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) |
3234
| --- | --- | --- |
33-
| Base triangles | 4000–5800 | 4872 / 4872 / 4872 |
34-
| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 |
35-
| LOD2 ratio | 0.10–0.35 of base | 0.2196 / 0.2196 / 0.2188 |
36-
| Materials | exactly 3 distinct; ≥350 wood, ≥180 metal, ≥40 rope | 3 slots; 1424 / 1020 / 208 |
35+
| Base triangles | 4000–5800 | 5458 / 5458 / 5458 |
36+
| LOD1 ratio | 0.32–0.62 of base | 0.4998 / 0.4998 / 0.4998 |
37+
| LOD2 ratio | 0.10–0.35 of base | 0.2199 / 0.2199 / 0.2191 |
38+
| Materials | exactly 3 distinct; ≥350 wood, ≥180 metal, ≥40 rope | 3 slots; 1448 / 1020 / 486 |
3739
| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 |
38-
| Outer AABB | (0.383, 0.346, 0.527) m ± 0.015 | (0.3832, 0.3462, 0.5271), zmin 0 |
39-
| Collider tris | ≤ 420 | 302 |
40-
| Export | written, size > 0 | 378296 / 378296 / 378276 bytes |
40+
| Outer AABB | (0.396, 0.346, 0.534) m ± 0.015 | (0.3957, 0.3462, 0.5338), zmin 0 |
41+
| Collider tris | ≤ 420 | 276 |
42+
| Export | written, size > 0 | 420984 / 420984 / 420976 bytes |
4143

4244
Base triangles rose from **4272 to 4872** in the quality pass: overlapping
4345
identical staves, circular hoops, and a 12-box bail became 16 jittered
4446
staves, chord-seated hoops, a polygonal croze floor, and a round bail
45-
through the ear rings.
47+
through the ear rings. The second pass took it to **5458**: the bail
48+
became three-strand rope (48 segments of a nine-vertex lobed section,
49+
running on through the rings) and the floor three boards.
4650

47-
DECIMATE COLLAPSE triangle counts are **not** identical across series —
48-
5.2.1 is 4 tris leaner on LOD2. The gate is a ratio band, not an exact
51+
DECIMATE COLLAPSE triangle counts are **not** identical across series,
52+
so LOD2 ratios differ slightly between versions. The gate is a ratio band, not an exact
4953
count. Bake pixels are stochastic; the gate is `has_data` plus operator
5054
`FINISHED`, not byte-identity. Stave-width jitter uses fixed seed 17.
51-
Export byte counts differ by 20 B on 5.2.1 (glTF serializer), not a
52-
gated axis.
55+
Export byte counts differ on 5.2.1 (glTF serializer), not a gated axis.
5356

5457
### Hygiene
5558

@@ -71,13 +74,15 @@ Recomputed from the generated mesh, not asserted about the script.
7174

7275
| Axis | Declared | Measured (all three) |
7376
| --- | --- | --- |
74-
| Bail-ear BVH gap | ≤ 0.006 m | 0.00125 |
75-
| Floor-croze rim BVH gap | ≤ 0.008 m | 0.00458 |
77+
| Bail-ear BVH gap | ≤ 0.006 m | 0.00107 |
78+
| Floor-croze rim BVH gap | ≤ 0.008 m | 0.00474 |
79+
| Bottom boards | 3; every seam 0.0006–0.0025 m | 3; 0.00120 |
80+
| Rope clears the ear plates | 2 plates; 0 rope vertices inside either | 2; 0 |
7681
| Hoop bite (host r − inner hoop r) | 0.0010–0.007 m | 0.00250 |
7782

7883
### Falsifiers
7984

80-
Each violates one named budget. All seven were run on 4.5.11, 5.1.2 and
85+
Each violates one named budget. All nine were run on 4.5.11, 5.1.2 and
8186
5.2.1 and returned the same code on each.
8287

8388
| Flag | Budget violated | Exit |
@@ -89,6 +94,31 @@ Each violates one named budget. All seven were run on 4.5.11, 5.1.2 and
8994
| `--float-handle` | bail-ear gap | 17 |
9095
| `--float-bottom` | floor-croze gap | 17 |
9196
| `--round-band` | hoop bite band | 18 |
97+
| `--one-piece-bottom` | bottom boards: 3 | 17 |
98+
| `--sunk-rope` | rope clears the ear plates | 17 |
99+
100+
## Rope and ears
101+
102+
The bail was a smooth eight-sided tube in a rope material, and it read as
103+
a plastic hose. It is now laid rope: a three-lobed section turned one
104+
vertex step per ring, so the lobes wind along the bail as strands. The
105+
section's frame is fixed to the bail's plane, so the lay does not jump
106+
where the ends turn vertical.
107+
108+
The ring offset from the ear plate was `RING_MAJOR * 0.25`, which put the
109+
rope's axis 3.25 mm off the plate and its body through it (hidden by the
110+
ring in the old stills). The offset is now sized from the rope's lobes
111+
plus 0.5 mm, and **Rope clears the ear plates** asserts it. `--sunk-rope`
112+
restores the old offset and puts 19 rope vertices inside a plate. The
113+
outer AABB was re-fitted to the honest envelope: 12.5 mm wider across the
114+
ears and 6 mm taller.
115+
116+
## Surface
117+
118+
Every stave and board carries a seeded `PlankTone` and a `GrainDir` (its
119+
own long axis) as face attributes, and `wood_material` stretches grain
120+
along that axis. The hoops, plates and rings are dark rusted iron. The
121+
temp `.glb` is removed once its size is measured.
92122

93123
## Run
94124

@@ -101,6 +131,8 @@ blender --background --python wooden_bucket.py -- --short-staves
101131
blender --background --python wooden_bucket.py -- --float-handle
102132
blender --background --python wooden_bucket.py -- --float-bottom
103133
blender --background --python wooden_bucket.py -- --round-band
134+
blender --background --python wooden_bucket.py -- --one-piece-bottom
135+
blender --background --python wooden_bucket.py -- --sunk-rope
104136
blender --background --python wooden_bucket.py -- --output bucket.png
105137
```
106138

@@ -131,6 +163,6 @@ hygiene and joint-fit family.
131163
| 14 | `--output` produced no file |
132164
| 15 | Mesh hygiene: loose, non-manifold, zero-area, doubles, n-gons, z-fight |
133165
| 16 | Not grounded: bounding box `zmin` off 0, or a named stave floats |
134-
| 17 | Joint fit: bail-ear gap or floor-croze gap |
166+
| 17 | Joint fit: bail-ear gap, floor-croze gap, bottom boards and seams, or rope through an ear plate |
135167
| 18 | Seat: hoop bite band (`--round-band`) |
136168
| 19 | Body diameter or height off the stated real-world size |
4.07 KB
Loading

0 commit comments

Comments
 (0)