Struct BSplineSurface 

pub struct BSplineSurface { /* private fields */ }

A tensor-product B-spline patch, polynomial or rational.

Implementations

impl BSplineSurface

pub fn restricted_to_degree( &self, max_degree: usize, tolerance: f64, tol: Tolerances, ) -> OgeomResult<Fitted<Self>>

This patch at degrees no higher than max_degree in either direction, to a stated tolerance: itself where it already is, and otherwise a fit through a grid of its own points, the grid doubled until the fit holds every sample to the tolerance or the budget runs out. The fit’s parameterization is its own (chord-length through the grid, not the patch’s), so a pcurve spoken against the patch must be re-derived against the result.

Errors

OgeomError::Construction if max_degree is zero or the tolerance is not a distance; as fit::fit_surface_grid.

impl BSplineSurface

pub fn new( u_knots: KnotVector, v_knots: KnotVector, grid: &ControlGrid<Point>, tol: Tolerances, ) -> OgeomResult<Self>

A polynomial patch.

Errors

OgeomError::Dimension on a shape mismatch.

pub fn rational( u_knots: KnotVector, v_knots: KnotVector, grid: ControlGrid<Weighted<Point>>, ) -> OgeomResult<Self>

A rational patch.

Errors

OgeomError::Dimension on a shape mismatch.

pub fn extended( &self, along_u: bool, at_end: bool, length: f64, continuity: usize, tol: Tolerances, ) -> OgeomResult<Self>

This patch continued past one of its four sides by about length in space: every column of the control net continued along u (or every row along v), as BSplineCurve::extended continues a curve, over one shared span so the net stays a grid. The span is the length over the mean speed along that side, so the continuation reaches the length where the side runs at its mean speed and less where the surface stretches faster. The original patch keeps its parameters; the domain grows at the side continued.

Errors

OgeomError::Construction if the side stands still, or the length is not positive; as [ogeom_math::bspline::extend].

pub fn iso_u_curve(&self, at: f64, tol: Tolerances) -> OgeomResult<BSplineCurve>

The u = at iso-curve: a B-spline over the v knots whose controls are the control columns blended by the u basis at at, weights and all: exactly the curve the surface traces up that column.

Errors

OgeomError::Domain if at is outside the u domain.

pub fn iso_v_curve(&self, at: f64, tol: Tolerances) -> OgeomResult<BSplineCurve>

The v = at iso-curve, as BSplineSurface::iso_u_curve the other way round.

Errors

As BSplineSurface::iso_u_curve.

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

The patch of this surface over u by v, exactly and keeping its parameters: the patch at (u, v) is this surface at (u, v).

Errors

OgeomError::Domain if either range is empty or leaves the domain.

pub const fn u_knots(&self) -> &KnotVector

The u knot vector.

pub const fn v_knots(&self) -> &KnotVector

The v knot vector.

pub const fn grid(&self) -> &ControlGrid<Weighted<Point>>

The control grid.

pub const fn is_rational(&self) -> bool

Whether the weights differ, so the patch is genuinely rational.

Trait Implementations

impl Clone for BSplineSurface

fn clone(&self) -> BSplineSurface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BSplineSurface

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 PartialEq for BSplineSurface

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

impl Surface for BSplineSurface

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.