Motor Scooter

showcase/motor-scooter/

A procedural 1960s Italian step-through motor scooter — a pressed-steel tail lofted from superellipse sections with two bulbous side cowls (pressed louvres on the engine side, chrome belt trims), a floorboard with rubber runner strips and chrome edge trims pressed up into the tail and into a leg shield convex in plan, arched up into the headset and rimmed in a rolled chrome trim, with a horn cast and grille, a single-sided front end (a column raked 26 degrees, crown, fork leg, trailing link and coil spring) under a crested mudguard, a headset carrying the headlamp, speedometer, ribbed grips, levers and two mirrors, a two-tone dual saddle with piping and a grab strap, 10-inch split rims with five nuts and finned drums in block-tread tyres, an alloy engine case with a finned cylinder, header, silencer and kick-start, a luggage rack, tail lamp and plate, and a centre stand with rubber feet — 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: 45060 tris, nine materials with 7156 paint, 4638 chrome, 3608 rubber, 1147 oxblood vinyl, 297 cream vinyl, 550 glass, 188 tail-lens, 4020 alloy and 2292 black-enamel faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.790×0.730×1.244 m, zmin 0 with both tyres and both stand feet on the floor, hygiene 0 including zero coplanar cross-shell pairs, both axles level and parallel (camber 0.000°, toe 0.000°, cap 0.3°), the steering column raked 26.000° meeting the ground 0.0750 m ahead of the front contact (band 0.055–0.090) and on its line, the body mirror-symmetric to 0.000 mm (cap 0.5, engine side excluded by construction), tail 0.862 m and saddle top 0.807 m, a 1.20000 m wheelbase (±0.004), a 101.6 kg scooter whose mass centre stands 0.1284 m inside its tyres-and-stand support polygon (floor 0.080), one connected assembly of 105 shells, the leg shield's foot 0.0320 m deep in the floorboard (band 0.020–0.040), LOD ratios in band, collider 1132 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-tyre 16; --toe-wheel 17; --steep-head 18; --odd-body 19; --short-wheelbase 20; --narrow-stand 21; --pop-speedo 22; --lift-shield 23.

category Vehicles

tags mesh export showcase

blender --background --python showcase/motor-scooter/motor_scooter.py --

A showcase piece, not an example, and the third in the vehicles category. It builds a procedural 1960s Italian step-through motor scooter (no brand names or badges), parked upright on its centre stand:

The layout is solved from named constants. The steering axis is a line through the ground a design trail (75 mm) ahead of the front axle, raked 26 degrees: the column, crown, headset, collar and horn cast are all placed on it. The tyre's rings are placed so a ring points straight down, so the centre rib's lowest vertices are exactly one tyre radius below the axle and both tyres ground at the same height as the stand's feet. The tail's section parameter is symmetric about its crown, so the body is its own mirror image vertex for vertex.

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.79 m from the mudguard's nose to the number plate, 0.73 m across the bar-end caps, 1.24 m to the mirror tops, with the saddle's top at 0.807 m and a 1.20 m wheelbase. The body's tail is 0.862 m long. The origin is under the scooter's centre, 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 triangles44400–4570045060
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2200
Materialsexactly 9 distinct; ≥6440 paint, ≥4350 chrome, ≥3250 rubber, ≥1030 oxblood vinyl, ≥265 cream vinyl, ≥495 glass, ≥170 tail lens, ≥3620 alloy, ≥2060 black enamel faces9 slots; 7156 / 4638 / 3608 / 1147 / 297 / 550 / 188 / 4020 / 2292
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(1.790, 0.730, 1.244) m ± 0.01(1.7901, 0.7300, 1.2435), zmin 0
Collider tris≤ 18501132
Exportwritten, size > 0, removed after measuring3347780 / 3347780 / 3347776 bytes (4.5.11 / 5.1.2 / 5.2.1)

The collider is the convex hull of the whole scooter; the mudguard, the mirrors and the tail carry its outline.

