From 42b562dd0a6c31b6e5cec241d8204b797418e069 Mon Sep 17 00:00:00 2001 From: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Date: Sun, 13 Sep 2026 15:12:38 -0400 Subject: [PATCH 1/2] feat: add campfire as a fourth showcase piece Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-authored-by: Cursor --- .cursor-plugin/plugin.json | 3 +- AGENTS.md | 2 +- CLAUDE.md | 2 +- README.md | 7 +- ROADMAP.md | 1 + docs/gallery/assets/campfire-hero.webp | Bin 0 -> 33862 bytes docs/gallery/campfire/index.html | 1103 ++++++++++++++++++++++++ docs/gallery/index.html | 13 +- showcase/campfire/README.md | 73 ++ showcase/campfire/campfire.py | 779 +++++++++++++++++ showcase/campfire/preview.webp | Bin 0 -> 31906 bytes showcase/gallery.json | 12 + tests/smoke/catalog.json | 3 +- 13 files changed, 1991 insertions(+), 7 deletions(-) create mode 100644 docs/gallery/assets/campfire-hero.webp create mode 100644 docs/gallery/campfire/index.html create mode 100644 showcase/campfire/README.md create mode 100644 showcase/campfire/campfire.py create mode 100644 showcase/campfire/preview.webp diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index d75ddde..4bea0e7 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -140,6 +140,7 @@ "showcase": [ "showcase/shipping-crate", "showcase/stone-well", - "showcase/wooden-barrel" + "showcase/wooden-barrel", + "showcase/campfire" ] } diff --git a/AGENTS.md b/AGENTS.md index dec8a32..f33c126 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,7 +21,7 @@ classifies it as a `cursor-plugin`. This is content the AI loads when the user asks Blender questions or works on Blender add-ons in Cursor or Claude Code. The content base is 16 skills, 9 rules, 3 templates, 27 snippets, 59 -examples, and 3 showcase pieces (counts are CI-enforced against README.md +examples, and 4 showcase pieces (counts are CI-enforced against README.md and the manifest). The full inventory tables and per-item purposes live in `CLAUDE.md`. Example anatomy and authoring rules: copy `examples/bmesh-gear/`; showcase conventions: `showcase/README.md`. The render look is specified diff --git a/CLAUDE.md b/CLAUDE.md index 3cb6a95..c740f45 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -22,7 +22,7 @@ rules/.mdc - Anti-pattern rules, 9 total templates// - Starter projects, 3 total snippets/.py - Standalone code patterns, 27 total examples// - Runnable smoke-gated examples, 59 total (+ gallery.json) -showcase// - Budget-conformance props, 3 pieces (sibling of examples/; see showcase/README.md) +showcase// - Budget-conformance props, 4 pieces (sibling of examples/; see showcase/README.md) scripts/build_gallery.py - Regenerates docs/gallery/ from examples/gallery.json + showcase/gallery.json scripts/site/ - Vendored landing-page build (Jinja2) docs/gallery/ - Committed generated gallery pages + hero renders diff --git a/README.md b/README.md index 4909166..86c661d 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@

- 16 skills  •  9 rules  •  3 templates  •  27 snippets  •  59 examples  •  3 showcase pieces + 16 skills  •  9 rules  •  3 templates  •  27 snippets  •  59 examples  •  4 showcase pieces

@@ -37,7 +37,7 @@ ## Overview -This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 59 examples, and 3 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable. +This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 59 examples, and 4 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable. The content is consumed by AI coding agents (Cursor, Claude Code, any MCP-capable client) when working on Blender add-ons, geometry nodes scripts, batch pipelines, or animation tooling. There is no build step. Edit the markdown and Python files directly. @@ -78,6 +78,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show Shipping crate: a wooden slat crate with iron corner brackets on a dark studio floor, warm wedge on the back wall Stone well: a round brick well with a shingled pyramid roof on posts, rope and bucket, on a dark studio floor Wooden barrel: a staved barrel with iron hoops on a dark studio floor, warm wedge on the back wall +Campfire: a stone ring, crossed logs, and ash mound on a dark studio floor, warm wedge on the back wall [`shipping-crate`](showcase/shipping-crate/) — procedural crate through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets. Falsifier `--skip-decimate` exits 9. @@ -85,6 +86,8 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show [`wooden-barrel`](showcase/wooden-barrel/) — procedural staved barrel with iron hoops through the same pipeline. Falsifier `--skip-decimate` exits 9. +[`campfire`](showcase/campfire/) — procedural cobble ring, logs, and ash through the same pipeline. Falsifier `--skip-decimate` exits 9. + ## Examples Runnable, smoke-gated demos live in [`examples/`](examples/) — each is executed headless on diff --git a/ROADMAP.md b/ROADMAP.md index 4788ab8..a45ede9 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -109,6 +109,7 @@ Not committed; target list for the next content version. (v0.3.0 shipped the smo - ~~Showcase sibling tree + shipping-crate pilot~~ **SHIPPED** as `showcase/shipping-crate/` — budget-conformance crate composing bake, LOD, collider, Unity glTF; `--skip-decimate` exits 9 on the LOD1 ratio band; DECIMATE COLLAPSE ratios diverge on 5.2 vs 4.5/5.1 - ~~Round stone well showcase~~ **SHIPPED** as `showcase/stone-well/` — running-bond brick well, shingled pyramid roof, windlass/rope/bucket; `--skip-decimate` exits 9 on the LOD1 ratio band - ~~Wooden barrel showcase~~ **SHIPPED** as `showcase/wooden-barrel/` — bulged staves, four iron hoops, lid heads; `--skip-decimate` exits 9 on the LOD1 ratio band +- ~~Campfire showcase~~ **SHIPPED** as `showcase/campfire/` — cobble ring, ash mound, crossed logs; `--skip-decimate` exits 9 on the LOD1 ratio band - Procedural terrain or landscape showcase using Geometry Nodes scatter - Hero prop with a more complex silhouette (lantern or treasure chest) as a second showcase piece - Small modular kit showcase on recognizable geometry (`modular-kit-snap` contract) diff --git a/docs/gallery/assets/campfire-hero.webp b/docs/gallery/assets/campfire-hero.webp new file mode 100644 index 0000000000000000000000000000000000000000..b25c3b91a97195a638083b1e63092da71cf59535 GIT binary patch literal 33862 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

WXOI_{c0Q~rA9m=^j0Kc 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 literal 0 HcmV?d00001 diff --git a/docs/gallery/campfire/index.html b/docs/gallery/campfire/index.html new file mode 100644 index 0000000..3e729e5 --- /dev/null +++ b/docs/gallery/campfire/index.html @@ -0,0 +1,1103 @@ + + + + + + campfire — Examples — Blender Developer Tools + + + + + + + + + + + + + + + + + +

+ Examples Gallery +
+ GitHub +
+
+
+

campfire

+

A procedural campfire through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

+
+
+ +

Rendered headless by the example itself — click to zoom.

+
witnesses Recomputed: 7528 tris, three materials with 116 wood and 18 ash faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.964×0.950×0.252 m, LOD ratios in band, convex collider 105 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.
+
+ 
blender --background --python showcase/campfire/campfire.py --
+ +
+
+

A showcase piece, not an example. Procedural campfire (flattened cobble ring, inner stones, ash mound, crossed logs, sticks, charcoal) then the shipped pipeline: unique-cell UVs, Cycles high-to-low normal bake, LOD chain, convex collider, Unity glTF export.

+

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, not imported as a package).

+

Budgets

+

Declared as named constants; every gate recomputes from the mesh, materials, UVs, evaluated LOD, collider, or export file.

+

| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) | | --- | --- | --- | | Base triangles | 7400–7650 | 7528 / 7528 / 7528 | | LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 | | LOD2 ratio | 0.10–0.35 of base | 0.2200 / 0.2200 / 0.2200 | | Materials | exactly 3 distinct, ≥24 wood faces, ≥8 ash faces | 3 slots, 116 wood, 18 ash | | UVs | in 0..1, AABB overlap ≤ 1e-5 | in range, overlap 0 | | Outer AABB | (0.964, 0.950, 0.252) m ± 0.01 | (0.9641, 0.9495, 0.2521), zmin 0 | | Collider tris | ≤ 160 | 105 | | Export | written, size > 0 | 548944 / 548944 / 548936 bytes |

+

DECIMATE COLLAPSE triangle counts are not guaranteed identical across series — the gate is a ratio band, not an exact count. This mesh happened to match on 4.5.11 / 5.1.2 / 5.2.1. Bake pixels are stochastic; the gate is has_data plus operator FINISHED, not byte-identity. Construction uses no RNG. glTF byte size differs by a few bytes across series.

+

--skip-decimate skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and exit 9 fires. That is the named budget the falsifier violates.

+

Run

+
blender --background --python campfire.py --
+blender --background --python campfire.py -- --skip-decimate
+blender --background --python campfire.py -- --output campfire.png
+

Smoke does not pass --output or --skip-decimate.

+

Exit codes

+

File-local. 9 is a valid check code. 10 is reserved for gallery_framing.check_framing on the --output path.

+

| Code | Meaning | | --- | --- | | 0 | Success | | 1 | Uncaught exception (FATAL wrapper) | | 2 | argparse / usage | | 3 | Mesh did not build / no UV layer | | 4 | Base triangle count outside range | | 5 | Material count ≠ 3 distinct slots, or wood/ash faces missing | | 6 | UVs outside 0..1 | | 7 | UV AABB overlap above tolerance | | 8 | World AABB off declared outer size | | 9 | LOD ratio band (--skip-decimate lands here) | | 10 | Framing gate (render path only) | | 11 | Collider triangle count above ceiling | | 12 | Bake did not finish or image has no data | | 13 | Export file missing or empty | | 14 | --output produced no file |

+
+
+

Source

