From 324b2a3b008a6b8cd13c8e8343e342a12c6afe73 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sun, 3 May 2026 16:19:25 +0100 Subject: [PATCH] Rebuild Pallas blockout as staged environment --- .../visual-blockout-architecture.md | 23 +++ ...trikes.service-ring-kappa.v0.blockout.json | 86 ++++++---- scripts/blender/build_visual_blockout.py | 152 +++++++++++++----- state/evidence.jsonl | 1 + 4 files changed, 190 insertions(+), 72 deletions(-) diff --git a/docs/architecture/visual-blockout-architecture.md b/docs/architecture/visual-blockout-architecture.md index 6d61877..c7b86a9 100644 --- a/docs/architecture/visual-blockout-architecture.md +++ b/docs/architecture/visual-blockout-architecture.md @@ -58,6 +58,29 @@ therefore be readable in ordinary visual terms: Color helps a human and may help the model, but shape carries the real burden. +## Construction Controls + +A useful blockout is not just visible geometry. The `.blend` may contain hidden +construction controls that define the stage: + +- lane centerlines +- station footprints +- catwalk walkable zones +- manifold and rail axes +- reach envelopes +- camera-safe staging points + +These controls are allowed to be invisible. Their job is to drive placement, +spacing, attachment, repetition, and later Geometry Nodes conversion. The +visible mesh is the output of the construction logic, not the whole graph. + +For scripted prototypes, hidden empties and hidden curve paths are acceptable +control objects. For production organs, the same idea should move into authored +Geometry Nodes / Geometry Script modules: curves, points, fields, indices, +attributes, and intermediate geometry can exist purely to place or transform +other geometry. If every artifact in the graph is visible, the graph is probably +doing layout by brute force. + ## Geometry Script Direction The first generator used straightforward Blender Python primitives to prove that diff --git a/examples/visual-blockouts/pallas-species-strikes.service-ring-kappa.v0.blockout.json b/examples/visual-blockouts/pallas-species-strikes.service-ring-kappa.v0.blockout.json index b4bc4ee..d27e155 100644 --- a/examples/visual-blockouts/pallas-species-strikes.service-ring-kappa.v0.blockout.json +++ b/examples/visual-blockouts/pallas-species-strikes.service-ring-kappa.v0.blockout.json @@ -77,15 +77,27 @@ }, { "material_id": "teth_blue_gray", - "display_name": "Teth and cephalopod work-support rig", + "display_name": "Teth cephalopod body proxy", "base_color": [ - 0.18, - 0.32, - 0.42, + 0.1, + 0.26, + 0.36, 1 ], - "intended_read": "Cephalopod body and open dry-operation work-support frame.", - "use_in_prompt": "Preserve nonhuman horizontal body volume and open work-support object class." + "intended_read": "Cephalopod body volume: horizontal mantle and tentacle reach.", + "use_in_prompt": "Preserve nonhuman horizontal body volume; do not reinterpret as a humanoid in a chair." + }, + { + "material_id": "support_rig_steel_blue", + "display_name": "Open cephalopod work-support rig", + "base_color": [ + 0.42, + 0.56, + 0.62, + 1 + ], + "intended_read": "Low open dry-operation support sled, soft pad, side rails, contact arcs, oxygenation tubes, and reachable tool rail.", + "use_in_prompt": "Preserve as workplace support equipment around the cephalopod body, not a tank, cage, or restraint chair." }, { "material_id": "callback_ivory", @@ -134,7 +146,11 @@ "length": 18, "radius": 4.2, "arc_degrees": 130, - "rib_count": 18 + "rib_count": 18, + "half_width": 3.35, + "knee_height": 1.05, + "crown_height": 3.25, + "arch_steps": 20 }, "material_id": "shell_aggregate", "notes": "Curved shell, deck floor, support ribs, and overhead pipe spine." @@ -198,13 +214,13 @@ "geometry_script_tree": "supervisor_catwalk", "parameters": { "position": [ - 3.1, + 2.55, 3.2, - 2.75 + 1.55 ], "length": 6.5, - "width": 1.5, - "rail_height": 0.9 + "width": 0.95, + "rail_height": 0.65 }, "material_id": "supervisor_blue", "notes": "Open elevated platform, transparent safety rail proxy, and blue screen slabs." @@ -216,15 +232,15 @@ "geometry_script_tree": "cephalopod_work_support_station", "parameters": { "position": [ - 1.8, + 1.75, 4.7, - 0.95 + 0.44 ], "width": 2.5, "depth": 1.6, - "height": 1.2 + "height": 0.82 }, - "material_id": "teth_blue_gray", + "material_id": "support_rig_steel_blue", "notes": "Open work-support frame with contact-band arcs, oxygenation tubes, and radial tool rails." }, { @@ -252,7 +268,7 @@ "default_position": [ 0, 3.2, - 0.9 + 0 ], "default_rotation": [ 0, @@ -272,9 +288,9 @@ "proxy_shape": "humanoid_capsule_supervisor", "material_id": "supervisor_blue", "default_position": [ - 3.2, + 2.55, 3.4, - 3.65 + 1.6 ], "default_rotation": [ 0, @@ -282,9 +298,9 @@ -1.5708 ], "scale": [ - 0.45, - 0.35, - 1.85 + 0.38, + 0.28, + 1.05 ], "notes": "Elevated on catwalk, visible above waist rail." }, @@ -296,7 +312,7 @@ "default_position": [ -2.15, 3.85, - 0.85 + 0 ], "default_rotation": [ 0, @@ -318,7 +334,7 @@ "default_position": [ 2.25, 2.35, - 0.95 + 0 ], "default_rotation": [ 0, @@ -340,7 +356,7 @@ "default_position": [ 1.45, 5, - 1 + 0.36 ], "default_rotation": [ 0, @@ -390,9 +406,9 @@ "pallas_bypass_kit" ], "position": [ - 3.45, - 2.25, - 1.85 + 0.65, + 2.35, + 1.35 ], "rotation": [ 1.3, @@ -400,11 +416,11 @@ 2.15 ], "target": [ - 1.75, + 1.62, 4.75, - 1.12 + 0.62 ], - "lens_mm": 32, + "lens_mm": 35, "shot_role": "cephalopod work-support station medium shot", "framing_notes": "Centers Teth, support loops, oxygenation tubes, radial tool rails, and Lio's inspection position without making the equipment read as containment." }, @@ -426,9 +442,9 @@ -0.45 ], "target": [ - 3.15, + 2.55, 3.35, - 3.35 + 2.08 ], "lens_mm": 28, "shot_role": "low floor view toward raised supervisor catwalk", @@ -455,7 +471,7 @@ "target": [ 1.2, 4.75, - 1.4 + 0.85 ], "lens_mm": 30, "shot_role": "crowded decision-line ensemble", @@ -511,6 +527,10 @@ "clay", "depth_optional" ], + "visible_actor_ids": [ + "lio_vale", + "teth_inkwise" + ], "output_refs": [ "experiments/blender/pallas-species-strikes/renders/pallas_teth_dry_operation.blockout.png" ], diff --git a/scripts/blender/build_visual_blockout.py b/scripts/blender/build_visual_blockout.py index acf711e..abccbde 100644 --- a/scripts/blender/build_visual_blockout.py +++ b/scripts/blender/build_visual_blockout.py @@ -82,7 +82,7 @@ def add_cube(name: str, location: tuple[float, float, float], scale: tuple[float obj.dimensions = scale bpy.ops.object.transform_apply(location=False, rotation=False, scale=True) obj.data.materials.append(material) - return obj + return add_bevel(obj, width=0.012, segments=1) def add_mesh_object(name: str, vertices: list[tuple[float, float, float]], faces: list[tuple[int, ...]], material: bpy.types.Material) -> bpy.types.Object: @@ -95,6 +95,45 @@ def add_mesh_object(name: str, vertices: list[tuple[float, float, float]], faces return obj +def add_bevel(obj: bpy.types.Object, width: float = 0.03, segments: int = 2) -> bpy.types.Object: + bevel = obj.modifiers.new("readable_blockout_bevel", "BEVEL") + bevel.width = width + bevel.segments = segments + obj.modifiers.new("weighted_blockout_normals", "WEIGHTED_NORMAL") + return obj + + +def add_control_empty(name: str, location: tuple[float, float, float]) -> bpy.types.Object: + obj = bpy.data.objects.new(name, None) + bpy.context.collection.objects.link(obj) + obj.empty_display_type = "PLAIN_AXES" + obj.empty_display_size = 0.25 + obj.location = location + obj.hide_render = True + obj.hide_viewport = True + obj["ghostlight_control"] = True + return obj + + +def add_control_curve(name: str, points: list[tuple[float, float, float]], closed: bool = False) -> bpy.types.Object: + curve = bpy.data.curves.new(name, "CURVE") + curve.dimensions = "3D" + curve.resolution_u = 1 + spl = curve.splines.new("POLY") + point_count = len(points) + (1 if closed else 0) + spl.points.add(point_count - 1) + path_points = points + ([points[0]] if closed else []) + for point, coords in zip(spl.points, path_points): + point.co = (coords[0], coords[1], coords[2], 1.0) + obj = bpy.data.objects.new(name, curve) + bpy.context.collection.objects.link(obj) + obj.hide_render = True + obj.hide_viewport = True + obj["ghostlight_control"] = True + obj["control_kind"] = "construction_curve" + return obj + + def make_runtime_material(material_id: str, color: tuple[float, float, float, float]) -> bpy.types.Material: material = bpy.data.materials.get(material_id) or bpy.data.materials.new(material_id) material.diffuse_color = color @@ -143,43 +182,58 @@ def build_service_ring_shell(module: dict[str, Any], materials: dict[str, bpy.ty p = module["parameters"] material = materials[module["material_id"]] length = float(p.get("length", 18.0)) - radius = float(p.get("radius", 4.2)) rib_count = int(p.get("rib_count", 18)) - arc_degrees = float(p.get("arc_degrees", 130.0)) y0 = -1.0 y1 = length - 1.0 - half_arc = math.radians(arc_degrees / 2.0) - arch_steps = 18 - arch_points: list[tuple[float, float]] = [] - for index in range(arch_steps + 1): - angle = math.pi / 2.0 + half_arc - index * (2.0 * half_arc / arch_steps) - arch_points.append((math.cos(angle) * radius, math.sin(angle) * radius)) + half_width = float(p.get("half_width", 3.35)) + knee_height = float(p.get("knee_height", 1.05)) + crown_height = float(p.get("crown_height", 3.25)) + arch_steps = int(p.get("arch_steps", 20)) + + add_control_empty("ctl_lane_center_start", (0, y0, 0)) + add_control_empty("ctl_lane_center_end", (0, y1, 0)) + add_control_empty("ctl_left_manifold_zone", (-half_width + 0.22, (y0 + y1) / 2, knee_height)) + add_control_empty("ctl_right_catwalk_zone", (half_width - 0.55, (y0 + y1) / 2, 1.55)) + add_control_empty("ctl_cephalopod_station_zone", (1.65, 4.75, 0.42)) + add_control_curve("ctl_lane_centerline_curve", [(0, y0, 0.02), (0, y1, 0.02)]) + add_control_curve("ctl_left_manifold_axis_curve", [(-half_width + 0.22, y0, knee_height), (-half_width + 0.22, y1, knee_height)]) + add_control_curve("ctl_right_catwalk_axis_curve", [(half_width - 0.55, y0, 1.55), (half_width - 0.55, y1, 1.55)]) + + cross_section: list[tuple[float, float]] = [(-half_width, 0.0), (-half_width, knee_height)] + for index in range(1, arch_steps): + t = index / arch_steps + x = -half_width + (2.0 * half_width * t) + arch_factor = max(0.0, 1.0 - (x / half_width) ** 2) + z = knee_height + (crown_height - knee_height) * math.sqrt(arch_factor) + cross_section.append((x, z)) + cross_section.extend([(half_width, knee_height), (half_width, 0.0)]) vertices: list[tuple[float, float, float]] = [] for y in (y0, y1): - for x, z in arch_points: - vertices.append((x, y, max(z, 0.18))) + for x, z in cross_section: + vertices.append((x, y, max(z, 0.0))) faces: list[tuple[int, ...]] = [] - row = len(arch_points) + row = len(cross_section) for index in range(row - 1): faces.append((index, index + 1, row + index + 1, row + index)) - add_mesh_object("service_ring_curved_inner_shell", vertices, faces, material) + shell = add_mesh_object("service_ring_curved_inner_shell", vertices, faces, material) + add_bevel(shell, width=0.015, segments=1) - deck_width = max(abs(arch_points[0][0]), abs(arch_points[-1][0])) * 1.95 - add_cube("service_lane_bolted_deck", (0, length / 2 - 1.0, 0.03), (deck_width, length, 0.12), material) - add_cube("left_shell_base_sill", (-deck_width / 2, length / 2 - 1.0, 0.22), (0.22, length, 0.35), material) - add_cube("right_shell_base_sill", (deck_width / 2, length / 2 - 1.0, 0.22), (0.22, length, 0.35), material) + deck_width = half_width * 2.0 + add_cube("service_lane_bolted_deck", (0, length / 2 - 1.0, -0.035), (deck_width, length, 0.07), material) + add_cube("left_floor_wall_seam", (-half_width + 0.08, length / 2 - 1.0, 0.08), (0.16, length, 0.16), material) + add_cube("right_floor_wall_seam", (half_width - 0.08, length / 2 - 1.0, 0.08), (0.16, length, 0.16), material) for index in range(rib_count): y = y0 + index * ((y1 - y0) / max(rib_count - 1, 1)) add_curve_pipe( f"shell_rib_{index:02d}", - [(x, y, max(z + 0.04, 0.24)) for x, z in arch_points], + [(x, y, max(z + 0.035, 0.0)) for x, z in cross_section], material, bevel_depth=0.035, ) - for x_offset in (-1.2, 0.0, 1.2): + for x_offset in (-1.1, 0.0, 1.1): name = "overhead_service_spine" if x_offset == 0 else f"overhead_service_spine_{x_offset:+.1f}" - add_curve_pipe(name, [(x_offset, y0, radius + 0.02), (x_offset, y1, radius + 0.02)], material, bevel_depth=0.055) + add_curve_pipe(name, [(x_offset, y0, crown_height - 0.10), (x_offset, y1, crown_height - 0.10)], material, bevel_depth=0.045) for index in range(7): y = y0 + 1.0 + index * 2.2 add_cube(f"deck_cross_plate_{index:02d}", (0, y, 0.11), (deck_width * 0.82, 0.08, 0.035), material) @@ -249,21 +303,32 @@ def build_supervisor_catwalk(module: dict[str, Any], materials: dict[str, bpy.ty length = float(p.get("length", 6.5)) width = float(p.get("width", 1.5)) rail_height = float(p.get("rail_height", 0.9)) + add_control_empty("ctl_catwalk_centerline", (x, y, z)) + add_control_curve( + "ctl_catwalk_walkable_footprint", + [ + (x - width / 2, y - length / 2, z + 0.06), + (x + width / 2, y - length / 2, z + 0.06), + (x + width / 2, y + length / 2, z + 0.06), + (x - width / 2, y + length / 2, z + 0.06), + ], + closed=True, + ) add_cube("supervisor_catwalk_grated_deck", (x, y, z), (width, length, 0.10), material) add_cube("supervisor_catwalk_wall_mount", (x + width / 2 + 0.08, y, z + 0.18), (0.14, length, 0.34), material) for side, sx in (("inner", -1), ("outer", 1)): rail_x = x + sx * width / 2 - add_curve_pipe(f"supervisor_catwalk_{side}_top_rail", [(rail_x, y - length / 2, z + rail_height), (rail_x, y + length / 2, z + rail_height)], material, bevel_depth=0.035) - add_curve_pipe(f"supervisor_catwalk_{side}_mid_rail", [(rail_x, y - length / 2, z + rail_height * 0.52), (rail_x, y + length / 2, z + rail_height * 0.52)], material, bevel_depth=0.022) + add_curve_pipe(f"supervisor_catwalk_{side}_top_rail", [(rail_x, y - length / 2, z + rail_height), (rail_x, y + length / 2, z + rail_height)], material, bevel_depth=0.028) + add_curve_pipe(f"supervisor_catwalk_{side}_mid_rail", [(rail_x, y - length / 2, z + rail_height * 0.52), (rail_x, y + length / 2, z + rail_height * 0.52)], material, bevel_depth=0.018) for index in range(5): yy = y - length / 2 + index * length / 4 - add_curve_pipe(f"supervisor_catwalk_{side}_post_{index:02d}", [(rail_x, yy, z), (rail_x, yy, z + rail_height)], material, bevel_depth=0.026) + add_curve_pipe(f"supervisor_catwalk_{side}_post_{index:02d}", [(rail_x, yy, z), (rail_x, yy, z + rail_height)], material, bevel_depth=0.022) for index in range(5): yy = y - length / 2 + 0.45 + index * (length - 0.9) / 4 - add_cube(f"supervisor_screen_{index:02d}", (x - width / 2 - 0.10, yy, z + 1.12), (0.06, 0.72, 0.44), material) + add_cube(f"supervisor_screen_{index:02d}", (x - width / 2 - 0.10, yy, z + 0.86), (0.05, 0.58, 0.34), material) for index in range(3): yy = y - length / 2 + index * length / 2 - add_curve_pipe(f"supervisor_catwalk_diagonal_brace_{index:02d}", [(x + width / 2, yy, z), (x + width / 2 + 0.45, yy + 0.7, 1.0)], material, bevel_depth=0.035) + add_curve_pipe(f"supervisor_catwalk_diagonal_brace_{index:02d}", [(x + width / 2, yy, z), (x + width / 2 + 0.35, yy + 0.7, 0.65)], material, bevel_depth=0.026) def build_cephalopod_work_support_station(module: dict[str, Any], materials: dict[str, bpy.types.Material]) -> None: @@ -273,25 +338,34 @@ def build_cephalopod_work_support_station(module: dict[str, Any], materials: dic width = float(p.get("width", 2.5)) depth = float(p.get("depth", 1.6)) height = float(p.get("height", 1.2)) + add_control_empty("ctl_teth_station_center", (x, y, z)) + add_control_curve( + "ctl_teth_station_service_footprint", + [ + (x - width / 2, y - depth / 2, z - 0.18), + (x + width / 2, y - depth / 2, z - 0.18), + (x + width / 2, y + depth / 2, z - 0.18), + (x - width / 2, y + depth / 2, z - 0.18), + ], + closed=True, + ) + add_control_curve("ctl_teth_primary_reach_axis", [(x - width * 0.45, y, z + 0.08), (x + width * 0.45, y, z + 0.08)]) add_cube("teth_work_support_low_service_sled", (x, y, z - 0.18), (width, depth, 0.12), material) + pad_material = make_runtime_material("teth_soft_pad_muted_teal", (0.12, 0.24, 0.28, 1.0)) + add_cube("teth_work_support_soft_pad", (x, y, z - 0.08), (width * 0.72, depth * 0.62, 0.08), pad_material) for sx in (-1, 1): rail_x = x + sx * width * 0.42 - add_curve_pipe(f"teth_longitudinal_side_rail_{sx}", [(rail_x, y - depth / 2, z + 0.10), (rail_x, y + depth / 2, z + 0.10)], material, bevel_depth=0.035) - add_curve_pipe(f"teth_padded_contact_arc_{sx}", [(rail_x, y - depth * 0.36, z + 0.06), (rail_x + sx * 0.08, y, z + height * 0.82), (rail_x, y + depth * 0.36, z + 0.06)], material, bevel_depth=0.030) - for yy_factor in (-0.35, 0.0, 0.35): + add_curve_pipe(f"teth_longitudinal_side_rail_{sx}", [(rail_x, y - depth / 2, z + 0.06), (rail_x, y + depth / 2, z + 0.06)], material, bevel_depth=0.028) + add_curve_pipe(f"teth_low_contact_arc_{sx}", [(rail_x, y - depth * 0.30, z + 0.03), (rail_x + sx * 0.06, y, z + height * 0.25), (rail_x, y + depth * 0.30, z + 0.03)], material, bevel_depth=0.024) + for yy_factor in (-0.30, 0.30): yy = y + yy_factor * depth - add_curve_pipe(f"teth_cross_support_band_{yy_factor:+.2f}", [(x - width * 0.44, yy, z + 0.18), (x, yy, z + 0.36), (x + width * 0.44, yy, z + 0.18)], material, bevel_depth=0.026) + add_curve_pipe(f"teth_cross_support_band_{yy_factor:+.2f}", [(x - width * 0.38, yy, z + 0.12), (x, yy, z + 0.22), (x + width * 0.38, yy, z + 0.12)], material, bevel_depth=0.022) for index, yy in enumerate((y - depth * 0.45, y + depth * 0.45)): - add_curve_pipe(f"teth_oxygenation_tube_{index:02d}", [(x - width * 0.55, yy, z + 0.12), (x, yy, z + height * 0.74), (x + width * 0.55, yy, z + 0.12)], material, bevel_depth=0.024) - for index in range(4): - offset = -0.45 + index * 0.30 - add_curve_pipe( - f"teth_front_tool_arm_{index:02d}", - [(x - width * 0.18 + offset, y - depth * 0.62, z + 0.18), (x - width * 0.12 + offset, y - depth * 0.92, z + 0.42)], - material, - bevel_depth=0.020, - ) - add_cube("teth_radial_tool_block", (x - width * 0.10, y - depth * 0.95, z + 0.38), (0.9, 0.12, 0.16), material) + add_curve_pipe(f"teth_oxygenation_tube_{index:02d}", [(x - width * 0.48, yy, z + 0.08), (x, yy, z + height * 0.42), (x + width * 0.48, yy, z + 0.08)], material, bevel_depth=0.020) + add_cube("teth_front_tool_block", (x, y - depth * 0.82, z + 0.18), (1.15, 0.16, 0.16), material) + for index in range(3): + offset = -0.35 + index * 0.35 + add_curve_pipe(f"teth_short_tool_nozzle_{index:02d}", [(x + offset, y - depth * 0.86, z + 0.20), (x + offset, y - depth * 1.03, z + 0.28)], material, bevel_depth=0.014) def build_object_callback_props(module: dict[str, Any], materials: dict[str, bpy.types.Material]) -> None: diff --git a/state/evidence.jsonl b/state/evidence.jsonl index 140cf74..6976253 100644 --- a/state/evidence.jsonl +++ b/state/evidence.jsonl @@ -68,3 +68,4 @@ {"ts": "2026-05-03T13:57:41+00:00", "type": "visual-blockout", "status": "ok", "note": "Corrected first Pallas blockout guide render problems: empty establishing renders now use per-render visible_actor_ids, the object callback shot has explicit prop geometry, and cameras target the intended shot subjects rather than inherited shared-scene clutter."} {"ts": "2026-05-03T14:13:49+00:00", "type": "visual-blockout", "status": "ok", "note": "Raised Pallas Service Ring Kappa blockout from symbolic primitives to organ-level maquette geometry: arched shell mesh, gasketed crawl throat, anchored catwalk rails/braces, layered manifold backplane/pipes/panels, and coherent cephalopod work-support rails/bands/tubes. Rendered guide outputs locally and validation passed."} {"ts": "2026-05-03T14:33:48+00:00", "type": "visual-blockout", "status": "rejected-path", "note": "Pallas blockout primitive-builder pass proved the Blender emission seam but is not viable as the production blockout method. Primitive stacking creates unreadable clutter, clipping, floating proxies, and weak nonhuman affordance silhouettes. Next visual blockout work should use authored Geometry Nodes/Geometry Script modules or hand-authored Blender kit pieces driven by plan parameters, with silhouette readability as the acceptance criterion."} +{"ts": "2026-05-03T15:17:04+00:00", "type": "visual-blockout", "status": "ok", "note": "Reworked the Pallas service-ring blockout around environment-first construction controls: hidden empties and hidden curves define lane, manifold, catwalk, and Teth station placement; the visible shell now meets the deck; actors are grounded; Teth body and support rig are separated; and guide renders were regenerated for IF image references."}