Struct CubicBezier 

pub struct CubicBezier<P: VectorSpace> {
    pub control_points: Vec<[P; 4]>,
}

A spline composed of a single cubic Bezier curve.

Useful for user-drawn curves with local control, or animation easing. See CubicSegment::new_bezier_easing for use in easing.

Interpolation

The curve only passes through the first and last control point in each set of four points. The curve is divided into “segments” by every fourth control point.

Tangency

Tangents are manually defined by the two intermediate control points within each set of four points. You can think of the control points the curve passes through as “anchors”, and as the intermediate control points as the anchors displaced along their tangent vectors

Continuity

A Bezier curve is at minimum C0 continuous, meaning it has no holes or jumps. Each curve segment is C2, meaning the tangent vector changes smoothly between each set of four control points, but this doesn’t hold at the control points between segments. Making the whole curve C1 or C2 requires moving the intermediate control points to align the tangent vectors between segments, and can result in a loss of local control.

Usage

let points = [[
    vec2(-1.0, -20.0),
    vec2(3.0, 2.0),
    vec2(5.0, 3.0),
    vec2(9.0, 8.0),
]];
let bezier = CubicBezier::new(points).to_curve().unwrap();
let positions: Vec<_> = bezier.iter_positions(100).collect();

Fields

control_points: Vec<[P; 4]>

The control points of the Bezier curve.

Implementations

impl<P: VectorSpace> CubicBezier<P>

pub fn new(control_points: impl IntoIterator<Item = [P; 4]>) -> Self

Create a new cubic Bezier curve from sets of control points.

Trait Implementations

impl<P: Clone + VectorSpace> Clone for CubicBezier<P>

fn clone(&self) -> CubicBezier<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: VectorSpace<Scalar = f32>> CubicGenerator<P> for CubicBezier<P>

Available on crate feature alloc only.

type Error = CubicBezierError

An error type indicating why construction might fail.

fn to_curve(&self) -> Result<CubicCurve<P>, Self::Error>

Build a CubicCurve by computing the interpolation coefficients for each curve segment.

impl<P: Debug + VectorSpace> Debug for CubicBezier<P>

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

Formats the value using the given formatter.