Struct bspline::BSpline
[−]
[src]
pub struct BSpline<T: Interpolate + Copy> { /* fields omitted */ }
Represents a B-spline curve that will use polynomials of the specified degree to interpolate between the control points given the knots.
Methods
impl<T: Interpolate + Copy> BSpline<T>
[src]
fn new(degree: usize, control_points: Vec<T>, knots: Vec<f32>) -> BSpline<T>
Create a new B-spline curve of the desired degree
that will interpolate
the control_points
using the knots
. The knots should be sorted in non-decreasing
order otherwise they will be sorted for you, which may lead to undesired knots
for control points. Note that here we use the interpolating polynomial degree,
if you're familiar with the convention of "B-spline curve order" the degree is curve_order - 1
.
Your curve must have a valid number of control points and knots or the function will panic. A B-spline
curve requires at least as one more control point than the degree (control_points.len() > degree
) and the number of knots should be equal to control_points.len() + degree + 1
.
fn point(&self, t: f32) -> T
Compute a point on the curve at t
, the parameter must be in the inclusive range
of values returned by knot_domain
. If t
is out of bounds this function will assert
on debug builds and on release builds you'll likely get an out of bounds crash.
fn control_points(&self) -> Iter<T>
Get an iterator over the control points.
fn knots(&self) -> Iter<f32>
Get an iterator over the knots.
fn knot_domain(&self) -> (f32, f32)
Get the min and max knot domain values for finding the t
range to compute
the curve over. The curve is only defined over the inclusive range [min, max]
,
passing a t
value outside of this range will result in an assert on debug builds
and likely a crash on release builds.
Trait Implementations
impl<T: Clone + Interpolate + Copy> Clone for BSpline<T>
[src]
fn clone(&self) -> BSpline<T>
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more