fix: reframe vse-cut-list bay into the band and gate the Bay scene

The corrected survey (render_pre capture) measured this hero for the
first time: the monitor top was cropped and the desk bled the bottom
edge (fill 1.000y, touch B+T) — the #107 survey had read bpy.context.scene,
which is the cut-list scene, not the Bay the still renders from. BayCam
pulls back from (2.0,-5.2,1.72) to (3.05,-7.9,2.0) with aim z 1.28 ->
1.20, landing fill 0.506x/0.850y with margins L0.247 R0.247 B0.067
T0.083. This was the most-broken of the seven (frame-filling before),
so the composition change is correspondingly larger; the bezel, stand,
desk, and on-screen cut list are all fully in frame now. The gate runs
on the Bay scene (the helper's scene-targeted matte from the previous
commit), falsified at lens 66 (fill 1.000 FAIL, exit 10) and restored.
check and --check-pixels both exit 0 on 5.1.2 and 4.5.11 with identical
pixel witnesses.

Signed-off-by: fOuttaMyPaint <TMhospitalitystrategies@gmail.com>

Author: TMHSDigital

docs/gallery/assets/vse-cut-list-hero.webp

@@ -204,6 +204,7 @@ <h2>Run</h2>
 # Also render the still (EEVEE on a GPU host; --engine cycles on GPU-less):
 blender --background --python vse_cut_list.py -- --output vse.png</code></pre>
 <p>It exits non-zero on failure and prints every measured value and tolerance on success, so CI logs carry the numbers. The <code>blender-smoke</code> workflow runs the check and the pixel witness on Blender 4.5 LTS and 5.1.</p>
+<p>The <code>--output</code> render path additionally measures framing against the Layer 1 band via <code>examples/gallery_framing.py</code> (exit 10 on violation) before writing the still.</p>
     </section>
     <section class="detail-section src">
       <h2>Source</h2>
@@ -259,6 +260,11 @@ <h2>Source</h2>
 <span class="k">import</span> bpy, sys, os, math, argparse, tempfile, warnings, shutil
 <span class="k">import</span> mathutils
 
+<span class="c"># Shared Layer 1 framing measurement (render path only) — see gallery_framing.py</span>
+sys.path.insert(<span class="n">0</span>, os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir))
+sys.dont_write_bytecode = <span class="k">True</span>  <span class="c"># keep examples/__pycache__ out of the repo tree</span>
+<span class="k">import</span> gallery_framing
+
 IS_5X = bpy.app.version &gt;= (<span class="n">5</span>, <span class="n">0</span>, <span class="n">0</span>)
 
 <span class="c"># Closed-form cut list, end-exclusive [start, end) spans on the timeline.</span>
@@ -724,10 +730,12 @@ <h2>Source</h2>
     cam_data = bpy.data.cameras.new(<span class="s">&quot;BayCam&quot;</span>)
     cam_data.lens = <span class="n">52.0</span>
     cam = bpy.data.objects.new(<span class="s">&quot;BayCam&quot;</span>, cam_data)
-    cam.location = (<span class="n">2.0</span>, -<span class="n">5.2</span>, <span class="n">1.72</span>)
+    <span class="c"># Pulled back from (2.0, -5.2, 1.72) so the bezel top and desk base</span>
+    <span class="c"># clear the frame edges (framing gate on the Bay scene).</span>
+    cam.location = (<span class="n">3.05</span>, -<span class="n">7.9</span>, <span class="n">2.0</span>)
     sc.collection.objects.link(cam)
     target = bpy.data.objects.new(<span class="s">&quot;BayAim&quot;</span>, <span class="k">None</span>)
-    target.location = (<span class="n">0.0</span>, <span class="n">0.0</span>, <span class="n">1.28</span>)
+    target.location = (<span class="n">0.0</span>, <span class="n">0.0</span>, <span class="n">1.20</span>)
     sc.collection.objects.link(target)
     con = cam.constraints.new(<span class="s">&quot;TRACK_TO&quot;</span>)
     con.target = target
