Ship's Wheel

showcase/ships-wheel/

A procedural eight-spoke ship's wheel on its pedestal — turned teak spokes and handles, a laminated rim with a brass inlay, a brass nave on an iron shaft in a bolted bearing collar, a helm stand with a moulded plinth and base, panelled column, brass band, coved capital and cap — through UVs, bake, LOD, 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: 11036 tris, three materials (teak 3996, brass 1628, iron 208 faces), UVs in 0..1 with zero overlap, a 1.000 × 0.622 × 1.500 m envelope, LOD1 0.5000 and LOD2 0.2193–0.2198, a 478-tri three-hull collider, a FINISHED normal bake and a 826 kB Unity glTF, hygiene all zero with no coplanar cross-shell faces, and the wheel exactly radial: the nave 0.0001 mm off the rim's centre, the shaft 0.0004 mm off the nave's axis with 0.599 mm bore clearance, every spoke seated 3.000 mm into the rim's inner face and every handle 4.000 mm into its outer face, consecutive spokes 45° apart within 0.00013°, every handle within 0.00007° of its spoke's axis, 1.000 m over the handles on a 0.720 m rim at 1.000 m. --skip-decimate exits 9 on LOD1; --stray-vert exits 15 on hygiene; --lift-z exits 16 on grounded zmin; --offset-hub exits 17 with the nave 2.000 mm off centre; --short-spoke exits 18 with a tip 7.000 mm clear of the rim; --skew-spoke exits 19 with the spacing 2.0000° off.

category Village

tags mesh export showcase

blender --background --python showcase/ships-wheel/ships_wheel.py --

