Enum PinchPolicy 

#[non_exhaustive]
pub enum PinchPolicy {
    Refuse,
    Accept,
}

How a triangulation treats rings that touch at a single point (#262): a hole touching the outer ring or another hole at a vertex, an outer ring pinched at a vertex, or a vertex lying on another ring’s edge.

The region such rings bound is valid, but the surface an extrusion builds over it is not a two-manifold: the walls of the two rings meet along one edge, which four faces then share. So solids refuse it and regions and surface patches accept it. The same holds for a ring that joins a hole by a seam it runs along both ways (#270): its region is the outer polygon less the hole, but an extrusion puts two coincident wall faces on the seam.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Refuse

Refuse touching rings and seams with InvalidInput naming them. For anything that must close into a two-manifold: extrusion and loft caps.

Accept

Triangulate the region the touching rings bound. For 2D regions and planar surface patches: a plan footprint that is a union of shadows touching at a corner, a space-boundary surface, a planar face of a B-rep (whose edges are the ring edges either way, once a vertex inside an edge, which ring_touches lists, is inserted into the neighbouring face’s copy of that edge too). A ring joining a hole by a seam run both ways (a keyhole, #270) is accepted too.

Trait Implementations

impl Clone for PinchPolicy

fn clone(&self) -> PinchPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PinchPolicy

impl Debug for PinchPolicy

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

Formats the value using the given formatter.

impl Eq for PinchPolicy

impl Hash for PinchPolicy

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PinchPolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PinchPolicy