Office Chair

showcase/office-chair/

A procedural ergonomic task chair on a chair mat at a desk corner — a polished aluminium five-star base with ribbed spokes and five swivelled hooded twin-wheel casters pressed into a smoked polycarbonate mat, a chrome gas lift in a telescoping cover under a synchro-tilt mechanism with tension knob and paddles, a moulded shell cupping a two-tone sculpted cushion with thigh channels, a waterfall front and two piped welts, an elastomeric mesh back on a graphite frame with an S-curved lumbar pad on sliders, a mesh headrest, 4D armrests, and a snake plant in a stone planter — 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: 44440 tris, fourteen materials each above its face floor, UVs in 0..1 with zero AABB overlap, outer AABB 1.635×1.480×1.317 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, the mat flat on the floor, all 10 wheels pressed 0.6 mm into the mat, the pot on the floor, spokes and bosses 72° apart (worst 0.00001°), bosses and swivel stems on one 0.305 m circle, stems plumb, coaxial and seated 34 mm, the gas-lift column coaxial with hub and socket (0.0 mm) and seated 52 and 28 mm, seven armrest part pairs mirrored and level within 0.5 mm, seat 0.497 m high, armrests 0.197 m over it, a 0.660 m star, the mass centre 0.215 m inside the caster contact hull (floor 0.12), one connected chair of 89 shells, both lumbar sliders 3.5–5.2 mm off the frame tube, nine leaves rooted 24.5–31.6 mm in the soil, LOD ratios in band, collider 374 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-caster 16; --curl-mat 16; --skew-spoke 17; --offset-column 18; --uneven-arms 19; --loose-wheel 20; --float-lumbar 21; --float-leaves 22.

category Household

tags mesh export showcase

blender --background --python showcase/office-chair/office_chair.py --

A showcase piece, not an example, and the second in the household category. It builds a procedural ergonomic task chair standing on a chair mat at the corner of a desk, with a potted plant beside it:

Everything is placed from named stations. The casters hang on caster_frame(k): a stem on the 0.305 m swivel circle at the spoke's own bearing, the axle 30 mm behind it along the caster's yaw. The chair is built on the floor and lifted by CHAIR_Z = MAT_T - MAT_SINK, so every wheel sits 0.6 mm into the sheet. The back is one surface function, back_point(u, v, off), that the frame, mesh, lumbar pad, straps, sliders, cross bar, hub plate, spine, headrest stem, headrest frame and headrest mesh all read, so a change of recline or wrap moves every part of the back together. The seat is one plan (seat_plan) and one sculpting function (seat_contour, every term even in x) that the cushion rings and both welts read.

Four things the coplanar budget shaped before it could fire:

Shading follows what each part is. Moulded, turned and upholstered surfaces are smooth-shaded; the mechanism's chamfers, the knob's knurl, the seams and every material boundary stay crisp through sharp edges. The upholstery is a heathered yarn over an undistorted plain weave (distorted bands read as wood grain). The mesh lets the light through its open cells, so the spine and headrest stem show behind it. Aluminium, chrome, the mechanism, the graphite plastics and the mat carry the studio reflection term (after espresso-machine): a metal on the dark stage mirrors the stage and reads as grey plastic without it.

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: seat 0.50 m high, a 0.66 m star, armrests 0.20 m over the seat, headrest top 1.32 m; a 1.20 × 1.28 m mat plus its 0.20 m lip; a planter 0.29 m tall with leaves to 0.96 m. The outer AABB is 1.635 × 1.480 × 1.317 m. The mat sets −X and ±Y, the plant sets +X, the headrest sets the top. The origin is under the hub, so the chair and its mat drop onto a floor together.

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. Parts are told apart by a part face attribute written at build time; every position, depth, angle and mass is read off the mesh.