@@ -749,8 +757,27 @@ <h2>Source</h2>
     sc.render.filepath = path
     <span class="c"># Standard keeps both the stage saturated and the on-screen frame true</span>
     sc.view_settings.view_transform = <span class="s">&quot;Standard&quot;</span>
+    <span class="c"># Layer 1 framing gate (silhouette matte) on the BAY scene — exit 10 on</span>
+    <span class="c"># violation, before the beauty render. Renderables here are the desk,</span>
+    <span class="c"># stand, and monitor assembly; floor/wall are the stage.</span>
+    stage = [o <span class="k">for</span> o <span class="k">in</span> sc.objects <span class="k">if</span> any(k <span class="k">in</span> o.name.lower() <span class="k">for</span> k <span class="k">in</span> (<span class="s">&quot;floor&quot;</span>, <span class="s">&quot;wall&quot;</span>))]
+    hero = [
+        o <span class="k">for</span> o <span class="k">in</span> sc.objects
+        <span class="k">if</span> o.type <span class="k">in</span> gallery_framing._RENDER_TYPES <span class="k">and</span> <span class="k">not</span> o.hide_render <span class="k">and</span> o <span class="k">not</span> <span class="k">in</span> stage
+    ]
+    fcode = gallery_framing.check_framing(
+        sc, cam,
+        hero=hero,
+        elements=hero,
+        stage=stage,
+    )
+    <span class="k">if</span> fcode:
+        <span class="k">return</span> fcode
     bpy.ops.render.render(write_still=<span class="k">True</span>, scene=sc.name)
-    <span class="k">return</span> os.path.exists(path) <span class="k">and</span> os.path.getsize(path) &gt; <span class="n">0</span>
+    <span class="k">if</span> <span class="k">not</span> (os.path.exists(path) <span class="k">and</span> os.path.getsize(path) &gt; <span class="n">0</span>):
+        print(<span class="s">&quot;ERROR: render produced no file&quot;</span>, file=sys.stderr)
+        <span class="k">return</span> <span class="n">11</span>
+    <span class="k">return</span> <span class="n">0</span>
 
 
 <span class="k">def</span> render_still(path, engine):
@@ -763,7 +790,7 @@ <h2>Source</h2>
     <span class="k">try</span>:
         frame_path = os.path.join(tmp, <span class="s">&quot;program.png&quot;</span>)
         <span class="k">if</span> <span class="k">not</span> render_frame(sc, frame_path, engine, RENDER_W, RENDER_H):
-            <span class="k">return</span> <span class="k">False</span>
+            <span class="k">return</span> <span class="n">11</span>
         bay = bpy.data.scenes.new(<span class="s">&quot;Bay&quot;</span>)
         build_stage(bay)          <span class="c"># the house dark studio, lights included</span>
         build_bay(bay, frame_path)
@@ -860,8 +887,11 @@ <h2>Source</h2>
     <span class="k">if</span> args.output:
         <span class="c"># The round-trip reloaded a .blend; start clean for the still.</span>
         bpy.ops.wm.read_factory_settings(use_empty=<span class="k">True</span>)
-        <span class="k">if</span> <span class="k">not</span> render_still(os.path.abspath(args.output), args.engine):
+        rcode = render_still(os.path.abspath(args.output), args.engine)
+        <span class="k">if</span> rcode == <span class="n">11</span>:
             <span class="k">return</span> fail(<span class="s">f&quot;</span><span class="s">render produced no file at </span>{args.output}<span class="s">&quot;</span>, <span class="n">11</span>)
+        <span class="k">if</span> rcode:
+            <span class="k">return</span> rcode
         print(<span class="s">f&quot;</span><span class="s">wrote </span>{args.output}<span class="s">&quot;</span>)
     <span class="k">return</span> <span class="n">0</span>
 

docs/gallery/contact-sheets/vse-cut-list-contact-sheet.webp

