Enum GroupCut 

pub enum GroupCut {
    Cut(Mesh),
    Retessellated(Mesh),
    Rejected(GroupReject),
}

Outcome of ClippingProcessor::subtract_mesh_many and of ClippingProcessor::subtract_mesh, which is a group of one.

Variants

Cut(Mesh)

The kernel classified a cut, and every produced intermediate passed validation and the accept gates. Single-cutter arrangements are lenient; group cuts additionally require conformity or the kernel’s volume oracle. Empty when the cutters engulf the host.

Retessellated(Mesh)

The kernel classified the cutter as not reaching the host solid, and this is the host re-tessellated along the arrangement, consolidated, validated and gated like a Cut. Same solid as the host, different triangles. Whether to keep it is the caller’s choice; the void router has kept it when it changed the triangle count, and the watertightness census depends on that (#4692). A non-conforming same-count miss is Rejected(Nonconforming) instead (#5362). The public group API does not return this variant. The private void group opt-in can retain a conforming, count-changing miss (#6516).

Rejected(GroupReject)

The host is untouched; uncertain results need a per-member fallback.

Implementations

impl GroupCut

pub fn found_no_overlap(&self) -> bool

Whether the kernel established that no cutter reaches the host solid, as opposed to failing to cut one that does: there is nothing to approximate, so a fallback cut must not run (#5362).

pub fn into_mesh(self) -> Option<Mesh>

The mesh the subtract produced, a cut or a re-tessellated miss; None for a rejection.

Trait Implementations

impl Clone for GroupCut

fn clone(&self) -> GroupCut

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GroupCut

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

Formats the value using the given formatter.