Skip to content

Official Codebase of 3DCodeVerse

Python

conventions: the 14-view rig + OBJECT_CLAY_VIEWS; clay views stop being a name-filter

gaoypeng083105feebb3
diff --git a/harness/codeverse/conventions.py b/harness/codeverse/conventions.py
index ea1b9234..d947354c 100644
--- a/harness/codeverse/conventions.py
+++ b/harness/codeverse/conventions.py
@@ -82,24 +82,42 @@ class ViewPreset:
elevation_deg: float
-#: Judge view set for objects: 3/4 views + orthographic-ish sides + top + underside.
+#: Judge view set for objects — the 14-view rig (brilliana camera numbers):
+#: three rings ±30° + eye-level cardinals + poles; adopted 2026-08-31, D47.
OBJECT_VIEWS: tuple[ViewPreset, ...] = (
+ ViewPreset("front_right_high", 45.0, 30.0),
+ ViewPreset("back_right_high", 135.0, 30.0),
+ ViewPreset("back_left_high", 225.0, 30.0),
+ ViewPreset("front_left_high", 315.0, 30.0),
+ ViewPreset("front", 0.0, 0.0),
+ ViewPreset("right", 90.0, 0.0),
+ ViewPreset("back", 180.0, 0.0),
+ ViewPreset("left", 270.0, 0.0),
+ ViewPreset("front_right_low", 45.0, -30.0),
+ ViewPreset("back_right_low", 135.0, -30.0),
+ ViewPreset("back_left_low", 225.0, -30.0),
+ ViewPreset("front_left_low", 315.0, -30.0),
+ ViewPreset("top", 0.0, 90.0),
+ ViewPreset("bottom", 0.0, -90.0),
+)
+
+#: The measured legacy clay cameras (the judge's geometry montage) — its OWN tuple,
+#: not a subset of the rig. Its ``top`` (el 88) shares a name with the rig's ``top``
+#: (el 90): that is fine ONLY because nothing unions the two tuples by name — clay
+#: tiles carry ``mode != "shaded"`` and prompt_builder resolves their labels here first.
+OBJECT_CLAY_VIEWS: tuple[ViewPreset, ...] = (
ViewPreset("front_right_34", 35.0, 22.0),
ViewPreset("back_left_34", 215.0, 22.0),
- ViewPreset("front", 0.0, 8.0),
- ViewPreset("right", 90.0, 8.0),
- ViewPreset("back", 180.0, 8.0),
- ViewPreset("left", 270.0, 8.0),
ViewPreset("top", 0.0, 88.0),
ViewPreset("low_front_left", 325.0, -12.0),
)
-#: Quick 4-view subset (cheap gates, contact sheets for agents).
-OBJECT_VIEWS_QUICK: tuple[ViewPreset, ...] = (
- OBJECT_VIEWS[0],
- OBJECT_VIEWS[1],
- OBJECT_VIEWS[2],
- OBJECT_VIEWS[6],
+_OBJECT_VIEW_BY_NAME: dict[str, ViewPreset] = {v.name: v for v in OBJECT_VIEWS}
+
+#: Quick 4-view subset (cheap gates, agent contact sheets, texture pass, candidates,
+#: scene assets) — by NAME so a rig reorder cannot silently change it.
+OBJECT_VIEWS_QUICK: tuple[ViewPreset, ...] = tuple(
+ _OBJECT_VIEW_BY_NAME[n] for n in ("front_right_high", "back_left_high", "front", "top")
)
#: Scene overview rig (scenes sit on ground: aerial + eye level, no underside).
diff --git a/harness/codeverse/judges/calibration.py b/harness/codeverse/judges/calibration.py
index 926f2304..3c171262 100644
--- a/harness/codeverse/judges/calibration.py
+++ b/harness/codeverse/judges/calibration.py
@@ -39,7 +39,6 @@ from codeverse.workspace import Workspace
log = logging.getLogger(__name__)
-GEOMETRY_VIEW_NAMES = ("front_right_34", "back_left_34", "top", "low_front_left")
def _run_label(run_dir: Path) -> str:
@@ -194,10 +193,10 @@ def render_geometry_views(case: RoundCase, out_dir: Path, mode: str) -> RenderSe
"""Clay/normals renders of the run's final GLB for the best round (object tracks only)."""
if not case.glb or case.inp.spec.track.value == "scene":
return None
- from codeverse.conventions import OBJECT_VIEWS
+ from codeverse.conventions import OBJECT_CLAY_VIEWS
from codeverse.spatial.render import render_glb
- views = [v for v in OBJECT_VIEWS if v.name in GEOMETRY_VIEW_NAMES]
+ views = list(OBJECT_CLAY_VIEWS)
try:
return render_glb(case.glb, out_dir / case.run / f"geometry_{mode}", views=views, mode=mode, sheet=False)
except Exception as e: # noqa: BLE001 — calibration must not die on a render hiccup
diff --git a/harness/codeverse/tracks/static_object.py b/harness/codeverse/tracks/static_object.py
index e436cef1..df114842 100644
--- a/harness/codeverse/tracks/static_object.py
+++ b/harness/codeverse/tracks/static_object.py
@@ -27,6 +27,7 @@ from codeverse.contracts.run import RoundRecord
from codeverse.conventions import (
BBOX_TOLERANCE_M,
LANGUAGE_FRAME,
+ OBJECT_CLAY_VIEWS,
OBJECT_VIEWS,
Frame,
to_pascal,
@@ -63,13 +64,13 @@ from codeverse.workspace import Workspace
log = logging.getLogger(__name__)
-#: the 4 clay views judged for holes/intersections (subset of OBJECT_VIEWS by name)
-GEOMETRY_VIEW_NAMES: tuple[str, ...] = ("front_right_34", "back_left_34", "top", "low_front_left")
-GEOMETRY_VIEWS = tuple(v for v in OBJECT_VIEWS if v.name in GEOMETRY_VIEW_NAMES)
+#: the 4 clay views judged for holes/intersections — their own measured cameras (D47),
+#: NOT a name-filter over OBJECT_VIEWS (which silently shrank under renamed rigs)
+GEOMETRY_VIEWS = OBJECT_CLAY_VIEWS
class ObjectPipeline:
- """Measure → connectivity + contract → 8-view render."""
+ """Measure → connectivity + contract → 14-view render."""
views = OBJECT_VIEWS