Moka Pot

showcase/moka-pot/

A procedural three-cup Moka Express-pattern pot — an eight-flat boiler and collector flaring out from an hourglass waist with a proud grip band, a V beak pinched from the rim, a hinged faceted lid and bakelite knob, a two-root bakelite D handle on a riveted fin, and a brass valve — carried through UVs, bake, LOD, compound 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: 1300 tris, three materials with 197 aluminium, 388 bakelite and 124 brass faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.1327×0.0832×0.1600 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, 10 shells, the collector 3.5 mm onto the boiler, both handle roots 2.5 mm into the fin, the knob 1.8 mm into the lid, spout and fin 1.5 mm into the wall, fasteners 1.2–1.6 mm in and ≥1.8 mm proud, 83.2/80.2/160.0 mm foot/collector/height against a 16 cm, 9 cm-base three-cup pot, plumb 0 and eight-fold spread 0. --lean-pot exits 19 at 3.3 mm of plumb drift and --odd-facet at 2.0 mm of facet spread, both inside the unchanged bounding box.

category Household

tags mesh export showcase

blender --background --python showcase/moka-pot/moka_pot.py --

A three-cup Moka Express-pattern stovetop pot: an eight-flat boiler that flares out to its foot, a collector that flares out to its rim, both pinching to the screw joint where the collector's threaded skirt stands proud as a grip band, a V beak pinched from the rim, a faceted lid on a hinge knuckle under a bakelite knob, a bakelite D handle rooted in a riveted fin, and a brass safety valve. A showcase piece, not an example — it witnesses no API contract. It asserts that generated geometry meets declared asset budgets, recomputed from the finished mesh.

What it composes#

Shipped contentUsed for
skills/mesh-editing-and-bmesheight-flat lathes, a swept handle, a prism beak and plates, all in one bmesh; bevel pinned to a material slot
skills/procedural-materials-and-shadersbrushed aluminium, glossy bakelite, brass
skills/bake-high-to-lowCycles tangent-space normal bake, high onto low
skills/engine-export-presetsUnity glTF (export_yup=True)
skills/depsgraph-and-evaluated-dataevaluated triangle counts for the LOD ratios
snippets/decimate_to_budget.pyLOD1 / LOD2 COLLAPSE chain
snippets/convex_hull_collider.pyone hull for the body, spout and lid, one for the handle
snippets/lod_chain.pyLOD naming and ratio pattern
examples/mesh-hygiene-audithygiene combinatorics (copied, not imported)

The budget that matters#

A moka pot is an octagon all the way up. Eight flats, every ring of the boiler and of the collector the same size on all eight sides, every ring centred on one vertical axis. Two ways to break that leave every other budget green:

Neither moves the bounding box (the handle and spout set it), the triangle band, the hygiene audit or a joint. So the piece measures both off the generated vertices:

--odd-facet pushes one flat of the collector's mid ring 2.5 mm out and exits 19 on the spread (1.97 mm measured, with the AABB unchanged). --lean-pot shears the pot 4 mm over its height and exits 19 on the plumb line (3.28 mm measured, spread untouched).

Budgets#

Declared in the script as named constants, recomputed from the generated mesh. Measured values are from Blender 5.2.1; 4.5 and 5.1 were not available locally and are unverified (CI runs the check-only path on both).

BudgetBandMeasured
Base triangles1200–14001300
LOD1 ratio0.32–0.620.5000
LOD2 ratio0.10–0.350.2185
Material slotsexactly 3, distinct3
Aluminium / bakelite / brass faces≥ 160 / 280 / 100197 / 388 / 124
UV boundsinside 0..1(0.0025, 0.0025)–(0.9975, 0.9975)
UV AABB overlap≤ 1e-50.000000
Outer AABB0.1327 × 0.0832 × 0.1600 m ± 0.0060.1327 × 0.0832 × 0.1600
Collider triangles≤ 200154 (two hulls)
Normal bake{'FINISHED'} with image data{'FINISHED'}, has_data=True
glTF exportfile written, non-empty~78 kB
Hygieneall zeroloose 0/0, non-manifold 0, zero-area 0, doubles 0, n-gons 0, coplanar cross-shell pairs 0
Grounded AABB\zmin\≤ 1e-4, boiler zmin ≤ 1e-40.00000
Shellsexactly 10, none unclassified10
Collector seat on the boiler2.5–4.5 mm3.50 mm
Handle bite into the fin1.0–3.0 mm, each of the two roots2.50 mm, both roots
Knob bite into the lid1.0–3.0 mm1.80 mm
Lid seat on the collector1.0–3.0 mm1.80 mm
Spout bite and reachbase 0.9–3.0 mm into the wall; tip 10–15 mm beyond it1.50 mm; 12.41 mm
Fin bite0.9–3.0 mm into the wall1.50 mm
Hinge bite1.5–5.0 mm into the collector2.63 mm
Fasteners (valve, one rivet)bite 0.8–2.5 mm, proud ≥ 1.2 mmvalve 1.60 / 4.60; rivet 1.20 / 1.80
Real size: foot, collector, height83.2 / 80.2 / 160.0 mm ± 383.2 / 80.2 / 160.0
Plumb≤ 0.8 mm0.000 mm
Eight-fold spread≤ 0.2 mm0.000 mm

