Archery Target

showcase/archery-target/

A procedural archery range target on a turf patch — a 1.10 m compressed-straw boss coiled from rope courses that show on its back and round its edge, bound with doubled jute twine drawn tight over the crests; an 80 cm ten-zone World Archery face in aged inks with ring lines, an X ring and a printed X, held by four target pins; a timber easel leaning it back 12° on toe skids with knee braces, a ledge with a stop lip on a bolted rail and gussets, a numbered butt board, a strap hinge pinned to a rear leg in a steel ferrule and foot, and a splay chain between eye bolts; five carbon arrows in the face with cresting, nocks and three vanes, one glancing into the straw edge, one snapped with its fletched half on the grass, and a leather quiver of arrows lying among grass tufts — 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: 42908 tris, sixteen materials with 4732 straw, 1856 twine, 1086 pine, 6288 steel, 522 white, 816 black, 128 blue, 128 red, 254 gold, 326 carbon, 500 vane, 300 cock-vane, 1076 nock, 5230 grass, 286 soil and 768 leather faces, UVs in 0..1 with zero AABB overlap, outer AABB 2.007×2.689×2.054 m, zmin 0 with both skids and the rear tread bedded 2.0 mm into the turf (band 1–4 mm), hygiene 0 including zero coplanar cross-shell pairs, the hinge pin 0.000 mm off the axis of all three knuckles (tol 0.3 mm), the boss seated 2.5 mm into its ledge and leaning 2.0 mm on both legs (bands 1–4 mm), the gold centre 1.3000 m above the turf (World Archery 1.30 ± 0.05) on a 1.100 × 0.280 m boss and a 0.800 m face tilted 12.000° (band 10–15°), seven points buried 0.119–0.149 m in the straw (band 0.08–0.20) with straw left ahead, every vane at least 0.419 m clear of the boss (min 0.25), ten fletched shafts with three vanes each within 0.002° of 120° (tol 1°), all ten ring lines on the 4 cm scoring table (0.000 mm off, tol 0.5 mm) in the right inks, a 73.85 kg stand and boss whose mass centre is 0.349 m inside its supports with a forward tip angle of 27.83° (min 20°), one connected assembly of 722 shells, LOD ratios in band, collider 634 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-foot 16; --offset-hinge 17; --lift-boss 18; --high-boss 19; --shallow-arrow 20; --short-arrow 21; --skew-vane 22; --wide-gold 23; --short-skids 24; --loose-pin 25.

category Sports

tags mesh export showcase

blender --background --python showcase/archery-target/archery_target.py --

A showcase piece, not an example, and the fifth in the sports category. It builds a procedural archery range target on a turf patch:

The layout is solved from named constants. The boss's lowest edge course bites the ledge 2.5 mm and its back crests bite both front legs 2 mm; the legs are placed from the boss, not the other way round. Arrows are placed by where they hit the face and how far they went in. The half arrow and the quiver are levelled on their own lowest points and dropped onto the turf.

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: 2.01 m across the turf patch, 2.69 m front to back, 2.05 m to the top of the front legs. The turf sets the width and depth, the leg tops the height. The centre of the gold stands 1.30 m above the turf, the World Archery height.

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 triangles42000–4400042908
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2200
Materialsexactly 16 distinct; ≥4490 straw, ≥1760 twine, ≥1030 pine, ≥5970 steel, ≥495 white, ≥775 black, ≥120 blue, ≥120 red, ≥240 gold, ≥310 carbon, ≥475 vane, ≥285 cock vane, ≥1020 nock, ≥4960 grass, ≥270 soil, ≥730 leather faces16 slots; 4732 / 1856 / 1086 / 6288 / 522 / 816 / 128 / 128 / 254 / 326 / 500 / 300 / 1076 / 5230 / 286 / 768
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(2.0071, 2.6887, 2.0538) m ± 0.01(2.0071, 2.6887, 2.0538), zmin 0
Collider tris≤ 1150634
Exportwritten, size > 0, removed after measuring3259388 / 3259388 / 3259380 bytes (4.5.11 / 5.1.2 / 5.2.1)

The collider is the convex hull of the whole piece; its count is carried by the 96-segment turf outline.

Every falsifier leaves the triangle count at 42908 and the AABB unchanged: they move parts or change a length, never add or remove geometry.

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 only seeded random.Random streams; 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: both skids and the rear tread bedded into the turf (turf top read off the mesh)3 supports, 1–4 mm2.0 mm each

The first draft measured 741 coplanar pairs, all fixed in the model. The two strands of each binding ended in caps on one plane (256): they now dive to different depths. The three vanes of each arrow had their rear edges on one plane square to the shaft (54): the rear edge is raked. The three quiver arrows' nocks ended on one plane and two of them shared vane angles (199): each tip bites the quiver floor a different depth and each lathe is turned by its arrow's roll. Pairs of domed bolt heads put side facets on one plane (232): heads are turned a quarter segment so no facet is square to the head's frame. The hinge leaf's edge sat on a knuckle's end face: the leaf is 2 mm narrower.

Stand, boss, face, arrows, stability and assembly#

