Road Bicycle

showcase/road-bicycle/

A procedural 1970s lugged-steel road bicycle standing on its side kickstand — a 56 cm diamond frame of round tubes joined in chromed, spear-pointed lugs at the head tube, seat cluster and bottom bracket, tapered stays in chromed tips, a fork with a chromed sloping crown and socks; two 700c wheels, each a box-section rim with 36 spokes laced three-cross from both flanges of a small-flange hub to nipples through the rim, quick-release skewers and tan-wall tyres with a black file-tread crown; a 52/42 crankset with quill pedals, toe clips and straps, a six-speed freewheel, a roller chain of 112 individual links solved round the ring, the cog and both jockey wheels, front and rear derailleurs, down-tube shifters, side-pull calipers with pads a millimetre off the rims, levers under gum hoods on cotton-taped drop bars, a quill stem, a leather saddle on rails and a bottle in a bolted wire cage — leaned 5° onto its stand, 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: 46092 tris, ten materials with 1048 paint, 6438 chrome, 6950 alloy, 8239 steel, 540 tread, 952 gum, 356 leather, 1080 tape, 1810 black and 176 bottle faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.670×0.438×0.997 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs across 112 chain links, both tyres and the stand foot on the ground, both hubs 0.000000 m off their dropout eyes (cap 0.0005), every one of 72 spokes 3.00 mm deep in its flange (band 2.0–4.0 mm) and 4.50 mm inside its nipple on its axis, both rims 0.000 mm off the frame's plane (cap 1.0 mm), seat tube 0.5800 m, wheelbase 0.99982 m, trail 0.05536 m (band 0.045–0.065), lacing 36/36 with 18 per flange, pitch 0.000° off and every spoke three-cross (60.000°), 30 rollers seated on the ring and 10 on the cog 1.20–3.40 mm above the root (band 0.5–6.5 mm), every roller and the cog 0.000 mm off the chain line (cap 1.0 mm), the mass centre 0.0393 m inside the support triangle (floor 0.020) at 11.80 kg, one connected assembly of 685 shells, LOD ratios in band, collider 574 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-tyre 16; --slip-wheel 17; --short-spoke 18; --dish-wheel 19; --steep-head 20; --bunch-spokes 21; --lift-chain 22; --shift-rollers 23; --tuck-stand 24; --pop-bottle 25.

category Vehicles

tags mesh export showcase

blender --background --python showcase/road-bicycle/road_bicycle.py --

A showcase piece, not an example, and the fifth in the vehicles category. It builds a procedural 1970s lugged-steel road bicycle (no brand names, badges with text or decals), standing on its side kickstand and leaning 5° onto it:

The layout is solved from named constants: a 415 mm chain stay with a 70 mm bottom-bracket drop, a 73.5° seat tube, a 73° head tube with 45 mm of fork offset, and a 560 mm top tube. The front axle is placed so the steering axis passes one fork offset behind it, which gives the design trail (55 mm). The chain's path is solved from the four circles it wraps (ring, cog, and the two jockeys, each wrapped on its own side), and the derailleur cage swings until the loop is a whole, even number of pitches. The bike is built upright and leaned about the line through both tyres' contacts; the kickstand is built after the lean, its sole on the plane the tyres touch.

It asserts budget conformance of the generated result. It does not witness an API contract. "It rendered without error" is not a check.

Composes skills mesh-editing-and-bmesh, bake-high-to-low, depsgraph-and-evaluated-data, engine-export-presets, and snippets bake_normal_high_to_low.py, setup_bake_target_image.py, lod_chain.py / decimate_to_budget.py, convex_hull_collider.py, export_preset_unity.py (helpers copied inline, not imported).

Intended size: 1.67 m from tyre to tyre, a 1.000 m wheelbase, 0.44 m across the bars and pedals, 1.00 m to the saddle's top. The seat tube is 0.580 m from the bottom-bracket centre to its top. The origin is under the bike, so it lands on its tyres and stand.

Budgets#

