Struct CpuCutout 

pub struct CpuCutout {
    pub focus_local: [f32; 3],
    pub tan_outer: f32,
    pub tan_inner: f32,
    pub margin: f32,
    pub focus_z: i32,
}

OC.0 — the view cutout as one grid’s render pass consumes it, fully derived by the facade each frame (stage OC; see FrameParams::view_cutout in roxlap-render). A cell is hidden iff ALL of: its CENTRE lies inside the view cone around the eye→focus axis (the cone tapers across the feather band), its eye distance is under the nearest character-column point’s minus margin, and its grid-local z is above the focus plane (z < focus_z, z-down) — walls between the camera and the focus cut, the floor in front of the focus stays.

Per-CELL, not per-pixel (the OC.3 visual-pass round-2 redesign): the original rule gated each RAY by a screen-space window, so a cell straddling the window edge rendered for the outside pixels only — sub-cell fragments that read as ragged teeth wherever the boundary crossed a floor or wall at a shallow angle. Classifying whole cells by their centres makes the cut edge cube-granular and spatially coherent, exactly like the CA clip’s edges.

Fields

focus_local: [f32; 3]

The focus point in this grid’s local frame, voxel units (the same space the ray origin lives in).

tan_outer: f32

Tangent of the cone’s OUTER half-angle (nothing is cut outside it). The facade derives it from the keyhole’s pixel radius and the frame’s focal length (radius_px / hz), so it still means “a screen circle of ~radius_px around the projected focus”.

tan_inner: f32

Tangent of the full-reveal INNER half-angle ((radius − feather)/hz): between the two the reveal distance tapers linearly to zero, closing the keyhole into a smooth funnel. == tan_outer gives a hard edge.

margin: f32

How far short of the character COLUMN the reveal stops, in this grid’s voxel units (world units /vws). The reveal surface hugs the column — the vertical segment at the focus xy between the focus plane (Self::focus_z, the feet) and its mirror above the focus (the head): a cell is hidden while its eye distance is under the eye distance of the NEAREST column point at the cell’s own height, minus this margin. A fixed eye-distance sphere through the focus (the previous rule) kept waist-down stumps of any obstacle the character stood right behind — below-chest cells in front sit FARTHER from an elevated eye than the chest itself.

focus_z: i32

Grid-local absolute voxel z of the focus plane (mip-0, z-down, spanning stacked chz chunks — the same space as Self::z_clip); cells with z < focus_z qualify for hiding. At mip N the compare uses focus_z >> mip (arithmetic shift = floor), the CA.1 formula. This is the FIRST, cheap gate in the hit branch: i32::MIN-like sentinels keep the disabled cost at one never-true compare.

Trait Implementations

impl Clone for CpuCutout

fn clone(&self) -> CpuCutout

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CpuCutout

impl Debug for CpuCutout

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for CpuCutout

fn eq(&self, other: &CpuCutout) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CpuCutout