AxisDeclaredMeasured
Hinge: each of the 3 knuckles' centres (vertex mean of the ring) against the pin's axis (PCA)3 knuckles; ≤ 0.3 mm0.000 mm
Boss on its ledge: the ledge's top along the face's up axis minus the boss's lowest point, which must lie over the ledge; each front leg's front face minus the boss's back crests over that leg, along the face normalseat 1–4 mm; lean 1–4 mm on both legs2.5 mm; 2.0, 2.0 mm
Regulation and size: gold centre above the turf; boss diameter and thickness about the face's axis; face diameter; tilt of the face normal1.30 ± 0.05 m; 1.100, 0.280 ± 0.004; 0.800 ± 0.002; 10–15°1.3000; 1.1000, 0.2800; 0.8000; 12.000°
Points buried: every shaft with a steel point whose tip is inside the boss; a ray back along the shaft to where it leaves the straw, and one forward to the straw left ahead7 arrows; 0.08–0.20 m; ahead ≥ 0.01 m7; 0.119–0.149 m; ≥ 0.051 m
Fletching clear: every vane's signed distance from the boss surface (BVH nearest, sign by the face normal)≥ 0.25 m0.419 m
Vanes at 120°: every vane assigned to the nearest shaft axis; its angle round that axis10 fletched shafts, 3 vanes each; gaps within 1° of 120°as declared; 0.002°
Scoring rings: annuli of the paper's front read off the mesh; each ring line's centre radius, and every zone and line in the ink the table gives itlines at 0.02, 0.04 … 0.36 m ± 0.5 mm; 0 wrong0.000 mm off; 0
Stability: mass centre of boss, face, bindings, stand and hardware (shell volume × density: straw 160, pine 500, twine 500, paper 700, steel 7850 kg/m³) against the convex hull of the supports' contact points; forward tip angle over the front edgeinside; tip ≥ 20°73.85 kg, 0.349 m inside; 27.83°
One connected assembly (union of shells whose BVH trees overlap)1 component1 (722 shells)

A boss is only safe on an easel if it sits on its ledge and against both legs. The gold height is the World Archery rule, measured from the turf read off the mesh. An arrow that has not buried its point falls out; one whose fletching reaches the face was shot through the boss. The scoring table is what makes the face a target face. An archer pulling arrows leans on the boss; the toe skids carry the stand's front edge forward of its mass centre, and the tip angle is what they buy.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1 and exited its declared code, with the triangle count and AABB unchanged and every budget checked before the target still 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-footevery support bedded in the turf (rear tread and ferrule 6 mm up: bite −0.004 m)16
--offset-hingehinge pin coaxial with its knuckles (pin 2.5 mm up the face: all three 0.0025 m off)17
--lift-bossboss resting on its ledge (boss and all it carries 6 mm up the legs: seat −0.0035 m, lean unchanged)18
--high-bossregulation gold height (boss, ledge, rail and gussets 80 mm up the legs: 1.3783 m)19
--shallow-arrowevery point buried (third arrow in 30 mm: 0.0287 m)20
--short-arrowevery fletching clear of the face (second arrow a 0.40 m shaft: a vane 0.1420 m from the straw)21
--skew-vanevanes at 120° (one vane of the first arrow turned 15°: 15.000° off)22
--wide-goldring radii of the scoring table (gold/red line printed at 0.09 m)23
--short-skidsforward tip angle (skid toes cut back to 50 mm ahead of the legs: 15.20°, mass centre still 0.289 m inside)24
--loose-pinone connected assembly (one target pin 75 mm out of the face: 2 components)25

--lift-boss moves the boss along the legs, so it still leans on both. --high-boss moves the ledge with the boss, so the seat holds and only the height fails. --shallow-arrow pushes the fletching further from the face. --short-arrow keeps the point's depth. --short-skids keeps both skids bedded and the mass centre inside the supports.

Run#

blender --background --python archery_target.py --
blender --background --python archery_target.py -- --skip-decimate
blender --background --python archery_target.py -- --stray-vert
blender --background --python archery_target.py -- --lift-z
blender --background --python archery_target.py -- --float-foot
blender --background --python archery_target.py -- --offset-hinge
blender --background --python archery_target.py -- --lift-boss
blender --background --python archery_target.py -- --high-boss
blender --background --python archery_target.py -- --shallow-arrow
blender --background --python archery_target.py -- --short-arrow
blender --background --python archery_target.py -- --skew-vane
blender --background --python archery_target.py -- --wide-gold
blender --background --python archery_target.py -- --short-skids
blender --background --python archery_target.py -- --loose-pin
blender --background --python archery_target.py -- --output target.png

Smoke passes no flags.

The hero turns the piece HERO_YAW_DEG (6°), so the face meets the camera at about a third of a right angle: the left edge with its glancing arrow, the bindings and the courses show, and the arrows in the face read at length. The wall stands 3.4 m behind the target, and the warm wedge pools on 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–25 are file-local. 26 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 ≠ 16 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, or a support not bedded 1–4 mm into the turf, or not 3 supports (--lift-z, --float-foot)
17Hinge: not 3 knuckles, or one off the pin's axis (--offset-hinge)
18Boss not resting on its ledge, or not leaning on both legs (--lift-boss)
19Regulation: gold height, boss or face size, or tilt off (--high-boss)
20Arrow points: not 7 in the boss, one buried outside its band, or through the back (--shallow-arrow)
21Fletching: a vane closer to the boss than its clearance (--short-arrow)
22Vanes: not 10 fletched shafts of 3, or spacing off 120° (--skew-vane)
23Scoring rings: a line off the table, or a zone in the wrong ink (--wide-gold)
24Stability: mass centre outside the supports, or forward tip angle under its floor (--short-skids)
25Assembly: not one connected component (--loose-pin)
26Asset-quality floor (render path only; remapped from 11)

Source

showcase/archery-target/archery_target.py View the script on GitHub →
A straw archery boss with a gold, red, blue, black and white face and five arrows, leaning on a timber easel numbered 12, a quiver on the grass patch below.