Bamboo Clump

showcase/bamboo-clump/

A procedural clump of seven clumping-bamboo culms rising from a 0.6 m rhizome mass on a lobed hummock of leaf-litter soil, five jointed rhizome knuckles breaking the soil at the outer culms' feet; each culm splayed out from the soil, then leaning and arching to a fine whip, ringed with 99 raised nodes at a pitch short at the foot, long through the middle and short again at the tip, its lowest three nodes still in papery sheaths and a fresh culm white-waxed below every node; 107 arching branches, one or two to a node, carrying 815 slim leaves with a droop of their own; three young shoots and litter off the hummock, 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: 73804 tris, five materials with 2734 soil, 16944 culm, 17115 leaf, 2979 sheath and 756 dry-leaf faces, UVs in 0..1 with zero AABB overlap, outer AABB 3.817×3.551×4.825 m read off the vertices, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, all 7 culms, 3 shoots and 5 rhizome knuckles bedded 0.0256–0.0479 m in the soil (band 0.020–0.075), all 99 node rings seated with the crest 0.0035–0.0036 m outside the wall (band 0.0025–0.0048) and the inner wall 0.0031–0.0034 m inside it (band 0.0020–0.0060), all 107 branches sprung from a node 0.0055–0.0067 m inside their culm (band 0.004–0.010), all 815 leaves seated 0.0020–0.0040 m in their branch (band 0.0010–0.0052), all 21 culm sheaths bitten 0.0014–0.0016 m into their culm (band 0.0008–0.0030) and 0.0036–0.0037 m proud (band 0.0020–0.0065), culms 2.712–4.546 m tall and 0.0458–0.0738 m across with a radius that never rises up a culm (taper ratio 0.5728–0.6036, band 0.54–0.66), node pitch 0.2487–0.2566 m per culm (band 0.23–0.28) with the middle third 0.079–0.106 m longer than the first (min 0.06), no two culms intersecting and 0.0831 m apart at closest (min 0.020), 41 litter blades resting 0.0011–0.0027 m in the soil (band 0.0005–0.006), LOD ratios in band, lower-clump collider 88 tris (max 96), non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z and --float-culm 16; --sunk-nodes 17; --stray-branches 18; --swell-culm 19; --bunch-nodes 20; --crowd-culms 21; --float-litter 22; --lift-leaves 23; --loose-sheaths 25.

category Nature

tags mesh export showcase

blender --background --python showcase/bamboo-clump/bamboo_clump.py --

A showcase piece, not an example, and a nature piece. It builds a procedural, game-ready clump of clumping bamboo on a low mound of leaf-litter soil:

Proportion, stated. Real clumping bamboo is slenderer than this: a Bambusa textilis or B. tuldoides culm stands 100–200 diameters tall. These stand about 60–75. The culms are thickened on purpose so each still reads as a cane rather than a wire at gallery size; the node pitch, the taper and the clump's 0.6 m footprint are kept to life.

Every seeded draw comes from random.Random(SEED) in plan_clump(), before anything is built, and only places the litter. Everything on the culms comes from a closed-form hash of the node's indices, so no flag can shift it.

Five materials, one per substance: soil, bamboo culm (culm, node rings, branches and rhizome knuckles, told apart by a face zone), leaf, culm sheath (the shoots, the sheaths still on the culms and the fallen ones) and dry leaf. Point attributes Along (the run along a culm, branch, leaf or shoot), Nd (the signed distance to the nearest node: the wax band lies only below a node, the scar line either side) and Side (across a leaf for its midrib, and up a node ring to mark its crest), a Skirt attribute for the soil's cut edge, and a seeded Tone face attribute carry the variation. Everything is smooth-shaded; every material boundary and every fold sharper than 62° is a hard edge, so a leaf's edge and a node ring's shoulders stay crisp while a ten-sided culm stays round.

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 clump 3.82 × 3.55 m across its leaves and 4.83 m to the highest leaf. The outer AABB is 3.8168 × 3.5512 × 4.8254 m, read off the vertices: the leaning culms and their branches set X and Y, a leaf on the tallest culm's top plume sets the top; the soil's underside is the ground. The collider is the convex hull of the lower 1.25 m of the clump, coarse: a player walks the litter and brushes through the leaves, but not through the culms.

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 triangles72800–7480073804
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2200
Materialsexactly 5 distinct; ≥2680 soil, ≥16600 culm, ≥16770 leaf, ≥2920 sheath, ≥740 dry-leaf faces5 slots; 2734 / 16944 / 17115 / 2979 / 756
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(3.8168, 3.5512, 4.8254) m ± 0.01(3.8168, 3.5512, 4.8254), zmin 0
Collider tris (lower 1.25 m hull)≤ 9688
Exportwritten, size > 0, removed after measuring5606976 / 5606976 / 5606968 bytes (4.5.11 / 5.1.2 / 5.2.1)

