Enum DegenerateReason 

pub enum DegenerateReason {
    EmptyOperand,
    NoOverlap,
    BelowKernelResolution {
        thickness_m: f64,
        required_m: f64,
    },
    BudgetExhausted,
}

Why no solid is being returned.

Variants

EmptyOperand

One or both operands had no triangles.

NoOverlap

The kernel’s exact intersection is empty: the pair does not overlap, or overlaps by less than the 2^-16 m snap grid so both faces snapped flush. A touching pair (coplanar faces, zero overlap) lands here.

BelowKernelResolution

The pair overlaps, but not deeply enough for the kernel’s arrangement to resolve the overlap as a solid rather than a coplanar contact. The solid that would be returned here is systematically wrong (see the module docs), so it is withheld. thickness_m is the intersection’s smallest extent over the candidate contact normals (see gate_axes), which for a box-box pair is the true penetration depth whatever the pair’s orientation; required_m is the depth this pair would have needed.

thickness_m == 0.0 exactly is a real and distinct outcome, observed on the bridge model (IfcColumn #761 × IfcWall #828): the kernel returned triangles, but they are FLAT — a coplanar contact patch with no thickness at all, rather than a slab too thin to resolve. It is reported here instead of as NoOverlap because the arrangement did produce geometry; the caller’s action is the same either way (fall back to the contact marker), and the two are told apart by this field.

Fields

thickness_m: f64

required_m: f64

BudgetExhausted

The #1109 escalation budget tripped, so the arrangement is partial and nothing about it can be trusted.

Trait Implementations

impl Clone for DegenerateReason

fn clone(&self) -> DegenerateReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DegenerateReason

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

Formats the value using the given formatter.

impl PartialEq for DegenerateReason

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for DegenerateReason

impl StructuralPartialEq for DegenerateReason