Enum SurfaceGeometry 

pub enum SurfaceGeometry {
    Plane(PlaneSurface),
    Cylinder(CylinderSurface),
    Cone(ConeSurface),
    Sphere(SphereSurface),
    Torus(TorusSurface),
    BSpline(BSplineSurface),
    Revolution(Box<RevolutionSurface>),
    Extrusion(Box<ExtrusionSurface>),
    Trimmed(Box<TrimmedSurface>),
    Offset(Box<OffsetSurface>),
}

A surface.

Variants

Plane(PlaneSurface)

A plane.

Cylinder(CylinderSurface)

A circular cylinder.

Cone(ConeSurface)

A circular cone.

Sphere(SphereSurface)

A sphere.

Torus(TorusSurface)

A torus.

BSpline(BSplineSurface)

A polynomial or rational B-spline patch.

Revolution(Box<RevolutionSurface>)

A curve revolved about an axis.

Extrusion(Box<ExtrusionSurface>)

A curve swept along a direction.

Trimmed(Box<TrimmedSurface>)

Another surface restricted to a sub-rectangle.

Offset(Box<OffsetSurface>)

A surface at a constant signed distance along another’s normal.

Implementations

impl SurfaceGeometry

pub fn fitted_bspline( &self, tolerance: f64, tol: Tolerances, ) -> OgeomResult<Fitted<BSplineSurface>>

This surface as a B-spline fitted over its own domain to a stated tolerance: the approximation to_bspline refuses to make silently, for an offset surface or anything else with no exact rational form. A grid of the surface’s points is fitted at degree three at the surface’s own parameters, the fit measured against the surface between the samples as well as at them, and the grid refined where it misses until the tolerance holds or the budget runs out; error is the worst measured, not what was asked. The fit spans the surface’s own domain, but its knots are its own, so a pcurve spoken against the surface is re-derived against the result. Where the surface cannot be evaluated (an offset sphere’s poles, where the basis has no normal) the fit takes the limit of the points around, and the error stated counts how closely they close on it.

Errors

OgeomError::Construction if the domain is unbounded, the tolerance is not a distance, or the surface cannot be evaluated somewhere and the points around do not close on one (an offset cone’s apex); as fit::fit_surface_grid.

impl SurfaceGeometry

pub fn to_bspline(&self, tol: Tolerances) -> OgeomResult<BSplineSurface>

This surface as a B-spline patch, exactly, over [0, 1] in both directions.

Every analytic surface here is a surface of revolution or a ruled one, so its exact form falls out of the curve conversion above rather than needing a construction of its own: revolve an exactly-converted profile and the patch is exact wherever the profile was.

As for curves, the parameterization does not survive: a cylinder’s u is an angle and the patch’s is not. See the module documentation.

Errors

OgeomError::Construction if the surface’s own extents are degenerate, or its geometry cannot be evaluated.

Trait Implementations

impl Clone for SurfaceGeometry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SurfaceGeometry

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

Formats the value using the given formatter.

impl From<BSplineSurface> for SurfaceGeometry

fn from(s: BSplineSurface) -> Self

Converts to this type from the input type.

impl From<ConeSurface> for SurfaceGeometry

fn from(s: ConeSurface) -> Self

Converts to this type from the input type.

impl From<CylinderSurface> for SurfaceGeometry

fn from(s: CylinderSurface) -> Self

Converts to this type from the input type.

impl From<ExtrusionSurface> for SurfaceGeometry

fn from(s: ExtrusionSurface) -> Self

Converts to this type from the input type.

impl From<PlaneSurface> for SurfaceGeometry

fn from(s: PlaneSurface) -> Self

Converts to this type from the input type.

impl From<RevolutionSurface> for SurfaceGeometry

fn from(s: RevolutionSurface) -> Self

Converts to this type from the input type.

impl From<SphereSurface> for SurfaceGeometry

fn from(s: SphereSurface) -> Self

Converts to this type from the input type.

impl From<TorusSurface> for SurfaceGeometry

fn from(s: TorusSurface) -> Self

Converts to this type from the input type.

impl From<TrimmedSurface> for SurfaceGeometry

fn from(s: TrimmedSurface) -> Self

Converts to this type from the input type.

impl PartialEq for SurfaceGeometry

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SurfaceGeometry

impl Surface for SurfaceGeometry

fn domain(&self) -> ((f64, f64), (f64, f64))

The u and v parameter intervals.

fn point_at(&self, u: f64, v: f64, tol: Tolerances) -> OgeomResult<Point>

The point at (u, v).

fn d1_at( &self, u: f64, v: f64, tol: Tolerances, ) -> OgeomResult<(Vector, Vector)>

The two first derivatives at (u, v).

fn d2_at( &self, u: f64, v: f64, tol: Tolerances, ) -> OgeomResult<(Vector, Vector, Vector)>

The three second derivatives at (u, v): d2u, duv, d2v.

fn point_d1_at( &self, u: f64, v: f64, tol: Tolerances, ) -> OgeomResult<(Point, Vector, Vector)>

The point and first derivatives together: (point, du, dv).

fn jet_at(&self, u: f64, v: f64, tol: Tolerances) -> OgeomResult<SurfaceJet>

The point and every derivative through second order, together.

fn kind(&self) -> SurfaceKind

What kind of surface this is.

fn continuity(&self) -> Continuity

How smooth the surface is across its domain.

fn is_closed_u(&self, tol: Tolerances) -> bool

Whether the surface closes on itself along u.

fn is_closed_v(&self, tol: Tolerances) -> bool

Whether the surface closes on itself along v.

fn is_periodic_u(&self) -> bool

Whether u repeats past the domain.

fn is_periodic_v(&self) -> bool

Whether v repeats past the domain.

fn normal_at(&self, u: f64, v: f64, tol: Tolerances) -> OgeomResult<Direction>

The unit normal at (u, v), following du x dv.

fn curvature_at( &self, u: f64, v: f64, tol: Tolerances, ) -> OgeomResult<SurfaceCurvature>

The principal curvatures and directions at (u, v).

fn is_degenerate_at(&self, u: f64, v: f64, tol: Tolerances) -> OgeomResult<bool>

Whether the surface degenerates at (u, v).

fn normalize_parameters( &self, u: f64, v: f64, tol: Tolerances, ) -> OgeomResult<(f64, f64)>

Bring (u, v) into the domain, wrapping in whichever directions are periodic, or closed.

fn parameter_outside( &self, t: f64, a: f64, b: f64, periodic: bool, across: bool, tol: Tolerances, ) -> OgeomResult<f64>

A parameter outside its domain, or on a periodic direction: wrapped where the direction repeats or closes on itself, refused otherwise.

impl Transformable for SurfaceGeometry

fn transformed(&self, t: &Transform, tol: Tolerances) -> OgeomResult<Self>

This geometry moved by t.