A one-metre, eight-spoke ship's wheel on its pedestal: eight turned teak spokes running from a brass nave out to a laminated teak rim, eight turned handles carried on past the rim on the spokes' own axes, a 10 mm brass inlay round the rim's face, brass ferrules where the handles leave the rim and a second brass ring on the king spoke. It turns on an iron shaft in a flanged brass bearing collar bolted to a panelled teak helm stand: a moulded plinth and base, a brass band, a coved capital and an overhanging cap. 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-bmeshrevolved spokes, handles, nave, rim, shaft, collar, nut, ferrules and bolt heads, a chamfered plinth block and pedestal mouldings lofted through square-ring profiles, all in one bmesh, chamfered with bmesh.ops.bevel
skills/custom-propertiesface attributes Part (what each shell is) and WoodTone (one tone per member), and a point attribute GrainCo (each vertex in its member's own grain frame)
skills/procedural-materials-and-shadersvarnished teak whose figure runs along each member (up the column, along every spoke and handle, round the rim), with a tone and hue per member and hand wear, recess grime from an ambient-occlusion term and a light varnish coat; brass polished on its high points and tarnished in its recesses; black iron
skills/bake-high-to-lowCycles tangent-space normal bake, a doubled-segment high onto the 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.pya hull over the plinth, one over the column, one over the whole wheel
snippets/lod_chain.pyLOD naming and ratio pattern
examples/mesh-hygiene-audithygiene combinatorics (copied, not imported)

The budget that matters#

A ship's wheel is exact radial repetition, and it can fail without looking wrong:

The piece measures all of it off the finished mesh. Every shell carries a Part face attribute written at build time, so the audit finds the rim, the nave, the shaft, the eight spokes and the eight handles without guessing from shape.

--offset-hub moves the nave 2 mm across and leaves the shaft and every spoke where they were: concentric, coaxial and bore all fail, exit 17. --short-spoke shortens one diagonal spoke 10 mm, so its tip stands 7 mm clear of the rim: exit 18. --skew-spoke turns one diagonal spoke and its handle 2° about the shaft; its tip still seats, so only the spacing fails, exit 19. Both act on diagonal spokes, whose tips set no edge of the envelope.

Budgets#

Declared in the script as named constants, recomputed from the generated mesh. Measured values below are from Blender 5.2.1; see the cross-version table for 4.5.11 and 5.1.2.

BudgetBandMeasured
Base triangles10500–1160011036
LOD1 ratio0.32–0.620.5000
LOD2 ratio0.10–0.350.2193
Material slotsexactly 3, distinct3
Teak / brass / iron faces≥ 3700 / 1500 / 1903996 / 1628 / 208
UV boundsinside 0..1(0.0005, 0.0005)–(0.9995, 0.9995)
UV AABB overlap≤ 1e-50.000000
Outer AABB1.000 × 0.622 × 1.500 m ± 0.0201.0000 × 0.6220 × 1.5000
Collider triangles≤ 560478 (three hulls)
Normal bake{'FINISHED'} with image data{'FINISHED'}, has_data=True
glTF exportfile written, non-empty~826 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
Partsplinth block and ogee step, moulded base, column, brass band, capital, cap, 3 panel fields in 12 moulding pieces, collar, 4 bolts, shaft, nut, nave, rim, inlay, 8 spokes, 8 handles, 8 ferrules, 1 king ringas stated
Nave concentric, shaft coaxial≤ 0.3 mm each, bore clearance 0.3–1.0 mm0.0001 mm, 0.0004 mm, 0.599 mm
Spoke seat in the rim1–6 mm into the inner face3.000 mm (all eight)
Handle seat in the rim1–6 mm into the outer face4.000 mm (all eight)
Spoke spacing45° ± 0.05°worst 0.00013°
Handle on its spoke's axis≤ 0.05°worst 0.00007°
Real-world size1.000 ± 0.004 m over the handles, rim 0.720 ± 0.004 m, centre 1.000 ± 0.002 m above the deck1.0000, 0.7200, 1.0000

Real-world size: a small vessel's pedestal helm is about a metre over the handles with eight spokes, the rim a little under three quarters of that, the handles turned to a hand's grip (about 40 mm at the bulb) and the wheel's centre about a metre off the deck.

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
Hygiene incl. cross-shell coplanaryesexit 15
Plumb and real-world sizeyeswheel diameter, rim diameter and centre height; exit 19
A member is tenoned into its seatyesspokes into the nave and the rim, handles into the rim, the column into the plinth, the collar into the column
Seat conformance (a band: minimum so it cannot float)yesevery spoke and handle in the rim (--short-spoke), exit 18
Mirrored assembliesnoa wheel is radial, not mirrored; its symmetry is the spacing budget
Material face floorsyesteak 3700, brass 1500, iron 190
One substance, one slotyesteak, brass, iron
Shading is part of the modelyesturned parts smooth, every edge over 35° hard; pedestal faceted
Edge treatmentyesevery box chamfered, every moulding profiled, the rim's section rounded; no separate budget, removing the chamfers moves the triangle band first
Sort bmesh operator inputsyesthe bevel's edge list is sorted by index
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 stillyesno falsifier moves the AABB
Named supports, wrappers, rope, roofs, vessels, scatter, fastenerspartlyfasteners: the collar's bolts are counted as parts

Falsifiers#

Each breaks one pipeline stage so a named budget fails. All six were run on Blender 4.5.11, 5.1.2 and 5.2.1 and exited the declared code.

FlagTarget budgetBreaksExit
--skip-decimateLOD1 ratiodrops the DECIMATE modifiers, LOD1 ratio goes to 1.00009
--stray-vertmesh hygieneadds one loose vertex behind the wheel15
--lift-zgrounded zminlifts the whole mesh 50 mm16
--offset-hubconcentric nave, shaft in its boremoves the nave 2 mm across; 2.000 mm off centre, bore clearance −1.400 mm17
--short-spokespoke seat in the rimshortens one diagonal spoke 10 mm; tip −7.000 mm from the rim18
--skew-spokeequal angular spacingturns one diagonal spoke and its handle 2°; spacing off by 2.0000°19

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, has no UV layer, or a part count is wrong
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 (--lift-z)
17Nave off the rim's centre, shaft off its axis, or bore clearance out of band (--offset-hub)
18A spoke or handle not seated in the rim (--short-spoke)
19Spoke spacing, a handle off its spoke's axis, or real-world size (--skew-spoke)
21Asset-quality floors (examples/gallery_asset_quality.py, render path only)

Run it#

# Budget check, no render. A few seconds warm.
blender --background --python ships_wheel.py --

# Falsifier: one spoke turned 2 degrees. Must exit 19.
blender --background --python ships_wheel.py -- --skew-spoke

# Falsifier: one spoke 10 mm short of the rim. Must exit 18.
blender --background --python ships_wheel.py -- --short-spoke

# Render the gallery still (Cycles; EEVEE is the default engine).
blender --background --python ships_wheel.py -- --output ships_wheel.png --engine cycles

Smoke runs the check-only path. It does not pass --output or any falsifier.

Cross-version measurements#

Every default run and every falsifier was run on all three binaries (.scratch/blender-<ver>-windows-x64/blender.exe, reporting 4.5.11 LTS, 5.1.2 and 5.2.1 LTS). Only the DECIMATE counts differ, which is why the LOD gate is a ratio band; every concentric, seat, spacing and size value is identical.

Value4.5.115.1.25.2.1
Base triangles110361103611036
LOD1 / LOD2 triangles5518 / 24265518 / 24265518 / 2420
LOD2 ratio0.21980.21980.2193
Faces teak / brass / iron3996 / 1628 / 208samesame
Collider triangles478478478
Concentric, coaxial, bore0.0001 / 0.0004 / 0.599 mmsamesame
Spoke / handle seat3.000 / 4.000 mmsamesame
Falsifier exits 9 / 15 / 16 / 17 / 18 / 19all as declaredall as declaredall as declared

Source

showcase/ships-wheel/ships_wheel.py View the script on GitHub →
A varnished teak ship's wheel with eight turned spokes and handles and a brass nave, on a panelled teak helm stand with a moulded base, a brass band and a coved capital.