Real-world size: a three-cup Moka Express is listed at 16.0 cm tall and 9.0 cm across the base point to point, which is 83.2 mm across its flats. The collector rim is read off product photos at 0.96 of the foot, 80.2 mm across its flats. The waist at the joint is 0.76 of the foot. Spout tip to handle is about 133 mm.

Construction#

Findings the budgets forced#

Conventions walked#

Every convention in showcase/README.md, and whether it applies here.

ConventionAppliesHow
Deterministic, budgets declared, assertions recomputeyesno RNG; every value above is read off the mesh
Falsifier fails the budget it targetsyestable below
Hygiene incl. cross-shell coplanaryesexit 15; --flush-joint is the coplanar falsifier
Named supportsnoone support (the boiler's foot)
Joint-fit budgetsyesshell count, collector seat, both handle roots (exit 17)
Fasteners aimed down the host normalyesrivet and valve (--float-valve, exit 18)
Seat conformanceyesknob, lid, spout, fin, hinge, fasteners (exit 18)
A member is tenoned into its seat, never stood on ityescollector, lid, knob, handle
Plumb and real-world sizeyesexit 19; plumb, three sizes in metres
Mirrored assembliesnonothing is paired
Even shaping termsn/ano shaping function; profiles are piecewise linear
Edge treatment: no right anglesyes0.7 mm chamfer on every aluminium edge over 30°; the asset-quality right-angle fraction is 0.044
One substance, one slotyesaluminium, bakelite, brass
Shading is part of the modelyessee Construction
Chamfer n-gon caps, then triangulateyesevery cap
Sort bmesh operator inputsyesbevel edges sorted by index
Level on the stage; stage scaledyesturned about Z only; the 60 m stage and the rig are scaled by 0.2 with light power by 0.04
Keep a falsifier's envelope stillyesevery falsifier moves less than BBOX_TOL (6 mm)
Rope, masonry, roofs, hung rings, scatternonone present

Falsifiers#

Each breaks one pipeline stage so a named budget fails. All ten were run on Blender 5.2.1 and exited the documented code; 4.5.11 and 5.1.2 were not available locally and are unverified.

FlagTarget budgetBreaksExit
--skip-decimateLOD1 ratiodrops the DECIMATE modifiers, LOD1 ratio goes to 1.00009
--stray-vertmesh hygieneadds one loose vertex on the axis15
--flush-jointcoplanar cross-shell pairsdrops the boiler's top plane onto the collector's floor plane; 6 pairs15
--lift-zgrounded zminlifts the whole mesh 20 mm16
--short-handlehandle bitestops both handle roots 3 mm outside the fin; no root vertex inside it17
--float-knobknob bitelifts the knob 4 mm; −2.2 mm18
--float-spoutspout bitelifts the spout's base 4 mm off the wall, tip fixed; −2.5 mm18
--float-valvefastener seatlifts the valve 3 mm off its flat; −1.4 mm18
--lean-potplumbshears the pot 4 mm over its height; 3.28 mm drift19
--odd-faceteight-fold spreadpushes one mid-ring flat 2.5 mm out; 1.97 mm spread19

Exit codes#

File-local and sequential. 9 is a valid check code. 1 is the FATAL wrapper — a crash, never a named check. 10 is the framing gate and 21 the asset-quality gate (the helper's own code, 11, is spent here on the collider ceiling), both on the render path only.

CodeMeaning
0Success
1Uncaught exception (FATAL wrapper)
2argparse / usage
3Mesh did not build, or has no UV layer
4Base triangle count outside band
5Material slots, or a material's face floor
6UVs outside 0..1
7UV AABB overlap above tolerance
8Outer AABB off declared size
9LOD1 or LOD2 ratio outside band (--skip-decimate)
10Framing gate (examples/gallery_framing.py, render path only)
11Collider triangles above ceiling
12Normal bake failed or produced no image data
13glTF export missing or empty
14--output produced no file
15Mesh hygiene (--stray-vert, --flush-joint)
16Grounded zmin (--lift-z)
17Shell count, collector seat, or handle bite (--short-handle)
18Knob, lid, spout, fin, hinge or fastener seat (--float-knob, --float-spout, --float-valve)
19Real-world size, plumb, or eight-fold spread (--lean-pot, --odd-facet)
21Asset-quality gate (examples/gallery_asset_quality.py, render path only)

Run it#

# Budget check, no render. ~1 s on a warm 5.2.
blender --background --python moka_pot.py --

# Falsifier: the pot leans at the lid. Must exit 19.
blender --background --python moka_pot.py -- --lean-pot

# Falsifier: one flat out of line with the other seven. Must exit 19.
blender --background --python moka_pot.py -- --odd-facet

# Render the gallery still (EEVEE; --engine cycles on a GPU-less host).
blender --background --python moka_pot.py -- --output moka_pot.webp

Smoke runs the check-only path. It does not pass --output or any falsifier.

Cross-version measurements#

Measured on 5.2.1 only. 4.5 and 5.1 are unverified locally.

Value5.2.1
Base triangles1300
LOD1 / LOD2 tris650 / 284
Face counts (aluminium / bakelite / brass)197 / 388 / 124
Outer AABB0.1327 × 0.0832 × 0.1600
Collider tris154
glTF bytes77860

Source

showcase/moka-pot/moka_pot.py View the script on GitHub →
A brushed eight-sided aluminium moka pot pinched to an hourglass waist with a proud grip band, a V-beak spout, a black bakelite knob and D handle, and a brass valve.