+
+ showcase/campfire/campfire.py + View on GitHub → +
+ 
"""Game-ready campfire — a showcase piece, not an example.
+
+Asserts budget conformance of a procedural campfire after composing
+shipped pipeline pieces: bmesh construction, UVs, three materials,
+high-to-low normal bake, LOD chain, convex collider, Unity glTF export.
+
+Budgets are declared below and recomputed from the generated result.
+They are not API-contract witnesses. ``--skip-decimate`` skips the LOD
+DECIMATE stage so the LOD-ratio budget fails.
+
+No RNG. Construction is closed-form. DECIMATE COLLAPSE triangle counts
+are not byte-identical across Blender versions — the LOD gate is a
+ratio band, not an exact count.
+
+    blender --background --python campfire.py --
+    blender --background --python campfire.py -- --skip-decimate
+    blender --background --python campfire.py -- --output campfire.png
+"""
+import argparse
+import math
+import os
+import sys
+import tempfile
+import traceback
+
+import bmesh
+import bpy
+from mathutils import Euler, Vector
+
+# Showcase lives at repo-root/showcase/, not under examples/. The framing
+# helper is the repo's only shared import and lives next to the examples;
+# resolve the repo root so we do not move gallery_framing.py.
+_REPO = os.path.abspath(
+    os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir, os.pardir)
+)
+sys.path.insert(0, os.path.join(_REPO, "examples"))
+sys.dont_write_bytecode = True
+import gallery_framing  # noqa: E402
+
+N_RING = 12
+RING_R = 0.40
+N_INNER = 7
+INNER_R = 0.22
+ASH_R = 0.26
+ASH_H = 0.055
+N_LOGS = 4
+LOG_LEN = 0.50
+LOG_R = 0.040
+N_STICKS = 3
+STICK_LEN = 0.38
+STICK_R = 0.016
+N_COALS = 5
+BBOX_TOL = 0.01
+# Fitted to the generated AABB after locking geometry. Recomputed from bound_box.
+OUTER_SIZE = (0.964, 0.950, 0.252)
+
+BASE_TRIS_MIN = 7400
+BASE_TRIS_MAX = 7650
+LOD1_RATIO_MIN = 0.32
+LOD1_RATIO_MAX = 0.62
+LOD2_RATIO_MIN = 0.10
+LOD2_RATIO_MAX = 0.35
+LOD1_TARGET = 0.50
+LOD2_TARGET = 0.22
+MATERIAL_COUNT = 3
+UV_EPS = 1e-4
+UV_OVERLAP_MAX = 1e-5
+COLLIDER_TRIS_MAX = 160
+BAKE_RES = 256
+CAGE_EXTRUSION = 0.06
+
+STONE_IDX = 0
+WOOD_IDX = 1
+ASH_IDX = 2
+
+
+def eevee_engine_id():
+    return "BLENDER_EEVEE" if bpy.app.version >= (5, 0, 0) else "BLENDER_EEVEE_NEXT"
+
+
+def fail(msg, code):
+    print(f"ERROR: {msg}", file=sys.stderr)
+    return code
+
+
+def triangle_count(mesh):
+    mesh.calc_loop_triangles()
+    return len(mesh.loop_triangles)
+
+
+def evaluated_triangle_count(obj):
+    # Duplicated from snippets/lod_chain.py / decimate_to_budget.py (not a package).
+    depsgraph = bpy.context.evaluated_depsgraph_get()
+    eval_obj = obj.evaluated_get(depsgraph)
+    eval_mesh = eval_obj.to_mesh()
+    try:
+        eval_mesh.calc_loop_triangles()
+        return len(eval_mesh.loop_triangles)
+    finally:
+        eval_obj.to_mesh_clear()
+
+
+def add_box(bm, loc, scale, mat_idx, euler=(0.0, 0.0, 0.0)):
+    geo = bmesh.ops.create_cube(bm, size=1.0)
+    verts = geo["verts"]
+    rot = Euler(euler).to_matrix()
+    origin = Vector(loc)
+    for v in verts:
+        p = Vector((v.co.x * scale[0], v.co.y * scale[1], v.co.z * scale[2]))
+        v.co = rot @ p + origin
+    faces = {f for v in verts for f in v.link_faces}
+    for f in faces:
+        f.material_index = mat_idx
+    return verts
+
+
+def add_cobble(bm, loc, scale, mat_idx, euler=(0.0, 0.0, 0.0), lump=0.22):
+    geo = bmesh.ops.create_icosphere(bm, subdivisions=1, radius=0.5)
+    verts = list(geo["verts"])
+    rot = Euler(euler).to_matrix()
+    origin = Vector(loc)
+    for v in verts:
+        p = Vector((v.co.x * scale[0], v.co.y * scale[1], v.co.z * scale[2]))
+        h = math.sin(p.x * 19.7 + p.y * 13.3) * math.cos(p.z * 17.1 + p.x * 7.9)
+        h += 0.40 * math.sin(p.y * 31.0 + p.z * 23.0)
+        h = max(-0.80, min(0.80, h))
+        p = p * (1.0 + lump * h)
+        v.co = rot @ p + origin
+    faces = {f for v in verts for f in v.link_faces}
+    for f in faces:
+        f.material_index = mat_idx
+    return verts
+
+
+def add_cone(bm, loc, radius1, radius2, depth, segments, mat_idx, euler=(0.0, 0.0, 0.0)):
+    geo = bmesh.ops.create_cone(
+        bm,
+        cap_ends=True,
+        cap_tris=False,
+        segments=segments,
+        radius1=radius1,
+        radius2=radius2,
+        depth=depth,
+    )
+    verts = geo["verts"]
+    rot = Euler(euler).to_matrix()
+    origin = Vector(loc)
+    for v in verts:
+        v.co = rot @ v.co + origin
+    faces = {f for v in verts for f in v.link_faces}
+    for f in faces:
+        f.material_index = mat_idx
+    return verts
+
+
+def add_cylinder(bm, loc, radius, depth, segments, mat_idx, euler=(0.0, 0.0, 0.0)):
+    return add_cone(bm, loc, radius, radius, depth, segments, mat_idx, euler=euler)
+
+
+def pack_uvs(bm, margin=0.08):
+    uv = bm.loops.layers.uv.new("UVMap")
+    faces = list(bm.faces)
+    n = len(faces)
+    cols = max(1, math.ceil(math.sqrt(n)))
+    rows = max(1, math.ceil(n / cols))
+    cell_w = 1.0 / cols
+    cell_h = 1.0 / rows
+    pad_u = margin * cell_w * 0.5
+    pad_v = margin * cell_h * 0.5
+    usable_w = cell_w - 2.0 * pad_u
+    usable_h = cell_h - 2.0 * pad_v
+    for i, face in enumerate(faces):
+        col = i % cols
+        row = i // cols
+        nrm = face.normal
+        ax = abs(nrm.x)
+        ay = abs(nrm.y)
+        az = abs(nrm.z)
+        coords = []
+        for loop in face.loops:
+            co = loop.vert.co
+            if az >= ax and az >= ay:
+                coords.append((co.x, co.y))
+            elif ax >= ay:
+                coords.append((co.y, co.z))
+            else:
+                coords.append((co.x, co.z))
+        xs = [c[0] for c in coords]
+        ys = [c[1] for c in coords]
+        minx, maxx = min(xs), max(xs)
+        miny, maxy = min(ys), max(ys)
+        dx = max(maxx - minx, 1e-8)
+        dy = max(maxy - miny, 1e-8)
+        origin_u = col * cell_w + pad_u
+        origin_v = row * cell_h + pad_v
+        for loop, (x, y) in zip(face.loops, coords):
+            loop[uv].uv = (
+                origin_u + (x - minx) / dx * usable_w,
+                origin_v + (y - miny) / dy * usable_h,
+            )
+
+
+def _stone_size(i, base_xy, base_z, k):
+    sx = base_xy[0] + 0.035 * abs(math.sin(i * 2.17 + k))
+    sy = base_xy[1] + 0.028 * abs(math.cos(i * 1.73 + k * 0.7))
+    sz = base_z + 0.038 * abs(math.sin(i * 1.11 + k * 1.3))
+    return sx, sy, sz
+
+
+def build_campfire_mesh(name, bevel_offset, bevel_segments):
+    bm = bmesh.new()
+    bevel_verts = []
+    ash_faces = set()
+    wood_faces = set()
+    try:
+        for i in range(N_RING):
+            ang = 2.0 * math.pi * i / N_RING
+            sx, sy, sz = _stone_size(i, (0.175, 0.138), 0.070, 0.2)
+            r = RING_R + 0.028 * math.sin(i * 1.9)
+            loc = (r * math.cos(ang), r * math.sin(ang), sz / 2.0)
+            tilt = (
+                math.radians(18.0 * math.sin(i * 0.7)),
+                math.radians(14.0 * math.cos(i * 1.3)),
+                ang + math.radians(22.0 * math.sin(i * 1.1)),
+            )
+            bevel_verts.extend(
+                add_cobble(bm, loc, (sx, sy, sz), STONE_IDX, euler=tilt, lump=0.24)
+            )
+
+        for i in range(N_INNER):
+            ang = 2.0 * math.pi * i / N_INNER + 0.31
+            sx, sy, sz = _stone_size(i, (0.100, 0.082), 0.048, 1.4)
+            r = INNER_R + 0.018 * math.cos(i * 1.4)
+            loc = (r * math.cos(ang), r * math.sin(ang), sz / 2.0)
+            tilt = (
+                math.radians(12.0 * math.cos(i * 0.9)),
+                math.radians(10.0 * math.sin(i * 1.5)),
+                ang + 0.4,
+            )
+            bevel_verts.extend(
+                add_cobble(bm, loc, (sx, sy, sz), STONE_IDX, euler=tilt, lump=0.20)
+            )
+
+        before = set(bm.faces)
+        add_cone(
+            bm,
+            (0.0, 0.0, ASH_H / 2.0),
+            ASH_R,
+            0.055,
+            ASH_H,
+            16,
+            ASH_IDX,
+        )
+        ash_faces.update(set(bm.faces) - before)
+
+        for i in range(N_LOGS):
+            yaw = i * (math.pi / 2.0) + math.radians(18.0)
+            loc = (
+                0.045 * math.cos(yaw + math.pi / 4.0),
+                0.045 * math.sin(yaw + math.pi / 4.0),
+                LOG_R + 0.020 + 0.012 * (i % 2),
+            )
+            before = set(bm.faces)
+            verts = add_cylinder(
+                bm,
+                loc,
+                LOG_R * (1.0 - 0.08 * (i % 2)),
+                LOG_LEN,
+                12,
+                WOOD_IDX,
+                euler=(math.pi / 2.0, 0.0, yaw),
+            )
+            bevel_verts.extend(verts)
+            wood_faces.update(set(bm.faces) - before)
+
+        for i in range(N_STICKS):
+            yaw = i * (2.0 * math.pi / N_STICKS) + 0.55
+            pitch = math.radians(32.0 + 6.0 * math.sin(i * 1.7))
+            loc = (
+                0.07 * math.cos(yaw),
+                0.07 * math.sin(yaw),
+                0.055 + STICK_R,
+            )
+            before = set(bm.faces)
+            verts = add_cylinder(
+                bm,
+                loc,
+                STICK_R,
+                STICK_LEN,
+                8,
+                WOOD_IDX,
+                euler=(math.pi / 2.0 - pitch, 0.0, yaw),
+            )
+            bevel_verts.extend(verts)
+            wood_faces.update(set(bm.faces) - before)
+
+        for i in range(N_COALS):
+            ang = 2.0 * math.pi * i / N_COALS + 0.2
+            r = 0.07 + 0.025 * (i % 2)
+            sz = 0.028 + 0.010 * abs(math.sin(i * 2.2))
+            loc = (r * math.cos(ang), r * math.sin(ang), ASH_H * 0.55 + sz / 2.0)
+            before = set(bm.faces)
+            verts = add_box(
+                bm,
+                loc,
+                (0.040, 0.028, sz),
+                WOOD_IDX,
+                euler=(0.0, 0.0, ang),
+            )
+            bevel_verts.extend(verts)
+            wood_faces.update(set(bm.faces) - before)
+
+        if bevel_offset > 0.0:
+            edges = list({e for v in bevel_verts for e in v.link_edges})
+            bmesh.ops.bevel(
+                bm,
+                geom=edges,
+                offset=bevel_offset,
+                segments=bevel_segments,
+                profile=0.5,
+                affect="EDGES",
+                clamp_overlap=True,
+            )
+
+        zmin = min(v.co.z for v in bm.verts)
+        if zmin != 0.0:
+            for v in bm.verts:
+                v.co.z -= zmin
+
+        pack_uvs(bm)
+        bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces))
+        for face in bm.faces:
+            face.smooth = True
+        for edge in bm.edges:
+            edge.smooth = True
+            if edge.is_manifold and len(edge.link_faces) == 2:
+                if edge.calc_face_angle() > math.radians(35.0):
+                    edge.smooth = False
+        for f in ash_faces:
+            if f.is_valid:
+                f.material_index = ASH_IDX
+        for f in wood_faces:
+            if f.is_valid:
+                f.material_index = WOOD_IDX
+        me = bpy.data.meshes.new(name)
+        bm.to_mesh(me)
+        me.update()
+    finally:
+        bm.free()
+    obj = bpy.data.objects.new(name, me)
+    bpy.context.collection.objects.link(obj)
+    return obj
+
+
+def principled(name, color, metallic, roughness):
+    mat = bpy.data.materials.new(name)
+    mat.use_nodes = True
+    bsdf = mat.node_tree.nodes["Principled BSDF"]
+    bsdf.inputs["Base Color"].default_value = color
+    bsdf.inputs["Metallic"].default_value = metallic
+    bsdf.inputs["Roughness"].default_value = roughness
+    return mat
+
+
+def assign_slots(obj, stone, wood, ash):
+    # Do not materials.clear() — that resets polygon material_index to 0
+    # on this Blender, which would drop wood/ash faces onto stone.
+    mats = obj.data.materials
+    wanted = (stone, wood, ash)
+    for i, mat in enumerate(wanted):
+        if i < len(mats):
+            mats[i] = mat
+        else:
+            mats.append(mat)
+
+
+def world_bbox(obj):
+    corners = [obj.matrix_world @ Vector(c) for c in obj.bound_box]
+    xs = [c.x for c in corners]
+    ys = [c.y for c in corners]
+    zs = [c.z for c in corners]
+    return (min(xs), min(ys), min(zs), max(xs), max(ys), max(zs))
+
+
+def uv_stats(mesh):
+    uv = mesh.uv_layers.active
+    if uv is None:
+        return 0.0, 0.0, 1.0, 1.0, 0, 1.0
+    data = uv.data
+    us = [loop.uv[0] for loop in data]
+    vs = [loop.uv[1] for loop in data]
+    aabbs = []
+    for poly in mesh.polygons:
+        pu = [data[i].uv[0] for i in poly.loop_indices]
+        pv = [data[i].uv[1] for i in poly.loop_indices]
+        aabbs.append((min(pu), min(pv), max(pu), max(pv)))
+    overlap = 0.0
+    for i in range(len(aabbs)):
+        a = aabbs[i]
+        for j in range(i + 1, len(aabbs)):
+            b = aabbs[j]
+            x0 = max(a[0], b[0])
+            y0 = max(a[1], b[1])
+            x1 = min(a[2], b[2])
+            y1 = min(a[3], b[3])
+            overlap += max(0.0, x1 - x0) * max(0.0, y1 - y0)
+    return min(us), min(vs), max(us), max(vs), overlap, len(aabbs)
+
+
+def make_lod(obj, name, ratio, skip_decimate):
+    mesh = obj.data.copy()
+    lod = bpy.data.objects.new(name, mesh)
+    lod.matrix_world = obj.matrix_world.copy()
+    bpy.context.scene.collection.objects.link(lod)
+    if not skip_decimate and 0.0 < ratio < 1.0:
+        mod = lod.modifiers.new("DecimateBudget", "DECIMATE")
+        mod.decimate_type = "COLLAPSE"
+        mod.ratio = ratio
+    return lod
+
+
+def convex_hull_collider(obj, name):
+    # Duplicated from snippets/convex_hull_collider.py (not a package).
+    mesh = bpy.data.meshes.new(name)
+    bm = bmesh.new()
+    try:
+        bm.from_mesh(obj.data)
+        result = bmesh.ops.convex_hull(bm, input=list(bm.verts))
+        interior = result.get("geom_interior") or []
+        unused = result.get("geom_unused") or []
+        if interior:
+            bmesh.ops.delete(bm, geom=interior, context="VERTS")
+        if unused:
+            bmesh.ops.delete(bm, geom=unused, context="VERTS")
+        bm.to_mesh(mesh)
+        mesh.update()
+    finally:
+        bm.free()
+    collider = bpy.data.objects.new(name, mesh)
+    bpy.context.collection.objects.link(collider)
+    collider.matrix_world = obj.matrix_world.copy()
+    return collider
+
+
+def setup_bake_image(obj, target_mat, size=BAKE_RES):
+    # Adapted from snippets/setup_bake_target_image.py — do not replace slots.
+    if not obj.data.uv_layers:
+        return None, None
+    img = bpy.data.images.new("CampfireNrm", size, size, alpha=True, float_buffer=False)
+    img.colorspace_settings.name = "Non-Color"
+    nodes = target_mat.node_tree.nodes
+    tex = nodes.new("ShaderNodeTexImage")
+    tex.image = img
+    nodes.active = tex
+    tex.select = True
+    obj.active_material_index = STONE_IDX
+    return img, tex
+
+
+def bake_normal(high, low):
+    # Duplicated from snippets/bake_normal_high_to_low.py (not a package).
+    scene = bpy.context.scene
+    scene.render.engine = "CYCLES"
+    scene.cycles.device = "CPU"
+    scene.cycles.samples = 1
+    scene.cycles.use_denoising = False
+    for ob in bpy.context.view_layer.objects:
+        ob.select_set(False)
+    high.select_set(True)
+    low.select_set(True)
+    bpy.context.view_layer.objects.active = low
+    return bpy.ops.object.bake(
+        type="NORMAL",
+        use_selected_to_active=True,
+        cage_extrusion=CAGE_EXTRUSION,
+        use_cage=False,
+        normal_space="TANGENT",
+        margin=4,
+        margin_type="ADJACENT_FACES",
+        use_clear=True,
+        target="IMAGE_TEXTURES",
+    )
+
+
+def export_unity(path, objects):
+    # Duplicated from snippets/export_preset_unity.py (not a package).
+    for ob in bpy.context.view_layer.objects:
+        ob.select_set(False)
+    for ob in objects:
+        ob.select_set(True)
+    bpy.context.view_layer.objects.active = objects[0]
+    bpy.ops.export_scene.gltf(
+        filepath=path,
+        use_selection=True,
+        export_yup=True,
+        export_apply=True,
+        export_draco_mesh_compression_enable=False,
+        export_animations=False,
+    )
+
+
+def check(skip_decimate):
+    bpy.ops.wm.read_factory_settings(use_empty=True)
+    low = build_campfire_mesh("CampfireLow", bevel_offset=0.006, bevel_segments=2)
+    high = build_campfire_mesh("CampfireHigh", bevel_offset=0.006, bevel_segments=4)
+    stone = principled("CampfireStone", (0.46, 0.40, 0.34, 1.0), 0.0, 0.72)
+    wood = principled("CampfireWood", (0.14, 0.075, 0.040, 1.0), 0.0, 0.78)
+    ash = principled("CampfireAsh", (0.28, 0.26, 0.24, 1.0), 0.0, 0.90)
+    assign_slots(low, stone, wood, ash)
+    assign_slots(high, stone, wood, ash)
+
+    if low.data is None or len(low.data.polygons) < 6:
+        return fail("campfire mesh did not build", 3), None, None, None, None, None
+
+    base_tris = triangle_count(low.data)
+    mats = [s for s in low.data.materials if s is not None]
+    nmat = len(mats)
+    distinct_mats = len({id(s) for s in mats})
+    idx_counts = {}
+    for poly in low.data.polygons:
+        idx_counts[poly.material_index] = idx_counts.get(poly.material_index, 0) + 1
+    print(f"measured mat_index_counts={idx_counts}")
+    u0, v0, u1, v1, overlap, nfaces = uv_stats(low.data)
+    bb = world_bbox(low)
+    size_x = bb[3] - bb[0]
+    size_y = bb[4] - bb[1]
+    size_z = bb[5] - bb[2]
+
+    img, tex = setup_bake_image(low, stone)
+    if img is None:
+        return fail("campfire has no UV layer", 3), None, None, None, None, None
+    bake_result = bake_normal(high, low)
+
+    lod1 = make_lod(low, "CampfireLOD1", LOD1_TARGET, skip_decimate)
+    lod2 = make_lod(low, "CampfireLOD2", LOD2_TARGET, skip_decimate)
+    bpy.context.view_layer.update()
+    lod1_tris = evaluated_triangle_count(lod1)
+    lod2_tris = evaluated_triangle_count(lod2)
+    r1 = lod1_tris / base_tris if base_tris else 0.0
+    r2 = lod2_tris / base_tris if base_tris else 0.0
+
+    collider_src = build_campfire_mesh(
+        "CampfireColSrc", bevel_offset=0.0, bevel_segments=1
+    )
+    collider = convex_hull_collider(collider_src, "CampfireCollider")
+    bpy.data.objects.remove(collider_src, do_unlink=True)
+    col_tris = triangle_count(collider.data)
+
+    export_path = os.path.join(
+        tempfile.gettempdir(),
+        f"bdt_campfire_{os.getpid()}.glb",
+    )
+    if os.path.exists(export_path):
+        os.remove(export_path)
+    export_unity(export_path, [low, collider])
+    export_size = os.path.getsize(export_path) if os.path.isfile(export_path) else 0
+
+    print(
+        f"blender={tuple(bpy.app.version)} skip_decimate={skip_decimate}"
+    )
+    print(
+        f"measured base_tris={base_tris} lod1_tris={lod1_tris} "
+        f"lod2_tris={lod2_tris} r1={r1:.4f} r2={r2:.4f}"
+    )
+    print(
+        f"measured nmat={nmat} uv=({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f}) "
+        f"overlap={overlap:.6f} nfaces={nfaces}"
+    )
+    print(
+        f"measured bbox=({size_x:.4f},{size_y:.4f},{size_z:.4f}) "
+        f"outer={OUTER_SIZE} zmin={bb[2]:.4f}"
+    )
+    print(
+        f"measured collider_tris={col_tris} bake={bake_result} "
+        f"bake_has_data={img.has_data} export_bytes={export_size}"
+    )
+
+    if not (BASE_TRIS_MIN <= base_tris <= BASE_TRIS_MAX):
+        return fail(
+            f"base tris {base_tris} not in [{BASE_TRIS_MIN}, {BASE_TRIS_MAX}]",
+            4,
+        ), None, None, None, None, None
+    if nmat != MATERIAL_COUNT or distinct_mats != MATERIAL_COUNT:
+        return fail(
+            f"material slots {nmat} distinct {distinct_mats} != {MATERIAL_COUNT}",
+            5,
+        ), None, None, None, None, None
+    if idx_counts.get(WOOD_IDX, 0) < 24:
+        return fail(
+            f"wood log faces {idx_counts.get(WOOD_IDX, 0)} < 24",
+            5,
+        ), None, None, None, None, None
+    if idx_counts.get(ASH_IDX, 0) < 8:
+        return fail(
+            f"ash faces {idx_counts.get(ASH_IDX, 0)} < 8",
+            5,
+        ), None, None, None, None, None
+    if u0 < -UV_EPS or v0 < -UV_EPS or u1 > 1.0 + UV_EPS or v1 > 1.0 + UV_EPS:
+        return fail(
+            f"UVs outside 0..1: ({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f})",
+            6,
+        ), None, None, None, None, None
+    if overlap > UV_OVERLAP_MAX:
+        return fail(
+            f"UV AABB overlap {overlap:.6f} > {UV_OVERLAP_MAX}",
+            7,
+        ), None, None, None, None, None
+    if (
+        abs(size_x - OUTER_SIZE[0]) > BBOX_TOL
+        or abs(size_y - OUTER_SIZE[1]) > BBOX_TOL
+        or abs(size_z - OUTER_SIZE[2]) > BBOX_TOL
+    ):
+        return fail(
+            f"bbox ({size_x:.4f},{size_y:.4f},{size_z:.4f}) "
+            f"off outer {OUTER_SIZE}",
+            8,
+        ), None, None, None, None, None
+    if not (LOD1_RATIO_MIN <= r1 <= LOD1_RATIO_MAX):
+        return fail(
+            f"LOD1 ratio {r1:.4f} not in [{LOD1_RATIO_MIN}, {LOD1_RATIO_MAX}] "
+            "(--skip-decimate is the designed fail)",
+            9,
+        ), None, None, None, None, None
+    if not (LOD2_RATIO_MIN <= r2 <= LOD2_RATIO_MAX):
+        return fail(
+            f"LOD2 ratio {r2:.4f} not in [{LOD2_RATIO_MIN}, {LOD2_RATIO_MAX}]",
+            9,
+        ), None, None, None, None, None
+    if col_tris > COLLIDER_TRIS_MAX:
+        return fail(
+            f"collider tris {col_tris} > {COLLIDER_TRIS_MAX}",
+            11,
+        ), None, None, None, None, None
+    if bake_result != {"FINISHED"} or not img.has_data:
+        return fail(
+            f"bake failed result={bake_result} has_data={img.has_data}",
+            12,
+        ), None, None, None, None, None
+    if export_size <= 0:
+        return fail("export file missing or empty", 13), None, None, None, None, None
+    return 0, low, high, stone, tex, collider
+
+
+def wire_normal(mat, tex):
+    nt = mat.node_tree
+    bsdf = nt.nodes["Principled BSDF"]
+    nrm = nt.nodes.new("ShaderNodeNormalMap")
+    nrm.inputs["Strength"].default_value = 1.0
+    nt.links.new(tex.outputs["Color"], nrm.inputs["Color"])
+    nt.links.new(nrm.outputs["Normal"], bsdf.inputs["Normal"])
+
+
+def render_still(low, stone, tex, path, engine):
+    scene = bpy.context.scene
+    wire_normal(stone, tex)
+    for ob in list(scene.objects):
+        if ob.type == "MESH" and ob != low:
+            ob.hide_render = True
+            ob.hide_viewport = True
+
+    low.rotation_euler.z = math.radians(-36.0)
+    low.rotation_euler.x = math.radians(4.0)
+
+    floor_me = bpy.data.meshes.new("Floor")
+    bm = bmesh.new()
+    try:
+        bmesh.ops.create_grid(bm, x_segments=1, y_segments=1, size=14.0)
+        bm.to_mesh(floor_me)
+    finally:
+        bm.free()
+    fmat = bpy.data.materials.new("Floor")
+    fmat.use_nodes = True
+    fb = fmat.node_tree.nodes["Principled BSDF"]
+    fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
+    fb.inputs["Roughness"].default_value = 0.7
+    floor_me.materials.append(fmat)
+    floor = bpy.data.objects.new("Floor", floor_me)
+    scene.collection.objects.link(floor)
+    wall = bpy.data.objects.new("Wall", floor_me.copy())
+    wall.location = (0.0, 8.5, 0.0)
+    wall.rotation_euler = (math.radians(90), 0.0, 0.0)
+    scene.collection.objects.link(wall)
+
+    world = bpy.data.worlds.new("World")
+    world.use_nodes = True
+    world.node_tree.nodes["Background"].inputs["Color"].default_value = (
+        0.02, 0.021, 0.025, 1.0,
+    )
+    scene.world = world
+
+    def light(name, loc, energy, size, col, rot):
+        ld = bpy.data.lights.new(name, "AREA")
+        ld.energy = energy
+        ld.size = size
+        ld.color = col
+        ob = bpy.data.objects.new(name, ld)
+        ob.location = loc
+        ob.rotation_euler = tuple(math.radians(a) for a in rot)
+        scene.collection.objects.link(ob)
+
+    light("Key", (-3.6, -5.0, 5.8), 680.0, 4.0, (1.0, 0.94, 0.86), (50, 0, -36))
+    light("Fill", (5.0, -3.6, 2.6), 48.0, 8.0, (0.72, 0.82, 1.0), (62, 0, 50))
+    light("Wedge", (2.4, 4.2, 4.1), 640.0, 5.5, (1.0, 0.70, 0.40), (-70, 0, 198))
+
+    cam_data = bpy.data.cameras.new("Cam")
+    cam_data.lens = 50.0
+    cam = bpy.data.objects.new("Cam", cam_data)
+    cam.location = (0.96, -1.33, 0.69)
+    scene.collection.objects.link(cam)
+    aim = bpy.data.objects.new("Aim", None)
+    aim.location = (0.0, 0.0, 0.10)
+    scene.collection.objects.link(aim)
+    con = cam.constraints.new("TRACK_TO")
+    con.target = aim
+    con.track_axis = "TRACK_NEGATIVE_Z"
+    con.up_axis = "UP_Y"
+    scene.camera = cam
+
+    scene.render.engine = "CYCLES" if engine == "cycles" else eevee_engine_id()
+    if engine == "cycles":
+        scene.cycles.samples = 32
+        scene.cycles.device = "CPU"
+    else:
+        try:
+            scene.eevee.taa_render_samples = 64
+        except AttributeError:
+            pass
+    scene.render.resolution_x = 1280
+    scene.render.resolution_y = 720
+    scene.render.image_settings.file_format = (
+        "WEBP" if path.lower().endswith(".webp") else "PNG"
+    )
+    if path.lower().endswith(".webp"):
+        scene.render.image_settings.quality = 90
+    scene.render.filepath = path
+    scene.view_settings.view_transform = "Standard"
+
+    fcode = gallery_framing.check_framing(
+        scene, cam, hero=[low], elements=[low], stage=[floor, wall],
+    )
+    if fcode:
+        return fcode
+    bpy.ops.render.render(write_still=True)
+    if not (os.path.exists(path) and os.path.getsize(path) > 0):
+        return fail("render produced no file", 14)
+    return 0
+
+
+def main():
+    argv = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else []
+    p = argparse.ArgumentParser()
+    p.add_argument("--output", default=None)
+    p.add_argument("--engine", default="eevee", choices=("eevee", "cycles"))
+    p.add_argument(
+        "--skip-decimate",
+        action="store_true",
+        help="falsification: skip the LOD DECIMATE stage",
+    )
+    args = p.parse_args(argv)
+
+    code, low, _high, stone, tex, _col = check(args.skip_decimate)
+    if code:
+        return code
+    if args.output:
+        rcode = render_still(low, stone, tex, os.path.abspath(args.output), args.engine)
+        if rcode:
+            return rcode
+        print(f"rendered still {args.output}")
+    print("campfire OK")
+    return 0
+
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except Exception as e:
+        traceback.print_exc()
+        print(f"FATAL: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+
+ +
+
+ generated from examples/gallery.json + CC-BY-NC-ND-4.0 + exit 0 +
+
+ + + diff --git a/docs/gallery/index.html b/docs/gallery/index.html index 98d5568..0a59254 100644 --- a/docs/gallery/index.html +++ b/docs/gallery/index.html @@ -272,7 +272,7 @@

Examples Gallery

autocomplete="off" spellcheck="false" aria-label="Search examples" /> - 54 examples + 55 examples
@@ -918,6 +918,17 @@

wooden-barrel

View example
+
+ + campfire — A procedural campfire through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract. + +
+

campfire

+

A procedural campfire through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

+

witnesses Recomputed: 7528 tris, three materials with 116 wood and 18 ash faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.964×0.950×0.252 m, LOD ratios in band, convex collider 105 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.

+ View example +
+
diff --git a/showcase/campfire/README.md b/showcase/campfire/README.md new file mode 100644 index 0000000..a92161a --- /dev/null +++ b/showcase/campfire/README.md @@ -0,0 +1,73 @@ +# Campfire + +A showcase piece, not an example. Procedural campfire (flattened cobble +ring, inner stones, ash mound, crossed logs, sticks, charcoal) then the +shipped pipeline: unique-cell UVs, Cycles high-to-low normal bake, LOD +chain, convex collider, Unity glTF export. + +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, not imported as a package). + +## Budgets + +Declared as named constants; every gate **recomputes** from the mesh, +materials, UVs, evaluated LOD, collider, or export file. + +| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) | +| --- | --- | --- | +| Base triangles | 7400–7650 | 7528 / 7528 / 7528 | +| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 | +| LOD2 ratio | 0.10–0.35 of base | 0.2200 / 0.2200 / 0.2200 | +| Materials | exactly 3 distinct, ≥24 wood faces, ≥8 ash faces | 3 slots, 116 wood, 18 ash | +| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 | +| Outer AABB | (0.964, 0.950, 0.252) m ± 0.01 | (0.9641, 0.9495, 0.2521), zmin 0 | +| Collider tris | ≤ 160 | 105 | +| Export | written, size > 0 | 548944 / 548944 / 548936 bytes | + +DECIMATE COLLAPSE triangle counts are **not** guaranteed identical across +series — the gate is a ratio band, not an exact count. This mesh happened +to match on 4.5.11 / 5.1.2 / 5.2.1. Bake pixels are stochastic; the gate +is `has_data` plus operator `FINISHED`, not byte-identity. Construction +uses no RNG. glTF byte size differs by a few bytes across series. + +`--skip-decimate` skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and +exit 9 fires. That is the named budget the falsifier violates. + +## Run + +```bash +blender --background --python campfire.py -- +blender --background --python campfire.py -- --skip-decimate +blender --background --python campfire.py -- --output campfire.png +``` + +Smoke does not pass `--output` or `--skip-decimate`. + +## Exit codes + +File-local. `9` is a valid check code. `10` is reserved for +`gallery_framing.check_framing` on the `--output` path. + +| Code | Meaning | +| --- | --- | +| 0 | Success | +| 1 | Uncaught exception (FATAL wrapper) | +| 2 | argparse / usage | +| 3 | Mesh did not build / no UV layer | +| 4 | Base triangle count outside range | +| 5 | Material count ≠ 3 distinct slots, or wood/ash faces missing | +| 6 | UVs outside 0..1 | +| 7 | UV AABB overlap above tolerance | +| 8 | World AABB off declared outer size | +| 9 | LOD ratio band (`--skip-decimate` lands here) | +| 10 | Framing gate (render path only) | +| 11 | Collider triangle count above ceiling | +| 12 | Bake did not finish or image has no data | +| 13 | Export file missing or empty | +| 14 | `--output` produced no file | diff --git a/showcase/campfire/campfire.py b/showcase/campfire/campfire.py new file mode 100644 index 0000000..d8f2a82 --- /dev/null +++ b/showcase/campfire/campfire.py @@ -0,0 +1,779 @@ +"""Game-ready campfire — a showcase piece, not an example. + +Asserts budget conformance of a procedural campfire after composing +shipped pipeline pieces: bmesh construction, UVs, three materials, +high-to-low normal bake, LOD chain, convex collider, Unity glTF export. + +Budgets are declared below and recomputed from the generated result. +They are not API-contract witnesses. ``--skip-decimate`` skips the LOD +DECIMATE stage so the LOD-ratio budget fails. + +No RNG. Construction is closed-form. DECIMATE COLLAPSE triangle counts +are not byte-identical across Blender versions — the LOD gate is a +ratio band, not an exact count. + + blender --background --python campfire.py -- + blender --background --python campfire.py -- --skip-decimate + blender --background --python campfire.py -- --output campfire.png +""" +import argparse +import math +import os +import sys +import tempfile +import traceback + +import bmesh +import bpy +from mathutils import Euler, Vector + +# Showcase lives at repo-root/showcase/, not under examples/. The framing +# helper is the repo's only shared import and lives next to the examples; +# resolve the repo root so we do not move gallery_framing.py. +_REPO = os.path.abspath( + os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir, os.pardir) +) +sys.path.insert(0, os.path.join(_REPO, "examples")) +sys.dont_write_bytecode = True +import gallery_framing # noqa: E402 + +N_RING = 12 +RING_R = 0.40 +N_INNER = 7 +INNER_R = 0.22 +ASH_R = 0.26 +ASH_H = 0.055 +N_LOGS = 4 +LOG_LEN = 0.50 +LOG_R = 0.040 +N_STICKS = 3 +STICK_LEN = 0.38 +STICK_R = 0.016 +N_COALS = 5 +BBOX_TOL = 0.01 +# Fitted to the generated AABB after locking geometry. Recomputed from bound_box. +OUTER_SIZE = (0.964, 0.950, 0.252) + +BASE_TRIS_MIN = 7400 +BASE_TRIS_MAX = 7650 +LOD1_RATIO_MIN = 0.32 +LOD1_RATIO_MAX = 0.62 +LOD2_RATIO_MIN = 0.10 +LOD2_RATIO_MAX = 0.35 +LOD1_TARGET = 0.50 +LOD2_TARGET = 0.22 +MATERIAL_COUNT = 3 +UV_EPS = 1e-4 +UV_OVERLAP_MAX = 1e-5 +COLLIDER_TRIS_MAX = 160 +BAKE_RES = 256 +CAGE_EXTRUSION = 0.06 + +STONE_IDX = 0 +WOOD_IDX = 1 +ASH_IDX = 2 + + +def eevee_engine_id(): + return "BLENDER_EEVEE" if bpy.app.version >= (5, 0, 0) else "BLENDER_EEVEE_NEXT" + + +def fail(msg, code): + print(f"ERROR: {msg}", file=sys.stderr) + return code + + +def triangle_count(mesh): + mesh.calc_loop_triangles() + return len(mesh.loop_triangles) + + +def evaluated_triangle_count(obj): + # Duplicated from snippets/lod_chain.py / decimate_to_budget.py (not a package). + depsgraph = bpy.context.evaluated_depsgraph_get() + eval_obj = obj.evaluated_get(depsgraph) + eval_mesh = eval_obj.to_mesh() + try: + eval_mesh.calc_loop_triangles() + return len(eval_mesh.loop_triangles) + finally: + eval_obj.to_mesh_clear() + + +def add_box(bm, loc, scale, mat_idx, euler=(0.0, 0.0, 0.0)): + geo = bmesh.ops.create_cube(bm, size=1.0) + verts = geo["verts"] + rot = Euler(euler).to_matrix() + origin = Vector(loc) + for v in verts: + p = Vector((v.co.x * scale[0], v.co.y * scale[1], v.co.z * scale[2])) + v.co = rot @ p + origin + faces = {f for v in verts for f in v.link_faces} + for f in faces: + f.material_index = mat_idx + return verts + + +def add_cobble(bm, loc, scale, mat_idx, euler=(0.0, 0.0, 0.0), lump=0.22): + geo = bmesh.ops.create_icosphere(bm, subdivisions=1, radius=0.5) + verts = list(geo["verts"]) + rot = Euler(euler).to_matrix() + origin = Vector(loc) + for v in verts: + p = Vector((v.co.x * scale[0], v.co.y * scale[1], v.co.z * scale[2])) + h = math.sin(p.x * 19.7 + p.y * 13.3) * math.cos(p.z * 17.1 + p.x * 7.9) + h += 0.40 * math.sin(p.y * 31.0 + p.z * 23.0) + h = max(-0.80, min(0.80, h)) + p = p * (1.0 + lump * h) + v.co = rot @ p + origin + faces = {f for v in verts for f in v.link_faces} + for f in faces: + f.material_index = mat_idx + return verts + + +def add_cone(bm, loc, radius1, radius2, depth, segments, mat_idx, euler=(0.0, 0.0, 0.0)): + geo = bmesh.ops.create_cone( + bm, + cap_ends=True, + cap_tris=False, + segments=segments, + radius1=radius1, + radius2=radius2, + depth=depth, + ) + verts = geo["verts"] + rot = Euler(euler).to_matrix() + origin = Vector(loc) + for v in verts: + v.co = rot @ v.co + origin + faces = {f for v in verts for f in v.link_faces} + for f in faces: + f.material_index = mat_idx + return verts + + +def add_cylinder(bm, loc, radius, depth, segments, mat_idx, euler=(0.0, 0.0, 0.0)): + return add_cone(bm, loc, radius, radius, depth, segments, mat_idx, euler=euler) + + +def pack_uvs(bm, margin=0.08): + uv = bm.loops.layers.uv.new("UVMap") + faces = list(bm.faces) + n = len(faces) + cols = max(1, math.ceil(math.sqrt(n))) + rows = max(1, math.ceil(n / cols)) + cell_w = 1.0 / cols + cell_h = 1.0 / rows + pad_u = margin * cell_w * 0.5 + pad_v = margin * cell_h * 0.5 + usable_w = cell_w - 2.0 * pad_u + usable_h = cell_h - 2.0 * pad_v + for i, face in enumerate(faces): + col = i % cols + row = i // cols + nrm = face.normal + ax = abs(nrm.x) + ay = abs(nrm.y) + az = abs(nrm.z) + coords = [] + for loop in face.loops: + co = loop.vert.co + if az >= ax and az >= ay: + coords.append((co.x, co.y)) + elif ax >= ay: + coords.append((co.y, co.z)) + else: + coords.append((co.x, co.z)) + xs = [c[0] for c in coords] + ys = [c[1] for c in coords] + minx, maxx = min(xs), max(xs) + miny, maxy = min(ys), max(ys) + dx = max(maxx - minx, 1e-8) + dy = max(maxy - miny, 1e-8) + origin_u = col * cell_w + pad_u + origin_v = row * cell_h + pad_v + for loop, (x, y) in zip(face.loops, coords): + loop[uv].uv = ( + origin_u + (x - minx) / dx * usable_w, + origin_v + (y - miny) / dy * usable_h, + ) + + +def _stone_size(i, base_xy, base_z, k): + sx = base_xy[0] + 0.035 * abs(math.sin(i * 2.17 + k)) + sy = base_xy[1] + 0.028 * abs(math.cos(i * 1.73 + k * 0.7)) + sz = base_z + 0.038 * abs(math.sin(i * 1.11 + k * 1.3)) + return sx, sy, sz + + +def build_campfire_mesh(name, bevel_offset, bevel_segments): + bm = bmesh.new() + bevel_verts = [] + ash_faces = set() + wood_faces = set() + try: + for i in range(N_RING): + ang = 2.0 * math.pi * i / N_RING + sx, sy, sz = _stone_size(i, (0.175, 0.138), 0.070, 0.2) + r = RING_R + 0.028 * math.sin(i * 1.9) + loc = (r * math.cos(ang), r * math.sin(ang), sz / 2.0) + tilt = ( + math.radians(18.0 * math.sin(i * 0.7)), + math.radians(14.0 * math.cos(i * 1.3)), + ang + math.radians(22.0 * math.sin(i * 1.1)), + ) + bevel_verts.extend( + add_cobble(bm, loc, (sx, sy, sz), STONE_IDX, euler=tilt, lump=0.24) + ) + + for i in range(N_INNER): + ang = 2.0 * math.pi * i / N_INNER + 0.31 + sx, sy, sz = _stone_size(i, (0.100, 0.082), 0.048, 1.4) + r = INNER_R + 0.018 * math.cos(i * 1.4) + loc = (r * math.cos(ang), r * math.sin(ang), sz / 2.0) + tilt = ( + math.radians(12.0 * math.cos(i * 0.9)), + math.radians(10.0 * math.sin(i * 1.5)), + ang + 0.4, + ) + bevel_verts.extend( + add_cobble(bm, loc, (sx, sy, sz), STONE_IDX, euler=tilt, lump=0.20) + ) + + before = set(bm.faces) + add_cone( + bm, + (0.0, 0.0, ASH_H / 2.0), + ASH_R, + 0.055, + ASH_H, + 16, + ASH_IDX, + ) + ash_faces.update(set(bm.faces) - before) + + for i in range(N_LOGS): + yaw = i * (math.pi / 2.0) + math.radians(18.0) + loc = ( + 0.045 * math.cos(yaw + math.pi / 4.0), + 0.045 * math.sin(yaw + math.pi / 4.0), + LOG_R + 0.020 + 0.012 * (i % 2), + ) + before = set(bm.faces) + verts = add_cylinder( + bm, + loc, + LOG_R * (1.0 - 0.08 * (i % 2)), + LOG_LEN, + 12, + WOOD_IDX, + euler=(math.pi / 2.0, 0.0, yaw), + ) + bevel_verts.extend(verts) + wood_faces.update(set(bm.faces) - before) + + for i in range(N_STICKS): + yaw = i * (2.0 * math.pi / N_STICKS) + 0.55 + pitch = math.radians(32.0 + 6.0 * math.sin(i * 1.7)) + loc = ( + 0.07 * math.cos(yaw), + 0.07 * math.sin(yaw), + 0.055 + STICK_R, + ) + before = set(bm.faces) + verts = add_cylinder( + bm, + loc, + STICK_R, + STICK_LEN, + 8, + WOOD_IDX, + euler=(math.pi / 2.0 - pitch, 0.0, yaw), + ) + bevel_verts.extend(verts) + wood_faces.update(set(bm.faces) - before) + + for i in range(N_COALS): + ang = 2.0 * math.pi * i / N_COALS + 0.2 + r = 0.07 + 0.025 * (i % 2) + sz = 0.028 + 0.010 * abs(math.sin(i * 2.2)) + loc = (r * math.cos(ang), r * math.sin(ang), ASH_H * 0.55 + sz / 2.0) + before = set(bm.faces) + verts = add_box( + bm, + loc, + (0.040, 0.028, sz), + WOOD_IDX, + euler=(0.0, 0.0, ang), + ) + bevel_verts.extend(verts) + wood_faces.update(set(bm.faces) - before) + + if bevel_offset > 0.0: + edges = list({e for v in bevel_verts for e in v.link_edges}) + bmesh.ops.bevel( + bm, + geom=edges, + offset=bevel_offset, + segments=bevel_segments, + profile=0.5, + affect="EDGES", + clamp_overlap=True, + ) + + zmin = min(v.co.z for v in bm.verts) + if zmin != 0.0: + for v in bm.verts: + v.co.z -= zmin + + pack_uvs(bm) + bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces)) + for face in bm.faces: + face.smooth = True + for edge in bm.edges: + edge.smooth = True + if edge.is_manifold and len(edge.link_faces) == 2: + if edge.calc_face_angle() > math.radians(35.0): + edge.smooth = False + for f in ash_faces: + if f.is_valid: + f.material_index = ASH_IDX + for f in wood_faces: + if f.is_valid: + f.material_index = WOOD_IDX + me = bpy.data.meshes.new(name) + bm.to_mesh(me) + me.update() + finally: + bm.free() + obj = bpy.data.objects.new(name, me) + bpy.context.collection.objects.link(obj) + return obj + + +def principled(name, color, metallic, roughness): + mat = bpy.data.materials.new(name) + mat.use_nodes = True + bsdf = mat.node_tree.nodes["Principled BSDF"] + bsdf.inputs["Base Color"].default_value = color + bsdf.inputs["Metallic"].default_value = metallic + bsdf.inputs["Roughness"].default_value = roughness + return mat + + +def assign_slots(obj, stone, wood, ash): + # Do not materials.clear() — that resets polygon material_index to 0 + # on this Blender, which would drop wood/ash faces onto stone. + mats = obj.data.materials + wanted = (stone, wood, ash) + for i, mat in enumerate(wanted): + if i < len(mats): + mats[i] = mat + else: + mats.append(mat) + + +def world_bbox(obj): + corners = [obj.matrix_world @ Vector(c) for c in obj.bound_box] + xs = [c.x for c in corners] + ys = [c.y for c in corners] + zs = [c.z for c in corners] + return (min(xs), min(ys), min(zs), max(xs), max(ys), max(zs)) + + +def uv_stats(mesh): + uv = mesh.uv_layers.active + if uv is None: + return 0.0, 0.0, 1.0, 1.0, 0, 1.0 + data = uv.data + us = [loop.uv[0] for loop in data] + vs = [loop.uv[1] for loop in data] + aabbs = [] + for poly in mesh.polygons: + pu = [data[i].uv[0] for i in poly.loop_indices] + pv = [data[i].uv[1] for i in poly.loop_indices] + aabbs.append((min(pu), min(pv), max(pu), max(pv))) + overlap = 0.0 + for i in range(len(aabbs)): + a = aabbs[i] + for j in range(i + 1, len(aabbs)): + b = aabbs[j] + x0 = max(a[0], b[0]) + y0 = max(a[1], b[1]) + x1 = min(a[2], b[2]) + y1 = min(a[3], b[3]) + overlap += max(0.0, x1 - x0) * max(0.0, y1 - y0) + return min(us), min(vs), max(us), max(vs), overlap, len(aabbs) + + +def make_lod(obj, name, ratio, skip_decimate): + mesh = obj.data.copy() + lod = bpy.data.objects.new(name, mesh) + lod.matrix_world = obj.matrix_world.copy() + bpy.context.scene.collection.objects.link(lod) + if not skip_decimate and 0.0 < ratio < 1.0: + mod = lod.modifiers.new("DecimateBudget", "DECIMATE") + mod.decimate_type = "COLLAPSE" + mod.ratio = ratio + return lod + + +def convex_hull_collider(obj, name): + # Duplicated from snippets/convex_hull_collider.py (not a package). + mesh = bpy.data.meshes.new(name) + bm = bmesh.new() + try: + bm.from_mesh(obj.data) + result = bmesh.ops.convex_hull(bm, input=list(bm.verts)) + interior = result.get("geom_interior") or [] + unused = result.get("geom_unused") or [] + if interior: + bmesh.ops.delete(bm, geom=interior, context="VERTS") + if unused: + bmesh.ops.delete(bm, geom=unused, context="VERTS") + bm.to_mesh(mesh) + mesh.update() + finally: + bm.free() + collider = bpy.data.objects.new(name, mesh) + bpy.context.collection.objects.link(collider) + collider.matrix_world = obj.matrix_world.copy() + return collider + + +def setup_bake_image(obj, target_mat, size=BAKE_RES): + # Adapted from snippets/setup_bake_target_image.py — do not replace slots. + if not obj.data.uv_layers: + return None, None + img = bpy.data.images.new("CampfireNrm", size, size, alpha=True, float_buffer=False) + img.colorspace_settings.name = "Non-Color" + nodes = target_mat.node_tree.nodes + tex = nodes.new("ShaderNodeTexImage") + tex.image = img + nodes.active = tex + tex.select = True + obj.active_material_index = STONE_IDX + return img, tex + + +def bake_normal(high, low): + # Duplicated from snippets/bake_normal_high_to_low.py (not a package). + scene = bpy.context.scene + scene.render.engine = "CYCLES" + scene.cycles.device = "CPU" + scene.cycles.samples = 1 + scene.cycles.use_denoising = False + for ob in bpy.context.view_layer.objects: + ob.select_set(False) + high.select_set(True) + low.select_set(True) + bpy.context.view_layer.objects.active = low + return bpy.ops.object.bake( + type="NORMAL", + use_selected_to_active=True, + cage_extrusion=CAGE_EXTRUSION, + use_cage=False, + normal_space="TANGENT", + margin=4, + margin_type="ADJACENT_FACES", + use_clear=True, + target="IMAGE_TEXTURES", + ) + + +def export_unity(path, objects): + # Duplicated from snippets/export_preset_unity.py (not a package). + for ob in bpy.context.view_layer.objects: + ob.select_set(False) + for ob in objects: + ob.select_set(True) + bpy.context.view_layer.objects.active = objects[0] + bpy.ops.export_scene.gltf( + filepath=path, + use_selection=True, + export_yup=True, + export_apply=True, + export_draco_mesh_compression_enable=False, + export_animations=False, + ) + + +def check(skip_decimate): + bpy.ops.wm.read_factory_settings(use_empty=True) + low = build_campfire_mesh("CampfireLow", bevel_offset=0.006, bevel_segments=2) + high = build_campfire_mesh("CampfireHigh", bevel_offset=0.006, bevel_segments=4) + stone = principled("CampfireStone", (0.46, 0.40, 0.34, 1.0), 0.0, 0.72) + wood = principled("CampfireWood", (0.14, 0.075, 0.040, 1.0), 0.0, 0.78) + ash = principled("CampfireAsh", (0.28, 0.26, 0.24, 1.0), 0.0, 0.90) + assign_slots(low, stone, wood, ash) + assign_slots(high, stone, wood, ash) + + if low.data is None or len(low.data.polygons) < 6: + return fail("campfire mesh did not build", 3), None, None, None, None, None + + base_tris = triangle_count(low.data) + mats = [s for s in low.data.materials if s is not None] + nmat = len(mats) + distinct_mats = len({id(s) for s in mats}) + idx_counts = {} + for poly in low.data.polygons: + idx_counts[poly.material_index] = idx_counts.get(poly.material_index, 0) + 1 + print(f"measured mat_index_counts={idx_counts}") + u0, v0, u1, v1, overlap, nfaces = uv_stats(low.data) + bb = world_bbox(low) + size_x = bb[3] - bb[0] + size_y = bb[4] - bb[1] + size_z = bb[5] - bb[2] + + img, tex = setup_bake_image(low, stone) + if img is None: + return fail("campfire has no UV layer", 3), None, None, None, None, None + bake_result = bake_normal(high, low) + + lod1 = make_lod(low, "CampfireLOD1", LOD1_TARGET, skip_decimate) + lod2 = make_lod(low, "CampfireLOD2", LOD2_TARGET, skip_decimate) + bpy.context.view_layer.update() + lod1_tris = evaluated_triangle_count(lod1) + lod2_tris = evaluated_triangle_count(lod2) + r1 = lod1_tris / base_tris if base_tris else 0.0 + r2 = lod2_tris / base_tris if base_tris else 0.0 + + collider_src = build_campfire_mesh( + "CampfireColSrc", bevel_offset=0.0, bevel_segments=1 + ) + collider = convex_hull_collider(collider_src, "CampfireCollider") + bpy.data.objects.remove(collider_src, do_unlink=True) + col_tris = triangle_count(collider.data) + + export_path = os.path.join( + tempfile.gettempdir(), + f"bdt_campfire_{os.getpid()}.glb", + ) + if os.path.exists(export_path): + os.remove(export_path) + export_unity(export_path, [low, collider]) + export_size = os.path.getsize(export_path) if os.path.isfile(export_path) else 0 + + print( + f"blender={tuple(bpy.app.version)} skip_decimate={skip_decimate}" + ) + print( + f"measured base_tris={base_tris} lod1_tris={lod1_tris} " + f"lod2_tris={lod2_tris} r1={r1:.4f} r2={r2:.4f}" + ) + print( + f"measured nmat={nmat} uv=({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f}) " + f"overlap={overlap:.6f} nfaces={nfaces}" + ) + print( + f"measured bbox=({size_x:.4f},{size_y:.4f},{size_z:.4f}) " + f"outer={OUTER_SIZE} zmin={bb[2]:.4f}" + ) + print( + f"measured collider_tris={col_tris} bake={bake_result} " + f"bake_has_data={img.has_data} export_bytes={export_size}" + ) + + if not (BASE_TRIS_MIN <= base_tris <= BASE_TRIS_MAX): + return fail( + f"base tris {base_tris} not in [{BASE_TRIS_MIN}, {BASE_TRIS_MAX}]", + 4, + ), None, None, None, None, None + if nmat != MATERIAL_COUNT or distinct_mats != MATERIAL_COUNT: + return fail( + f"material slots {nmat} distinct {distinct_mats} != {MATERIAL_COUNT}", + 5, + ), None, None, None, None, None + if idx_counts.get(WOOD_IDX, 0) < 24: + return fail( + f"wood log faces {idx_counts.get(WOOD_IDX, 0)} < 24", + 5, + ), None, None, None, None, None + if idx_counts.get(ASH_IDX, 0) < 8: + return fail( + f"ash faces {idx_counts.get(ASH_IDX, 0)} < 8", + 5, + ), None, None, None, None, None + if u0 < -UV_EPS or v0 < -UV_EPS or u1 > 1.0 + UV_EPS or v1 > 1.0 + UV_EPS: + return fail( + f"UVs outside 0..1: ({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f})", + 6, + ), None, None, None, None, None + if overlap > UV_OVERLAP_MAX: + return fail( + f"UV AABB overlap {overlap:.6f} > {UV_OVERLAP_MAX}", + 7, + ), None, None, None, None, None + if ( + abs(size_x - OUTER_SIZE[0]) > BBOX_TOL + or abs(size_y - OUTER_SIZE[1]) > BBOX_TOL + or abs(size_z - OUTER_SIZE[2]) > BBOX_TOL + ): + return fail( + f"bbox ({size_x:.4f},{size_y:.4f},{size_z:.4f}) " + f"off outer {OUTER_SIZE}", + 8, + ), None, None, None, None, None + if not (LOD1_RATIO_MIN <= r1 <= LOD1_RATIO_MAX): + return fail( + f"LOD1 ratio {r1:.4f} not in [{LOD1_RATIO_MIN}, {LOD1_RATIO_MAX}] " + "(--skip-decimate is the designed fail)", + 9, + ), None, None, None, None, None + if not (LOD2_RATIO_MIN <= r2 <= LOD2_RATIO_MAX): + return fail( + f"LOD2 ratio {r2:.4f} not in [{LOD2_RATIO_MIN}, {LOD2_RATIO_MAX}]", + 9, + ), None, None, None, None, None + if col_tris > COLLIDER_TRIS_MAX: + return fail( + f"collider tris {col_tris} > {COLLIDER_TRIS_MAX}", + 11, + ), None, None, None, None, None + if bake_result != {"FINISHED"} or not img.has_data: + return fail( + f"bake failed result={bake_result} has_data={img.has_data}", + 12, + ), None, None, None, None, None + if export_size <= 0: + return fail("export file missing or empty", 13), None, None, None, None, None + return 0, low, high, stone, tex, collider + + +def wire_normal(mat, tex): + nt = mat.node_tree + bsdf = nt.nodes["Principled BSDF"] + nrm = nt.nodes.new("ShaderNodeNormalMap") + nrm.inputs["Strength"].default_value = 1.0 + nt.links.new(tex.outputs["Color"], nrm.inputs["Color"]) + nt.links.new(nrm.outputs["Normal"], bsdf.inputs["Normal"]) + + +def render_still(low, stone, tex, path, engine): + scene = bpy.context.scene + wire_normal(stone, tex) + for ob in list(scene.objects): + if ob.type == "MESH" and ob != low: + ob.hide_render = True + ob.hide_viewport = True + + low.rotation_euler.z = math.radians(-36.0) + low.rotation_euler.x = math.radians(4.0) + + floor_me = bpy.data.meshes.new("Floor") + bm = bmesh.new() + try: + bmesh.ops.create_grid(bm, x_segments=1, y_segments=1, size=14.0) + bm.to_mesh(floor_me) + finally: + bm.free() + fmat = bpy.data.materials.new("Floor") + fmat.use_nodes = True + fb = fmat.node_tree.nodes["Principled BSDF"] + fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0) + fb.inputs["Roughness"].default_value = 0.7 + floor_me.materials.append(fmat) + floor = bpy.data.objects.new("Floor", floor_me) + scene.collection.objects.link(floor) + wall = bpy.data.objects.new("Wall", floor_me.copy()) + wall.location = (0.0, 8.5, 0.0) + wall.rotation_euler = (math.radians(90), 0.0, 0.0) + scene.collection.objects.link(wall) + + world = bpy.data.worlds.new("World") + world.use_nodes = True + world.node_tree.nodes["Background"].inputs["Color"].default_value = ( + 0.02, 0.021, 0.025, 1.0, + ) + scene.world = world + + def light(name, loc, energy, size, col, rot): + ld = bpy.data.lights.new(name, "AREA") + ld.energy = energy + ld.size = size + ld.color = col + ob = bpy.data.objects.new(name, ld) + ob.location = loc + ob.rotation_euler = tuple(math.radians(a) for a in rot) + scene.collection.objects.link(ob) + + light("Key", (-3.6, -5.0, 5.8), 680.0, 4.0, (1.0, 0.94, 0.86), (50, 0, -36)) + light("Fill", (5.0, -3.6, 2.6), 48.0, 8.0, (0.72, 0.82, 1.0), (62, 0, 50)) + light("Wedge", (2.4, 4.2, 4.1), 640.0, 5.5, (1.0, 0.70, 0.40), (-70, 0, 198)) + + cam_data = bpy.data.cameras.new("Cam") + cam_data.lens = 50.0 + cam = bpy.data.objects.new("Cam", cam_data) + cam.location = (0.96, -1.33, 0.69) + scene.collection.objects.link(cam) + aim = bpy.data.objects.new("Aim", None) + aim.location = (0.0, 0.0, 0.10) + scene.collection.objects.link(aim) + con = cam.constraints.new("TRACK_TO") + con.target = aim + con.track_axis = "TRACK_NEGATIVE_Z" + con.up_axis = "UP_Y" + scene.camera = cam + + scene.render.engine = "CYCLES" if engine == "cycles" else eevee_engine_id() + if engine == "cycles": + scene.cycles.samples = 32 + scene.cycles.device = "CPU" + else: + try: + scene.eevee.taa_render_samples = 64 + except AttributeError: + pass + scene.render.resolution_x = 1280 + scene.render.resolution_y = 720 + scene.render.image_settings.file_format = ( + "WEBP" if path.lower().endswith(".webp") else "PNG" + ) + if path.lower().endswith(".webp"): + scene.render.image_settings.quality = 90 + scene.render.filepath = path + scene.view_settings.view_transform = "Standard" + + fcode = gallery_framing.check_framing( + scene, cam, hero=[low], elements=[low], stage=[floor, wall], + ) + if fcode: + return fcode + bpy.ops.render.render(write_still=True) + if not (os.path.exists(path) and os.path.getsize(path) > 0): + return fail("render produced no file", 14) + return 0 + + +def main(): + argv = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else [] + p = argparse.ArgumentParser() + p.add_argument("--output", default=None) + p.add_argument("--engine", default="eevee", choices=("eevee", "cycles")) + p.add_argument( + "--skip-decimate", + action="store_true", + help="falsification: skip the LOD DECIMATE stage", + ) + args = p.parse_args(argv) + + code, low, _high, stone, tex, _col = check(args.skip_decimate) + if code: + return code + if args.output: + rcode = render_still(low, stone, tex, os.path.abspath(args.output), args.engine) + if rcode: + return rcode + print(f"rendered still {args.output}") + print("campfire OK") + return 0 + + +if __name__ == "__main__": + try: + sys.exit(main()) + except Exception as e: + traceback.print_exc() + print(f"FATAL: {e}", file=sys.stderr) + sys.exit(1) diff --git a/showcase/campfire/preview.webp b/showcase/campfire/preview.webp new file mode 100644 index 0000000000000000000000000000000000000000..22249ea6bc2af4b98e8263cbd65ad7ea1ca17d92 GIT binary patch literal 31906 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 literal 0 HcmV?d00001 diff --git a/showcase/gallery.json b/showcase/gallery.json index eadb323..bcec209 100644 --- a/showcase/gallery.json +++ b/showcase/gallery.json @@ -40,6 +40,18 @@ "mesh", "export" ] + }, + { + "name": "campfire", + "dir": "showcase/campfire", + "teaches": "A procedural campfire through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.", + "witnessesFix": "Recomputed: 7528 tris, three materials with 116 wood and 18 ash faces, UVs in 0..1 with zero AABB overlap, outer AABB 0.964×0.950×0.252 m, LOD ratios in band, convex collider 105 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.", + "hero": "docs/gallery/assets/campfire-hero.webp", + "preview": "showcase/campfire/preview.webp", + "tags": [ + "mesh", + "export" + ] } ] } diff --git a/tests/smoke/catalog.json b/tests/smoke/catalog.json index bc9124b..e6ea6c0 100644 --- a/tests/smoke/catalog.json +++ b/tests/smoke/catalog.json @@ -76,5 +76,6 @@ {"name": "mesh-automasking-settings", "script": "examples/mesh-automasking-settings/mesh_automasking_settings.py"}, {"name": "shipping-crate", "script": "showcase/shipping-crate/shipping_crate.py"}, {"name": "stone-well", "script": "showcase/stone-well/stone_well.py"}, - {"name": "wooden-barrel", "script": "showcase/wooden-barrel/wooden_barrel.py"} + {"name": "wooden-barrel", "script": "showcase/wooden-barrel/wooden_barrel.py"}, + {"name": "campfire", "script": "showcase/campfire/campfire.py"} ] From e07fd316f440906f855fa00c3375bfc47b8cd206 Mon Sep 17 00:00:00 2001 From: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Date: Sun, 13 Sep 2026 15:13:42 -0400 Subject: [PATCH 2/2] feat: add market-stall as a fifth showcase piece Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com> Co-authored-by: Cursor --- .cursor-plugin/plugin.json | 3 +- AGENTS.md | 2 +- CLAUDE.md | 2 +- README.md | 7 +- ROADMAP.md | 1 + docs/gallery/assets/market-stall-hero.webp | Bin 0 -> 29232 bytes docs/gallery/index.html | 13 +- docs/gallery/market-stall/index.html | 1108 ++++++++++++++++++++ showcase/gallery.json | 12 + showcase/market-stall/README.md | 73 ++ showcase/market-stall/market_stall.py | 784 ++++++++++++++ showcase/market-stall/preview.webp | Bin 0 -> 27318 bytes tests/smoke/catalog.json | 3 +- 13 files changed, 2001 insertions(+), 7 deletions(-) create mode 100644 docs/gallery/assets/market-stall-hero.webp create mode 100644 docs/gallery/market-stall/index.html create mode 100644 showcase/market-stall/README.md create mode 100644 showcase/market-stall/market_stall.py create mode 100644 showcase/market-stall/preview.webp diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 4bea0e7..83a9c9b 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -141,6 +141,7 @@ "showcase/shipping-crate", "showcase/stone-well", "showcase/wooden-barrel", - "showcase/campfire" + "showcase/campfire", + "showcase/market-stall" ] } diff --git a/AGENTS.md b/AGENTS.md index f33c126..d837213 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,7 +21,7 @@ classifies it as a `cursor-plugin`. This is content the AI loads when the user asks Blender questions or works on Blender add-ons in Cursor or Claude Code. The content base is 16 skills, 9 rules, 3 templates, 27 snippets, 59 -examples, and 4 showcase pieces (counts are CI-enforced against README.md +examples, and 5 showcase pieces (counts are CI-enforced against README.md and the manifest). The full inventory tables and per-item purposes live in `CLAUDE.md`. Example anatomy and authoring rules: copy `examples/bmesh-gear/`; showcase conventions: `showcase/README.md`. The render look is specified diff --git a/CLAUDE.md b/CLAUDE.md index c740f45..6b404d0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -22,7 +22,7 @@ rules/.mdc - Anti-pattern rules, 9 total templates// - Starter projects, 3 total snippets/.py - Standalone code patterns, 27 total examples// - Runnable smoke-gated examples, 59 total (+ gallery.json) -showcase// - Budget-conformance props, 4 pieces (sibling of examples/; see showcase/README.md) +showcase// - Budget-conformance props, 5 pieces (sibling of examples/; see showcase/README.md) scripts/build_gallery.py - Regenerates docs/gallery/ from examples/gallery.json + showcase/gallery.json scripts/site/ - Vendored landing-page build (Jinja2) docs/gallery/ - Committed generated gallery pages + hero renders diff --git a/README.md b/README.md index 86c661d..4b93baa 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@

- 16 skills  •  9 rules  •  3 templates  •  27 snippets  •  59 examples  •  4 showcase pieces + 16 skills  •  9 rules  •  3 templates  •  27 snippets  •  59 examples  •  5 showcase pieces

@@ -37,7 +37,7 @@ ## Overview -This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 59 examples, and 4 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable. +This repository ships **16 skills, 9 rules, 3 templates, 27 snippets, 59 examples, and 5 showcase pieces** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable. The content is consumed by AI coding agents (Cursor, Claude Code, any MCP-capable client) when working on Blender add-ons, geometry nodes scripts, batch pipelines, or animation tooling. There is no build step. Edit the markdown and Python files directly. @@ -79,6 +79,7 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show Stone well: a round brick well with a shingled pyramid roof on posts, rope and bucket, on a dark studio floor Wooden barrel: a staved barrel with iron hoops on a dark studio floor, warm wedge on the back wall Campfire: a stone ring, crossed logs, and ash mound on a dark studio floor, warm wedge on the back wall +Market stall: a timber frame with a striped awning and counter on a dark studio floor, warm wedge on the back wall [`shipping-crate`](showcase/shipping-crate/) — procedural crate through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets. Falsifier `--skip-decimate` exits 9. @@ -88,6 +89,8 @@ Budget-conformance props. Not examples. Conventions: [`showcase/README.md`](show [`campfire`](showcase/campfire/) — procedural cobble ring, logs, and ash through the same pipeline. Falsifier `--skip-decimate` exits 9. +[`market-stall`](showcase/market-stall/) — procedural timber stall with striped awning and counter through the same pipeline. Falsifier `--skip-decimate` exits 9. + ## Examples Runnable, smoke-gated demos live in [`examples/`](examples/) — each is executed headless on diff --git a/ROADMAP.md b/ROADMAP.md index a45ede9..33aad50 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -110,6 +110,7 @@ Not committed; target list for the next content version. (v0.3.0 shipped the smo - ~~Round stone well showcase~~ **SHIPPED** as `showcase/stone-well/` — running-bond brick well, shingled pyramid roof, windlass/rope/bucket; `--skip-decimate` exits 9 on the LOD1 ratio band - ~~Wooden barrel showcase~~ **SHIPPED** as `showcase/wooden-barrel/` — bulged staves, four iron hoops, lid heads; `--skip-decimate` exits 9 on the LOD1 ratio band - ~~Campfire showcase~~ **SHIPPED** as `showcase/campfire/` — cobble ring, ash mound, crossed logs; `--skip-decimate` exits 9 on the LOD1 ratio band +- ~~Market stall showcase~~ **SHIPPED** as `showcase/market-stall/` — timber frame, striped awning, counter; `--skip-decimate` exits 9 on the LOD1 ratio band - Procedural terrain or landscape showcase using Geometry Nodes scatter - Hero prop with a more complex silhouette (lantern or treasure chest) as a second showcase piece - Small modular kit showcase on recognizable geometry (`modular-kit-snap` contract) diff --git a/docs/gallery/assets/market-stall-hero.webp b/docs/gallery/assets/market-stall-hero.webp new file mode 100644 index 0000000000000000000000000000000000000000..46d7fad0f765fc016e72677d13d4196d45335c94 GIT binary patch literal 29232 zcmV(;K-<4kNk&E}asU8VMM6+kP&gnQasU9(Vgj83DgXu00zNSqh(sbGi5?^n0fJfE zzVL2OX$H4@?q*R4MY;R^YvB9)YJg9}Uf05@u#bhaZ|~-pho64>c@+8gu8))F?48=_ zk>_Km9XCAD=b_DqMgpJyM}DlM@~_~3nf&uBpCA=j(*8NnqHJmT`;h3Zg} zh@NqHrLF1JXA%+P(Zh z%|RM6(k{eeALC@Nh=1=AhYb4iRUs`tANkKVuB*xlocsU0Sx2C`m*^ zNHtI;R`OzF((M2kSC8+0H4HI2G^0>yg>C?+4xPpv=z_uob++@@ryN5Sm>gXN4pc|AXf6|_xq9u3Gg#}*j97?{tSM2?lnt zsiYll=wv0$XpyAMo(a&H*YBJiOMSF03{f<-WMvAN%%*yIzL7ba>cvzLh)?! zD)9h8r2W0+I!aAVFdV`mR+8?1Q3brHZr0O}u~3dBwcZd6r4YZB>>$AS$rjDjG5#`6 zWPn_+sj>#VU{df_CeC0V86^;?Op+3Q3(=2+3MVfH#Ax)S{V>?XxBO%tld+s_5&2w> z>#FjAIp8jnz|1_Ksr`GNCP&YdVlIoOqg2Ju9*_7F^S#3Ahs%$e#nM2HIJUO~F7v6_ zRwZ}p^dYf@j{YH)F4 zAx{P9t}7uQUZa(y9P)S5c?gMD*$Y%qO4`6<5eCDL#bG0!Ga(TsFU5sm)2&UdFHM0( z&aWjnsFKa(JL*(cnUdj1v6$vYQhB~IC@-qbE^+*V|^Akm5N*D$Gi+|q!oFS}y!}1Ef>zE~;5Bt;5@h%X)ZS8F4YZ-;tsD+DSGpq%}&&VC>?i0;- z+<1qO)R00T+{aS-RdRfS6V&x+6iz$b6WAXfcZ@E%^zREsayK|wbRG1X!1SEyD*W+n zZjfgS787lR)2?+4jy;_*^N=W;i;t$a9XHW+!hbv{88!TqEai|%K3M5xe^A!iSziHK z*cUJHq!a|~|KDS!-m~2b+w5fcm*)(`!&yJ)LGoJ;(!|GluU}Qj9v*2NRxC{I!B7VaU9pR{TQ z;7cVtp@v|j-zcmaZIy`8e2ApHWX%VzcyY>bo1PjJt=^T+Tg5APrHdwbr}s!RS#

    =O-j7r1X-?A&lBG*<9yj@S$X^^y>4QUy$TEox`2LN=GT0fM^f2r zd7VR9rc++k8&CYo#Xs#_06Bx88Q!EjjlVA84?bE0#>(rnR#K%BS3&tgapZ(Y7S{1Hua`~XYY!~kT}$G)pdFK5rbXHE8=J1E zcVgq_mXVW&&`4MP2?+@EMnOV7V^LB`u5w%ut0r&L&JtFfRc+=qU2n3T$7g7`xJ5)L z1E&kjQE7zbcZ1ml_AaNjyiCVoT(Nm8piAj}CpvRk>m3XsZu-lKLDd%3-TO#xUG#GD zxPy7;?H+6n%2PDcz@xdXkV)-nCtrUMKAyv)|iorr>#1i)`GF= zGPK60D%P-O{29$xvcKIszlnJ2dROk$BGzdDaE9z)4A8Y2NyVU8eu$IjFi4j*6FaV+}?UAbaw ziPyUrUa+#wY%`LkK9&7Sjen63NW}rhA|5p`{85F1Evz46l1PrJkQ;p=cra0VE(pHB z7&Zub3@=v=K@v;x#z3K{;ZwUd!033vTx(WC54(SaVQsIPZu~hi9UNps7yLkJ^p8#d z=<{Tn6!V9sJAP*o`jUvAa<#IIP6j-r z?*3d5y-F2+kR}gsN+9M^Lbl?p?S5sJAdaR#M`$%lv;sl~0aCxvrvi)EcXVf8**rqh zoJzmR#yH&1`U)lL2(rdI4@x;ATp!tLSP~mpX)!pI0+9CA9P#xyZO_0SgW*B#`B-Gg z!8c|C56x>LFCQYpSr zT^0Gde;1Oji^%wxZQt5+`2zmW=v8CkH$g!MN{#_#)oT!-9E3mI1Z;Iaf>1RMuqv=b zZ7#+JOO&Ly1-{k(42lKmXgswH=&J&66jg6_5jBj)IbLhNBoek*Yy_p@_Fn zXa3xZ8w~qSabXi^d9IIAFL@%VT@6;>J|vYwIMNgyLQ}ad_7fq#EVXX7q1f!5sCA4m3d;iSN~KPke3mw=Q34e zfNB>ql=f6#*c{N71t`bCoJbvqQ5WWWx+zlDW!d%j4U z1ji)+2E~7!ZQoeGN;3C2Wzuf;pEBzTb7fzSHKeNL|9y-;Md<`zGjQIHBj&!DhaWa4 zRC^ktS4MG@B-EJ}fi!5i-oikNF1=ZL1U)oh}zyEKqg$bBp+s`HDchrBF7#GXW8) zVqMU#2Hw9RQ@64pfP)SoRyahRwAV3NNvRzfj5UKvRUqDDT7n?zTaRm2&~G*oAs4gp zvtiU9lg+v`9FN4~y05@}1CIpu8wpof>A@Ce z5y1&@&PkQQ)$vwW$qJ$jl&cIWpNjlqO2k=HRz0 zgH}Ghgl*j4h0ee&ET_+#-@HTNZ*Axvs~TD-tz>X*6{kWAD}!s~RW!O$Q>Dk;)D(it zJx4%|j!*48VJb#ChZTG<+Z}+4#r5+!<~3YbR^PW2$RTP}CI;1AhReU0=gSfKN+MQn zQ^6lor`T+MOLsDuR|26&`EF$Aa7c`_nSr#m1rNxSnSj!M+mfVN2qiV3PVqi0>(qtK z?&;KTQ+QZyw4)UOQltLzJ__a@JW0Xbsx$R@lJyCho zAX)6z?S&K8>zK zZ2Yr&+QV0_9sJZ)wWiDhmCP~Hfp;puLk$wl_7I!=6oxI8M9EFy<7WHR1onkT6qAyw z#6*g*r59U?pz3Hg)Ie=_Y!nq!*(P%PF-i}F!=yHsc685c2z_o0i-HG=INDZ4GbMTu z?J^6T$EIL&@-JXv7Il!*Rw%9;aUQF^G`fxRSAmDHrbmqO#}Nc~LtEeL0=J=c*X`#| zMFYs-k@;+}9=uw*3q5;yR;M~a%pq~oa`?H*qpcC2SgPL1bbfwqfGj7s*sLW3(4um} zTy~5!+IUL50*##n(EqhXk)cfzVB7-EK#r)rop1_gE1fPlD}$>GlSg!0S*)$msICVLj#b zxT0;K`-vY?R)rbJv5|23c^A`@;U-KYEtx#jB$!k`!a;dahBlmSz++n??;jkVy&<}n5&t_@(=7k9b~uTf&ijKB1*C0@4p zAzTPE+n+BOyo5M@>WuCZyJR^IWritqA^J_0JMH98t!hcKWx}9yX)nolDJ$e z_y=dQ#m8oh8L0u&mqLWWiE?nqGVlNbsq4{DK7#4d%3uIp)qNNlo_8eJOF0vb-p~P~ zR%Jcv3#s;KvH_Kl&87*vNWz}mR9nP?wQHDBuNi3y79Q(H^4$AutC zi2@1$)sMDdw$G?kv3SjIBqiH#H~*%h9pS@|itb?H0oaUQ1KEtnm>NydZXdpynTR-F zV8JMTq@CLClh=Cg|39U{Oz%e*-id(~tx(T3x&Q_+@^B5pRd;g9ztp$2BYQJ7rl-3>Z9IK6-{@7Ylm$S0%kvqEPA+&(MPdn5w@ORqi1X_WENq+eybKMn)z#`gQ_$ z{i5~Fou4DObm_Y&ntIrDml3}L1@qiGqcTTrID^Y4fzccuEHXZdvs)9Hu6%oK1Ympm zHG4(BL3|Sar)W%t*2g?!wh6YM;fM>@@oMY7PMwiiNpW;qB3o9Pki1|RTSL};jK5Jn z;1kUnn5wuvS@H#{a!j=ykZ;1TcUxUeEmptXrw=gN)m=WN5DrBm(}00$D;Bd0aHR=L3NKqiW_YUBU#VhKWQ7T%ixS-I9Tl1UZoPE}6VNdP2^@>>Q&~c7x;Cak*we8Yzn*CY(r)gw@o37-c6X8~hk zr6>OYGIcDb4)7l(W+&@0UlJ^R6D-|}gBy)+BB(d}-sDF|bk;hkRzLSaGo^Aw`l>BF z{JPmOamrqsHB3_=CE)wxR0Jz&QTuK*#JwzaYqBF?Q1E;-hkKm@&;8Jt^NfbE+kO-$H&^DWvtF~JWZ$OlI0ETMv1gjr$aoHwXzMx zN4(i>a>I~A&iJ^@!&J`g1QcCxUbTw3Ky(w8R233G?8 zV-1*F4dVx6&D-HZdX^#Xb9-}v;#EWJe~*A5m==<-i8^xcP8z7)&B#-XV7gMZFT1Jo zeBrOEW`!8QrtXKt}%@Ix}@?Kr-(toQ&+$-@{{jY2ZlanO@f_)gNMpcAiDLd3j4B+qH3U*dsm zB`oL=SuNYD8?D|ZI(wMo8t@ zQbrw^7DMwR63bwxQ?pRn+@a8?km90|DUa04<56PC^N|nD=Rd@u0vC`mPs@2)S48@2 zf5IY{T0+B*f%KB|53NsU0c8;Pwk9Hjk@L}D4;Ia;$|kT^DsyEB=MHG?<0fLu<+P!H z3L!`vr!M+Zto>}uco&;ls*Nvw!}WDCTs^;M-h*sUQ|_Bt;nY~nNU?;>i8)sI!t`uo zRCV6jKktc-;U(#2h=F|JD|l6WGCYx{yGNB+-R_`(Pv&xmR>UG^an`NCKO9p6lDN(| zPDeUq!H)m2SB2=MCkQ|rEk`RZAl|H?V^KFGeLOtN@G+7pF0RKk@$coIIhfwHCVcJA zFjh&F36Ok=iTiXLLg(XF-B3mcbZvK+UO+hi&gP3w(A_{^Ec4@}`l0a}&pc7X8n$V z`gJGM2=dq*Nn4TfWHlKya7B28N9+FvWQ>KLj3T@HoG%TsSey5q`%k!}H4$KACnPi8 zaUm8wo=5=GM8Rg%lD}3Nx|rw?iBD)K@EW%3-eEju@%tkR&PAAOL&|NThlE+7rd#-BpS&qQQR0fB?N;KvpXIz8)v!x z$y2#_W^0~R9spF>Znq5TLP<$_f}g`LKMmrt`%=M~#q_5Vw#mGsugw3PZnKw@*HYO3 zYRF07s%?~{e|in(z4XvtaavdI8=Jw}<_wuZK#iVVa@6MG{QbelW9V3&!t0y0aT)&9 z>_Wj5c&Z!6+Y4W!zOCq{4hWpJPv(f|-U$K)ScDTuaAjY42ckjT)u6X%2Ge>kC4uPn zy92Q?@^G=tGDhYMiIJ_t{@69T*3D8yK+_0WMdfp7^wklY=gg zadydjMCZuv)ih|GY0dlASt*jFn-{_kK^D7kZX{97Pz6Ap`AouTX^$qX^@8~FV5mV| z-Vo8%kX`RmL1Ao!H5e;ho_6R3ITTEq43%(PYUO#Jzh)hlqA=C4=+adPKCp)@o?(7h z3FYz(FQ{E*eB+4P$&i3T0tc9MM6e^Yv%=~M9 zZ~yT~Hhqs)l02B~teMhHWzZlftdx+%I6@JarIuq%JF?eCg1sQx=o0#BZJ~w~q>#S-VA9j;by4gj#*zwt1}x{fNU_r&(y8 zZFIfha)C*I#`kQfo&J(VLO-eTuf?*?JXg60QD%fHv0X*mKNe-+th6G`MJtIt>M=))h zf5zj`&7SNXr0ct2-SV$AjMHxjnxgo*#;Nz$uqT#{vNvwj3DNAf=dOK^ZskYKrs0X~o znMn1_oBA~!!T>o3tOG7->4kPW7G9){o`{^-L@z-vBLGOK$&aAU9kU$*j zzIK$|XK|M(N}2lyh_hOk#H6xIcL>Lqiw$|ukrTs#1GHMZ%8jhp3?ZC(E;0&BD`in) z0uo%Z=^ShZl@(@Sqyu{Qfq)d(3=j&KTz5hlBHaA-<<3JCEI$Bj=lje~ z66{p(iON#;EKiOIwk)2#Q6%x`AFPB|Mi#HD?3M|d=r?VT>OBWtzb=GN?=VIuxehV-LZIinAsMyyF^W|Lkb zB&~WDknVRfZn$3zR_fwa+5^EOMf7GQ=8A)lme&*0HG<%aw#={i@}fge1wOE>nG&jl zdKCayhODRnO(nHizgq-ydzh9|KQyqO;ER$Y{B9&@tTC94T*5Ny1;Y1=tP6`(#!KK* zGn3_gIVMZItM6j>TN~5`7b`S-967QAWiz}zjUpgfJ7%L^%1!oa;nsCIAro*q{3N0E z7Fdh&=M}VCrMObNb7!H7z3c{oS)aVg`=I#i9(GbPR#UZVr{9lGlRe~Dj?O;IAc4p} zaZN$hud(_TMYRM|q@;2lS{(g-ce3*Y8}AQ^^Twz%PZhb4WgjgwvF>pTO%Wj!9|9xC z;ln`~BZI?!zDoX8uoB1-AL72(S8nsZs^sy+sM*4BWb|PX4UzwonMZ?q3bd|7kitvv zgp&I?HllUy>hLU&)Gzu0s*fAHxdI!fd1|(%@_lq&>+)_Aa)5C<6pJq9>t+S=RVGy( zX@SMCw(Ny=T*M@nh2Z1KZi?|!GrGIIN2ur97vah7#-8%vK<0JPDv|Ms{_rJ*o3H;N zxRbXq`85qN;F3kfKk{F-P1aBU+;Qqim%lp_(ZlMXe}2~rrX_KcE`U8eiv{Bw(w2S{imD@FRH zvYWM``zb-55pE)1is<-aIc$MmCZw0AOzv62AWm0LueGFSaQ*@8#Y0gEQEcY~RKZF7 zB(|C7}_4mKIOEwo@JeEF3aw4MIaQoi?Z;`K2L8c_%~$N{LHiO<-= zvtm87q-GtsW!S?T-f#j+!nQR#AE@#f@|ZXM_RlOz%L(Z4^65eLX}y!&pi^Ee<9U9} z=KRkNFn%-hQmq)w?s!}L(_!*0^AzphhIUWq>W1rY15A@}{FjghpLK)|W{Bu7=5cm2 z#~1O^9gNDN;~Y{z2c&5npmmWZOYpO=rt&F{$JRW4Fv}aZnlN=HSRG%iyU|b?rReiu z#P)orskM(=3=>8eC+pV0rd&aaiz2*B5qE&DOxH-ah}KP&ix;)fh}^n^VaW5+X0VH~ z-C+Q{R(wNa_^W2onM5fWTBvAiex`eokSELi!LZ7mUNc<}|FGvWaFEG25k4}2U!@OrZgpqhp1K?-$}}U@ zlw;2yQoK-FZpa}twFxv&xUS&oCJTTT}Bk>7tJqRWKq z;vfO22_?95qG!ZyM?OT%{(JZQfyKHFcTP^gMj)@|z#&D;U0tv$=vOA~)=$3qB{$XU zEo4(rJ_=Iwqx+inmkLwp{KSfFiEOHt*Kq(87Y$u)pKjSjfm{`Xx>m#rf6PJ>zvN1` z_WN|+UWy$)du}zoL;-haOAv{FKvGyPgm#1DVochCjap`a8pG3zVZfFw{}b%(o9CCo zm}Kk&N%1)E9TvV;64nDWcwe0^h74G%Axi9*bBW`?9hmk^`TfbBsQOQ#O z(<`_R0Ru8HMx{^fC7+p|(I2PDc@!w&bNR+~erKuPrQK?mHIC;(N58AI4*npHJ?g(> zG?ic?(&U0N_;IdQZAhHl3-#aC>=$g&w!@{1@{BQ{J@8yv3V*cQb{+_9vs;%BBeAuKLA^;_Iv!oL zZ_K0=nxs}F$ZaS!KaxTGuBP}#{iISZ$Utp7rDh3cxqMjE1L zB%K30DxigMy<6Hp%`4z1@DzJFt9W9(#*5+Qg!N;e82hz%U#ZGno)`QMKy0`cWM;KTF1(iGQ%$YCKMdzY08+l?d-!3G zKt11lN{$qTU7?BQjf{x-h1@?rb0?c2tXW$njQ3*x|9GRVLSH@+ze~h`d zqf#?-*z;AE>-P(x(MU?yrqHe?-g*urj@gT^ouGwz)xd-l05rYsoARKPWMF#>+c%<( zb7_O!^Iv;GK2aStPahKx<a3oQ?-qFGSCz~t8z`# za(%s~*IUkEu;_!r_{F|ZKDzT7R+q8AgY|i2c)G41?v;2b^Xro(xeuvtmfRgs2?0tC z#$JdOm;Wal+RR#=sFQgeVWI+E$OEt*GQxe3AiMaUbiNrTo1Y@giikz-omx0mMLr+l zHoi4xp0((AbHC=+l@b!fL)OI=ILCW^=Kh7GTc9k5{=Px3ja!Y#pOz%fH)0A`2kaTg zt(7^vmHtn7TN!-s-ICC7IA=X7N&H#3F9(G%r2XOubvbfkZeYYGHjmXM@|RCLNhl0o zt|byE=`jM>MVsIvxyk?0I8U>HDH>Dp3cy>eDs*wxyE}mIHDeC+Wy*dEN@d>Th(!~K z*UKL0Cfra2Z^V4HO7$QG^*vNW)ao->j&I?>h;SEFjmu zh{>47n2}&Qp{Kh;j}xmey3RY*1uY=y*Cr+jgtC^lV!5&uHY``LfPEUibNiwM@q*#U zcGNx%tApt&X4PiI3Xo!U5nM8xhsqCUd~ghWFEh3%8RIHxMq4bOIT0Blqxlzte!4H& z(&B#zI%eR6`g^wjCo6@=;OjAn(X%7bS1r`4n2%QyvZ!nbMnQ1sixDH8m7uk9}400~}yBE16rK2DvHUl)s4SsHQgU0h`+9)_mbWL6k^MPiUdyp4zS zODZa*j^<1x5G6iHvFptH%~@*$mT&E{U`VEDj2bms=!@s;L>g8oKz=MASorRW*V33w z_NyrkF(%9n* z&u7PGYr+??y)1PVYgL1V$uC<~?&`9-!_uAl@vDhylK4dyYsiOlPw7nxQP{sNy3(nd zl9=B#m51$^8lKDlZeD?$u%+^6f%j-OCs~&7k&tUvpZ+)^&QJG*Z?ra#@y1$Q3uVwJDl?>6;K|OMJgjiK6J*R(T z5|3eD!81U$@C&(a`56lKIAXT<@|ZpZ>v)P_Sx`K-$~*#lGJ@yHQW}wUccsQXaTbPO z=QqM7fL$)hZ{)AWg7$;<1=LjT1<&9GKTE#cNriH;z|ur! z%|o>5!Or%(CAowS;UM}l_j)md8Pot!`oeWe)0Q0freDY9?t%3{0=Px2RT;%iZ4XgC znD9(Ydi%*FB49kKkOu{95r5z(4`?5x2eA*NQt~TYlAnlz>Tr&8WoQ+RI4S7qK{xbE`hFvHa+FIe9ZPVW7 z4i}yQvyt5vYzQ{mOhl{^C+=W@CqKG^gJQ}a&sta#&aFP$XCB<*m@tSd1i-1%oW83^ zSfwtZ&vhw1Q`zsOMQ@#(2gYqw&xH1b z)mz{peg^SfUvb(Na3u0RJh+(I1R)hx;8#DFmP0?sW?tY%y@Ak$DBr3qfQgZuG7}KdDM5U$G5r-+Zg?Tof-N>S#fg<{Nm4CkIc0?{u`9+AO2Q^xoJx%Xh=9)M?4 z{)C*edH!4}Lr;IymM1@cO*FV47CYEDm&B&JY<=H_{Gko$M!5D$e3FlU4UAJ;A(t~0 zzJ$x#bB;O#O|#$QlGME{#=}JQEv-vq6OE7<*Moe-!yv-gix@2cPLo70>eW69-=%RM z;##@<_fWBN!=8H@c&Fq($&{kM%U4;sGTlH^W8#cRuc6g%DpH_Gj61X0W0*s}lwNotUz2y}GFS1ETFJLeACpvo()wSq|K)wVILDM9 z`xbX7cHQO5(XYS$#zv2jV=M!*7GCjK9V{=3Okyv$Dzk(BcUj=}_Ir=J1#<<)xW16i z=Rd3`Mm5M3WAHS=7d zYBI$oi)%0E{d{V}Et2k>1Ake+$$_zCpWxDBeeuUGdQZlS=!W3P$f6N?z+v&`T>P^*`x7MUds2+ zQn7=`3fBdyFg1`&(l zF`g|3)J#%m2rP2E02O&{?=b#fV(v$;=Tog*K8GzvJF+BC*m)_X_yxaIgmrB18uKOw z4B&tehm#LpC5X2#t_l1bEq0$I?y_T@(V*sSFy^EuUMYu}{w&l2!AXM1J(Rt>%AIGY zgPDz}tFM|q#4qZmVKx!0Oz3&VIl;(J9o-QI1@_9eaY`ncldRfq?7Hrdk zkrTBXt3n`I|GijH=?+;u!u+lkdZC7Fnyg8RoK4Q$D&ctu=E9LFk}kR-i5VU`v&|OH z`}HC5gdDmJfz(i|y2-*iMTDUed)^K<5=N#S(}GWvs6e?KsPg|Boo1%NK*K-3lK7-y zBt061JpF0T+LUoR_T}j8eF;QPCBakW(>rK8gIR~O16n;w+Z9CSzTj{E2f7Y(H$WLy zTp9-}U3Z|97B(>paHS*GK9a9?L_TW73^IZv<=T(OLn69b#KzD}&^6t!5C0K7O7ANc zU|DsMi?GOQFJ-a;I7eu}hck`JI>K$nOOTbzfx*;!Yb_Ve_#fG-_Sy$!xM@GP2%{C| zq%ox2cIsxeLY>{+IgNShzKqx`H}amK6-`;|aTBo)HvLAMuOqj;uhXTC&qYc|DetLp zxftOEF9+RD=#8`1ov4$(kWQRko2GCc!w^s4puscGw)XG78zK2Sq3s+5fP9i{r-Q`4 zZTV)G^_q{uC*Fy#*`NJ;d&%zc?d|Tl^Ntl3dg~_Z=Z}rBXoAMzK1|(mov|t{iN^O! zt~@Ov^*6ROFOC%K{r&gg1C(F>t3H8neJp}zWv_Vmh&;ZbpAYi;*5FnzU@J5p6NPGm zJ9KfBrw#QwlWrEmev?Sf=Vd}4Sp~^dqArxKKEQ@JU4L&CGjV(@PAreda*B7-P`>rD zU3;rC^yVg5OeV*RK*J=YN4S5Vn|JYNi4?bli==wf+OpQp$rEQ7Y4+T`7RP~SSSku* z+BBh2014L-+Q6YeCDV zZfjgTdKUsdgqH_X&1i-9+;yki5Vt^i)&rw+$f)R)0B`fq4t0?DWd)8X^Z;sdhpf_^ zu7WGc4R)gd7s;}y1*Hp_#t% ze|eLqQpJOoC-KE;1$bB(`yiTO_GB+(B>0OSbKR$NN5G*UYF;RhmT3OkEr0PJVO{&L)%7)i0!yvUk{`A9OSG1e|0f*8n?jyXL9pxpZS*1=D2k-!Y=a%V;yfC0=5fjsd;_ z*^BI`j+&e=1Y*yYy(t(2+i452A7|a9hTR{Kr$CDg)a67nZ?~MQ&sawei^K?VfJc zTfihH{-G5Q=vDnZ`37FH;+KnFF6J?w){RsZc{WD&K1`U!$ykVRC5qObwy@nYysf~# zb6*(ef1of#ZNZ;iX9K-f2TI|Y)HyhN`1%c(tJD@p>nSmtjnUr=Fz&u5QIO91$^ZN7 zb%1yqEe|%^NM;7Emh7NabS#jgSEkASQ6@p5fc~HnJbrZgzARmiQF}2P_GC~45WyO8 zf;E!}kuei(8gh)t3yte^y)v6Zzq|oXW=-c}$M@e?*4B6Etw{oxaP3ssbHW4qYE6DB8xJk@w>loeXO34ssuW>a zoetTwGt17RsE-$C94*v`Q7&mjbWwdmc6L+;J+(X8I=R)GBtk3>dyHi*a^@Cp zP^EP!3ijt@f%D8z3EX=I=^IV@TedpW*5x#YY?%lCY_54>&`&NMCBj$a# z+x{N#@U&md>o`1M^A?=RPM8dE<1j5%4Roa161?YQk}!f*pEqOWd6aA7x&i?QqlX_9 z$>s@mry)&=XE8aPc>nJun&VgCLvw8QpP|mmle>;&QZa@^Bzk61!>Ton7HZ_zdo~7C zj#IOA0a_Cl*&g1!i6v-bT`YfisY8uj9wy5lwm_@M!B($~}Z}XtmvSA(`*UEn^KS^7VR%j3{FOP&9+Kad-Ab zaKv77FT|LE5;9MN2Q^J){lApbz%x|*0Cyx?U_k?|On)uXo*FL4M)gbh&%^xV%{jQ&B6c`ol@YX4S z7US%;;?WYw?mOrHu={!`@{H3EucPkZsOC4+E5r7FSB$`gpV&?%9R-oZ-zu6ri^QBz zqwWK1S6pNiIrcS)zu)d{wTT(_N_c#_Jq>E%EUJY6<4d<9yG82ASiX=3>Oya8u7(*h zbe@uWC@TuUK$?1<&y4x^{y2n^FI`xH`ZlPkl2;!hwLT1^89-yjtnUYL?YEG^52A9k zhElx?PTgp7y?LN=_Hxi2f^Wi|0}iu#izOSK60c$++4k33qI~q3gG~+ktkFUtMi+T0 z9TZ=cI7s??k0ZLoi1x5F;5$uGDinl_ENz4ptx0F{{8bBPm`@ z)(qr`RsbuZB3r@G39;N$k(4c$=YQ_v+ek2-K3LQ;y79khs4{H!6)C`GAm~?S!G51o zsvUQfyC)SX;6BMSD_5y=&FnxP3{h>;UHFyDwYUT+3=4xka2f>{nhGob#m)G}H2rQF z636GlJj>oWeSWLjQPqe3fn7l6v=a#+Co1 zDDy;FhZQOEQv=c{*1!L?66eVVC5VS%$0}SPUhk!Bui6*;ML9!(~}*hyLwA<;Mz)5WpS>HS&aj1Ck4-%4^xUId7&L`0IDF5D`s8y%JMXAg@%o1Ak7m zn*YsnjXu=Gtm|S&LWT6WcD_ba2#dAzjhdnuxK~81yKl~ohd4qUh>i;^rkr>l$NuaM zUbEqfH;c-LmrHb#a=cTWie=O(21#A}{<-lWhwtBSjb8eVyF$E1FiY#yx`K0F?)4OEHWr7LYA$CUc3i6e$hV;bDZ{De^8-A=d~>Q0k8q@vn%%Gza>7EFlv60S}TSFMLAg5c~KhNod>$RlPZ@U zE|`%MFtB1o>H)}w+t3Y}?T=twEel45%xZW z{54ikA0$&^{JfleKKQ^DUh-*clxd*Fux>z<&o&lq=itq;K2lB0NXofFL_>CT{g+4o-4q#E!eW_DQNvhz`gDHeDoV8 z1uo01%aOn2GE}ao510Q|r`Gb|68go+XlX?OFC#ddx0UdfN?+6*x2BHzJTNZzE=p^e zK+|Na^^99$p&J8WRGm_dqJx^}q^2ISC2u)O{7=D;0z;qXaGwM0H4&`~n~_%64feit z50wOEJ{^=&>`Erm3<*{QoA}nQvh>(zkI3|J6)u`_gS;TxV!@VtyGZfAIF;w=p9432 zc*5|vT;|L%oj!_TR1VuSwjkgCq)K}|(fskQGDAo+DVnZmyniU{q|~6hq!rT5s*>SrocC zYM98WZU0{scWO1@|HPoFFl~`EWT3_k(w<`|Ixfd#>Q}P-46s8RjF+BCp)J`9A-oS( zX}%XOONTq}&5N>VFTHTtA+d-=TRt-4(|w9m{uEBq-IYW{9491v!nGlGf5=IfO_pp;0kpXi=o91@4Hm*MhI$` zfQY+%k*lZ{x?D0T3Umt0dOLhsd!%rybBno4=wVkdz207l#7_(3khlB7(BMjt5>%9FEwoevaa9 z;X)J&HlNz;QY9K_Xctov;0CVolO zHxM1Bj1De=y3JF~W|szo$5Br@g!H%OcTDMHduW|6G?1FVF3w%A8BZbVGIqfDT={lf zJ_%LT?kyQqK_ZQXyTvYj_{&_Ya&$G09X_6{E_yd2@0k9JsAJHBK&y{zHvF1SL_{~n z%vIaF>Tcur<5qg$n@R3O!7&0ZTckyF?zRwj!k??KA7~%+!zo4W{WGogRG;X_ZNo$P z<%;IIg$^8Ib4kH!kE$J6Vmr-aPit%~7TBDiq5I%GnpJ*$)_ zff=Vm+|d=lUKa@oy}Abr8XXFFls>JRh^cfqyjyP(8o>M_8{ahc_%$?)Hh9D4bSMJH zNU$Z-aE9Tw!^Z+w z1Z6>g5IIsZuUS`oe54i0g5S2g5v3YlX9@gLTS&`eg-!Z`--@vN z-89#`@6`wgpUL#t*Q}8d_7{=Xi5osB+bSolvf`acX&&Jk%D}@|!TNa+0 zgCAz!;G6(G9{soXvFDWn!b_bv&RRf=Jz08alvW^f7Mgw%CfAqZ980iia6;cm6i+l~ zynE(?o!aowdi;}FvwKx=kp?%E7vxk%vJG$m@N|K`70(!K2lcmalPVKx!x<5I*8|dI zcYK8tGiKG9L2{dE#95yX=|GA*uST;-C*K9hc?vpU1^VIHQ?-1I_;oC<2|LU-Q*cjb z`5PY*K%g=LhpV3yK8WbHyDiV|DZKzv6|2Fv2z=xJZ}!1uKG5u0+SU<#X4B;b*} zg?U9{HP7PJZn;T(rS<0pB&@%&zvNI{V{ zysKVo_-Bk=wGM!CiB}6Yg$Pp_Wf0%)f-9vJFpw!ElbsW(V7EM{!Pt5ZDQFS^=OqT! zXz>seRwwF&nY9r1X0Nag_O9g;Xx1Cp+c4Iq4grg%KprvVHjdE zcqU8mLy}Fo4LP$NMA?t)SY2!U0fOkOCt|Zet@Sw~tc==r&wh%EB8jw`@9Srug?~{= zCMp-BsVB)i|BX>(bKKg8JBYOmSVwq^bo6_V_;7+c2wHTfE+wQ$u~Ztf92DM6hQIWS zBRl&Yo30Hge>(-H{zI+koO{9)-G|-d~BcbKujrkX3BM zXEHJ+UUGnp@++`R)xQ;#@4!W;_(xGEh5cbuvXzEPIvP%B7tc9=K`Xz+S(~_<)jsK_ z>?ts*s1G(fS%P}zKm7klBzJ(wPqoY?2wv*)wiwtZn11=_{{BkxWO`*R|zv(W+} zwbPML%g0d{EeVNmoruy@F$-6`?TG1_hpTDh)PM0=3jG$5B+eW{6*Y+TE4SL4g)fPx zoL$iPLUA=A|E6`ZKx{CUQNHuea!s}Pbaw^eF(Vf-$Pl>jX{ber>lw494q&1B-s95$ z@KFwu9Bck~w+);Lq6WD#T&JKs?WUB8YR$zx<_Ug#-Z)Ya+hpIw+?C+nsnv=dkl*gX zTCsSp1xZ7J(Bmk)%B%x--9o8y)wRmrgFsN{<2b9+os$|V=v}h_+KnGrPGHbEwG-F7 z2U}wIW4sVQJWrW1Zzbyo6M;cQ4yV9!EB!Xx3S>%h!}lIUPq>DgImJ3-_^Vvdi5~R! z)KVO&8}iGUUn+CGNRqg7b($6efwRIqM$?VjtI-uHF=$7^t8m5UDY9QEU=(n_8)kNN zjAPsSrt%vGjK-b>@H}GXuJjNGKd=zjDBANhF!;kNg&7|nKYSC|5hCg@W^;wo-f1v) zp#h1!Rb<(zn7YikN++QYh5QtkiB<4F<)Oa*4B|V_fnXLedid z7HWY^*KBMrbf}&Dr95@F2fKj*+Simr7}ji~C8nNS;o4mOt94%GcFz2&xaj6W;IBYA za4Dy`${YFD$^f9(&>|eIOB1!(iki+tQg0O?N^TW-AIxm4wMr>{CmHgIX^iY$>Cp!6 z;X;h*=4E@JH5HXSF5;rVzQ2N)|3QzMzJ0oDHiMBL}^$zigBy2dy= zCkGwkUh>3;W5U6^8lH69EE)KSZC99hUOFxB9^R+8u(-Rw8nk9jbOob##kdJBXsQE; z+uBE~cM@VUnU>I`XYXdDr-4zq(k=t_=@Cf40=k>i6bBu=DL_!noJTF|l5eUf z4t1Mg_m$HgO@@UCWFN#=7?-QW>z=$xkG zqkrL%6-RVr`Q|h?9m|^xf4XU<+wN|^b`K{GCi#O_@I#mQcu|xJ3?OX+;XoWm!^&5h zo>k;?y1OiKBq&Xgu`ddU<6MS}*~e6m7_&LLbG-Sy6)GU}6d_$vw5chVhw-&K{jte9 zm~=#2V>f6%5PqXL&AEMZJ)JD5!;}VRav#b#L3uE1uRH@YJ8Q3>8mlbMW^i&%$4;X$ z|LdFtDX3SjaI-L@XNehb^IG=ukbJR3qH(9#zG>h~sz)5_DMyW56$wEB_zV4+XSDAW z?ay9Tni77s#=NBjCW7HIuB$UTUkEJCzMavxMC8CVOdrCw9%Xq174mnhj~`{FyV!2x z3P4iKZyzc&Q;*#Q%4?5P*R@l(c%nF4ZUeOf2tFG_G2QwvU~_NO#g#+-B5G(r0q&Le zL%yNbm|`h+)pEk*H+UBU7-Oc6fI5NH#3-q!uhTmC6w4o+?ATFWTvJVNKf{M0PgFw0buNVSg1I3T zCdFT{X(A)mtbAvSrYg5VGFb`eFESXk|1k zbsz*b~!S8oK;@JSB11K6RGx2u1IT8oMTlFhXilScQE^Mc~R>-MoMzceExk5z9 zWsIJlYD3h_IjFB{l_Wh>h9Bp1#JxUPQh}^%nzYh6x42!^&)@18?ZnURzE=c&jR5Ha z7^;@*qTnNu)P;RIRBVr;0?0s%+}Y&3+Lgf#!dx1Z`t9zhfpv4Vk#(LdlkFBTlgyT_ z=Xi`%6#6toB^08heb9a9<6r^rqh&o57BpEXEhf4Qgvo9H>rFXJK>{~`1dXaP1eK{x z`>axuTYZv!+MwXV2cJ5cF$((ZFv)S?6s2b+dbnm~EFfMK0&yZYc3Eg7!}l=RrKPG; zVgQn7R6gO7oHhd_lK+9(V-k(YPo)22lQo4Tss>MNdp&8;VuQlf+}SE|=u`2{e^& zbcRmIA!B=aAs1)PW+D83Dky7uVL@@t+V8cMJMWzxKwle)0T6Lo2RQvX8letc)9n%H z%G4vitz%|Ghk0}8id*su`tra;pqgZ@g6?>xN%PfrhUs@+GFxp?=H+Wq8LikMHdGq% zpg6jtsAfPZdNh%_P)#K`#-vCQu`6E5`wC@t?I$SfJHIK~m}9mE2*=op=`Q-VIZv zw5oC&LZur69B&v*bFHc%woh6n?>B3Nsuxq4niB1U# zr03^&MlwyS)^H1fT3D4jSH8_N(0WT39+yC;VL1+Z8% zJYxWh_fEHZO5p8kxqd!-M3YFlz}Jr4q$`FCczUNEOyC}$VwcPs|LLNPEzHI8`H>0{ zB!E|3Yd2Hmda=LRMhs2rGKpqGV4fpdZ{xN>|Ak9P>ncnU@}ZaUI#SOL;^Wf64Z?Z9 z5Qk`qNOdu2Bgz{{h9>s8jB^X7^DlRN(a_p;i|A zLg!RMV=>2UV;>uQZCEzw39FAdH{=JFYT~!&f87EATwPN5T>e0e@L1|NM-x=m^O+BG z)w!pgvC<51-*dgQMJYH|Hz`wdp`o8-rfu6AnJ$m*ze~Q^t{$@mF3GS^_te`IkV~@t zyS?mdA^tUJJCNax#XDEF`YG=DfbbKUtDgxM-3t7j$dG>o3l%kpeV-}U~owIsP!9)GBmlW zeM1n)3Az35=$UqxCReb~tjS7}(8eu?9Z8hYKmjn;fnEg^et2F(#YwJo?leLDAC*CT z@RKI=jlyWF!06NM>V3g>3e7eQ!WeM1` z!82x}1O+XpKWD&_U0`Pgzvdqg;(Pa*9xX*goHpCE+&iKV5C_xqV-cy`O9hizTXbH2 zI`BBiQScJIhx30vyu1M>56t0%ma(}?7pqhtSh%?O6GUaS8N^&CZjotkb$Y3^c4iB0 z;md}PrXjrp<38QDxJHGFarKJ#r_d%WX=R43)nO*&tU5b$v7$?dLw4Ujq;6~_#;fv9 zF{+t6{!|yCw=3}g+pL#Idb)!D$t`Ue-m#5B!c_>V@M0R#9I{HnS4JCeK z#bsrF6f$>3{Fj~VN*}u{=J4P4{@;@oSS9}SUFq*zl0fKpXYqBRqRXRyJ{*I+RU%+J zgFd4dC&-QtnTQx5+K|HTFlphP35fVQN~A~JRxKh%2_>vBShtC$V07lUv^xzPM`t_D zl>$N9utaZ@!~DN?dG^8lr`PEE1TSB&HP{(?Mw$iUZO>*3>r(u%c>_2N8zeLt-8r#M zCY$)0sih65(+&jI3=FADlbmyHAfc zQw+&1wOr3u?%LZ$X6~dyXlh;J#%nuFt=ZHcb#mjX9&lc!h}-V98$(^X#wsYhnUsPo z8f43lZ#*uf70~oS9oCS_vY>NRA%P+7N<%LF11+Cb)gft`Z#WWsVVhd+#i zcm!*4K5m=TyR$da@=GU#IUJ(Nx7s0VElZ7TtOIdRsCS%szPA3GhE$)b@y8@=@HXa; z4zK%TVf|=y+roZEf{c022PZg9BGf*tJzUWyiuapKehwlfGwgN8PSxN5tA1QkkuZ{i z;v<2SX2ln^5r;${UfPBbQ8W-f)9&ZkaPPN?&+Dpa3{YEwPx4o#cBTGm1RfzbHgHan zJMG7>v;y^<6gXlMiztumfgTyDuiIz7XOJaA$5=2W9wq}>kiDiX>@vYj(Im%Ya0~f@ zl3#-fUM-8+%pG{!(27+=cT_z(pyzL&{imKw(3HU@4p+f#_fH`fFO%(P2(Oo3F3?}7 zcHm(n#t7TF1XcK_)E6!7GGGrc~el+uG&cgxJ{ zbazla5vyOB*UwglPxh0eI}6R2x>kXb4@c4jn%hS(_!sz=7>8W$vAx1F z`x|`eu@aM5zxyZcSA!{M67jt?rDHpO@Hk(@#gcPt6yzQg6t~WrNbfP`dR**CVFB0XdY9t)Np6q zmW*AFGCfpxPYu@-;;OJHb_7{?$Vstm z#zgdNs=}taAn1NWLgu8>iPIEU| zvq(*HIa0+^E%ZDUSVzDY%N@-$~ulbsVlbtWyeQ1QtWTtVosf5YCpW{Ee4y8ahido z*JGc<4W(Dx7g9!Yu?7~@Wndmhtbo|!q6=3tfOA~)J#i#`%6-c^nDYU;2FQrFS+O6Pf!=hWP9HUdM$uPiFAYzUq2#_4Zg~Wiocmfm27Ctg>N^hi&V2vCa^P zYVC+o$~T`w%B)M?f}8S7mG=)u+?U8SU@sS4jl}mgxB9r?QCdbo9Q&GNa`IeRZ+`Zl z=`|^(yKPmX!7!^T1`CpEpaBZbvX@lM!sswd5jC#Xkjg9~#Qc7qxy!5Xs2aG^^#O2g zKl?v_w@^m3fxex(WmA6wlTf#YoDr?l{jG5N(?*!PjQlTAyhU9=F^fCZ(drZ(Dhl3^ zO+)hwN-%8|_ zB|-0X6Arlj0}R$K=}gzzMFu*@V;0(ef`WU2!A3T41%j{=)$h1U*bSO13d+@(Q}qj3 zQ|CZx$=)HwO6o3yA0NI(Kx;JCk|LJPgMu8UAr9=NJqXN4E|)_MAYqD)?yiftde^PB zMbz68hfXPzHPU`tA8|@GGj)A#YJ&9=KZfvjG9<7=GuyF`BLT3jM!Xl{sXk71`JQI! z>fDpif*;qZj2AF3IN0MC;=v3LN}FHhY*neck~tuz!WB4JQ0P32JH(>PKp}b;Y*eyk zHYrrS)^|mX@`L}dxBo?pSr>I8J##WaDM?E0Z62%KK@pAf= zUvzNqMUW*Cn*X^(70?MojWP&&i;4D;gWK{4aQ2A+*E0ApE;Pt=ZBEwy51<;6EQdnB z@vK5kgeYNh5V-r^5_t9hS&pgC8HGGcVDWqY41Yhe13f4%`0_M6k z9QZsxZ0?o7Mlt z=Y3QUd!E3>CU}pax|83L@yZGq8Ffh}iy0f(JQ?J|+$vVcv*j~$C;)#bDO^(WGoMfN z*8+>l_V33ct&LeWZkZw3b0?9VyE}@IF!)Eg>mXv#t~WSjM2>I%k*rT|S0qYIoiSh? zwvRe>PgbtIMA4=xwL{ZwN? zB0^Vl1ms>-S(m^Rg;)1(8ZuaP`7&rum;R*kZI^MT4yPbppvL^)IG1V~DNTOR2_H$R z<@Y$*&QiC;E=%e>Wmu*b1Sy+9dmwv=wC^2^z|j^ZK9L@P6WDr#eLi7aN-u=`(gK|s zZ~j*VIuX(>uCL>g;^LJBo1ifNjn; zCx=4laOCJu+1kWu`mEITA8!VDi4_f04z?VsO==zBxh^A(q@Lj!^jpA8uUE5$^s|)3qMEQl@Ogxk#4_shTbqrOc?1DS|*tZh6$oeiQH< zaWSh1XPkb%;kV)l`~P&lJd+s7g{9OwF6my|_p1b(t4LsUaFvM-_~LC2T72an%{cOE zaE@8`ZK{EY3lN?Y4Pr~W{APC?W`qUM+U6l4pXpo9t9lm)JTo3G%7OA+JWE}>SR@ur zHM(7|di?UNTU(eg2v#HPTv5okAi=!qu#fTl`7}f-Cl)69btBSGTBy{M4$L6QL5=!% zA+RXopL;n~s+Xz=vVFH7ZU)!}lgE6U`Kactm{?vZal{L<$b(zSBedMzVZT~V7g0|= zb|p(6$&Xjy60Nf(3UYg*U+^e2mT+=(J^V$l2`tEffh;*0hQsVA|0DSuFJZge`_B1Ar&|XDg&~+b zk@aw4*KRuziZ$ARwS00w{i@Nsa{u(J^_I&v-W>Trrh9oJBKL;gf{MC^xGj2X$%DhX zBp>1+3>R0Wbah5=aI}0mXD56E^99U2;_V@o#=k1qa5mWXc}gwpypTQ7|W+ z9VyC{H@zCS`VSGa^hPx}$f_vwY~U z&Fi=gnhNNkH*N6luY0~J33b>Ta$$T4v2Qm5@zeuex^EMF<;hRZUjv^v6_Euv-!v@O zpeTy!;IFrY#JyRN7guc2Khw7RqP>C+xmObWbhS?nUa)7<5N@x{ykEB=F?LE=lgPMA zo#?nNyC0*%!Yt$iZB zyCDb?Dm67yGD6c1ix>>e$Fbu&w8xD9>Q3^piYwYYk3_{hpKE6MY?AAXWJJd#RYM{XCKqq(ufGnsbv%>jtC^JcR`L^c$3Z-@#v z4uGFhJwrnA=>jFUlk7ZvPxTO^O8%6G;-gk24);-w8NF)z)$EC+q~bso$~Iks5nE&9 z7`T0kkJ#f2dopy8O*-GZLA9)PzfSz`QFR*;SdNIA(vqa3;as3}z}&YLsO|+pk33Hj zi6k|Q+^P%^-AVk#1bo-co?{7rU|aP6AdT8EK;&?CCx+Erazsapauw(OV4>p)DnspU z$n+rA$_O*he^W>TZE+C^-w~P3P-}zIhilaVWqd!nHL1AJ$2tI59F?xOfcA!fJ@v3KHi8yc75b=(A^c-E zw*1!q4=}N7_uUZhRM^AzaW{}79+h0T0RP2+Bq0(0-BL^2!;ml$lcQKyH^cH#Klr)%5dQ-QkNC!@MdYu0`G?a3i5wXc8kL$F4n0DvO1*c_ z(+-v@=$%x+$kd~8LgQ1k3`v1pu^_Cj?9NBr$TWD9C?#y;=yb~V%u34F|vz_?V z{i{+3r|R`-Xac+28y|EPvt@JjwCsQ04Lev*nbN2aAg*`mRG9%rMRZHfJRwyT+#h76 zusk^VupP?lxIMPDZe+HD-qC5qElQW=4J?)T@ci#h5i2x&Z4L{2&-x37?YVU6?wNH4Z7O^K5w0 zIb=Tw0e9Z(vjzRVTQ#lg6E<}{1X09jnQ~(W;T#rzW!Z_03zuwlwzbZuIq5i!#NaZ= zQL!t4X*R4b7O)(0$SZslJ!ggSKk8I;tazOZWtPeQIY`QYVs27z_K!u{k3knk2~sVU zOi1sTc*_bIeyx4@U&qpU`g4+F8g^pmf*Nj66P-r(;#`dhC2gXl4Ieu6q*V8l7%QvwCo!li+4nTC>y7r!XAp8?T?Iyx_@vodP z=5|8>Wt|)w2b|HWLW$8WCm$>sl!Vf%Xcb7*OYihtAwrm6Zz`g%hy`7F(&npIe9HG6 z=l~3Y06|G0a6oksCJ8`Oiln8xqISjT8qll2Z`(5*aY$6e<(ctx4)B~q*RG56u5(H3 zX-T6GMi)$65hYCUeG|DZBMBEwzltpl=clJguBN>jl1%0ZYP=m(5|LIBEc-s$wtcsk z-qsQ~jM^JcAaOUCdr*jdh;-!W00D1qmk|_NEAnPf97`@bEX)?^4|a9)aw#Y{rb*=M z9u%N@RUqumLxX?-00005y5toZEw0k$B2B5WQ7P7VXrh>^FGN)^Y;DK<9^DW&$Al1f&m)p)YFu=i%1*hZ%8u1FPanT0-eAwxbaO!z1C3O$tH9q#f2b)g zLKaFGh_SK(HP{3FL_W>QthH^LdH|1T=Bg(+`0pih$a!;p!q<#V-$KCo3^n3BEd zbl71($Z0;EaBA4`NQ?3g?cb=qU3KI_$Re$o!e&uDufqc@Ld;Bw%}~qn^n+ff{jQi>;Zq{wA>5YLSD5G=CF!R8rCDuFH8fy0C=Eu XFaT!(*Tf;>a>ha7@9jExamples Gallery autocomplete="off" spellcheck="false" aria-label="Search examples" /> - 55 examples + 56 examples
    @@ -929,6 +929,17 @@

    campfire

    View example
    +
    + + market-stall — A procedural timber market stall through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract. + +
    +

    market-stall

    +

    A procedural timber market stall through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

    +

    witnesses Recomputed: 2244 tris, three materials with 48 faces per awning stripe slot, UVs in 0..1 with zero AABB overlap, outer AABB 1.360×0.964×1.743 m, LOD ratios in band, convex collider 28 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.

    + View example +
    +
    diff --git a/docs/gallery/market-stall/index.html b/docs/gallery/market-stall/index.html new file mode 100644 index 0000000..0d54ced --- /dev/null +++ b/docs/gallery/market-stall/index.html @@ -0,0 +1,1108 @@ + + + + + + market-stall — Examples — Blender Developer Tools + + + + + + + + + + + + + + + + + +
    + Examples Gallery +
    + GitHub +
    +
    +
    +

    market-stall

    +

    A procedural timber market stall through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

    +
    +
    + +

    Rendered headless by the example itself — click to zoom.

    +
    witnesses Recomputed: 2244 tris, three materials with 48 faces per awning stripe slot, UVs in 0..1 with zero AABB overlap, outer AABB 1.360×0.964×1.743 m, LOD ratios in band, convex collider 28 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.
    +
    + 
    blender --background --python showcase/market-stall/market_stall.py --
    + +
    +
    +

    A showcase piece, not an example. Procedural timber stall (posts, slanted side plates, counter with apron and shelf, backboard, striped awning and valance) then the shipped pipeline: unique-cell UVs, Cycles high-to-low normal bake, LOD chain, convex collider, Unity glTF export.

    +

    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, not imported as a package).

    +

    Budgets

    +

    Declared as named constants; every gate recomputes from the mesh, materials, UVs, evaluated LOD, collider, or export file.

    +

    | Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) | | --- | --- | --- | | Base triangles | 2140–2350 | 2244 / 2244 / 2244 | | LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 | | LOD2 ratio | 0.10–0.35 of base | 0.2193 / 0.2193 / 0.2193 | | Materials | exactly 3 distinct, ≥16 faces per stripe slot | 3 slots, 48 / 48 stripe faces | | UVs | in 0..1, AABB overlap ≤ 1e-5 | in range, overlap 0 | | Outer AABB | (1.360, 0.964, 1.743) m ± 0.01 | (1.3600, 0.9639, 1.7430), zmin 0 | | Collider tris | ≤ 80 | 28 | | Export | written, size > 0 | 163992 / 163992 / 163968 bytes |

    +

    DECIMATE COLLAPSE triangle counts are not guaranteed identical across series — the gate is a ratio band, not an exact count. This mesh happened to match on 4.5.11 / 5.1.2 / 5.2.1. Bake pixels are stochastic; the gate is has_data plus operator FINISHED, not byte-identity. Construction uses no RNG. glTF byte size differs by a few bytes across series.

    +

    --skip-decimate skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and exit 9 fires. That is the named budget the falsifier violates.

    +

    Run

    +
    blender --background --python market_stall.py --