Every falsifier leaves the triangle count at 45060 and the outer AABB unchanged: they move, turn or bend parts, never add or remove them.

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 of the 2 tyres and 2 stand feet has its own zminwithin 1e-4 of 00, 0; 0, 0

Parts laid out in a row share planes by construction. The first draft measured 525 coplanar cross-shell pairs: the seven runner strips' tops and end chamfers, the five rim nuts against each other and against the hub cap, the rack's cross bars' end caps, and the louvres' outer faces. The strips and nuts are now staggered 0.3 mm each (the strips grow in length as they rise, so their 45° end chamfers cannot re-align), the hub cap's base sits below every nut, the cross bars' ends are staggered 0.4 mm, and the louvres are graduated in length and laid along the cowl's own latitude, so each slat's face is tangent to a different part of the cowl.

Wheels, steering, symmetry, stance and assembly#

AxisDeclaredMeasured
Wheel alignment: each tyre's axle (its least-variance PCA axis) horizontal, and the two axles parallel in plancamber ≤ 0.3° each; toe ≤ 0.3°0.000°, 0.000°; 0.000°
Steering: the column's axis (principal PCA axis) meets the ground ahead of the front tyre's contact patch (its lowest ring of vertices), on its linetrail 0.055–0.090 m; ≤ 2 mm across0.0750 m (rake 26.000°); 0.000 mm
Body mirror symmetry: every vertex of the body shells (tail, both cowls, floorboard, both floor fillets, leg shield, horn cast, mudguard, headset) against its nearest vertex at (x, −y, z)≤ 0.5 mm0.000 mm
Size: the tail's length, the saddle's top0.862 m, 0.807 m, each ± 0.0040.8624, 0.8068
Wheelbase: the two tyres' centres (vertex means) apart in plan1.200 ± 0.004 m1.20000 m
Stance: mass centre (shell volumes × density per material) inside the convex polygon of both tyres' contact rings and both stand feet's soles≥ 0.080 m inside every edge0.1284 (101.6 kg, centre at x −0.278, y −0.036)
One connected assembly (union of shells whose BVH trees overlap)1 component1 (105 shells)
Shield seam: the leg shield's foot (its lowest ring) below the floorboard's top, both read off the mesh0.020–0.040 m deep0.0320 m

The mirror audit excludes the engine side by construction: it reads only the body shells, all built symmetric, and not the louvres (the only paint shells under 0.15 m), the engine case, cylinder, exhaust, kick-start, brake pedal or the single-sided fork and link, which a scooter carries on one side only. The louvres, pressed into the right cowl alone, are separate shells for that reason.

The seam budget is the leg shield's joint with the floor. A shield that stops on or above the floor's top stands apart from it as a plank with daylight under its foot; one sunk too deep punches out of the floor's underside. The fillet sheets make the joint read as one pressing, but they would bridge a lifted shield just as well, so the budget reads the shield itself.

The steering axis and its trail are what keep a scooter going straight: the axis must meet the ground ahead of the tyre's contact, on the wheel's line, by a few centimetres. Too little trail and it wanders; too much and it will not turn. The wheel-alignment budget is its partner: the axles must be level and parallel, or the wheels fight each other. The densities are named constants (the pressed-steel body shells as hollow panels with their contents 300 kg/m³, chrome parts 2500, tyres and rubber 700, vinyl and foam 250, glass 2500, lens 1200, alloy castings and rims 2200, black-enamel steel parts 2600), and the volumes come from the mesh. The engine on the right puts the mass centre 36 mm right of the centreline; the stand's feet carry it.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1 and exited its declared code. None moves the envelope: every run measured the same outer AABB and triangle count as the default, and every budget checked before the target stayed green.

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 both stand feet on the ground (rear wheel 4 mm up: its zmin 0.00400, the rest 0)16
--toe-wheelwheel alignment (front wheel steered 2.5° about its own vertical: toe 2.5000°)17
--steep-headsteering trail (column turned 6° steeper about its crown: rake 20.000°, trail 0.01683 m)18
--odd-bodybody mirror symmetry (a 3.5 mm sideways bow in the tail, zero at both ends: deviation 0.00695 m)19
--short-wheelbasewheelbase band (rear wheel 15 mm forward: 1.18500 m)20
--narrow-standstance (stand feet drawn in to ±0.060 m: margin 0.0424 m)21
--pop-speedoone connected assembly (speedometer 30 mm out of the headset: 2 components)22
--lift-shieldshield seam (the shield's foot stood 4 mm above the floor's top: −0.00400 m)23

