Farm Tractor

showcase/farm-tractor/

A procedural mid-century utility tractor standing in the ruts of a muddy farmyard with a puddle between its wheels — a cast-iron backbone (engine, bell housing, gearbox, rear axle housing and trumpets); a front axle oscillating on a pivot pin through the front support's lugs and the beam's two bushings, kingpins, spindles and a tie rod; 1.240 m rear tyres with 44 chevron bars rooted in the carcass, handed for forward travel and wrapped round the shoulder, mud packed between them, on dished rims with clamp lugs and cast-iron half-moon weights; ribbed front tyres; a grille shell with radiator and headlamps, bonnet, fuel tank and dash; a vertical exhaust stack with a hinged rain cap and an oil-bath pre-cleaner bowl; a raked steering column, a pan seat on a leaf spring, pedals and footplates; mudguards with a tail lamp and a work lamp; a three-point linkage with lift arms, lift rods, lower links, a stowed top link and drawbar, and a PTO stub under its shield; worn paint chipped to primer at its edges, rust-streaked and mud-splashed — 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: 124384 tris, twelve materials with 8792 body paint, 9344 wheel paint, 16592 rubber, 7498 cast iron, 10876 steel, 2556 zinc, 2900 black enamel, 868 glass, 1160 exhaust, 56 radiator core, 12676 soil and 140 water faces, UVs in 0..1 with zero AABB overlap, outer AABB 3.584×2.087×1.733 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, all 4 tyres pressed 28.9–30.1 mm into the mud (band 18–45 mm), 4 hubs 0.0 mm off their spindles and half-shafts and the pivot pin 0.0 mm off both bushings (≤ 0.3 mm), 14 link eyes 0.0 mm off their pins with the pins ≥ 8.5 mm past both faces, tyre beads seated 0.683–0.962 mm (band 0.4–2.0 mm), 88 chevron bars rooted 3.985–3.999 mm in the carcass (band 2.0–6.0 mm) and 34.3 mm proud (≥ 30 mm), bar pitch exact, every bar's apex 10.886° ahead of its shoulder (≥ 5°), body and wheels mirrored within 0.0001 mm, wheelbase 1.780 m, tracks 1.220 / 1.320 m, rear tyres 1.240 m, the mass centre 0.4120 m inside the support triangle of the rear contacts and the front pivot (≥ 0.330 m), one connected assembly of 505 shells, LOD ratios in band, collider 944 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-tyre 16; --cock-hub 17; --cant-pin 17; --unpin-link 17; --sink-tyre 18; --float-lugs 18; --skew-wheel 19; --wide-track 19; --tall-lugs 19; --odd-fender 19; --bunch-lugs 20; --reverse-lugs 21; --offset-pivot 22; --loose-lamp 23.

category Vehicles

tags mesh export showcase

blender --background --python showcase/farm-tractor/farm_tractor.py --