@@ -116,3 +116,5 @@ blender --background --python vse_cut_list.py -- --output vse.png
 It exits non-zero on failure and prints every measured value and tolerance on
 success, so CI logs carry the numbers. The `blender-smoke` workflow runs the
 check and the pixel witness on Blender 4.5 LTS and 5.1.
+
+The `--output` render path additionally measures framing against the Layer 1 band via `examples/gallery_framing.py` (exit 10 on violation) before writing the still.

docs/gallery/vse-cut-list/index.html

@@ -46,6 +46,11 @@
 import bpy, sys, os, math, argparse, tempfile, warnings, shutil
 import mathutils
 
+# Shared Layer 1 framing measurement (render path only) — see gallery_framing.py
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), os.pardir))
+sys.dont_write_bytecode = True  # keep examples/__pycache__ out of the repo tree
+import gallery_framing
+
 IS_5X = bpy.app.version >= (5, 0, 0)
 
 # Closed-form cut list, end-exclusive [start, end) spans on the timeline.
@@ -511,10 +516,12 @@ def render_bay(sc, path, engine, w, h):
     cam_data = bpy.data.cameras.new("BayCam")
     cam_data.lens = 52.0
     cam = bpy.data.objects.new("BayCam", cam_data)
-    cam.location = (2.0, -5.2, 1.72)
+    # Pulled back from (2.0, -5.2, 1.72) so the bezel top and desk base
+    # clear the frame edges (framing gate on the Bay scene).
+    cam.location = (3.05, -7.9, 2.0)
     sc.collection.objects.link(cam)
     target = bpy.data.objects.new("BayAim", None)
-    target.location = (0.0, 0.0, 1.28)
+    target.location = (0.0, 0.0, 1.20)
     sc.collection.objects.link(target)
     con = cam.constraints.new("TRACK_TO")
     con.target = target
@@ -536,8 +543,27 @@ def render_bay(sc, path, engine, w, h):
     sc.render.filepath = path
     # Standard keeps both the stage saturated and the on-screen frame true
     sc.view_settings.view_transform = "Standard"
+    # Layer 1 framing gate (silhouette matte) on the BAY scene — exit 10 on
+    # violation, before the beauty render. Renderables here are the desk,
+    # stand, and monitor assembly; floor/wall are the stage.
+    stage = [o for o in sc.objects if any(k in o.name.lower() for k in ("floor", "wall"))]
+    hero = [
+        o for o in sc.objects
+        if o.type in gallery_framing._RENDER_TYPES and not o.hide_render and o not in stage
+    ]
+    fcode = gallery_framing.check_framing(
+        sc, cam,
+        hero=hero,
+        elements=hero,
+        stage=stage,
+    )
+    if fcode:
+        return fcode
     bpy.ops.render.render(write_still=True, scene=sc.name)
-    return os.path.exists(path) and os.path.getsize(path) > 0
+    if not (os.path.exists(path) and os.path.getsize(path) > 0):
+        print("ERROR: render produced no file", file=sys.stderr)
+        return 11
+    return 0
 
 
 def render_still(path, engine):
@@ -550,7 +576,7 @@ def render_still(path, engine):
     try:
         frame_path = os.path.join(tmp, "program.png")
         if not render_frame(sc, frame_path, engine, RENDER_W, RENDER_H):
-            return False
+            return 11
         bay = bpy.data.scenes.new("Bay")
         build_stage(bay)          # the house dark studio, lights included
         build_bay(bay, frame_path)
@@ -647,8 +673,11 @@ def main():
     if args.output:
         # The round-trip reloaded a .blend; start clean for the still.
         bpy.ops.wm.read_factory_settings(use_empty=True)
-        if not render_still(os.path.abspath(args.output), args.engine):
+        rcode = render_still(os.path.abspath(args.output), args.engine)
+        if rcode == 11:
             return fail(f"render produced no file at {args.output}", 11)
+        if rcode:
+            return rcode
         print(f"wrote {args.output}")
     return 0