Toboggan

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.

witnesses Recomputed: 7356 tris, five materials with 252 slat, 864 frame, 1560 steel, 1412 rope and 48 paint faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.623×0.468×0.243 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, both steel shoes standing on the floor, six posts 11.5 mm into their runners and 13.5 mm into their bearers, 21 slat rebates of 3.0 mm each carrying a screw head 0.6 mm into the slat and 1.2 mm proud, shoes 1.5 mm up into the timber, six bolt heads 4.4 mm proud, the bar 70 mm proud of each runner, the rope through the bar's 11 mm hole with 4.2 mm to spare, a 1.191 m runner, a deck 0.943×0.417 m at 0.145 m, and mirrored runners. --miss-hole exits 18 at −7.8 mm clearance while everything else passes; --float-shoe exits 16 with the other shoe still grounding the AABB.

category Vehicles

tags mesh export showcase

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.

What it composes#

Shipped contentUsed for
skills/mesh-editing-and-bmeshchamfered 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-propertiesface attributes (PlankTone, GrainDir) and a point attribute (Lay) read by the shaders
skills/procedural-materials-and-shadersslat pine, stained frame, worn steel, hemp darkened in the lay grooves, worn red enamel
skills/bake-high-to-lowCycles tangent-space normal bake, high onto low
skills/engine-export-presetsUnity glTF (export_yup=True)
skills/depsgraph-and-evaluated-dataevaluated triangle counts for the LOD ratios
snippets/decimate_to_budget.pyLOD1 / LOD2 COLLAPSE chain
snippets/convex_hull_collider.pyfour hulls per runner, one for the deck, one for the bar, merged into a compound
snippets/lod_chain.pyLOD naming and ratio pattern
examples/mesh-hygiene-audithygiene combinatorics (copied, not imported)

The budgets that matter#

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:

Budgets#

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.

BudgetBandMeasured
Base triangles7050–76507356
LOD1 ratio0.32–0.620.5000
LOD2 ratio0.10–0.350.2200
Material slotsexactly 5, distinct5
Slat / frame / steel / rope / paint faces≥ 230 / 770 / 1450 / 1300 / 44252 / 864 / 1560 / 1412 / 48
UV boundsinside 0..1(0.0037, 0.0043)–(0.9962, 0.9957)
UV AABB overlap≤ 1e-50.000000
Outer AABB1.623 × 0.468 × 0.243 m ± 0.0201.6234 × 0.4680 × 0.2428
Collider triangles≤ 720632 (10 hulls)
Normal bake{'FINISHED'} with image data{'FINISHED'}, has_data=True
glTF exportfile written, non-empty~326 kB
Hygieneall zeroloose 0/0, non-manifold 0, zero-area 0, doubles 0, n-gons 0, coplanar cross-shell pairs 0
Grounded AABB\zmin\≤ 1e-40.00000
Named shoes2 shoes, each zmin ≤ 1e-42 at 0.00000
Post bite into runner6 posts, 5–16 mm11.5 mm
Post tenon into bearer6–18 mm; clear of the slats ≥ 12 mm13.5 mm; 21.5 mm
Bar protrusion1 bar, 55–85 mm past each runner's outer face70.0 mm both ends
Slat seat7 slats, 21 joints, 1.5–4.5 mm3.0 mm
Screw seat21 screws, one per slat-bearer joint, 0.3–1.2 mm bite, 0.8–2.0 mm proud0.6 mm; 1.2 mm
Shoe seat2 shoes, 0.5–2.5 mm up into the runner1.5 mm
Bolt seat6 bolts, 3–6 mm proud, 0.5–2 mm bite4.4 mm; 1.0 mm
Rope in the holebar 1, rope 1, clearance 0.5–6 mmhole r 11.0 mm, clearance 4.2 mm to the strand crowns, 72 rope vertices (six rings) inside the bar
Runner length1.15–1.25 m1.191 m
Deck0.90–0.98 m × 0.40–0.44 m, top 0.130–0.155 m0.943 × 0.417, 0.145
Track (runner centre to centre)0.29–0.31 m0.300 m
Mirrored runners and shoesextents mirrored through y = 0 within 0.1 mm0.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.

Construction#

Findings the budgets forced#

Conventions walked#

Every convention in showcase/README.md, and whether it applies here.