A showcase piece, not an example, and the ninth in the vehicles category: things that move. It builds a mid-century utility farm tractor (generic, no marks, text or maker's livery) standing in the ruts of a muddy farmyard:

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: wheelbase 1.780 m, rear track 1.320 m (52 in) and front track 1.220 m (48 in), tyre centre to tyre centre; rear tyres 1.240 m over the lugs (11.2-28 class), fronts 0.690 m (4.00-19 class); the rain cap 1.73 m over the slab's underside. The origin is under the patch at the slab's underside.

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. Shells are found by a part face attribute; every measured value is read from their vertices.

AxisDeclaredMeasured (5.2.1)
Base triangles123100–125700124384
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2198
Materialsexactly 12 distinct; ≥8080 body paint, ≥8590 wheel paint, ≥15260 rubber, ≥6890 cast iron, ≥10000 steel, ≥2350 zinc, ≥2660 black enamel, ≥790 glass, ≥1060 exhaust, ≥50 radiator core, ≥11660 soil, ≥128 water faces12 slots; 8792 / 9344 / 16592 / 7498 / 10876 / 2556 / 2900 / 868 / 1160 / 56 / 12676 / 140
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(3.5839, 2.0869, 1.7330) m ± 0.01, read off the vertices(3.5839, 2.0869, 1.7330), zmin 0
Collider tris≤ 1040944
Exportwritten, size > 0, removed after measuring9499928 bytes

Every falsifier leaves the triangle count at 124384 and the envelope at (3.5839, 2.0869, 1.7330): they move 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, and 4.5.11 and 5.1.2 print the same measurements as 5.2.1 (LOD2 decimates to 27364 triangles there against 27340, ratio 0.2200 against 0.2198).

Hygiene and grounding#

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
Tyres: each tyre's deepest vertex (carcass and bars) under the mud, read by a ray down onto the soil shell4 tyres; 18–45 mm4; 28.9–30.1 mm

The first draft measured 2471 coplanar pairs, none of them in a part: eleven identical grille bars side by side shared their faces' planes (each bar now steps back and down from the centre out, so neighbours differ and mirrored bars still match); three equal louvres shared their long faces (each now leans out at the top, so a level offset changes its plane, and is a step longer than the last); clamp-lug bolt heads on the lugs' faces; a weight bolt's head on the plane of the weight's cast grip; wheel nuts on the hub's end cap; the head's front on the bell housing's flange; exhaust port flanges of one size in a row; two spring bolts' undersides; a stalk's end on its collar; the steering shaft's end on its hub's. Stepping the bars to stop the pairs first broke the bonnet's mirror by 4.7 mm; the step now counts from the centre out.

Joints, seats, size, tread, stance and assembly#

AxisDeclaredMeasured
Joint fit: each front hub against its spindle and each rear hub against its half-shaft (axis of revolution and centre against the host's principal axis); the pivot pin against both bushings4 hubs, 2 bushings; ≤ 0.3 mm off, ≤ 0.3°4, 2; 0.0 mm, 0.0°
Joint fit: every link eye on a pin (lower links, lift arms, lift rods, top link, tie rod): centre on the pin's axis, axis along it, the pin past both faces14 eyes; ≤ 0.5 mm, ≤ 1.0°, ≥ 2 mm past14; 0.0 mm, 0.0°, ≥ 8.5 mm
Tyre seat: per tyre, per angular segment, the bead vertices against the rim's bead seat (a ray toward the axis along each vertex's own radial)4 tyres, each on a rim; 0.4–2.0 mm0.683–0.962 mm
Lugs: each bar's deepest root vertex inside the carcass, its crown proud of it (inside or out by a ray onto the carcass along the vertex's radial; how far by the nearest carcass face, since down the shoulder the carcass normal runs nearly along the axle)88 bars; 2.0–6.0 mm; ≥ 30 mm proud88; 3.985–3.999 mm; 34.289 mm
Mirror: every body-paint vertex against its partner across the centre plane between the half-shafts (KD-tree)≤ 0.5 mm0.0001 mm
Wheels: front and rear carcasses paired, centres and extents compared≤ 0.5 mm0.0001 mm
Size: wheelbase and both tracks from the carcasses' centres1.780 / 1.220 / 1.320 m ± 4 mm1.7800 / 1.2200 / 1.3200
Size: each rear tyre's diameter, twice its farthest vertex from the rim's axis1.240 m ± 6 mm1.2400, 1.2400
Tread pitch: per rear tyre and half, the bars' angles round the axleevery gap within 0.25° of 360/220.0000°
Handing: every rear bar's apex ahead of its shoulder end in forward rolling (about +Y, the same for both wheels)≥ 5°10.886°
Stance: mass centre (per-shell volume × a per-material density) inside the support triangle: the two rear contact patches and the front-axle pivot≥ 0.330 m (a quarter of the rear track)0.4120 m (1539 kg)
One connected assembly (union of shells whose BVH trees overlap, the patch included)1 component1 (505 shells)

The support is a triangle, not the four tyres' rectangle: the front axle oscillates on its pin, so sideways the front wheels carry nothing until the axle reaches its stop. That is the tractor's real stability story — a mass centre that moves toward the narrow front of the triangle, or a pivot that moves off the centre line, tips it.

A mirror image of a rear tyre across the tractor's centre plane does not reverse its chevrons (the bars are symmetric about the tyre's own mid-plane); what reverses them is building the tread about the wheel's own outboard axis, which on the right-hand wheel turns the tyre round. Both tyres are built about the world's +Y, the axis forward travel turns them about, and the handing budget reads each bar's apex and shoulder angles about that same axis. Densities are effective: castings, tanks and tyres are modelled solid but are hollow.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1, 4.5.11 and 5.1.2 and exited its declared code, with the triangle count and envelope unchanged and every budget checked before the target 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-tyreevery tyre pressed into the mud (the left front lifted 40 mm: −9.889 mm)16
--cock-hubhubs coaxial (the left rear hub 1.5 mm off its half-shaft: 1.5 mm)17
--cant-pinpivot pin coaxial with its bushings (the pin turned 1.5° in plan: 1.894 mm, 1.5°)17
--unpin-linklink eyes on their pins (the top link 8 mm short: its rear eye 8.0 mm off the stowage pin)17
--sink-tyretyre bead seat (the right rear bead 3 mm into its seat: 2.762 mm)18
--float-lugsbars rooted in the carcass (the left rear bars lifted 7 mm off the carcass along its normal: −3.056 mm)18
--skew-wheelrear wheels mirrored (the left rear wheel 6 mm aft of its hub: 6.000 mm)19
--wide-trackrear track at its stated size (each rear wheel 4 mm out: 1.3280 m)19
--tall-lugsrear tyre diameter at its stated size (bars 8 mm taller: 1.256 m)19
--odd-fenderbody mirror symmetry (the left mudguard bowed 3 mm out: 3.000 mm)19
--bunch-lugseven bar pitch (every fourth bar of one right rear half turned 2°: 2.000°)20
--reverse-lugschevron handing (the right rear tread built about its outboard axis: −10.886°)21
--offset-pivotstance (the pivot pin and bushings 0.30 m to the right: 0.3100 m)22
--loose-lampone connected assembly (the tail lamp 4 mm off its mudguard: 2 components, 4 and 501 shells)23

