Enum FaceName

pub enum FaceName {
    Swept(SweptFace),
    Blend(Box<EdgeName>),
    Fragment {
        operand: Operand,
        source: Box<FaceName>,
    },
    Anonymous(u32),
}

A persistent, structural name for one exact B-rep face.

Names compose: a boolean fragment of a filleted extrusion wall carries the whole chain, so a caller can ask both “which operand” and “which original profile edge” without consulting the operation that produced it.

Variants

Swept(SweptFace)

A face of a swept solid, named by its role in the sweep.

Blend(Box<EdgeName>)

A blend face introduced by filleting or chamfering a named edge.

The name is the edge that was blended, not a fresh anonymous id, so re-running the feature after an edit still names the same blend.

Fragment

A fragment of a face of one operand of a boolean.

Boolean output faces are always pieces of input faces – the operation never invents a surface – so every fragment can say which input face it is part of.

Fields

operand: Operand

Which operand contributed the face this fragment came from.

source: Box<FaceName>

The name that face carried in its own solid.

Anonymous(u32)

A face whose provenance was not tracked by the producing operation.

Deliberately explicit: an operation that cannot name its output says so, instead of fabricating a name that would collide with a real one.

Implementations

impl FaceName

pub const fn swept(part: SweptFace) -> FaceName

Name a swept cap or wall.

pub fn blend(edge: EdgeName) -> FaceName

Name the blend that replaced edge.

pub fn fragment(self, operand: Operand) -> FaceName

Name a fragment of self cut out by a boolean.

pub fn origin(&self) -> &FaceName

The original face name with all boolean fragment layers stripped.

Answers “what was this before any boolean touched it”, which is what a material or finish assignment needs.

pub fn is_anonymous(&self) -> bool

Whether this name, or anything it came from, is anonymous.

A caller that requires full provenance checks this rather than pattern matching the outermost layer, which a fragment would hide.

Trait Implementations

impl Clone for FaceName

fn clone(&self) -> FaceName

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FaceName

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

Formats the value using the given formatter.

impl Display for FaceName

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

Formats the value using the given formatter.

impl Hash for FaceName

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 Ord for FaceName

fn cmp(&self, other: &FaceName) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for FaceName

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

fn partial_cmp(&self, other: &FaceName) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for FaceName

impl StructuralPartialEq for FaceName