AxisDeclaredMeasured (5.2.1)
Base triangles43700–4520044440
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2200
Materialsexactly 14 distinct; ≥1330 fabric, ≥1450 mesh, ≥3260 shell, ≥4100 nylon, ≥3950 aluminium, ≥1370 chrome, ≥1820 tread, ≥1600 leatherette, ≥510 steel, ≥1060 border, ≥790 mat, ≥750 ceramic, ≥220 soil, ≥715 leaf faces14 slots; 1402 / 1534 / 3440 / 4322 / 4167 / 1450 / 1920 / 1688 / 538 / 1118 / 836 / 796 / 236 / 756
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(1.635, 1.480, 1.317) m ± 0.01(1.6350, 1.4800, 1.3169), zmin 0
Collider tris≤ 580374
Exportwritten, size > 0, removed after measuring3283660 / 3283660 / 3283652 bytes (4.5.11 / 5.1.2 / 5.2.1)

No falsifier changes the triangle count, so the band is narrow and centred on the measurement. 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; the plant's per-blade variation is closed-form from the blade index. 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, star, gas lift, stance, assembly, lumbar and plant#

AxisDeclaredMeasured
Mat flat on the floor: highest vertex of the mat's downward faces≤ 1e-40.0000 (120 vertices)
Named supports: every wheel pressed into the mat, measured against the mat's own surface by a ray straight down from the wheel's lowest vertex10 wheels, 0.3–1.0 mm each10; 0.6–0.6 mm
Pot on the floorzmin ≤ 1e-40.0000
Five-star geometry: spoke bearings and boss bearings (shell centroids) round the hub72° apart ± 0.25°0.00001° worst gap error
Bosses and swivel stems on one circleradius spread ≤ 1 mm each0.305 / 0.305 m, spread 0
Stems plumb (bottom- and top-slab centroids), coaxial with their bosses, seated in themtilt ≤ 0.2°; axis ≤ 0.3 mm off the boss's; seat 25–40 mm0.000°; 0.0000 mm; 34 mm each
Gas lift: the column's axis through the hub's and the socket's axes≤ 0.3 mm at each; tilt ≤ 0.2°0.0000 / 0.0000 mm; 0.000°
Column inserted into the hub / the socket40–65 mm / 20–40 mm52 / 28 mm
Armrests: bracket, cover, post, height button, pivot button, pad plate and pad paired left to right, mirrored in X and level in Y and Z≤ 0.5 mm, 7 pairs0.0000 mm
Seat height (cushion top), armrest height over the seat0.44–0.50 m, 0.17–0.26 m0.4965, 0.1974 m
Star diameter (outer boss reach ×2)0.660 m ± 0.0050.6599
Stance: the chair's mass centre (shell volumes × density per material; the mat and plant excluded) inside the hull of the ten wheels' contacts≥ 0.12 m inside every edge0.2149 (34.24 kg, centre at y 0.035)
One connected chair (union of the chair's shells whose BVH trees overlap; the mat and plant are not part of it)1 component1 (89 shells)
Lumbar sliders clamped on the frame: distance from every slider vertex to the frame tube's surface2 sliders, 2.0–6.5 mm2; 3.5–5.2 mm
Plant rooted: each leaf's base depth under the soil's own surface straight above it; base clear of the pot wall9 leaves, 15–45 mm; ≥ 10 mm9; 24.5–31.6 mm; 66 mm

The densities are named constants: 50 for seat foam, 300 for the leatherette pads, 400 for the mesh, 1150 for nylon and the graphite plastics, 1200 for the treads, 2700 for aluminium, 7850 for chrome steel, and an effective 3000 for the mechanism, a pressed-steel housing modelled solid. The five spokes are measured by bearing, not by index: rotating any one breaks two of the five gaps. The chair's connectivity excludes the mat because the casters press into it: counted with the mat, a wheel slid off its axle would still be joined to the chair through the sheet.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1 and exited its declared code with every earlier budget green. None moves the envelope or the triangle count: every run measured the default's outer AABB and 44440 triangles.

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-casterevery wheel pressed into the mat (caster 3's body lifted 5 mm up its stem: its wheels 4.4 mm over the sheet, the other eight still pressed 0.6 mm in)16
--curl-matmat flat on the floor (its back-left corner curled 6 mm up: underside rises to 0.00600 m, clear of every wheel)16
--skew-spokefive-star geometry (spoke 0 and its caster turned 3°: worst gap off 72° by 3.000°)17
--offset-columngas lift coaxial (column moved 3 mm in X: 0.00300 m off both the hub's and the socket's axes)18
--uneven-armsarmrests mirrored and level (right post, buttons, plate and pad raised 10 mm in the cover: 0.01000 m)19
--loose-wheelone connected chair (caster 0's outer wheel slid 24 mm off its axle end: 2 components)20
--float-lumbarlumbar sliders clamped on the frame (pad, straps and sliders floated 6 mm forward: gap 0.07–11.0 mm)21
--float-leavesleaves rooted in the soil (every blade lifted 40 mm: depth −15.5 to −8.4 mm)22

--float-caster lifts the caster body, not the stem, so the stem only rides deeper into the web and the star budget still passes. --curl-mat curls only the corner where −x + y is largest, which no wheel reaches, so the wheels stay seated and the mat-flat budget is the one that fires. --offset-column leaves the column seated 52 mm and 28 mm deep and plumb, so only the coaxial budget sees it. --uneven-arms slides the arm up its own cover, as the height adjuster does, so the chair stays connected and the envelope holds; the seat and armrest heights stay in band. --loose-wheel slides a wheel along its own axle, so it still presses into the mat and the named-supports budget passes; it is attached by one joint, the axle, which is why it is the part that splits. --float-lumbar moves the lumbar unit less than a slider's wall is deep past the frame, so the sliders still bite the frame and the chair stays one component; only the clamp band sees it. --float-leaves lifts the blades inside the envelope: the headrest, not the plant, sets the top.

Run#

blender --background --python office_chair.py --
blender --background --python office_chair.py -- --skip-decimate
blender --background --python office_chair.py -- --stray-vert
blender --background --python office_chair.py -- --lift-z
blender --background --python office_chair.py -- --float-caster
blender --background --python office_chair.py -- --curl-mat
blender --background --python office_chair.py -- --skew-spoke
blender --background --python office_chair.py -- --offset-column
blender --background --python office_chair.py -- --uneven-arms
blender --background --python office_chair.py -- --loose-wheel
blender --background --python office_chair.py -- --float-lumbar
blender --background --python office_chair.py -- --float-leaves
blender --background --python office_chair.py -- --output chair.png

Smoke passes no flags.

The hero turns the whole vignette HERO_YAW_DEG (18°), so the seat and arms face the camera's right, the mat's lip points toward the camera and the plant stands to the chair's right. The camera stands low (0.72 m over the vignette's centre): the mat foreshortens, the chair fills more of the frame's height, and the mesh back and headrest read against the dark back wall, with the floor/wall seam behind the seat rather than through the mesh. The warm wedge pools on the floor to the plant's right, not behind the back. The mat and plant widen the composition: fill 0.49 of the frame's width (was 0.27) and 0.84 of its height, which meets the framing band.

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–22 are file-local. 23 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 ≠ 14 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, the mat not flat on the floor, a wheel not pressed into the mat within its band or not 10 wheels, or the pot off the floor (--lift-z, --curl-mat, --float-caster)
17Five-star geometry: spokes or bosses off 72° spacing, bosses or stems off one circle, a stem tilted, off its boss's axis or outside its seat band (--skew-spoke)
18Gas lift: column off the hub's or the socket's axis, tilted, or inserted outside its bands (--offset-column)
19Stance and size: armrests not mirrored and level, seat or armrest height, star diameter, or the mass centre within 0.12 m of the caster contact hull's edge (--uneven-arms)
20The chair splits into more than one connected component (--loose-wheel)
21Lumbar sliders not clamped on the back frame within their gap band (--float-lumbar)
22Plant: a leaf's base outside its depth band in the soil, too near the pot wall, or not 9 leaves (--float-leaves)
23Asset-quality floor (render path only; remapped from 11)

Source

showcase/office-chair/office_chair.py View the script on GitHub →
A graphite mesh-back office chair with a muted-teal two-tone seat, mesh headrest and polished five-star base, on a smoked chair mat beside a snake plant in a stone planter.