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, the grid doubled until every sample is within the tolerance or the budget runs out, and error is what was measured. The fit’s parameterization is its own, so a pcurve spoken against the surface must be re-derived against the result.

Errors

OgeomError::Construction if the domain is unbounded or the tolerance is not a distance; 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) -> SurfaceGeometry

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: &SurfaceGeometry) -> 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 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 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.