Shipping Crate
A procedural shipping crate through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.
showcase/toboggan/
A procedural runner sled — two steel-shod timber runners with high front horns and a near-flat tail, tenoned posts and bearers under a screwed seven-slat deck, one painted steering bar drilled at its centre, and a three-strand hemp rope through the hole to a wooden toggle — carried through UVs, bake, LOD, compound collider, and Unity glTF, asserting recomputed budgets rather than an API contract.
Rendered headless by the showcase piece itself. Select it to enlarge.
category Vehicles
blender --background --python showcase/toboggan/toboggan.py --
A traditional runner sled in the Flexible Flyer pattern (the name is the repo's; the model is the steered runner sled, not a flat-bottom toboggan): two steel-shod wooden runners with upturned front horns, six posts carrying three cross bearers, a deck of seven lengthwise slats screwed to them, one painted steering bar through both horns and proud of each as a hand grip, and a three-strand hemp rope threaded through a hole drilled in the bar's centre and stopped with a knot behind it, ending in a wooden toggle on the floor. A showcase piece, not an example — it witnesses no API contract. It asserts that generated geometry meets declared asset budgets, recomputed from the finished mesh.
| Shipped content | Used for |
|---|---|
skills/mesh-editing-and-bmesh | chamfered and round-cornered members swept along a curve, a drilled bar, lathed bolts and screws, a three-strand rope on a parallel-transport frame, all in one bmesh |
skills/custom-properties | face attributes (PlankTone, GrainDir) and a point attribute (Lay) read by the shaders |
skills/procedural-materials-and-shaders | slat pine, stained frame, worn steel, hemp darkened in the lay grooves, worn red enamel |
skills/bake-high-to-low | Cycles tangent-space normal bake, high onto low |
skills/engine-export-presets | Unity glTF (export_yup=True) |
skills/depsgraph-and-evaluated-data | evaluated triangle counts for the LOD ratios |
snippets/decimate_to_budget.py | LOD1 / LOD2 COLLAPSE chain |
snippets/convex_hull_collider.py | four hulls per runner, one for the deck, one for the bar, merged into a compound |
snippets/lod_chain.py | LOD naming and ratio pattern |
examples/mesh-hygiene-audit | hygiene combinatorics (copied, not imported) |
A sled stands on two steel shoes and is held together by tenons, rebates and a rope through a hole. Each of those fails invisibly to an AABB:
zmin sees it (--float-shoe, exit 16).--miss-hole, exit 18).Declared in the script as named constants, recomputed from the generated mesh. Measured values are from Blender 5.2.1, the only binary run locally; 4.5 and 5.1 were not run for this piece.
| Budget | Band | Measured | ||
|---|---|---|---|---|
| Base triangles | 7050–7650 | 7356 | ||
| LOD1 ratio | 0.32–0.62 | 0.5000 | ||
| LOD2 ratio | 0.10–0.35 | 0.2200 | ||
| Material slots | exactly 5, distinct | 5 | ||
| Slat / frame / steel / rope / paint faces | ≥ 230 / 770 / 1450 / 1300 / 44 | 252 / 864 / 1560 / 1412 / 48 | ||
| UV bounds | inside 0..1 | (0.0037, 0.0043)–(0.9962, 0.9957) | ||
| UV AABB overlap | ≤ 1e-5 | 0.000000 | ||
| Outer AABB | 1.623 × 0.468 × 0.243 m ± 0.020 | 1.6234 × 0.4680 × 0.2428 | ||
| Collider triangles | ≤ 720 | 632 (10 hulls) | ||
| Normal bake | {'FINISHED'} with image data | {'FINISHED'}, has_data=True | ||
| glTF export | file written, non-empty | ~326 kB | ||
| Hygiene | all zero | loose 0/0, non-manifold 0, zero-area 0, doubles 0, n-gons 0, coplanar cross-shell pairs 0 | ||
| Grounded AABB | \ | zmin\ | ≤ 1e-4 | 0.00000 |
| Named shoes | 2 shoes, each zmin ≤ 1e-4 | 2 at 0.00000 | ||
| Post bite into runner | 6 posts, 5–16 mm | 11.5 mm | ||
| Post tenon into bearer | 6–18 mm; clear of the slats ≥ 12 mm | 13.5 mm; 21.5 mm | ||
| Bar protrusion | 1 bar, 55–85 mm past each runner's outer face | 70.0 mm both ends | ||
| Slat seat | 7 slats, 21 joints, 1.5–4.5 mm | 3.0 mm | ||
| Screw seat | 21 screws, one per slat-bearer joint, 0.3–1.2 mm bite, 0.8–2.0 mm proud | 0.6 mm; 1.2 mm | ||
| Shoe seat | 2 shoes, 0.5–2.5 mm up into the runner | 1.5 mm | ||
| Bolt seat | 6 bolts, 3–6 mm proud, 0.5–2 mm bite | 4.4 mm; 1.0 mm | ||
| Rope in the hole | bar 1, rope 1, clearance 0.5–6 mm | hole r 11.0 mm, clearance 4.2 mm to the strand crowns, 72 rope vertices (six rings) inside the bar | ||
| Runner length | 1.15–1.25 m | 1.191 m | ||
| Deck | 0.90–0.98 m × 0.40–0.44 m, top 0.130–0.155 m | 0.943 × 0.417, 0.145 | ||
| Track (runner centre to centre) | 0.29–0.31 m | 0.300 m | ||
| Mirrored runners and shoes | extents mirrored through y = 0 within 0.1 mm | 0.000 mm |
Real-world size: the bands are this piece's own, chosen to match the common retail runner sled (about 1.2 m of runner, a deck about 0.4 m wide, standing 0.12–0.15 m off the snow). They are not taken from a standard.
SHOE_BITE), and its bottom vertices sit at exactly z = 0 on the flat run.PlankTone lands 0.73–1.33 of the ramp, so neighbouring boards read as different boards rather than one sheet.6 mm × (1 + 0.14 cos(3θ − 2πs/36 mm)), so the strands spiral along the rope in its silhouette, and a Lay point attribute with the same phase darkens the grooves between them. The path is re-cut at an even 6 mm. It starts at a knot centre behind the bar, runs straight through the hole, sags to the floor over 250 mm on a smoothstep, then curls 85° on the floor and ends in a toggle. The floor run sits at the strand crowns' radius (6.84 mm), not the mean, so the rope does not dip through the floor. The knot sphere (16.5 mm) is larger than the hole (11 mm), so the rope cannot pull through.doubles=2: the rope path's straight run landed exactly on the point where the sag begins, and the start-of-sag point was appended again. The path now appends it only when it is more than 0.1 mm from the last point.--float-bolts first lifted the bolts 4 mm, which put each bolt's base disc on y = 167 mm, exactly the plane of the steel shoe's side. The disc and the shoe's side face share no area, but the coplanar cross-shell count sees centres within 50 mm and reported 184 pairs, so the run exited 15, not 18. The displacement is now 3.5 mm.--short-bar (both ends pulled inside the runners) shrank the AABB by 80 mm in Y and exited 8, not 17. It now pulls only the left end in 19 mm, which stays inside BBOX_TOL (the box narrows 17.8 mm) and leaves that end 51 mm proud, under the 55 mm minimum.Every convention in showcase/README.md, and whether it applies here.
| Convention | Applies | How |
|---|---|---|
| Deterministic, budgets declared, assertions recompute | yes | no RNG; every value above is read off the mesh |
| Falsifier fails the budget it targets | yes | table below, run on 5.2.1 |
| Hygiene incl. cross-shell coplanar | yes | exit 15 |
| Named supports | yes | the two shoes (--float-shoe) |
| Even shaping terms and mirror symmetry | yes | one curve for both runners; mirrored runners and shoes asserted (--skew-runner) |
| Plumb and real-world size | yes | runner, deck and track bands (--tall-posts) |
| A member is tenoned into its seat | yes | posts into runner and bearer (--short-post), slats rebated (--float-slats) |
| Joint-fit budgets | yes | post and bar bands recomputed from the host shell |
| Fasteners seated | yes | bolt heads proud and bitten (--float-bolts); slat screws bitten and proud (--float-screws) |
| Seat conformance | yes | shoe up into runner (--lift-runners) |
| Hung / threaded rope | yes | rope in the bar's centre hole (--miss-hole) |
| Wrappers follow the host's profile | n/a | the shoe is a parallel offset of the same centreline, not a wrapper |
| Edge treatment: no right angles | yes, by construction | every member is a chamfered section; a 90° edge fraction of 0.015 is printed by the asset-quality gate on the render path |
| Shading is part of the model | yes | smooth along members, every edge over 40° hard (chamfers, caps) |
| One substance, one slot | yes | slat pine, frame, steel, rope, paint |
| Iron is not chrome | yes | steel metallic 0.85, roughness 0.30–0.62, rust speckle |
| Identical boards read as CG | yes | per-shell PlankTone; grain along each member |
| The bake cage is narrower than the nearest neighbour | yes | CAGE_EXTRUSION 0.01 m |
| Level on the stage; stage 60 m | yes | turned about Z only; 60 m floor and wall |
| Keep a falsifier's envelope still | yes | every displacement stays inside BBOX_TOL; --tall-posts raises the deck 40 mm but stays under the horn tips, so the AABB is unchanged |
| Masonry, vessels, scatter, roofs | no | the piece has none of these |
Each breaks one pipeline stage so a named budget fails. All thirteen exited their declared code on Blender 5.2.1; 4.5 and 5.1 were not run.
| Flag | Target budget | Breaks | Exit |
|---|---|---|---|
--skip-decimate | LOD1 ratio | drops the DECIMATE modifiers, LOD1 ratio goes to 1.0000 | 9 |
--stray-vert | mesh hygiene | adds one loose vertex under the deck | 15 |
--lift-z | grounded zmin | lifts the whole mesh 50 mm | 16 |
--float-shoe | named shoes | lifts the left shoe 6 mm; the right still grounds the AABB | 16 |
--short-post | post bite into the runner | starts every post 4 mm above the runner's top; −2.5 mm | 17 |
--short-bar | bar protrusion | pulls the bar's left end in 19 mm; 51 mm proud, under the 55 mm minimum | 17 |
--float-slats | slat seat | lifts every slat 5 mm off its bearers; −2.0 mm | 18 |
--lift-runners | shoe seat | lifts both timbers 4 mm off their shoes; −2.5 mm | 18 |
--float-bolts | bolt seat | moves every bolt 3.5 mm outward; bite −2.5 mm | 18 |
--float-screws | screw seat | lifts every screw head 3 mm off its slat; bite −2.4 mm | 18 |
--miss-hole | rope in the hole | lifts the rope and knot 12 mm; clearance −7.8 mm | 18 |
--tall-posts | real-world deck height | raises bearers, posts and slats 40 mm; deck top 185 mm | 19 |
--skew-runner | mirrored runners | moves the left runner and shoe 6 mm along X; 6.0 mm | 19 |
File-local and sequential. 9 is a valid check code. 1 is the FATAL wrapper — a crash, never a named check.
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Uncaught exception (FATAL wrapper) |
| 2 | argparse / usage |
| 3 | Mesh did not build, or has no UV layer |
| 4 | Base triangle count outside band |
| 5 | Material slots, or a material's face floor |
| 6 | UVs outside 0..1 |
| 7 | UV AABB overlap above tolerance |
| 8 | Outer AABB off declared size |
| 9 | LOD1 or LOD2 ratio outside band (--skip-decimate) |
| 10 | Framing gate (examples/gallery_framing.py, render path only) |
| 11 | Collider triangles above ceiling |
| 12 | Normal bake failed or produced no image data |
| 13 | glTF export missing or empty |
| 14 | --output produced no file |
| 15 | Mesh hygiene (--stray-vert) |
| 16 | Grounded zmin, or a shoe floating (--lift-z, --float-shoe) |
| 17 | Post bite or tenon, or bar protrusion (--short-post, --short-bar) |
| 18 | Slat, screw, shoe or bolt seat, or the rope in its hole (--float-slats, --float-screws, --lift-runners, --float-bolts, --miss-hole) |
| 19 | Real-world size or mirrored runners (--tall-posts, --skew-runner) |
| 24 | Asset-quality floors (examples/gallery_asset_quality.py, render path only; remapped from 11) |
# Budget check, no render. About 2 s on 5.2.1.
blender --background --python toboggan.py --
# Falsifier: the rope sits in solid wood, not in the hole. Must exit 18.
blender --background --python toboggan.py -- --miss-hole
# Falsifier: one shoe leaves the floor. Must exit 16.
blender --background --python toboggan.py -- --float-shoe
# Render the gallery still (EEVEE; --engine cycles on a GPU-less host).
blender --background --python toboggan.py -- --output toboggan.webp
Smoke runs the check-only path. It does not pass --output or any falsifier.
Only Blender 5.2.1 was run locally. The values below are from it; a column for 4.5 and 5.1 would be a guess, so there is none.
| Value | 5.2.1 |
|---|---|
| Base triangles | 7356 |
| LOD1 / LOD2 tris | 3678 / 1618 |
| Face counts (slat / frame / steel / rope / paint) | 252 / 864 / 1560 / 1412 / 48 |
| Outer AABB | 1.6234 × 0.4680 × 0.2428 |
| Collider tris | 632 |
| glTF bytes | 325848 |