--float-tyre lifts the rear wheel while the front tyre and the stand ground the box. --toe-wheel turns the front wheel about the vertical through its axle, so its contact ring stays where it was and the trail does not move; the rim, drum and nuts turn with the tyre and stay in the link. --steep-head turns only the column, about its crown, so the headset and horn cast stay put. --odd-body bows the tail by sin²(π s) along its length, so both ends stay seated in the floorboard and under the tail lamp; its first draft, a plain sin bow with the luggage rack's rails riding past the tail's shoulder, laid one rail face in the plane of a bowed tail face and exited 15. The rails now follow the crown inside the shoulder, and the falsifier reaches 19. --narrow-stand keeps both feet on the ground; the first draft drew them in to ±0.035 m, where the two soles' faces came within the coplanar range of each other and exited 15, so it stops at ±0.060 m. --short-wheelbase moves the rear wheel inside the envelope; the plate and the mudguard still set the length. --pop-speedo lifts a part held by one joint only: the speedometer is seated in the headset and nothing else. Its first draft moved it 15 mm, which left its base still inside the headset's crown; it moves 30 mm. --lift-shield raises only the shield's foot, its top held, so the fillets follow it and the assembly stays one piece; only the seam budget sees the gap.

Run#

blender --background --python motor_scooter.py --
blender --background --python motor_scooter.py -- --skip-decimate
blender --background --python motor_scooter.py -- --stray-vert
blender --background --python motor_scooter.py -- --lift-z
blender --background --python motor_scooter.py -- --float-tyre
blender --background --python motor_scooter.py -- --toe-wheel
blender --background --python motor_scooter.py -- --steep-head
blender --background --python motor_scooter.py -- --odd-body
blender --background --python motor_scooter.py -- --short-wheelbase
blender --background --python motor_scooter.py -- --narrow-stand
blender --background --python motor_scooter.py -- --pop-speedo
blender --background --python motor_scooter.py -- --lift-shield
blender --background --python motor_scooter.py -- --output scooter.png

Smoke passes no flags.

The hero turns the piece HERO_YAW_DEG (−58°), so the nose, the front wheel's open face and the engine side come toward the lens: the louvres, the silencer, the split rim's nuts and the fork. The wall stands 2.6 m behind the scooter, and the warm wedge pools on it.

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–23 are file-local. 24 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 ≠ 9 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
16Not grounded: bounding box zmin off 0, or a tyre or stand foot off the ground, or not 2 tyres and 2 feet (--lift-z, --float-tyre)
17Wheel alignment: a tyre's axle tilted (camber) or the axles not parallel in plan (toe) (--toe-wheel)
18Steering: not 1 column, trail outside its band, or the axis off the front contact's line (--steep-head)
19Body mirror symmetry, or the tail's length or saddle height off (--odd-body)
20Wheelbase outside its band (--short-wheelbase)
21Stance: mass centre within 0.080 m of the support polygon's edge (--narrow-stand)
22Assembly splits into more than one connected component (--pop-speedo)
23Leg shield's foot outside its seat band in the floorboard (--lift-shield)
24Asset-quality floor (render path only; remapped from 11)

Source

showcase/motor-scooter/motor_scooter.py View the script on GitHub →
A pastel sea-green 1960s scooter on its centre stand: cream and oxblood saddle, louvred side cowl, curved chrome-rimmed leg shield, split-rim front wheel, black silencer.