The quality pass re-fitted four of these around the new measurements, each for a stated reason. The triangle band moved from 51500–53500 to 72800–74800, paying for a fuller crown (815 leaves on 107 branches against 567 on 63), 21 culm sheaths, five knuckles and a wax-band row under every node. The face floors follow the same counts. The collider ceiling went from 80 to 96: the culms now rise from a 0.6 m footprint and splay from the soil, so the hull of the lower 1.25 m has more facets (88). The AABB is a new shape.

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. The plan is seeded and nothing else is random; the geometry is pure Python math. 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

The first builds had cross-shell pairs: litter flanks lying in the soil's plane (five, then two), and later one pair of tip leaves sharing a base point. The litter's flanks now lean steeper than the mound can tilt and the two tip leaves start 4% of the branch apart, rather than widening any band.

Culms, nodes, branches, the clump and the litter#

These are the organic invariants. The 1099 shells are told apart by a Part face attribute that names a shell and never measures it; every number below is read off the generated vertices.

AxisDeclaredMeasured
Shells1 soil, 7 culms, 3 shoots, 36 litter leaves, 5 fallen sheaths, 5 knuckles, and as many node rings, branches, leaves and culm sheaths as were built1 / 7 / 3 / 36 / 5 / 5 / 99 / 107 / 815 / 21
Grounded, per support: each culm's, shoot's and knuckle's lowest vertex under the soil straight above it0.020–0.075 m (each of 15 supports)0.0256–0.0479 m
Nodes seated: for each ring, a ray from its centre (on the culm's axis) to each ring vertex meets the host culm's own surface at that angle. The crest is outside it, the inner wall inside itcrest 0.0025–0.0048 m, inner wall 0.0020–0.0060 m, all 99 rings0.0035–0.0036 m; 0.0031–0.0034 m
Branches sprung from nodes: the first ring's centre inside its host culm (ray parity, three directions, distance to the nearest face), and its distance from the nearest node ring centre less the culm radius theredepth 0.004–0.010 m; ≤ 0.010 m off its node; all 1070.0055–0.0067 m; −0.0063 to −0.0053 m
Leaves seated: each leaf's first ring centre inside its branch0.0010–0.0052 m; all 8150.0020–0.0040 m
Size: each culm's height from the soil under its lowest vertex to its highest; its diameter at the lowest node (twice the distance from the ring's centre to the culm's surface)height 2.6–4.7 m with a spread of at least 1.0 m; diameter 0.042–0.080 m2.7117–4.5463 m; 0.0458–0.0738 m
Taper: the radius at each node going up each culm never rises; the last node over the firstrise ≤ 0.0004 m; ratio 0.54–0.66−0.00044 m (it falls at every node); 0.5728–0.6036
Pitch: the distance between consecutive ring centres up each culm, its mean per culm, and the middle third's mean minus the first third'sat least 10 nodes a culm; gap 0.12–0.38 m; mean 0.23–0.28 m; middle longer by ≥ 0.06 m11–18; 0.1516–0.3305 m; 0.2487–0.2566 m; 0.0794–0.1064 m
Clump: BVH overlap between every pair of culms, and the closest vertex-to-surface approach0 intersecting pairs; ≥ 0.020 m0; 0.0831 m
Litter resting: each blade's deepest vertex under the soil straight above it41 blades, each 0.0005–0.006 m0.0011–0.0027 m
Culm sheaths seated: per sheath, against the culm its centroid lies in, the deepest vertex inside the culm, the proudest outside it, and the share of its vertices inside (the inner wall is half of them)inside 0.0008–0.0030 m, proud 0.0020–0.0065 m, share ≥ 0.45; all 210.0014–0.0016 m; 0.0036–0.0037 m; 0.50

Three measurements needed care. A ring's host is the culm its centre lies inside, by ray parity, not the nearest surface: with two culms overlapping, a centre can be nearer its neighbour's skin than its own. A litter blade's lowest vertex is often a flank on a slope, so the litter is measured by its deepest vertex. And a node ring is revolved about the axis, so its centroid is the axis point, which makes the radius, the pitch and the host all one measurement.

The taper budget is what keeps the culm honest: it is a cone that only narrows, nothing swells at a node, and the rings follow the wall rather than carry the shape. The whip above the last node is outside its reach by design: no ring stands there, so the fast final thinning cannot flatter the ratio measured between the first and last rings.

A culm sheath's columns stand on the culm's own ten vertex bearings. Set half a step round, its inner wall would cut the culm's flat facets at their middles, where the facet lies 4.9% of the radius inside the vertex circle, and a 1.5 mm bite would read as a gap on every culm thicker than 3 cm.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1 and exited its declared code, and the budget_fails line it prints names only its own budget. Blender 4.5 and 5.1 were not available locally.

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-culmeach support bedded in the soil (culm 5 raised 70 mm: its foot 0.0410 m above the soil), while the soil still grounds the AABB16
--sunk-nodesnodes seated (every ring's crest 0.6 mm outside the wall: 0.0016–0.0018 m)17
--stray-branchesbranches sprung from nodes (culm 0's lowest branch 90 mm up its culm, still inside it: 0.0613 m off the nearest node)18
--swell-culmtaper (culm 2 swells 35% about 45% up, its rings following: radius rises 0.00623 m between nodes)19
--bunch-nodespitch (culm 0's seventh node slid to 70 mm under the next: gaps 0.0700–0.4805 m)20
--crowd-culmsclump (culm 3's foot stood against culm 6's and re-bedded there: 18 intersecting triangle pairs, closest approach 0.0004 m)21
--float-litterlitter resting (every blade lifted 25 mm: deepest vertex 0.0223–0.0239 m above the soil)22
--lift-leavesleaves seated (every leaf's base lifted 8 mm out of its branch: −0.0059 to 0.0016 m)23
--loose-sheathsculm sheaths seated (every sheath's inner wall 3 mm outside its culm: −0.0030 to −0.0028 m, no vertex inside)25

Each falsifier moves only what its budget measures. --stray-branches moves one branch, --crowd-culms one culm and --float-culm one culm straight up, so the envelope does not move: each stays inside BBOX_TOL. --swell-culm scales the radius and the rings that follow it, --bunch-nodes moves one ring and the branch on it, --sunk-nodes moves only the crest of every ring, and --loose-sheaths moves only the sheaths. The first --stray-branches shifted every branch and grew the box 0.09 m, exit 8; the first --crowd-culms moved culm 4, which set the box's Y, exit 8 again.

In the quality pass --crowd-culms was re-aimed twice. Moving culm 0 (the tallest, which sets the top) toward culm 4 and holding its foot's height so the top stayed put left the foot 14 mm above the soil, because the rhizome hummock falls away from the centre: exit 16, not 21. Re-bedding it instead would have dropped the top. Every culm-and-neighbour pair was then tried against the envelope, and culm 3 stood against culm 6 is one of the few that moves no extreme: the envelope changes by 0.0000 m and only the clump budget fails.

Run#

blender --background --python bamboo_clump.py --
blender --background --python bamboo_clump.py -- --skip-decimate
blender --background --python bamboo_clump.py -- --stray-vert
blender --background --python bamboo_clump.py -- --lift-z
blender --background --python bamboo_clump.py -- --float-culm
blender --background --python bamboo_clump.py -- --sunk-nodes
blender --background --python bamboo_clump.py -- --stray-branches
blender --background --python bamboo_clump.py -- --swell-culm
blender --background --python bamboo_clump.py -- --bunch-nodes
blender --background --python bamboo_clump.py -- --crowd-culms
blender --background --python bamboo_clump.py -- --float-litter
blender --background --python bamboo_clump.py -- --lift-leaves
blender --background --python bamboo_clump.py -- --loose-sheaths
blender --background --python bamboo_clump.py -- --output bamboo.png

Smoke passes no flags.

The hero keeps the piece unturned (HERO_YAW_DEG 0°) and looks in from the south-south-west, 1.8 m above the clump's mid-height, so the clump fans across the frame, the lit leaves stand out of the dark wall and the eye falls a little onto the hummock. The fill is 0.303 × 0.833.

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, grounding, joint, seat and plumb family. 20–23 and 25 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, or a shell count off the plan
4Base triangle count outside range
5Material count ≠ 5 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 (--lift-z), or a culm, shoot or rhizome knuckle not bedded 0.020–0.075 m in the soil (--float-culm)
17Nodes: a ring's crest outside 0.0025–0.0048 m or its inner wall outside 0.0020–0.0060 m (--sunk-nodes)
18Branches: a first ring outside 0.004–0.010 m inside its culm, or more than 0.010 m off a node (--stray-branches)
19Size and taper: a culm's height or diameter (0.042–0.080 m) off its band, heights less than 1.0 m apart, a radius that rises up a culm, or a taper ratio off 0.54–0.66 (--swell-culm)
20Pitch: fewer than 10 nodes on a culm, a gap outside 0.12–0.38 m, a mean outside 0.23–0.28 m, or a middle third less than 0.06 m longer than the first (--bunch-nodes)
21Clump: two culms intersect, or come closer than 0.020 m (--crowd-culms)
22Litter: a blade's deepest vertex outside 0.0005–0.006 m under the soil (--float-litter)
23Leaves: a leaf's base not 0.0010–0.0052 m inside its branch (--lift-leaves)
24Asset-quality floor (render path only; remapped from 11)
25Culm sheaths: a sheath's inner wall not 0.0008–0.0030 m inside its culm, its outer wall not 0.0020–0.0065 m proud, or fewer than 45% of its vertices inside (--loose-sheaths)

Source

showcase/bamboo-clump/bamboo_clump.py View the script on GitHub →
A clump of seven bamboo culms, one gone yellow, ringed with dark nodes and sheathed in straw at the foot, arching apart under drooping leafy branches from a dark soil hummock.