Enum BoolFailureReason 

pub enum BoolFailureReason {
    OperandTooLarge {
        polys_a: usize,
        polys_b: usize,
    },
    EmptyOperand,
    DegenerateOperand,
    NoBoundsOverlap,
    KernelOutputInvalid,
    SolidSolidDifferenceSkipped,
    PolygonalBoundedHalfSpaceFallback,
    CutterUnionUnavailable,
    UnknownBooleanOperator(String),
    ManifoldOutputDegenerate {
        host_tris: usize,
        result_tris: usize,
    },
    KernelError(String),
    DifferenceEmptiedHost,
}

Why a boolean operation failed or was skipped.

Variants

OperandTooLarge

HISTORICAL: at least one operand exceeded the deleted legacy BSP CSG polygon cap. The pure-Rust exact kernel has no operand cap, so this is no longer emitted by the boolean ops; the variant (and its JSON label) is kept for the frozen diagnostics surface and void-router plumbing.

Fields

polys_a: usize

polys_b: usize

EmptyOperand

One or both operand meshes were empty before polygon extraction.

DegenerateOperand

Polygon extraction yielded an empty list (degenerate / non-finite vertices).

NoBoundsOverlap

Operand bounding boxes don’t overlap. Informational — host returned unchanged.

KernelOutputInvalid

The CSG kernel returned malformed polygons (NaN / non-finite).

SolidSolidDifferenceSkipped

HISTORICAL: solid-vs-solid IfcBooleanResult.DIFFERENCE was not attempted because the deleted legacy BSP could stack-overflow on arbitrary solid combinations. No longer emitted — the exact kernel always attempts the cut. Variant kept for the frozen label surface.

PolygonalBoundedHalfSpaceFallback

IfcPolygonalBoundedHalfSpace prism-subtraction failed; the kernel fell back to an unbounded plane clip, silently dropping the polygonal boundary. The clip is applied but is a strict superset of the requested cut.

CutterUnionUnavailable

The chained-clip cutter prisms couldn’t be unioned into one watertight solid, so the single batched subtract (issue #960) was skipped and the chain fell back to sequential per-cutter subtraction. The cuts are applied, but abutting cutters may leave zero-thickness seam fins that the batched path would have eliminated.

UnknownBooleanOperator(String)

IfcBooleanResult operator string didn’t match any known op.

ManifoldOutputDegenerate

HISTORICAL: the deleted Manifold C++ kernel’s difference returned output implausibly small relative to the host (a Linux-x86_64-only pathology). No longer emitted — the deterministic exact kernel replaced Manifold. Variant kept for the frozen label surface.

Fields

host_tris: usize

result_tris: usize

KernelError(String)

Catch-all for kernel-specific errors (free-form string).

DifferenceEmptiedHost

IfcBooleanResult.DIFFERENCE produced an empty mesh from a non-empty host. Almost always a buggy export — a clip plane authored AT the wall’s top with AgreementFlag = .T. (issue #821, Revit IFC2x3 TallBuilding.ifc) makes the half-space material region exactly cover the wall body, so the strict-spec subtract yields nothing. The caller falls back to the un-cut host (matching what BIMVision and similar viewers do in practice) and records this so the loss surfaces in diagnostics rather than as a silently missing element.

Implementations

impl BoolFailureReason

pub fn label(&self) -> &'static str

Stable short label for per-reason aggregation. Single home shared by the wasm console diagnostics and the server tracing summary so the two surfaces cannot drift (Rust-first).

Trait Implementations

impl Clone for BoolFailureReason

fn clone(&self) -> BoolFailureReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoolFailureReason

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

Formats the value using the given formatter.

impl Display for BoolFailureReason

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

Formats the value using the given formatter.

impl Eq for BoolFailureReason

impl PartialEq for BoolFailureReason

fn eq(&self, other: &BoolFailureReason) -> 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 StructuralPartialEq for BoolFailureReason