ConventionAppliesHow
Deterministic, budgets declared, assertions recomputeyesno RNG; every value above is read off the mesh
Falsifier fails the budget it targetsyestable below, run on 5.2.1
Hygiene incl. cross-shell coplanaryesexit 15
Named supportsyesthe two shoes (--float-shoe)
Even shaping terms and mirror symmetryyesone curve for both runners; mirrored runners and shoes asserted (--skew-runner)
Plumb and real-world sizeyesrunner, deck and track bands (--tall-posts)
A member is tenoned into its seatyesposts into runner and bearer (--short-post), slats rebated (--float-slats)
Joint-fit budgetsyespost and bar bands recomputed from the host shell
Fasteners seatedyesbolt heads proud and bitten (--float-bolts); slat screws bitten and proud (--float-screws)
Seat conformanceyesshoe up into runner (--lift-runners)
Hung / threaded ropeyesrope in the bar's centre hole (--miss-hole)
Wrappers follow the host's profilen/athe shoe is a parallel offset of the same centreline, not a wrapper
Edge treatment: no right anglesyes, by constructionevery 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 modelyessmooth along members, every edge over 40° hard (chamfers, caps)
One substance, one slotyesslat pine, frame, steel, rope, paint
Iron is not chromeyessteel metallic 0.85, roughness 0.30–0.62, rust speckle
Identical boards read as CGyesper-shell PlankTone; grain along each member
The bake cage is narrower than the nearest neighbouryesCAGE_EXTRUSION 0.01 m
Level on the stage; stage 60 myesturned about Z only; 60 m floor and wall
Keep a falsifier's envelope stillyesevery 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, roofsnothe piece has none of these

Falsifiers#

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.

FlagTarget budgetBreaksExit
--skip-decimateLOD1 ratiodrops the DECIMATE modifiers, LOD1 ratio goes to 1.00009
--stray-vertmesh hygieneadds one loose vertex under the deck15
--lift-zgrounded zminlifts the whole mesh 50 mm16
--float-shoenamed shoeslifts the left shoe 6 mm; the right still grounds the AABB16
--short-postpost bite into the runnerstarts every post 4 mm above the runner's top; −2.5 mm17
--short-barbar protrusionpulls the bar's left end in 19 mm; 51 mm proud, under the 55 mm minimum17
--float-slatsslat seatlifts every slat 5 mm off its bearers; −2.0 mm18
--lift-runnersshoe seatlifts both timbers 4 mm off their shoes; −2.5 mm18
--float-boltsbolt seatmoves every bolt 3.5 mm outward; bite −2.5 mm18
--float-screwsscrew seatlifts every screw head 3 mm off its slat; bite −2.4 mm18
--miss-holerope in the holelifts the rope and knot 12 mm; clearance −7.8 mm18
--tall-postsreal-world deck heightraises bearers, posts and slats 40 mm; deck top 185 mm19
--skew-runnermirrored runnersmoves the left runner and shoe 6 mm along X; 6.0 mm19

Exit codes#

File-local and sequential. 9 is a valid check code. 1 is the FATAL wrapper — a crash, never a named check.

CodeMeaning
0Success
1Uncaught exception (FATAL wrapper)
2argparse / usage
3Mesh did not build, or has no UV layer
4Base triangle count outside band
5Material slots, or a material's face floor
6UVs outside 0..1
7UV AABB overlap above tolerance
8Outer AABB off declared size
9LOD1 or LOD2 ratio outside band (--skip-decimate)
10Framing gate (examples/gallery_framing.py, render path only)
11Collider triangles above ceiling
12Normal bake failed or produced no image data
13glTF export missing or empty
14--output produced no file
15Mesh hygiene (--stray-vert)
16Grounded zmin, or a shoe floating (--lift-z, --float-shoe)
17Post bite or tenon, or bar protrusion (--short-post, --short-bar)
18Slat, screw, shoe or bolt seat, or the rope in its hole (--float-slats, --float-screws, --lift-runners, --float-bolts, --miss-hole)
19Real-world size or mirrored runners (--tall-posts, --skew-runner)
24Asset-quality floors (examples/gallery_asset_quality.py, render path only; remapped from 11)

Run it#

# 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.

Cross-version measurements#

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.

Value5.2.1
Base triangles7356
LOD1 / LOD2 tris3678 / 1618
Face counts (slat / frame / steel / rope / paint)252 / 864 / 1560 / 1412 / 48
Outer AABB1.6234 × 0.4680 × 0.2428
Collider tris632
glTF bytes325848

Source

showcase/toboggan/toboggan.py View the script on GitHub →
A wooden sled in three-quarter view: steel-shod runners rising into high front horns, a screwed seven-slat deck, a red steering bar through the horns and a twisted hemp rope.