Floor Fan

showcase/floor-fan/

A procedural 1950s oscillating pedestal fan — a hollow two-tier cast base on a rubber gasket with a rotary speed switch and badge, a telescoping enamel and chrome column with a knurled height-lock collar, a strap yoke with a knurled tilt knob, a slotted motor housing with a trim band and an oscillation knob, a two-half wire guard of radial spokes and concentric rings welded to clipped rim rings with a centre badge, four swept brass blades on a hub with a hex spinner nut, and a cord to a plug — 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: 41460 tris, six materials with 4732 enamel, 13960 chrome, 584 brass, 1216 rubber, 810 bakelite and 440 badge faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.761×0.704×1.229 m, zmin 0 with the gasket on the floor, hygiene 0 including zero coplanar cross-shell pairs, hub, spinner, shaft, badge, rear mount and motor housing on the axis the rim rings define (worst 0.000001 m, cap 0.0005), all 48 spokes ending inside their rim rings (worst 0.0007 m from the ring's centreline, cap 0.0026) and each of 7 rings crossing all 24 spokes of its half, both column tubes plumb (0.000°, cap 0.2°) and on the base's axis (0.0000 m, cap 0.001), guard 0.452 m and base 0.400 m across, blade tips 0.0195 m inside the rim rings (band 0.012–0.030) and 0.0140 m from the nearest wire (floor 0.006), four blades 90° apart within 0.0002° (cap 0.3°), a 28.4 kg fan that stands on a 19.06° incline before it tips (floor 16°), one connected assembly of 109 shells, LOD ratios in band, collider 1560 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --offset-hub 17; --short-spoke 18; --lean-column 19; --long-blades 20; --skew-blade 21; --hollow-base 22; --loose-spinner 23.

category Household

tags mesh export showcase

blender --background --python showcase/floor-fan/floor_fan.py --

A showcase piece, not an example, and the third in the household category. It builds a procedural 1950s oscillating pedestal fan:

The head is placed from a named frame (hw()): it turns 28° on the column (it is oscillating) and tilts 7° up about the pivot, 155 mm behind the guard's rim plane. The yoke turns with the head but does not tilt. Every part of the head — guard, rotor, housing, bosses — is built in head-local coordinates, so the tilt and the turn move it as one.

The guard's two domes are closed-form: the front is y = y_rim + 0.066 (1 − (ρ/R)^2.6), flat across the middle and rolling down onto the rim; the rear is deeper (0.095, exponent 3) to clear the blades' pitch. A spoke follows its dome from inside the badge bezel (or the rear mount ring) out to its rim ring and ends on the ring's centreline. A ring lies on the dome at its radius, so it crosses every spoke of its half.

Two things the coplanar budget forced:

The two rim rings are not copies either: the rear ring is 1 mm smaller in major radius, 0.3 mm thinner and has its tube turned half a facet.

The cord is a Catmull-Rom spline clamped to rest on the floor. The plug's chamfer pass set its sole 1.2 mm below the floor, which grounded the whole piece on the plug and lifted the gasket; the plug is set back down after the chamfer, so the gasket and plug both reach Z = 0.

Shading follows what each part is. Turned and swept stock is smooth-shaded; the thin six-sided wire smooths across its facets (62°), everything else stays crisp above 35° and at every material boundary. The enamel is a muted sage under a clear coat, the brass and chrome rough enough to catch the key rather than mirror a black stage.

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: a 0.40 m base, a guard 0.452 m across its rim, and 1.23 m overall. The outer AABB is 0.761 × 0.704 × 1.229 m. The guard's rim sets the top, the guard and the cord's loop set the plan. The origin is under the base centre, so the fan drops onto a floor by its gasket.

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 triangles40600–4190041460
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2200
Materialsexactly 6 distinct; ≥4350 enamel, ≥12800 chrome, ≥540 brass, ≥1120 rubber, ≥740 bakelite, ≥400 badge faces6 slots; 4732 / 13960 / 584 / 1216 / 810 / 440
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(0.761, 0.704, 1.230) m ± 0.01(0.7614, 0.7039, 1.2286), zmin 0
Collider tris≤ 22001560
Exportwritten, size > 0, removed after measuring3119064 / 3119064 / 3119060 bytes (4.5.11 / 5.1.2 / 5.2.1)

No falsifier changes the topology, so every one of them measures the default's 41460 triangles and the default's AABB.

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: zmin, and the gasket's own zminwithin 1e-4 of 00.0000 / 0.0000

Guard, rotor, column, stance and assembly#

The guard axis is read off the mesh: the centre and normal (smallest PCA axis) of the front rim ring, the only chrome shells 0.4 m across being the two rims. Every other head part is classified by its lateral radius about that axis.

AxisDeclaredMeasured
Coaxial: the rear rim's normal against the front's, and the centre of the rear rim, hub, spinner, shaft, badge bezel, rear mount and motor housing off the guard axis≤ 0.2°; ≤ 0.0005 m; 7 parts found0.0078°; 0.000001 m; 7
Guard wires seated: each spoke's nearest vertex to its own rim ring's centreline circle; each concentric ring crossing (BVH) every spoke of its half; each spoke's inner end in the badge bezel or rear mount≤ 0.0026 m; 24 + 24 spokes, 7 rings, 6 clips; 0 loose0.000743 m; 24 per ring on all 7; 0
Column plumb: both tubes' PCA axes against Z, and each axis through the base's centre at the boss top≤ 0.2°; ≤ 0.001 m0.0000°; 0.000000 m
Size: guard rim and base diameters0.452 / 0.400 m ± 0.0040.4522 / 0.4000
Blade clearance: rim rings' inner face minus the farthest blade vertex, about the guard axis; nearest blade vertex to any guard wire0.012–0.030 m; ≥ 0.006 m; 4 blades, each seated in the hub0.01945 m; 0.01403 m; 4, 0 unseated
Blade spacing: angles of the blades about the hub's own axisevery gap 90° ± 0.3°worst 0.0002°
Stance: the steepest incline the fan stands on before its mass centre (shell volumes × densities) passes the gasket's edge≥ 16°19.06° (28.43 kg; base 12.66 kg; centre 0.510 m up, 0.176 m inside the edge)
One connected assembly (union of shells whose BVH trees overlap)1 component1 (109 shells)

A fan on a pole is a real tip risk: its head is a third of its mass and sits a metre up. The stance budget measures exactly that. The densities are named constants — cast iron and steel 7850, brass 8500, rubber 1200, bakelite 1400, the badges 2500 — with two per-shell overrides where the mesh is solid but the part is not: the motor housing (700, a pressed shell round windings and air) and the two column tubes (1100, drawn tube rather than bar).

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 triangle count and outer AABB as the default, and every budget checked before its own 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
--offset-hubrotor coaxial with the guard (hub, spinner and blades moved 3 mm off the axis: 0.003000 m)17
--short-spokeguard wires seated (one front spoke stopped 12 mm short of its rim ring: 0.014906 m)18
--lean-columncolumn plumb and coaxial (lower tube leaning 1° on its foot: 1.0000°, 0.001501 m off the base's axis)19
--long-bladesblade-tip clearance band (tips 12 mm longer: 0.00745 m)20
--skew-bladeequal blade spacing (one blade turned 5°: 4.9998°)21
--hollow-basestance (base pressed from 1.2 mm sheet: 18.64 kg, base 2.87 kg, centre 0.752 m up: 12.39°)22
--loose-spinnerone connected assembly (spinner nut backed 6 mm off the hub: 2 components)23

--offset-hub leaves the tip clearance in band (0.01648 m) and the blades evenly spaced about their own hub, so only the coaxial budget sees it. --long-blades still leaves every tip 7.4 mm clear of the nearest wire, so the band's floor is what fails. --lean-column tilts only the lower tube; the upper tube, the collar and the head stay put, and the tube stays inside the base's boss. --hollow-base keeps the outer casting, so the envelope and footprint are unchanged and only the mass moves.

Run#

blender --background --python floor_fan.py --
blender --background --python floor_fan.py -- --skip-decimate
blender --background --python floor_fan.py -- --stray-vert
blender --background --python floor_fan.py -- --lift-z
blender --background --python floor_fan.py -- --offset-hub
blender --background --python floor_fan.py -- --short-spoke
blender --background --python floor_fan.py -- --lean-column
blender --background --python floor_fan.py -- --long-blades
blender --background --python floor_fan.py -- --skew-blade
blender --background --python floor_fan.py -- --hollow-base
blender --background --python floor_fan.py -- --loose-spinner
blender --background --python floor_fan.py -- --output fan.png

Smoke passes no flags.

The hero turns the piece HERO_YAW_DEG (164°). The base's switch and badge then face the camera, while the head, turned 28° on the column, shows the guard three-quarter with the motor housing, yoke and tilt knob in profile. The cord's loop lies in the foreground. The wall stands 3 m behind the fan and the warm wedge pools on it behind the head.

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 ≠ 6 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, or the gasket's, off 0
17Coaxial: a turned head part off the guard axis, or the rims not parallel (--offset-hub)
18Guard wires: a spoke's end off its rim ring, a ring not crossing every spoke of its half, a spoke loose at its inner end, or not 24 + 24 spokes, 7 rings and 6 clips (--short-spoke)
19Column plumb and size: a tube tilted or off the base's axis, or the guard or base diameter off (--lean-column)
20Blade clearance: tip clearance outside its band, a blade too near a wire, a blade not seated in the hub, or not 4 blades (--long-blades)
21Blade spacing: a gap off 90° (--skew-blade)
22Stance: the fan tips on an incline under 16° (--hollow-base)
23Assembly splits into more than one connected component (--loose-spinner)
24Asset-quality floor (render path only; remapped from 11)

Source

showcase/floor-fan/floor_fan.py View the script on GitHub →
A sage-green 1950s pedestal fan, head turned on a tilt yoke: chrome wire guard over four brass blades, telescoping column, round cast base with a speed knob, cord to a plug.