Every budget is declared as a named constant. Every gate recomputes its value from the mesh, materials, UVs, evaluated LOD, collider, or export file.

AxisDeclaredMeasured (5.2.1)
Base triangles45600–4660046092
LOD1 ratio0.32–0.62 of base0.4995
LOD2 ratio0.10–0.35 of base0.2198
Materialsexactly 10 distinct; ≥940 paint, ≥5650 chrome, ≥6250 alloy, ≥7410 steel, ≥480 tread rubber, ≥850 gum, ≥320 leather, ≥970 tape, ≥1620 black, ≥158 bottle faces10 slots; 1048 / 6438 / 6950 / 8239 / 540 / 952 / 356 / 1080 / 1810 / 176
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(1.670, 0.438, 0.997) m ± 0.01(1.6698, 0.4376, 0.9969), zmin 0
Collider tris≤ 970574
Exportwritten, size > 0, removed after measuring3579436 / 3579436 / 3579428 bytes (4.5.11 / 5.1.2 / 5.2.1)

Every falsifier leaves the triangle count at 46092: they move parts, never add or remove them. --lift-chain keeps the default chain's link count and lets the derailleur cage take up the longer loop. DECIMATE COLLAPSE triangle counts are not identical across Blender series, so the LOD gate is a ratio band, not an exact count. Bake pixels are stochastic, so the bake gate is has_data plus operator FINISHED, not byte-identity. Construction uses no RNG; two default runs print identical measurements.

Hygiene#

Recomputed from the generated mesh, not asserted about the script.

AxisDeclaredMeasured
Non-manifold edges00
Loose verts / edges0 / 00 / 0
Doubles merged at 1e-500
Zero-area faces00
N-gons00
Coplanar cross-shell face pairs (KD range 0.05 m, plane ε 1e-4)00
Grounded: zminwithin 1e-4 of 00.0000
Supports: each tyre and the stand foot has its own zminwithin 1e-4 of 00, 0; 0

The chain is where this budget is hardest: 112 links, 224 plates and 112 rollers within a hand's width of each other, every plate cap on a plane parallel to every other. The first complete draft measured 7523 coplanar cross-shell pairs. What fixed them, family by family:

