Struct SolidBoundary 

pub struct SolidBoundary { /* private fields */ }

A solid’s boundary, prepared once and asked about many points.

Classifying a point casts rays and counts crossings, which is cheap. What is not cheap is what the rays are cast against: every face’s trimming rings, polylined, plus its placement’s inverse. That work depends on the solid and the chord, never on the point, and a boolean asks once per face piece. Preparing costs hundreds of times the ray casting it serves, so it is done once.

Implementations

impl SolidBoundary

pub fn of( model: &Model, solid: &Shape, ring_chord: f64, tol: Tolerances, ) -> OgeomResult<Self>

Prepare a solid’s boundary for classification at a given ring chord.

Errors

As classify_in_solid_exact.

pub fn of_closed( model: &Model, solid: &Shape, ring_chord: f64, tol: Tolerances, ) -> OgeomResult<Self>

SolidBoundary::of for a solid whose shells the caller has already found closed: their closure is not asked again, and a shell that is open after all classifies as its faces fall.

Errors

As SolidBoundary::of, but for an open shell.

pub fn of_kept( model: &Model, solid: &Shape, ring_chord: f64, closed: bool, tol: Tolerances, ) -> OgeomResult<Self>

SolidBoundary::of, or SolidBoundary::of_closed where closed says the caller has found the shells closed, kept in the model for a solid of many faces: a later boundary of the solid unchanged, at the same chord and tolerances, shares the faces prepared and the rings drawn of them. A solid prepared for the first time shares each face it holds as a solid kept so holds it (a boolean’s result, the faces it passed through from its operand).

The rings are drawn at the tolerances a point is asked about at, the first time one comes near: the boundary is to be asked at tol.

Errors

As SolidBoundary::of, or SolidBoundary::of_closed where closed.

pub fn holds( &self, model: &Model, point: Point, tol: Tolerances, ) -> OgeomResult<Containment>

Where a point stands against this boundary.

Errors

As classify_in_solid_exact.

pub fn clear_from( &self, model: &Model, from: Point, to: Point, on: &[Shape], tol: Tolerances, ) -> OgeomResult<bool>

Whether the segment from from to to meets no face of the boundary past the faces from lies on, on: it crosses none inside its trim but those at its start, comes within the rings’ band of none’s boundary, and lies in none’s surface.

A step off faces lying together reads their two sides only along such a segment. A face of on met again further along (the far wall of a drum stepped across) is met.

Errors

As classify_in_solid_exact.

pub fn winding( &self, model: &Model, point: Point, tol: Tolerances, ) -> OgeomResult<Option<i64>>

The winding number of the boundary about point: how many times more a ray from it leaves through a face, along the face’s outward normal, than it enters through one. One inside a solid and zero outside; past one where a boundary passing through itself encloses a region twice. None where point lies on a face, or where every ray met a tangency, a face’s boundary or a degenerate point.

Errors

As classify_in_solid_exact.

pub fn faces_at( &self, model: &Model, point: Point, tol: Tolerances, ) -> OgeomResult<Vec<Shape>>

The faces point lies on, within each one’s own reach.

Errors

As classify_in_solid_exact.

Trait Implementations

impl Debug for SolidBoundary

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

Formats the value using the given formatter.