--float-tyre lifts the carcass alone while the rest of the tractor and the slab still ground the box. --float-lugs also makes the tyre 14 mm taller, but the bars' roots are read (18) before the diameter (19); --tall-lugs keeps the roots and changes only the crowns. --skew-wheel and --wide-track move the wheel (tyre, bars, rim, disc, weights) and leave the hub on its half-shaft, so the joint budget stays green. --cant-pin first turned the bushings with the pin, which stayed coaxial and exited 0; it now turns the pin alone. --loose-lamp first exited 0 because the lamp's bezel rested on the skirt; the lamp now stands clear on its bracket, which is its only contact.

Run#

blender --background --python farm_tractor.py --
blender --background --python farm_tractor.py -- --skip-decimate
blender --background --python farm_tractor.py -- --stray-vert
blender --background --python farm_tractor.py -- --lift-z
blender --background --python farm_tractor.py -- --float-tyre
blender --background --python farm_tractor.py -- --cock-hub
blender --background --python farm_tractor.py -- --cant-pin
blender --background --python farm_tractor.py -- --unpin-link
blender --background --python farm_tractor.py -- --sink-tyre
blender --background --python farm_tractor.py -- --float-lugs
blender --background --python farm_tractor.py -- --skew-wheel
blender --background --python farm_tractor.py -- --wide-track
blender --background --python farm_tractor.py -- --tall-lugs
blender --background --python farm_tractor.py -- --odd-fender
blender --background --python farm_tractor.py -- --bunch-lugs
blender --background --python farm_tractor.py -- --reverse-lugs
blender --background --python farm_tractor.py -- --offset-pivot
blender --background --python farm_tractor.py -- --loose-lamp
blender --background --python farm_tractor.py -- --output tractor.png

Smoke passes no flags.

The hero looks from the front right and above, so the grille, headlamp, bonnet, exhaust stack and pre-cleaner lead, the engine's right side (manifold, dynamo, starter, filter) shows under the bonnet, the right rear wheel with its weights stands behind, and the puddle lies in the rut between the wheels. The wall stands 6 m behind the patch and the warm wedge pools on it. Default stage; no deviation.

Shading#

Tyres, lathed parts, sheet metal and the seat are smooth-shaded; chamfers, bars, lugs and every material boundary stay crisp through sharp edges above 35°. Every part carries a PartTone face attribute, so the four tyres and the two weight halves differ, and the lamp glass picks clear or red from it. An EdgeWear point attribute is 1 on square edges (a sheet's rolled rim, a plate's edge) and 0 on smooth surfaces and 45° chamfers; the paint chips through to red-oxide primer and bare steel in patches along those edges, and every part that carries wear has a vertex ring a few millimetres in from its square edges, so the wear stays on the edge rather than being interpolated across a face (the first draft's grille shell carried a rust band a quarter of its length wide). The paint also fades where it faces the sky, darkens with grime toward the ground, takes sparse scuffs and rust streaks, and is splashed with mud rising from the rut. Cast iron is near-black and rough, not chrome; zinc is kept to the caps, bezels, lamp housings and the bonnet strip. The mud is wet and glossy only on the up-facing rut floors. A TreadMud face attribute marks the rear carcasses' crowns; the rubber packs them with clumped, lumpy mud there, so the clean black bars stand out of 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 ≠ 12 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, a tyre out of its sink band, or not 4 tyres (--lift-z, --float-tyre)
17Joint fit: a hub off its spindle or half-shaft, the pivot pin off its bushings, a link eye off its pin, or a part missing (--cock-hub, --cant-pin, --unpin-link)
18Seat: a tyre bead out of its seat band, a bar's root out of its band or its crown not proud, or a part missing (--sink-tyre, --float-lugs)
19Mirror and size: body or wheels not mirrored, wheelbase, a track or a rear tyre's diameter off (--skew-wheel, --wide-track, --tall-lugs, --odd-fender)
20Tread pitch: a bar out of step round its tyre (--bunch-lugs)
21Chevron handing: a bar's apex not ahead of its shoulder in forward rolling (--reverse-lugs)
22Stance: the mass centre too near an edge of the support triangle (--offset-pivot)
23Assembly splits into more than one connected component (--loose-lamp)
24Asset-quality floor (render path only; remapped from 11)

Source

showcase/farm-tractor/farm_tractor.py View the script on GitHub →
Green farm tractor in muddy ruts beside a puddle: long bonnet, barred grille, rusty exhaust stack, big rear tyres with mud-packed chevron lugs on cream rims with weights, small ribbed fronts.