+blender --background --python market_stall.py -- --skip-decimate
+blender --background --python market_stall.py -- --output stall.png
    +

    Smoke does not pass --output or --skip-decimate.

    +

    Exit codes

    +

    File-local. 9 is a valid check code. 10 is reserved for gallery_framing.check_framing on the --output path.

    +

    | Code | Meaning | | --- | --- | | 0 | Success | | 1 | Uncaught exception (FATAL wrapper) | | 2 | argparse / usage | | 3 | Mesh did not build / no UV layer | | 4 | Base triangle count outside range | | 5 | Material count ≠ 3 distinct slots, or stripe faces missing | | 6 | UVs outside 0..1 | | 7 | UV AABB overlap above tolerance | | 8 | World AABB off declared outer size | | 9 | LOD ratio band (--skip-decimate lands here) | | 10 | Framing gate (render path only) | | 11 | Collider triangle count above ceiling | | 12 | Bake did not finish or image has no data | | 13 | Export file missing or empty | | 14 | --output produced no file |

    +
    +
    +

    Source

    +
    + showcase/market-stall/market_stall.py + View on GitHub → +
    + 
    """Game-ready market stall — a showcase piece, not an example.
+
+Asserts budget conformance of a procedural timber stall after composing
+shipped pipeline pieces: bmesh construction, UVs, three materials,
+high-to-low normal bake, LOD chain, convex collider, Unity glTF export.
+
+Budgets are declared below and recomputed from the generated result.
+They are not API-contract witnesses. ``--skip-decimate`` skips the LOD
+DECIMATE stage so the LOD-ratio budget fails.
+
+No RNG. Construction is closed-form. DECIMATE COLLAPSE triangle counts
+are not byte-identical across Blender versions — the LOD gate is a
+ratio band, not an exact count.
+
+    blender --background --python market_stall.py --
+    blender --background --python market_stall.py -- --skip-decimate
+    blender --background --python market_stall.py -- --output stall.png
+"""
+import argparse
+import math
+import os
+import sys
+import tempfile
+import traceback
+
+import bmesh
+import bpy
+from mathutils import Euler, Vector
+
+# Showcase lives at repo-root/showcase/, not under examples/. The framing
+# helper is the repo's only shared import and lives next to the examples;
+# resolve the repo root so we do not move gallery_framing.py.
+_REPO = os.path.abspath(
+    os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir, os.pardir)
+)
+sys.path.insert(0, os.path.join(_REPO, "examples"))
+sys.dont_write_bytecode = True
+import gallery_framing  # noqa: E402
+
+WIDTH = 1.36
+DEPTH = 0.92
+POST = 0.070
+FRONT_H = 1.28
+BACK_H = 1.72
+N_STRIPES = 8
+AWNING_T = 0.018
+COUNTER_Z = 0.82
+COUNTER_D = 0.34
+COUNTER_T = 0.070
+BRACE = 0.036
+BBOX_TOL = 0.01
+# Fitted to the generated AABB after locking geometry. Recomputed from bound_box.
+OUTER_SIZE = (1.360, 0.964, 1.743)
+
+BASE_TRIS_MIN = 2140
+BASE_TRIS_MAX = 2350
+LOD1_RATIO_MIN = 0.32
+LOD1_RATIO_MAX = 0.62
+LOD2_RATIO_MIN = 0.10
+LOD2_RATIO_MAX = 0.35
+LOD1_TARGET = 0.50
+LOD2_TARGET = 0.22
+MATERIAL_COUNT = 3
+UV_EPS = 1e-4
+UV_OVERLAP_MAX = 1e-5
+COLLIDER_TRIS_MAX = 80
+BAKE_RES = 256
+CAGE_EXTRUSION = 0.06
+
+WOOD_IDX = 0
+STRIPE_A_IDX = 1
+STRIPE_B_IDX = 2
+
+
+def eevee_engine_id():
+    return "BLENDER_EEVEE" if bpy.app.version >= (5, 0, 0) else "BLENDER_EEVEE_NEXT"
+
+
+def fail(msg, code):
+    print(f"ERROR: {msg}", file=sys.stderr)
+    return code
+
+
+def triangle_count(mesh):
+    mesh.calc_loop_triangles()
+    return len(mesh.loop_triangles)
+
+
+def evaluated_triangle_count(obj):
+    # Duplicated from snippets/lod_chain.py / decimate_to_budget.py (not a package).
+    depsgraph = bpy.context.evaluated_depsgraph_get()
+    eval_obj = obj.evaluated_get(depsgraph)
+    eval_mesh = eval_obj.to_mesh()
+    try:
+        eval_mesh.calc_loop_triangles()
+        return len(eval_mesh.loop_triangles)
+    finally:
+        eval_obj.to_mesh_clear()
+
+
+def add_box(bm, loc, scale, mat_idx, euler=(0.0, 0.0, 0.0)):
+    geo = bmesh.ops.create_cube(bm, size=1.0)
+    verts = geo["verts"]
+    rot = Euler(euler).to_matrix()
+    origin = Vector(loc)
+    for v in verts:
+        p = Vector((v.co.x * scale[0], v.co.y * scale[1], v.co.z * scale[2]))
+        v.co = rot @ p + origin
+    faces = {f for v in verts for f in v.link_faces}
+    for f in faces:
+        f.material_index = mat_idx
+    return verts
+
+
+def pack_uvs(bm, margin=0.08):
+    uv = bm.loops.layers.uv.new("UVMap")
+    faces = list(bm.faces)
+    n = len(faces)
+    cols = max(1, math.ceil(math.sqrt(n)))
+    rows = max(1, math.ceil(n / cols))
+    cell_w = 1.0 / cols
+    cell_h = 1.0 / rows
+    pad_u = margin * cell_w * 0.5
+    pad_v = margin * cell_h * 0.5
+    usable_w = cell_w - 2.0 * pad_u
+    usable_h = cell_h - 2.0 * pad_v
+    for i, face in enumerate(faces):
+        col = i % cols
+        row = i // cols
+        nrm = face.normal
+        ax = abs(nrm.x)
+        ay = abs(nrm.y)
+        az = abs(nrm.z)
+        coords = []
+        for loop in face.loops:
+            co = loop.vert.co
+            if az >= ax and az >= ay:
+                coords.append((co.x, co.y))
+            elif ax >= ay:
+                coords.append((co.y, co.z))
+            else:
+                coords.append((co.x, co.z))
+        xs = [c[0] for c in coords]
+        ys = [c[1] for c in coords]
+        minx, maxx = min(xs), max(xs)
+        miny, maxy = min(ys), max(ys)
+        dx = max(maxx - minx, 1e-8)
+        dy = max(maxy - miny, 1e-8)
+        origin_u = col * cell_w + pad_u
+        origin_v = row * cell_h + pad_v
+        for loop, (x, y) in zip(face.loops, coords):
+            loop[uv].uv = (
+                origin_u + (x - minx) / dx * usable_w,
+                origin_v + (y - miny) / dy * usable_h,
+            )
+
+
+def build_stall_mesh(name, bevel_offset, bevel_segments):
+    bm = bmesh.new()
+    wood_verts = []
+    stripe_a = set()
+    stripe_b = set()
+    try:
+        hx = WIDTH / 2.0
+        hy = DEPTH / 2.0
+        inset = POST / 2.0
+        posts = (
+            (-hx + inset, -hy + inset, FRONT_H / 2.0, FRONT_H),
+            (hx - inset, -hy + inset, FRONT_H / 2.0, FRONT_H),
+            (-hx + inset, hy - inset, BACK_H / 2.0, BACK_H),
+            (hx - inset, hy - inset, BACK_H / 2.0, BACK_H),
+        )
+        for x, y, z, h in posts:
+            wood_verts.extend(add_box(bm, (x, y, z), (POST, POST, h), WOOD_IDX))
+
+        # Front and back header beams (along X).
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, -hy + inset, FRONT_H - POST / 2.0),
+                (WIDTH - POST, POST, POST),
+                WOOD_IDX,
+            )
+        )
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, hy - inset, BACK_H - POST / 2.0),
+                (WIDTH - POST, POST, POST),
+                WOOD_IDX,
+            )
+        )
+        # Side plates, slanted to match the awning.
+        dz = BACK_H - FRONT_H
+        slant_len = math.hypot(DEPTH - POST, dz)
+        pitch = math.atan2(dz, DEPTH - POST)
+        for sx in (-hx + inset, hx - inset):
+            wood_verts.extend(
+                add_box(
+                    bm,
+                    (sx, 0.0, (FRONT_H + BACK_H) / 2.0 - POST / 2.0),
+                    (POST * 0.85, slant_len, POST * 0.85),
+                    WOOD_IDX,
+                    euler=(pitch, 0.0, 0.0),
+                )
+            )
+
+        # Mid rail on the back wall and two diagonal braces at the sides.
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, hy - inset, BACK_H * 0.55),
+                (WIDTH - 2.0 * POST, POST * 0.7, POST * 0.7),
+                WOOD_IDX,
+            )
+        )
+        for sx in (-hx + inset, hx - inset):
+            p0 = Vector((sx, -hy + inset, 0.30))
+            p1 = Vector((sx, hy - inset, BACK_H * 0.58))
+            mid = (p0 + p1) * 0.5
+            delta = p1 - p0
+            brace_len = delta.length
+            brace_pitch = math.atan2(delta.z, delta.y)
+            wood_verts.extend(
+                add_box(
+                    bm,
+                    (mid.x, mid.y, mid.z),
+                    (BRACE, brace_len, BRACE),
+                    WOOD_IDX,
+                    euler=(brace_pitch, 0.0, 0.0),
+                )
+            )
+
+        # Counter top, apron, and four legs.
+        cy = -hy + COUNTER_D / 2.0 + 0.04
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, cy, COUNTER_Z),
+                (WIDTH - 0.04, COUNTER_D, COUNTER_T),
+                WOOD_IDX,
+            )
+        )
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, cy - COUNTER_D / 2.0 + COUNTER_T / 2.0, COUNTER_Z - 0.09),
+                (WIDTH - 0.08, COUNTER_T * 0.7, 0.16),
+                WOOD_IDX,
+            )
+        )
+        under_shelf_z = 0.38
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, cy, under_shelf_z),
+                (WIDTH - 0.16, COUNTER_D * 0.78, 0.028),
+                WOOD_IDX,
+            )
+        )
+        for lx in (-hx + 0.16, hx - 0.16):
+            for ly in (cy - COUNTER_D * 0.32, cy + COUNTER_D * 0.32):
+                wood_verts.extend(
+                    add_box(
+                        bm,
+                        (lx, ly, COUNTER_Z / 2.0),
+                        (0.045, 0.045, COUNTER_Z),
+                        WOOD_IDX,
+                    )
+                )
+
+        # Backboard behind the counter.
+        wood_verts.extend(
+            add_box(
+                bm,
+                (0.0, hy - inset - 0.012, 0.95),
+                (WIDTH - 2.2 * POST, 0.022, 0.55),
+                WOOD_IDX,
+            )
+        )
+
+        stripe_w = WIDTH / N_STRIPES
+        awning_len = math.hypot(DEPTH, dz)
+        awning_pitch = math.atan2(dz, DEPTH)
+        cz = (FRONT_H + BACK_H) / 2.0 + AWNING_T * 0.35
+        for i in range(N_STRIPES):
+            cx = -hx + (i + 0.5) * stripe_w
+            idx = STRIPE_A_IDX if (i % 2 == 0) else STRIPE_B_IDX
+            before = set(bm.faces)
+            add_box(
+                bm,
+                (cx, 0.0, cz),
+                (stripe_w * 0.98, awning_len + 0.04, AWNING_T),
+                idx,
+                euler=(awning_pitch, 0.0, 0.0),
+            )
+            new_faces = set(bm.faces) - before
+            if idx == STRIPE_A_IDX:
+                stripe_a.update(new_faces)
+            else:
+                stripe_b.update(new_faces)
+
+        # Front valance hanging from the eave.
+        for i in range(N_STRIPES):
+            cx = -hx + (i + 0.5) * stripe_w
+            idx = STRIPE_B_IDX if (i % 2 == 0) else STRIPE_A_IDX
+            before = set(bm.faces)
+            add_box(
+                bm,
+                (cx, -hy - 0.01, FRONT_H - 0.08),
+                (stripe_w * 0.96, 0.016, 0.14),
+                idx,
+            )
+            new_faces = set(bm.faces) - before
+            if idx == STRIPE_A_IDX:
+                stripe_a.update(new_faces)
+            else:
+                stripe_b.update(new_faces)
+
+        if bevel_offset > 0.0:
+            edges = list({e for v in wood_verts for e in v.link_edges})
+            bmesh.ops.bevel(
+                bm,
+                geom=edges,
+                offset=bevel_offset,
+                segments=bevel_segments,
+                profile=0.5,
+                affect="EDGES",
+                clamp_overlap=True,
+            )
+
+        zmin = min(v.co.z for v in bm.verts)
+        if zmin != 0.0:
+            for v in bm.verts:
+                v.co.z -= zmin
+
+        pack_uvs(bm)
+        bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces))
+        for face in bm.faces:
+            face.smooth = False
+        for edge in bm.edges:
+            edge.smooth = False
+            if edge.is_manifold and len(edge.link_faces) == 2:
+                if edge.calc_face_angle() < math.radians(25.0):
+                    edge.smooth = True
+        for f in stripe_a:
+            if f.is_valid:
+                f.material_index = STRIPE_A_IDX
+        for f in stripe_b:
+            if f.is_valid:
+                f.material_index = STRIPE_B_IDX
+        me = bpy.data.meshes.new(name)
+        bm.to_mesh(me)
+        me.update()
+    finally:
+        bm.free()
+    obj = bpy.data.objects.new(name, me)
+    bpy.context.collection.objects.link(obj)
+    return obj
+
+
+def principled(name, color, metallic, roughness):
+    mat = bpy.data.materials.new(name)
+    mat.use_nodes = True
+    bsdf = mat.node_tree.nodes["Principled BSDF"]
+    bsdf.inputs["Base Color"].default_value = color
+    bsdf.inputs["Metallic"].default_value = metallic
+    bsdf.inputs["Roughness"].default_value = roughness
+    return mat
+
+
+def assign_slots(obj, wood, stripe_a, stripe_b):
+    # Do not materials.clear() — that resets polygon material_index to 0
+    # on this Blender, which would drop awning stripes onto wood.
+    mats = obj.data.materials
+    wanted = (wood, stripe_a, stripe_b)
+    for i, mat in enumerate(wanted):
+        if i < len(mats):
+            mats[i] = mat
+        else:
+            mats.append(mat)
+
+
+def world_bbox(obj):
+    corners = [obj.matrix_world @ Vector(c) for c in obj.bound_box]
+    xs = [c.x for c in corners]
+    ys = [c.y for c in corners]
+    zs = [c.z for c in corners]
+    return (min(xs), min(ys), min(zs), max(xs), max(ys), max(zs))
+
+
+def uv_stats(mesh):
+    uv = mesh.uv_layers.active
+    if uv is None:
+        return 0.0, 0.0, 1.0, 1.0, 0, 1.0
+    data = uv.data
+    us = [loop.uv[0] for loop in data]
+    vs = [loop.uv[1] for loop in data]
+    aabbs = []
+    for poly in mesh.polygons:
+        pu = [data[i].uv[0] for i in poly.loop_indices]
+        pv = [data[i].uv[1] for i in poly.loop_indices]
+        aabbs.append((min(pu), min(pv), max(pu), max(pv)))
+    overlap = 0.0
+    for i in range(len(aabbs)):
+        a = aabbs[i]
+        for j in range(i + 1, len(aabbs)):
+            b = aabbs[j]
+            x0 = max(a[0], b[0])
+            y0 = max(a[1], b[1])
+            x1 = min(a[2], b[2])
+            y1 = min(a[3], b[3])
+            overlap += max(0.0, x1 - x0) * max(0.0, y1 - y0)
+    return min(us), min(vs), max(us), max(vs), overlap, len(aabbs)
+
+
+def make_lod(obj, name, ratio, skip_decimate):
+    mesh = obj.data.copy()
+    lod = bpy.data.objects.new(name, mesh)
+    lod.matrix_world = obj.matrix_world.copy()
+    bpy.context.scene.collection.objects.link(lod)
+    if not skip_decimate and 0.0 < ratio < 1.0:
+        mod = lod.modifiers.new("DecimateBudget", "DECIMATE")
+        mod.decimate_type = "COLLAPSE"
+        mod.ratio = ratio
+    return lod
+
+
+def convex_hull_collider(obj, name):
+    # Duplicated from snippets/convex_hull_collider.py (not a package).
+    mesh = bpy.data.meshes.new(name)
+    bm = bmesh.new()
+    try:
+        bm.from_mesh(obj.data)
+        result = bmesh.ops.convex_hull(bm, input=list(bm.verts))
+        interior = result.get("geom_interior") or []
+        unused = result.get("geom_unused") or []
+        if interior:
+            bmesh.ops.delete(bm, geom=interior, context="VERTS")
+        if unused:
+            bmesh.ops.delete(bm, geom=unused, context="VERTS")
+        bm.to_mesh(mesh)
+        mesh.update()
+    finally:
+        bm.free()
+    collider = bpy.data.objects.new(name, mesh)
+    bpy.context.collection.objects.link(collider)
+    collider.matrix_world = obj.matrix_world.copy()
+    return collider
+
+
+def setup_bake_image(obj, target_mat, size=BAKE_RES):
+    # Adapted from snippets/setup_bake_target_image.py — do not replace slots.
+    if not obj.data.uv_layers:
+        return None, None
+    img = bpy.data.images.new("StallNrm", size, size, alpha=True, float_buffer=False)
+    img.colorspace_settings.name = "Non-Color"
+    nodes = target_mat.node_tree.nodes
+    tex = nodes.new("ShaderNodeTexImage")
+    tex.image = img
+    nodes.active = tex
+    tex.select = True
+    obj.active_material_index = WOOD_IDX
+    return img, tex
+
+
+def bake_normal(high, low):
+    # Duplicated from snippets/bake_normal_high_to_low.py (not a package).
+    scene = bpy.context.scene
+    scene.render.engine = "CYCLES"
+    scene.cycles.device = "CPU"
+    scene.cycles.samples = 1
+    scene.cycles.use_denoising = False
+    for ob in bpy.context.view_layer.objects:
+        ob.select_set(False)
+    high.select_set(True)
+    low.select_set(True)
+    bpy.context.view_layer.objects.active = low
+    return bpy.ops.object.bake(
+        type="NORMAL",
+        use_selected_to_active=True,
+        cage_extrusion=CAGE_EXTRUSION,
+        use_cage=False,
+        normal_space="TANGENT",
+        margin=4,
+        margin_type="ADJACENT_FACES",
+        use_clear=True,
+        target="IMAGE_TEXTURES",
+    )
+
+
+def export_unity(path, objects):
+    # Duplicated from snippets/export_preset_unity.py (not a package).
+    for ob in bpy.context.view_layer.objects:
+        ob.select_set(False)
+    for ob in objects:
+        ob.select_set(True)
+    bpy.context.view_layer.objects.active = objects[0]
+    bpy.ops.export_scene.gltf(
+        filepath=path,
+        use_selection=True,
+        export_yup=True,
+        export_apply=True,
+        export_draco_mesh_compression_enable=False,
+        export_animations=False,
+    )
+
+
+def check(skip_decimate):
+    bpy.ops.wm.read_factory_settings(use_empty=True)
+    low = build_stall_mesh("StallLow", bevel_offset=0.006, bevel_segments=2)
+    high = build_stall_mesh("StallHigh", bevel_offset=0.006, bevel_segments=4)
+    wood = principled("StallWood", (0.42, 0.24, 0.10, 1.0), 0.0, 0.55)
+    stripe_a = principled("StallStripeA", (0.72, 0.12, 0.10, 1.0), 0.0, 0.62)
+    stripe_b = principled("StallStripeB", (0.86, 0.80, 0.62, 1.0), 0.0, 0.58)
+    assign_slots(low, wood, stripe_a, stripe_b)
+    assign_slots(high, wood, stripe_a, stripe_b)
+
+    if low.data is None or len(low.data.polygons) < 6:
+        return fail("stall mesh did not build", 3), None, None, None, None, None
+
+    base_tris = triangle_count(low.data)
+    mats = [s for s in low.data.materials if s is not None]
+    nmat = len(mats)
+    distinct_mats = len({id(s) for s in mats})
+    idx_counts = {}
+    for poly in low.data.polygons:
+        idx_counts[poly.material_index] = idx_counts.get(poly.material_index, 0) + 1
+    print(f"measured mat_index_counts={idx_counts}")
+    u0, v0, u1, v1, overlap, nfaces = uv_stats(low.data)
+    bb = world_bbox(low)
+    size_x = bb[3] - bb[0]
+    size_y = bb[4] - bb[1]
+    size_z = bb[5] - bb[2]
+
+    img, tex = setup_bake_image(low, wood)
+    if img is None:
+        return fail("stall has no UV layer", 3), None, None, None, None, None
+    bake_result = bake_normal(high, low)
+
+    lod1 = make_lod(low, "StallLOD1", LOD1_TARGET, skip_decimate)
+    lod2 = make_lod(low, "StallLOD2", LOD2_TARGET, skip_decimate)
+    bpy.context.view_layer.update()
+    lod1_tris = evaluated_triangle_count(lod1)
+    lod2_tris = evaluated_triangle_count(lod2)
+    r1 = lod1_tris / base_tris if base_tris else 0.0
+    r2 = lod2_tris / base_tris if base_tris else 0.0
+
+    collider_src = build_stall_mesh("StallColSrc", bevel_offset=0.0, bevel_segments=1)
+    collider = convex_hull_collider(collider_src, "StallCollider")
+    bpy.data.objects.remove(collider_src, do_unlink=True)
+    col_tris = triangle_count(collider.data)
+
+    export_path = os.path.join(
+        tempfile.gettempdir(),
+        f"bdt_market_stall_{os.getpid()}.glb",
+    )
+    if os.path.exists(export_path):
+        os.remove(export_path)
+    export_unity(export_path, [low, collider])
+    export_size = os.path.getsize(export_path) if os.path.isfile(export_path) else 0
+
+    print(
+        f"blender={tuple(bpy.app.version)} skip_decimate={skip_decimate}"
+    )
+    print(
+        f"measured base_tris={base_tris} lod1_tris={lod1_tris} "
+        f"lod2_tris={lod2_tris} r1={r1:.4f} r2={r2:.4f}"
+    )
+    print(
+        f"measured nmat={nmat} uv=({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f}) "
+        f"overlap={overlap:.6f} nfaces={nfaces}"
+    )
+    print(
+        f"measured bbox=({size_x:.4f},{size_y:.4f},{size_z:.4f}) "
+        f"outer={OUTER_SIZE} zmin={bb[2]:.4f}"
+    )
+    print(
+        f"measured collider_tris={col_tris} bake={bake_result} "
+        f"bake_has_data={img.has_data} export_bytes={export_size}"
+    )
+
+    if not (BASE_TRIS_MIN <= base_tris <= BASE_TRIS_MAX):
+        return fail(
+            f"base tris {base_tris} not in [{BASE_TRIS_MIN}, {BASE_TRIS_MAX}]",
+            4,
+        ), None, None, None, None, None
+    if nmat != MATERIAL_COUNT or distinct_mats != MATERIAL_COUNT:
+        return fail(
+            f"material slots {nmat} distinct {distinct_mats} != {MATERIAL_COUNT}",
+            5,
+        ), None, None, None, None, None
+    if idx_counts.get(STRIPE_A_IDX, 0) < 16:
+        return fail(
+            f"stripe A faces {idx_counts.get(STRIPE_A_IDX, 0)} < 16",
+            5,
+        ), None, None, None, None, None
+    if idx_counts.get(STRIPE_B_IDX, 0) < 16:
+        return fail(
+            f"stripe B faces {idx_counts.get(STRIPE_B_IDX, 0)} < 16",
+            5,
+        ), None, None, None, None, None
+    if u0 < -UV_EPS or v0 < -UV_EPS or u1 > 1.0 + UV_EPS or v1 > 1.0 + UV_EPS:
+        return fail(
+            f"UVs outside 0..1: ({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f})",
+            6,
+        ), None, None, None, None, None
+    if overlap > UV_OVERLAP_MAX:
+        return fail(
+            f"UV AABB overlap {overlap:.6f} > {UV_OVERLAP_MAX}",
+            7,
+        ), None, None, None, None, None
+    if (
+        abs(size_x - OUTER_SIZE[0]) > BBOX_TOL
+        or abs(size_y - OUTER_SIZE[1]) > BBOX_TOL
+        or abs(size_z - OUTER_SIZE[2]) > BBOX_TOL
+    ):
+        return fail(
+            f"bbox ({size_x:.4f},{size_y:.4f},{size_z:.4f}) "
+            f"off outer {OUTER_SIZE}",
+            8,
+        ), None, None, None, None, None
+    if not (LOD1_RATIO_MIN <= r1 <= LOD1_RATIO_MAX):
+        return fail(
+            f"LOD1 ratio {r1:.4f} not in [{LOD1_RATIO_MIN}, {LOD1_RATIO_MAX}] "
+            "(--skip-decimate is the designed fail)",
+            9,
+        ), None, None, None, None, None
+    if not (LOD2_RATIO_MIN <= r2 <= LOD2_RATIO_MAX):
+        return fail(
+            f"LOD2 ratio {r2:.4f} not in [{LOD2_RATIO_MIN}, {LOD2_RATIO_MAX}]",
+            9,
+        ), None, None, None, None, None
+    if col_tris > COLLIDER_TRIS_MAX:
+        return fail(
+            f"collider tris {col_tris} > {COLLIDER_TRIS_MAX}",
+            11,
+        ), None, None, None, None, None
+    if bake_result != {"FINISHED"} or not img.has_data:
+        return fail(
+            f"bake failed result={bake_result} has_data={img.has_data}",
+            12,
+        ), None, None, None, None, None
+    if export_size <= 0:
+        return fail("export file missing or empty", 13), None, None, None, None, None
+    return 0, low, high, wood, tex, collider
+
+
+def wire_normal(mat, tex):
+    nt = mat.node_tree
+    bsdf = nt.nodes["Principled BSDF"]
+    nrm = nt.nodes.new("ShaderNodeNormalMap")
+    nrm.inputs["Strength"].default_value = 1.0
+    nt.links.new(tex.outputs["Color"], nrm.inputs["Color"])
+    nt.links.new(nrm.outputs["Normal"], bsdf.inputs["Normal"])
+
+
+def render_still(low, wood, tex, path, engine):
+    scene = bpy.context.scene
+    wire_normal(wood, tex)
+    for ob in list(scene.objects):
+        if ob.type == "MESH" and ob != low:
+            ob.hide_render = True
+            ob.hide_viewport = True
+
+    low.rotation_euler.z = math.radians(-26.0)
+    low.rotation_euler.x = math.radians(3.0)
+
+    floor_me = bpy.data.meshes.new("Floor")
+    bm = bmesh.new()
+    try:
+        bmesh.ops.create_grid(bm, x_segments=1, y_segments=1, size=14.0)
+        bm.to_mesh(floor_me)
+    finally:
+        bm.free()
+    fmat = bpy.data.materials.new("Floor")
+    fmat.use_nodes = True
+    fb = fmat.node_tree.nodes["Principled BSDF"]
+    fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0)
+    fb.inputs["Roughness"].default_value = 0.7
+    floor_me.materials.append(fmat)
+    floor = bpy.data.objects.new("Floor", floor_me)
+    scene.collection.objects.link(floor)
+    wall = bpy.data.objects.new("Wall", floor_me.copy())
+    wall.location = (0.0, 8.5, 0.0)
+    wall.rotation_euler = (math.radians(90), 0.0, 0.0)
+    scene.collection.objects.link(wall)
+
+    world = bpy.data.worlds.new("World")
+    world.use_nodes = True
+    world.node_tree.nodes["Background"].inputs["Color"].default_value = (
+        0.02, 0.021, 0.025, 1.0,
+    )
+    scene.world = world
+
+    def light(name, loc, energy, size, col, rot):
+        ld = bpy.data.lights.new(name, "AREA")
+        ld.energy = energy
+        ld.size = size
+        ld.color = col
+        ob = bpy.data.objects.new(name, ld)
+        ob.location = loc
+        ob.rotation_euler = tuple(math.radians(a) for a in rot)
+        scene.collection.objects.link(ob)
+
+    light("Key", (-3.6, -5.0, 5.8), 680.0, 4.0, (1.0, 0.94, 0.86), (50, 0, -36))
+    light("Fill", (5.0, -3.6, 2.6), 48.0, 8.0, (0.72, 0.82, 1.0), (62, 0, 50))
+    light("Wedge", (2.4, 4.2, 4.1), 640.0, 5.5, (1.0, 0.70, 0.40), (-70, 0, 198))
+
+    cam_data = bpy.data.cameras.new("Cam")
+    cam_data.lens = 50.0
+    cam = bpy.data.objects.new("Cam", cam_data)
+    cam.location = (3.51, -5.00, 2.42)
+    scene.collection.objects.link(cam)
+    aim = bpy.data.objects.new("Aim", None)
+    aim.location = (0.0, 0.0, 0.88)
+    scene.collection.objects.link(aim)
+    con = cam.constraints.new("TRACK_TO")
+    con.target = aim
+    con.track_axis = "TRACK_NEGATIVE_Z"
+    con.up_axis = "UP_Y"
+    scene.camera = cam
+
+    scene.render.engine = "CYCLES" if engine == "cycles" else eevee_engine_id()
+    if engine == "cycles":
+        scene.cycles.samples = 32
+        scene.cycles.device = "CPU"
+    else:
+        try:
+            scene.eevee.taa_render_samples = 64
+        except AttributeError:
+            pass
+    scene.render.resolution_x = 1280
+    scene.render.resolution_y = 720
+    scene.render.image_settings.file_format = (
+        "WEBP" if path.lower().endswith(".webp") else "PNG"
+    )
+    if path.lower().endswith(".webp"):
+        scene.render.image_settings.quality = 90
+    scene.render.filepath = path
+    scene.view_settings.view_transform = "Standard"
+
+    fcode = gallery_framing.check_framing(
+        scene, cam, hero=[low], elements=[low], stage=[floor, wall],
+    )
+    if fcode:
+        return fcode
+    bpy.ops.render.render(write_still=True)
+    if not (os.path.exists(path) and os.path.getsize(path) > 0):
+        return fail("render produced no file", 14)
+    return 0
+
+
+def main():
+    argv = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else []
+    p = argparse.ArgumentParser()
+    p.add_argument("--output", default=None)
+    p.add_argument("--engine", default="eevee", choices=("eevee", "cycles"))
+    p.add_argument(
+        "--skip-decimate",
+        action="store_true",
+        help="falsification: skip the LOD DECIMATE stage",
+    )
+    args = p.parse_args(argv)
+
+    code, low, _high, wood, tex, _col = check(args.skip_decimate)
+    if code:
+        return code
+    if args.output:
+        rcode = render_still(low, wood, tex, os.path.abspath(args.output), args.engine)
+        if rcode:
+            return rcode
+        print(f"rendered still {args.output}")
+    print("market-stall OK")
+    return 0
+
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except Exception as e:
+        traceback.print_exc()
+        print(f"FATAL: {e}", file=sys.stderr)
+        sys.exit(1)
+
    +
    +
    + +
    +
    + generated from examples/gallery.json + CC-BY-NC-ND-4.0 + exit 0 +
    +
    + + + diff --git a/showcase/gallery.json b/showcase/gallery.json index bcec209..9a1b572 100644 --- a/showcase/gallery.json +++ b/showcase/gallery.json @@ -52,6 +52,18 @@ "mesh", "export" ] + }, + { + "name": "market-stall", + "dir": "showcase/market-stall", + "teaches": "A procedural timber market stall through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.", + "witnessesFix": "Recomputed: 2244 tris, three materials with 48 faces per awning stripe slot, UVs in 0..1 with zero AABB overlap, outer AABB 1.360×0.964×1.743 m, LOD ratios in band, convex collider 28 tris, non-empty glTF. --skip-decimate exits 9 on the LOD1 ratio budget.", + "hero": "docs/gallery/assets/market-stall-hero.webp", + "preview": "showcase/market-stall/preview.webp", + "tags": [ + "mesh", + "export" + ] } ] } diff --git a/showcase/market-stall/README.md b/showcase/market-stall/README.md new file mode 100644 index 0000000..823383c --- /dev/null +++ b/showcase/market-stall/README.md @@ -0,0 +1,73 @@ +# Market stall + +A showcase piece, not an example. Procedural timber stall (posts, slanted +side plates, counter with apron and shelf, backboard, striped awning and +valance) then the shipped pipeline: unique-cell UVs, Cycles high-to-low +normal bake, LOD chain, convex collider, Unity glTF export. + +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, not imported as a package). + +## Budgets + +Declared as named constants; every gate **recomputes** from the mesh, +materials, UVs, evaluated LOD, collider, or export file. + +| Axis | Declared | Measured (4.5.11 / 5.1.2 / 5.2.1) | +| --- | --- | --- | +| Base triangles | 2140–2350 | 2244 / 2244 / 2244 | +| LOD1 ratio | 0.32–0.62 of base | 0.5000 / 0.5000 / 0.5000 | +| LOD2 ratio | 0.10–0.35 of base | 0.2193 / 0.2193 / 0.2193 | +| Materials | exactly 3 distinct, ≥16 faces per stripe slot | 3 slots, 48 / 48 stripe faces | +| UVs | in `0..1`, AABB overlap ≤ 1e-5 | in range, overlap 0 | +| Outer AABB | (1.360, 0.964, 1.743) m ± 0.01 | (1.3600, 0.9639, 1.7430), zmin 0 | +| Collider tris | ≤ 80 | 28 | +| Export | written, size > 0 | 163992 / 163992 / 163968 bytes | + +DECIMATE COLLAPSE triangle counts are **not** guaranteed identical across +series — the gate is a ratio band, not an exact count. This mesh happened +to match on 4.5.11 / 5.1.2 / 5.2.1. Bake pixels are stochastic; the gate +is `has_data` plus operator `FINISHED`, not byte-identity. Construction +uses no RNG. glTF byte size differs by a few bytes across series. + +`--skip-decimate` skips the LOD DECIMATE stage so LOD1 ratio is 1.0 and +exit 9 fires. That is the named budget the falsifier violates. + +## Run + +```bash +blender --background --python market_stall.py -- +blender --background --python market_stall.py -- --skip-decimate +blender --background --python market_stall.py -- --output stall.png +``` + +Smoke does not pass `--output` or `--skip-decimate`. + +## Exit codes + +File-local. `9` is a valid check code. `10` is reserved for +`gallery_framing.check_framing` on the `--output` path. + +| Code | Meaning | +| --- | --- | +| 0 | Success | +| 1 | Uncaught exception (FATAL wrapper) | +| 2 | argparse / usage | +| 3 | Mesh did not build / no UV layer | +| 4 | Base triangle count outside range | +| 5 | Material count ≠ 3 distinct slots, or stripe faces missing | +| 6 | UVs outside 0..1 | +| 7 | UV AABB overlap above tolerance | +| 8 | World AABB off declared outer size | +| 9 | LOD ratio band (`--skip-decimate` lands here) | +| 10 | Framing gate (render path only) | +| 11 | Collider triangle count above ceiling | +| 12 | Bake did not finish or image has no data | +| 13 | Export file missing or empty | +| 14 | `--output` produced no file | diff --git a/showcase/market-stall/market_stall.py b/showcase/market-stall/market_stall.py new file mode 100644 index 0000000..27cc074 --- /dev/null +++ b/showcase/market-stall/market_stall.py @@ -0,0 +1,784 @@ +"""Game-ready market stall — a showcase piece, not an example. + +Asserts budget conformance of a procedural timber stall after composing +shipped pipeline pieces: bmesh construction, UVs, three materials, +high-to-low normal bake, LOD chain, convex collider, Unity glTF export. + +Budgets are declared below and recomputed from the generated result. +They are not API-contract witnesses. ``--skip-decimate`` skips the LOD +DECIMATE stage so the LOD-ratio budget fails. + +No RNG. Construction is closed-form. DECIMATE COLLAPSE triangle counts +are not byte-identical across Blender versions — the LOD gate is a +ratio band, not an exact count. + + blender --background --python market_stall.py -- + blender --background --python market_stall.py -- --skip-decimate + blender --background --python market_stall.py -- --output stall.png +""" +import argparse +import math +import os +import sys +import tempfile +import traceback + +import bmesh +import bpy +from mathutils import Euler, Vector + +# Showcase lives at repo-root/showcase/, not under examples/. The framing +# helper is the repo's only shared import and lives next to the examples; +# resolve the repo root so we do not move gallery_framing.py. +_REPO = os.path.abspath( + os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir, os.pardir) +) +sys.path.insert(0, os.path.join(_REPO, "examples")) +sys.dont_write_bytecode = True +import gallery_framing # noqa: E402 + +WIDTH = 1.36 +DEPTH = 0.92 +POST = 0.070 +FRONT_H = 1.28 +BACK_H = 1.72 +N_STRIPES = 8 +AWNING_T = 0.018 +COUNTER_Z = 0.82 +COUNTER_D = 0.34 +COUNTER_T = 0.070 +BRACE = 0.036 +BBOX_TOL = 0.01 +# Fitted to the generated AABB after locking geometry. Recomputed from bound_box. +OUTER_SIZE = (1.360, 0.964, 1.743) + +BASE_TRIS_MIN = 2140 +BASE_TRIS_MAX = 2350 +LOD1_RATIO_MIN = 0.32 +LOD1_RATIO_MAX = 0.62 +LOD2_RATIO_MIN = 0.10 +LOD2_RATIO_MAX = 0.35 +LOD1_TARGET = 0.50 +LOD2_TARGET = 0.22 +MATERIAL_COUNT = 3 +UV_EPS = 1e-4 +UV_OVERLAP_MAX = 1e-5 +COLLIDER_TRIS_MAX = 80 +BAKE_RES = 256 +CAGE_EXTRUSION = 0.06 + +WOOD_IDX = 0 +STRIPE_A_IDX = 1 +STRIPE_B_IDX = 2 + + +def eevee_engine_id(): + return "BLENDER_EEVEE" if bpy.app.version >= (5, 0, 0) else "BLENDER_EEVEE_NEXT" + + +def fail(msg, code): + print(f"ERROR: {msg}", file=sys.stderr) + return code + + +def triangle_count(mesh): + mesh.calc_loop_triangles() + return len(mesh.loop_triangles) + + +def evaluated_triangle_count(obj): + # Duplicated from snippets/lod_chain.py / decimate_to_budget.py (not a package). + depsgraph = bpy.context.evaluated_depsgraph_get() + eval_obj = obj.evaluated_get(depsgraph) + eval_mesh = eval_obj.to_mesh() + try: + eval_mesh.calc_loop_triangles() + return len(eval_mesh.loop_triangles) + finally: + eval_obj.to_mesh_clear() + + +def add_box(bm, loc, scale, mat_idx, euler=(0.0, 0.0, 0.0)): + geo = bmesh.ops.create_cube(bm, size=1.0) + verts = geo["verts"] + rot = Euler(euler).to_matrix() + origin = Vector(loc) + for v in verts: + p = Vector((v.co.x * scale[0], v.co.y * scale[1], v.co.z * scale[2])) + v.co = rot @ p + origin + faces = {f for v in verts for f in v.link_faces} + for f in faces: + f.material_index = mat_idx + return verts + + +def pack_uvs(bm, margin=0.08): + uv = bm.loops.layers.uv.new("UVMap") + faces = list(bm.faces) + n = len(faces) + cols = max(1, math.ceil(math.sqrt(n))) + rows = max(1, math.ceil(n / cols)) + cell_w = 1.0 / cols + cell_h = 1.0 / rows + pad_u = margin * cell_w * 0.5 + pad_v = margin * cell_h * 0.5 + usable_w = cell_w - 2.0 * pad_u + usable_h = cell_h - 2.0 * pad_v + for i, face in enumerate(faces): + col = i % cols + row = i // cols + nrm = face.normal + ax = abs(nrm.x) + ay = abs(nrm.y) + az = abs(nrm.z) + coords = [] + for loop in face.loops: + co = loop.vert.co + if az >= ax and az >= ay: + coords.append((co.x, co.y)) + elif ax >= ay: + coords.append((co.y, co.z)) + else: + coords.append((co.x, co.z)) + xs = [c[0] for c in coords] + ys = [c[1] for c in coords] + minx, maxx = min(xs), max(xs) + miny, maxy = min(ys), max(ys) + dx = max(maxx - minx, 1e-8) + dy = max(maxy - miny, 1e-8) + origin_u = col * cell_w + pad_u + origin_v = row * cell_h + pad_v + for loop, (x, y) in zip(face.loops, coords): + loop[uv].uv = ( + origin_u + (x - minx) / dx * usable_w, + origin_v + (y - miny) / dy * usable_h, + ) + + +def build_stall_mesh(name, bevel_offset, bevel_segments): + bm = bmesh.new() + wood_verts = [] + stripe_a = set() + stripe_b = set() + try: + hx = WIDTH / 2.0 + hy = DEPTH / 2.0 + inset = POST / 2.0 + posts = ( + (-hx + inset, -hy + inset, FRONT_H / 2.0, FRONT_H), + (hx - inset, -hy + inset, FRONT_H / 2.0, FRONT_H), + (-hx + inset, hy - inset, BACK_H / 2.0, BACK_H), + (hx - inset, hy - inset, BACK_H / 2.0, BACK_H), + ) + for x, y, z, h in posts: + wood_verts.extend(add_box(bm, (x, y, z), (POST, POST, h), WOOD_IDX)) + + # Front and back header beams (along X). + wood_verts.extend( + add_box( + bm, + (0.0, -hy + inset, FRONT_H - POST / 2.0), + (WIDTH - POST, POST, POST), + WOOD_IDX, + ) + ) + wood_verts.extend( + add_box( + bm, + (0.0, hy - inset, BACK_H - POST / 2.0), + (WIDTH - POST, POST, POST), + WOOD_IDX, + ) + ) + # Side plates, slanted to match the awning. + dz = BACK_H - FRONT_H + slant_len = math.hypot(DEPTH - POST, dz) + pitch = math.atan2(dz, DEPTH - POST) + for sx in (-hx + inset, hx - inset): + wood_verts.extend( + add_box( + bm, + (sx, 0.0, (FRONT_H + BACK_H) / 2.0 - POST / 2.0), + (POST * 0.85, slant_len, POST * 0.85), + WOOD_IDX, + euler=(pitch, 0.0, 0.0), + ) + ) + + # Mid rail on the back wall and two diagonal braces at the sides. + wood_verts.extend( + add_box( + bm, + (0.0, hy - inset, BACK_H * 0.55), + (WIDTH - 2.0 * POST, POST * 0.7, POST * 0.7), + WOOD_IDX, + ) + ) + for sx in (-hx + inset, hx - inset): + p0 = Vector((sx, -hy + inset, 0.30)) + p1 = Vector((sx, hy - inset, BACK_H * 0.58)) + mid = (p0 + p1) * 0.5 + delta = p1 - p0 + brace_len = delta.length + brace_pitch = math.atan2(delta.z, delta.y) + wood_verts.extend( + add_box( + bm, + (mid.x, mid.y, mid.z), + (BRACE, brace_len, BRACE), + WOOD_IDX, + euler=(brace_pitch, 0.0, 0.0), + ) + ) + + # Counter top, apron, and four legs. + cy = -hy + COUNTER_D / 2.0 + 0.04 + wood_verts.extend( + add_box( + bm, + (0.0, cy, COUNTER_Z), + (WIDTH - 0.04, COUNTER_D, COUNTER_T), + WOOD_IDX, + ) + ) + wood_verts.extend( + add_box( + bm, + (0.0, cy - COUNTER_D / 2.0 + COUNTER_T / 2.0, COUNTER_Z - 0.09), + (WIDTH - 0.08, COUNTER_T * 0.7, 0.16), + WOOD_IDX, + ) + ) + under_shelf_z = 0.38 + wood_verts.extend( + add_box( + bm, + (0.0, cy, under_shelf_z), + (WIDTH - 0.16, COUNTER_D * 0.78, 0.028), + WOOD_IDX, + ) + ) + for lx in (-hx + 0.16, hx - 0.16): + for ly in (cy - COUNTER_D * 0.32, cy + COUNTER_D * 0.32): + wood_verts.extend( + add_box( + bm, + (lx, ly, COUNTER_Z / 2.0), + (0.045, 0.045, COUNTER_Z), + WOOD_IDX, + ) + ) + + # Backboard behind the counter. + wood_verts.extend( + add_box( + bm, + (0.0, hy - inset - 0.012, 0.95), + (WIDTH - 2.2 * POST, 0.022, 0.55), + WOOD_IDX, + ) + ) + + stripe_w = WIDTH / N_STRIPES + awning_len = math.hypot(DEPTH, dz) + awning_pitch = math.atan2(dz, DEPTH) + cz = (FRONT_H + BACK_H) / 2.0 + AWNING_T * 0.35 + for i in range(N_STRIPES): + cx = -hx + (i + 0.5) * stripe_w + idx = STRIPE_A_IDX if (i % 2 == 0) else STRIPE_B_IDX + before = set(bm.faces) + add_box( + bm, + (cx, 0.0, cz), + (stripe_w * 0.98, awning_len + 0.04, AWNING_T), + idx, + euler=(awning_pitch, 0.0, 0.0), + ) + new_faces = set(bm.faces) - before + if idx == STRIPE_A_IDX: + stripe_a.update(new_faces) + else: + stripe_b.update(new_faces) + + # Front valance hanging from the eave. + for i in range(N_STRIPES): + cx = -hx + (i + 0.5) * stripe_w + idx = STRIPE_B_IDX if (i % 2 == 0) else STRIPE_A_IDX + before = set(bm.faces) + add_box( + bm, + (cx, -hy - 0.01, FRONT_H - 0.08), + (stripe_w * 0.96, 0.016, 0.14), + idx, + ) + new_faces = set(bm.faces) - before + if idx == STRIPE_A_IDX: + stripe_a.update(new_faces) + else: + stripe_b.update(new_faces) + + if bevel_offset > 0.0: + edges = list({e for v in wood_verts for e in v.link_edges}) + bmesh.ops.bevel( + bm, + geom=edges, + offset=bevel_offset, + segments=bevel_segments, + profile=0.5, + affect="EDGES", + clamp_overlap=True, + ) + + zmin = min(v.co.z for v in bm.verts) + if zmin != 0.0: + for v in bm.verts: + v.co.z -= zmin + + pack_uvs(bm) + bmesh.ops.recalc_face_normals(bm, faces=list(bm.faces)) + for face in bm.faces: + face.smooth = False + for edge in bm.edges: + edge.smooth = False + if edge.is_manifold and len(edge.link_faces) == 2: + if edge.calc_face_angle() < math.radians(25.0): + edge.smooth = True + for f in stripe_a: + if f.is_valid: + f.material_index = STRIPE_A_IDX + for f in stripe_b: + if f.is_valid: + f.material_index = STRIPE_B_IDX + me = bpy.data.meshes.new(name) + bm.to_mesh(me) + me.update() + finally: + bm.free() + obj = bpy.data.objects.new(name, me) + bpy.context.collection.objects.link(obj) + return obj + + +def principled(name, color, metallic, roughness): + mat = bpy.data.materials.new(name) + mat.use_nodes = True + bsdf = mat.node_tree.nodes["Principled BSDF"] + bsdf.inputs["Base Color"].default_value = color + bsdf.inputs["Metallic"].default_value = metallic + bsdf.inputs["Roughness"].default_value = roughness + return mat + + +def assign_slots(obj, wood, stripe_a, stripe_b): + # Do not materials.clear() — that resets polygon material_index to 0 + # on this Blender, which would drop awning stripes onto wood. + mats = obj.data.materials + wanted = (wood, stripe_a, stripe_b) + for i, mat in enumerate(wanted): + if i < len(mats): + mats[i] = mat + else: + mats.append(mat) + + +def world_bbox(obj): + corners = [obj.matrix_world @ Vector(c) for c in obj.bound_box] + xs = [c.x for c in corners] + ys = [c.y for c in corners] + zs = [c.z for c in corners] + return (min(xs), min(ys), min(zs), max(xs), max(ys), max(zs)) + + +def uv_stats(mesh): + uv = mesh.uv_layers.active + if uv is None: + return 0.0, 0.0, 1.0, 1.0, 0, 1.0 + data = uv.data + us = [loop.uv[0] for loop in data] + vs = [loop.uv[1] for loop in data] + aabbs = [] + for poly in mesh.polygons: + pu = [data[i].uv[0] for i in poly.loop_indices] + pv = [data[i].uv[1] for i in poly.loop_indices] + aabbs.append((min(pu), min(pv), max(pu), max(pv))) + overlap = 0.0 + for i in range(len(aabbs)): + a = aabbs[i] + for j in range(i + 1, len(aabbs)): + b = aabbs[j] + x0 = max(a[0], b[0]) + y0 = max(a[1], b[1]) + x1 = min(a[2], b[2]) + y1 = min(a[3], b[3]) + overlap += max(0.0, x1 - x0) * max(0.0, y1 - y0) + return min(us), min(vs), max(us), max(vs), overlap, len(aabbs) + + +def make_lod(obj, name, ratio, skip_decimate): + mesh = obj.data.copy() + lod = bpy.data.objects.new(name, mesh) + lod.matrix_world = obj.matrix_world.copy() + bpy.context.scene.collection.objects.link(lod) + if not skip_decimate and 0.0 < ratio < 1.0: + mod = lod.modifiers.new("DecimateBudget", "DECIMATE") + mod.decimate_type = "COLLAPSE" + mod.ratio = ratio + return lod + + +def convex_hull_collider(obj, name): + # Duplicated from snippets/convex_hull_collider.py (not a package). + mesh = bpy.data.meshes.new(name) + bm = bmesh.new() + try: + bm.from_mesh(obj.data) + result = bmesh.ops.convex_hull(bm, input=list(bm.verts)) + interior = result.get("geom_interior") or [] + unused = result.get("geom_unused") or [] + if interior: + bmesh.ops.delete(bm, geom=interior, context="VERTS") + if unused: + bmesh.ops.delete(bm, geom=unused, context="VERTS") + bm.to_mesh(mesh) + mesh.update() + finally: + bm.free() + collider = bpy.data.objects.new(name, mesh) + bpy.context.collection.objects.link(collider) + collider.matrix_world = obj.matrix_world.copy() + return collider + + +def setup_bake_image(obj, target_mat, size=BAKE_RES): + # Adapted from snippets/setup_bake_target_image.py — do not replace slots. + if not obj.data.uv_layers: + return None, None + img = bpy.data.images.new("StallNrm", size, size, alpha=True, float_buffer=False) + img.colorspace_settings.name = "Non-Color" + nodes = target_mat.node_tree.nodes + tex = nodes.new("ShaderNodeTexImage") + tex.image = img + nodes.active = tex + tex.select = True + obj.active_material_index = WOOD_IDX + return img, tex + + +def bake_normal(high, low): + # Duplicated from snippets/bake_normal_high_to_low.py (not a package). + scene = bpy.context.scene + scene.render.engine = "CYCLES" + scene.cycles.device = "CPU" + scene.cycles.samples = 1 + scene.cycles.use_denoising = False + for ob in bpy.context.view_layer.objects: + ob.select_set(False) + high.select_set(True) + low.select_set(True) + bpy.context.view_layer.objects.active = low + return bpy.ops.object.bake( + type="NORMAL", + use_selected_to_active=True, + cage_extrusion=CAGE_EXTRUSION, + use_cage=False, + normal_space="TANGENT", + margin=4, + margin_type="ADJACENT_FACES", + use_clear=True, + target="IMAGE_TEXTURES", + ) + + +def export_unity(path, objects): + # Duplicated from snippets/export_preset_unity.py (not a package). + for ob in bpy.context.view_layer.objects: + ob.select_set(False) + for ob in objects: + ob.select_set(True) + bpy.context.view_layer.objects.active = objects[0] + bpy.ops.export_scene.gltf( + filepath=path, + use_selection=True, + export_yup=True, + export_apply=True, + export_draco_mesh_compression_enable=False, + export_animations=False, + ) + + +def check(skip_decimate): + bpy.ops.wm.read_factory_settings(use_empty=True) + low = build_stall_mesh("StallLow", bevel_offset=0.006, bevel_segments=2) + high = build_stall_mesh("StallHigh", bevel_offset=0.006, bevel_segments=4) + wood = principled("StallWood", (0.42, 0.24, 0.10, 1.0), 0.0, 0.55) + stripe_a = principled("StallStripeA", (0.72, 0.12, 0.10, 1.0), 0.0, 0.62) + stripe_b = principled("StallStripeB", (0.86, 0.80, 0.62, 1.0), 0.0, 0.58) + assign_slots(low, wood, stripe_a, stripe_b) + assign_slots(high, wood, stripe_a, stripe_b) + + if low.data is None or len(low.data.polygons) < 6: + return fail("stall mesh did not build", 3), None, None, None, None, None + + base_tris = triangle_count(low.data) + mats = [s for s in low.data.materials if s is not None] + nmat = len(mats) + distinct_mats = len({id(s) for s in mats}) + idx_counts = {} + for poly in low.data.polygons: + idx_counts[poly.material_index] = idx_counts.get(poly.material_index, 0) + 1 + print(f"measured mat_index_counts={idx_counts}") + u0, v0, u1, v1, overlap, nfaces = uv_stats(low.data) + bb = world_bbox(low) + size_x = bb[3] - bb[0] + size_y = bb[4] - bb[1] + size_z = bb[5] - bb[2] + + img, tex = setup_bake_image(low, wood) + if img is None: + return fail("stall has no UV layer", 3), None, None, None, None, None + bake_result = bake_normal(high, low) + + lod1 = make_lod(low, "StallLOD1", LOD1_TARGET, skip_decimate) + lod2 = make_lod(low, "StallLOD2", LOD2_TARGET, skip_decimate) + bpy.context.view_layer.update() + lod1_tris = evaluated_triangle_count(lod1) + lod2_tris = evaluated_triangle_count(lod2) + r1 = lod1_tris / base_tris if base_tris else 0.0 + r2 = lod2_tris / base_tris if base_tris else 0.0 + + collider_src = build_stall_mesh("StallColSrc", bevel_offset=0.0, bevel_segments=1) + collider = convex_hull_collider(collider_src, "StallCollider") + bpy.data.objects.remove(collider_src, do_unlink=True) + col_tris = triangle_count(collider.data) + + export_path = os.path.join( + tempfile.gettempdir(), + f"bdt_market_stall_{os.getpid()}.glb", + ) + if os.path.exists(export_path): + os.remove(export_path) + export_unity(export_path, [low, collider]) + export_size = os.path.getsize(export_path) if os.path.isfile(export_path) else 0 + + print( + f"blender={tuple(bpy.app.version)} skip_decimate={skip_decimate}" + ) + print( + f"measured base_tris={base_tris} lod1_tris={lod1_tris} " + f"lod2_tris={lod2_tris} r1={r1:.4f} r2={r2:.4f}" + ) + print( + f"measured nmat={nmat} uv=({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f}) " + f"overlap={overlap:.6f} nfaces={nfaces}" + ) + print( + f"measured bbox=({size_x:.4f},{size_y:.4f},{size_z:.4f}) " + f"outer={OUTER_SIZE} zmin={bb[2]:.4f}" + ) + print( + f"measured collider_tris={col_tris} bake={bake_result} " + f"bake_has_data={img.has_data} export_bytes={export_size}" + ) + + if not (BASE_TRIS_MIN <= base_tris <= BASE_TRIS_MAX): + return fail( + f"base tris {base_tris} not in [{BASE_TRIS_MIN}, {BASE_TRIS_MAX}]", + 4, + ), None, None, None, None, None + if nmat != MATERIAL_COUNT or distinct_mats != MATERIAL_COUNT: + return fail( + f"material slots {nmat} distinct {distinct_mats} != {MATERIAL_COUNT}", + 5, + ), None, None, None, None, None + if idx_counts.get(STRIPE_A_IDX, 0) < 16: + return fail( + f"stripe A faces {idx_counts.get(STRIPE_A_IDX, 0)} < 16", + 5, + ), None, None, None, None, None + if idx_counts.get(STRIPE_B_IDX, 0) < 16: + return fail( + f"stripe B faces {idx_counts.get(STRIPE_B_IDX, 0)} < 16", + 5, + ), None, None, None, None, None + if u0 < -UV_EPS or v0 < -UV_EPS or u1 > 1.0 + UV_EPS or v1 > 1.0 + UV_EPS: + return fail( + f"UVs outside 0..1: ({u0:.4f},{v0:.4f})-({u1:.4f},{v1:.4f})", + 6, + ), None, None, None, None, None + if overlap > UV_OVERLAP_MAX: + return fail( + f"UV AABB overlap {overlap:.6f} > {UV_OVERLAP_MAX}", + 7, + ), None, None, None, None, None + if ( + abs(size_x - OUTER_SIZE[0]) > BBOX_TOL + or abs(size_y - OUTER_SIZE[1]) > BBOX_TOL + or abs(size_z - OUTER_SIZE[2]) > BBOX_TOL + ): + return fail( + f"bbox ({size_x:.4f},{size_y:.4f},{size_z:.4f}) " + f"off outer {OUTER_SIZE}", + 8, + ), None, None, None, None, None + if not (LOD1_RATIO_MIN <= r1 <= LOD1_RATIO_MAX): + return fail( + f"LOD1 ratio {r1:.4f} not in [{LOD1_RATIO_MIN}, {LOD1_RATIO_MAX}] " + "(--skip-decimate is the designed fail)", + 9, + ), None, None, None, None, None + if not (LOD2_RATIO_MIN <= r2 <= LOD2_RATIO_MAX): + return fail( + f"LOD2 ratio {r2:.4f} not in [{LOD2_RATIO_MIN}, {LOD2_RATIO_MAX}]", + 9, + ), None, None, None, None, None + if col_tris > COLLIDER_TRIS_MAX: + return fail( + f"collider tris {col_tris} > {COLLIDER_TRIS_MAX}", + 11, + ), None, None, None, None, None + if bake_result != {"FINISHED"} or not img.has_data: + return fail( + f"bake failed result={bake_result} has_data={img.has_data}", + 12, + ), None, None, None, None, None + if export_size <= 0: + return fail("export file missing or empty", 13), None, None, None, None, None + return 0, low, high, wood, tex, collider + + +def wire_normal(mat, tex): + nt = mat.node_tree + bsdf = nt.nodes["Principled BSDF"] + nrm = nt.nodes.new("ShaderNodeNormalMap") + nrm.inputs["Strength"].default_value = 1.0 + nt.links.new(tex.outputs["Color"], nrm.inputs["Color"]) + nt.links.new(nrm.outputs["Normal"], bsdf.inputs["Normal"]) + + +def render_still(low, wood, tex, path, engine): + scene = bpy.context.scene + wire_normal(wood, tex) + for ob in list(scene.objects): + if ob.type == "MESH" and ob != low: + ob.hide_render = True + ob.hide_viewport = True + + low.rotation_euler.z = math.radians(-26.0) + low.rotation_euler.x = math.radians(3.0) + + floor_me = bpy.data.meshes.new("Floor") + bm = bmesh.new() + try: + bmesh.ops.create_grid(bm, x_segments=1, y_segments=1, size=14.0) + bm.to_mesh(floor_me) + finally: + bm.free() + fmat = bpy.data.materials.new("Floor") + fmat.use_nodes = True + fb = fmat.node_tree.nodes["Principled BSDF"] + fb.inputs["Base Color"].default_value = (0.03, 0.032, 0.037, 1.0) + fb.inputs["Roughness"].default_value = 0.7 + floor_me.materials.append(fmat) + floor = bpy.data.objects.new("Floor", floor_me) + scene.collection.objects.link(floor) + wall = bpy.data.objects.new("Wall", floor_me.copy()) + wall.location = (0.0, 8.5, 0.0) + wall.rotation_euler = (math.radians(90), 0.0, 0.0) + scene.collection.objects.link(wall) + + world = bpy.data.worlds.new("World") + world.use_nodes = True + world.node_tree.nodes["Background"].inputs["Color"].default_value = ( + 0.02, 0.021, 0.025, 1.0, + ) + scene.world = world + + def light(name, loc, energy, size, col, rot): + ld = bpy.data.lights.new(name, "AREA") + ld.energy = energy + ld.size = size + ld.color = col + ob = bpy.data.objects.new(name, ld) + ob.location = loc + ob.rotation_euler = tuple(math.radians(a) for a in rot) + scene.collection.objects.link(ob) + + light("Key", (-3.6, -5.0, 5.8), 680.0, 4.0, (1.0, 0.94, 0.86), (50, 0, -36)) + light("Fill", (5.0, -3.6, 2.6), 48.0, 8.0, (0.72, 0.82, 1.0), (62, 0, 50)) + light("Wedge", (2.4, 4.2, 4.1), 640.0, 5.5, (1.0, 0.70, 0.40), (-70, 0, 198)) + + cam_data = bpy.data.cameras.new("Cam") + cam_data.lens = 50.0 + cam = bpy.data.objects.new("Cam", cam_data) + cam.location = (3.51, -5.00, 2.42) + scene.collection.objects.link(cam) + aim = bpy.data.objects.new("Aim", None) + aim.location = (0.0, 0.0, 0.88) + scene.collection.objects.link(aim) + con = cam.constraints.new("TRACK_TO") + con.target = aim + con.track_axis = "TRACK_NEGATIVE_Z" + con.up_axis = "UP_Y" + scene.camera = cam + + scene.render.engine = "CYCLES" if engine == "cycles" else eevee_engine_id() + if engine == "cycles": + scene.cycles.samples = 32 + scene.cycles.device = "CPU" + else: + try: + scene.eevee.taa_render_samples = 64 + except AttributeError: + pass + scene.render.resolution_x = 1280 + scene.render.resolution_y = 720 + scene.render.image_settings.file_format = ( + "WEBP" if path.lower().endswith(".webp") else "PNG" + ) + if path.lower().endswith(".webp"): + scene.render.image_settings.quality = 90 + scene.render.filepath = path + scene.view_settings.view_transform = "Standard" + + fcode = gallery_framing.check_framing( + scene, cam, hero=[low], elements=[low], stage=[floor, wall], + ) + if fcode: + return fcode + bpy.ops.render.render(write_still=True) + if not (os.path.exists(path) and os.path.getsize(path) > 0): + return fail("render produced no file", 14) + return 0 + + +def main(): + argv = sys.argv[sys.argv.index("--") + 1:] if "--" in sys.argv else [] + p = argparse.ArgumentParser() + p.add_argument("--output", default=None) + p.add_argument("--engine", default="eevee", choices=("eevee", "cycles")) + p.add_argument( + "--skip-decimate", + action="store_true", + help="falsification: skip the LOD DECIMATE stage", + ) + args = p.parse_args(argv) + + code, low, _high, wood, tex, _col = check(args.skip_decimate) + if code: + return code + if args.output: + rcode = render_still(low, wood, tex, os.path.abspath(args.output), args.engine) + if rcode: + return rcode + print(f"rendered still {args.output}") + print("market-stall OK") + return 0 + + +if __name__ == "__main__": + try: + sys.exit(main()) + except Exception as e: + traceback.print_exc() + print(f"FATAL: {e}", file=sys.stderr) + sys.exit(1) diff --git a/showcase/market-stall/preview.webp b/showcase/market-stall/preview.webp new file mode 100644 index 0000000000000000000000000000000000000000..3ede55dd29706da743e4cf55ec5c2a49aded314b GIT binary patch literal 27318 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