The remaining constants (the idle cogs' tooth phase, the roller phase step, the plate tapers, the right-hand plate scale and the tilt step) were chosen by a seeded search in a probe that counted pairs; the shipped script has no RNG.

Wheels, steering, chain, stance and assembly#

AxisDeclaredMeasured
Hubs coaxial with their dropouts: each hub's axle (principal PCA axis of its body) against both dropout eyes' centres≤ 0.5 mm0.000 mm (front and rear, 2 eyes each)
Spoke seats: every spoke's hub end below its flange's rim (read off the hub's own radius at that station), and its rim end on its nipple's axis and inside itflange depth 2.0–4.0 mm; ≤ 0.3 mm off axis; ≥ 2.0 mm inside the nipple3.00 mm; 0.000 mm; 4.50 mm (36 + 36 spokes, 36 + 36 nipples)
Wheels in the frame's centre plane: each rim's centre (PCA) against the plane of the main triangle's four tubes, and its axis against the plane's normal; frame size and wheelbase≤ 1.0 mm; ≤ 0.3°; seat tube 0.580 ± 0.004 m; wheelbase 1.000 ± 0.005 m0.000, 0.000 mm; 0.000°; 0.5800 m; 0.99982 m
Steering trail: the head tube's axis (principal PCA axis) meets the ground ahead of the front tyre's contact, on its line0.045–0.065 m; ≤ 3 mm across0.05536 m (axis 17.70° from vertical, 73° head angle plus the lean); 0.000 mm
Lacing: 36 spokes a wheel, 18 from each flange, rim ends equally pitched, each hub end three crosses round from its rim endpitch within 0.3° of 10°; cross angle 58–62°36, 36; 18/18, 18/18; 0.000°; 60.000°
Chain seated: every roller that engages the big ring or the driven cog (its body straddles the sprocket's plane and cuts its teeth), counted and seated between root and tip≥ 20 on the ring, ≥ 6 on the cog; 0.5–6.5 mm above the root circle read off the sprocket30, 10; 1.20–3.40 mm
Chain line: every roller and the driven cog against the big ring's mid-plane≤ 1.0 mm0.000 mm; 0.000 mm
Stance: mass centre (shell volumes × density per material) inside the triangle of both tyres' contact rings and the stand foot's sole≥ 0.020 m inside every edge0.0393 m (11.80 kg, centre at x 0.076, y 0.039, z 0.498)
One connected assembly (union of shells whose BVH trees overlap)1 component1 (685 shells)

A seated roller sits 1.2 mm above the root circle (its centre is on the pitch circle); the rollers entering and leaving each wrap sit higher, up to 3.4 mm, which is what the band's width allows for. The densities are named constants (frame tubes and rims as hollow sections, tyres round an air chamber, solid steel for chrome and chain parts), and the volumes come from the mesh. The lean puts the mass centre 39 mm onto the stand's side of the tyres' line; upright, it would sit just right of it (the drivetrain is on the right) and the bike would fall away from its stand, which is what --tuck-stand shows.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1 and exited its declared code, with every budget checked before it green and the triangle count unchanged.

FlagBudget violatedExit
--skip-decimateLOD1 ratio band (measured 1.0000)9
--stray-vertloose vertex count is 0 (measured 1, placed inside the envelope)15
--lift-zbounding box zmin is 0 (measured 0.05000)16
--float-tyreboth tyres and the stand foot on the ground (rear tyre 3 mm up: its zmin 0.00300, the rest 0)16
--slip-wheelhubs coaxial with their dropouts (front wheel 2 mm forward in its dropouts: 0.00200 m)17
--short-spokespoke seats (one front spoke 9 mm short at the rim: its end 1.5 mm outside its nipple, −0.00150 m)18
--dish-wheelwheels in the frame's plane (rear rim, tyre and nipples 3 mm to the drive side, spokes re-aimed from their flanges: 0.00299 m)19
--steep-headsteering trail (head tube turned 6° steeper about its middle: trail −0.02926 m)20
--bunch-spokeslacing (one front spoke and nipple turned 4° about the axle: pitch off by 4.000°)21
--lift-chainchain seated (the chain wrapped 5 mm high on ring and cog: seated up to 8.11 mm above the root)22
--shift-rollerschain line (every roller pushed 1.5 mm inboard along its pin: 0.00150 m)23
--tuck-standstance (the stand's foot drawn in to 40 mm off the tyres' line: margin −0.0062 m)24
--pop-bottleone connected assembly (the bottle lifted 80 mm straight off the tube, clear of its cage: 2 components, bottle and cap)25

--float-tyre lifts only the rear tyre, so the rim, spokes and chain stay seated and only the support budget sees it. --slip-wheel moves the whole front wheel (tyre, rim, spokes, nipples, hub, skewer) along its dropouts, so every spoke still seats and the trail stays in band (53.4 mm); only the hub-to-eye distance sees it. Its first draft moved it 3 mm, which set a hub face on a dropout eye's plane and exited 15. --short-spoke pulls one spoke's rim end back along the spoke, which barely turns it about the axle, so the lacing still passes. --dish-wheel moves the rim horizontally in world space rather than along the leaned axle, which would have lifted the rear tyre off the ground and exited 16. --steep-head turns only the head tube, in the frame's plane, so the frame-plane budget before it is unchanged. --shift-rollers replaced a first draft that bent the chain's rear half inboard: a gradient of 2 mm over the chain stay moved each plate 0.12 mm per two links, exactly one stagger level, and 4528 plate faces landed on each other's planes (exit 15). Moving the rollers along their own pins leaves every plate face where it was. The chain audit counts a roller as engaged only when its body straddles the sprocket's plane; with contact alone the shifted rollers' pin tips touched the 19 and the audit chose it as the driven cog (exit 22). --pop-bottle lifts a part held by one joint only, and it caught a real defect: its first draft moved the bottle 30 mm sideways and split off seven shells, not two — the wire cage had been hanging on the bottle, its spines never reaching the bosses. The cage now has a crossbar and bolt at each boss, and the bottle, lifted 80 mm clear of the hoops, comes away alone with its cap. --float-tyre's first draft lifted the tyre 4 mm and set a face on a brake pad's plane (exit 15); it lifts 3 mm.

Run#

blender --background --python road_bicycle.py --
blender --background --python road_bicycle.py -- --skip-decimate
blender --background --python road_bicycle.py -- --stray-vert
blender --background --python road_bicycle.py -- --lift-z
blender --background --python road_bicycle.py -- --float-tyre
blender --background --python road_bicycle.py -- --slip-wheel
blender --background --python road_bicycle.py -- --short-spoke
blender --background --python road_bicycle.py -- --dish-wheel
blender --background --python road_bicycle.py -- --steep-head
blender --background --python road_bicycle.py -- --bunch-spokes
blender --background --python road_bicycle.py -- --lift-chain
blender --background --python road_bicycle.py -- --shift-rollers
blender --background --python road_bicycle.py -- --tuck-stand
blender --background --python road_bicycle.py -- --pop-bottle
blender --background --python road_bicycle.py -- --output bicycle.png

Smoke passes no flags.

The hero turns the piece HERO_YAW_DEG (−50°): a shallow three-quarter from the drive side, front wheel to the right, so the crankset, chain and derailleurs face the lens and the bike leans away onto its stand. The wall stands 2.6 m behind the bicycle, and the warm wedge pools on it. Chrome, alloy and steel carry the reflection-vector studio from espresso-machine so they read as metal on the dark stage.

Exit codes#

File-local. 9 is a valid check code. 10 is reserved for gallery_framing.check_framing on the --output path. 15–19 are the hygiene and joint-fit family. 20–25 are file-local. 26 is the asset-quality floor on the render path: check_asset_quality returns 11, which this piece already spends on the collider ceiling, so the call site remaps it.

CodeMeaning
0Success
1Uncaught exception (FATAL wrapper)
2argparse / usage
3Mesh did not build / no UV layer
4Base triangle count outside range
5Material count ≠ 10 distinct slots, or a face-count floor missed
6UVs outside 0..1
7UV AABB overlap above tolerance
8World AABB off declared outer size
9LOD ratio band (--skip-decimate lands here)
10Framing gate (render path only)
11Collider triangle count above ceiling
12Bake did not finish or image has no data
13Export file missing or empty
14--output produced no file
15Mesh hygiene: loose, non-manifold, zero-area, doubles, n-gons, coplanar cross-shell pairs (--stray-vert)
16Not grounded: bounding box zmin off 0, or a tyre or the stand foot off the ground (--lift-z, --float-tyre)
17A hub's axle off a dropout eye's centre (--slip-wheel)
18Spoke seats: a hub end outside its flange band, or a rim end off its nipple's axis or not inside it (--short-spoke)
19A rim off the frame's centre plane or tilted to it, or the seat tube or wheelbase off size (--dish-wheel)
20Steering trail outside its band, or the axis off the front contact's line (--steep-head)
21Lacing: spoke or flange counts, rim-end pitch, or cross angle (--bunch-spokes)
22Chain seat: too few rollers engaged on ring or cog, or one seated outside its band (--lift-chain)
23Chain line: a roller or the driven cog off the big ring's plane (--shift-rollers)
24Stance: mass centre within 0.020 m of the support triangle's edge (--tuck-stand)
25Assembly splits into more than one connected component (--pop-bottle)
26Asset-quality floor (render path only; remapped from 11)

Source

showcase/road-bicycle/road_bicycle.py View the script on GitHub →
A deep red lugged-steel road bicycle leaning on its kickstand: chromed lugs and fork socks, tan-wall 700c wheels, a honey leather saddle, cream-taped drop bars and a chain over a double crankset.