Struct kurbo::CubicBez

pub struct CubicBez {
    pub p0: Point,
    pub p1: Point,
    pub p2: Point,
    pub p3: Point,
}

A single cubic Bézier segment.

Fields

p0: Point

p1: Point

p2: Point

p3: Point

Methods

impl CubicBez

pub fn new<P: Into<Point>>(p0: P, p1: P, p2: P, p3: P) -> CubicBez

Create a new cubic Bézier segment.

pub fn to_quads(
    &self,
    accuracy: f64
) -> impl Iterator<Item = (f64, f64, QuadBez)>

Convert to quadratic Béziers.

The iterator returns the start and end parameter in the cubic of each quadratic segment, along with the quadratic.

Note that the resulting quadratic Béziers are not in general G1 continuous; they are optimized for minimizing distance error.

Trait Implementations

impl ParamCurve for CubicBez

fn eval(&self, t: f64) -> Point

Evaluate the curve at parameter t.

fn start(&self) -> Point

The start point.

fn end(&self) -> Point

The end point.

fn subsegment(&self, range: Range<f64>) -> CubicBez

Get a subsegment of the curve for the given parameter range.

fn subdivide(&self) -> (CubicBez, CubicBez)

Subdivide into halves, using de Casteljau.

impl ParamCurveDeriv for CubicBez

type DerivResult = QuadBez

fn deriv(&self) -> QuadBez

The derivative of the curve.

fn gauss_arclen(&self, coeffs: &[(f64, f64)]) -> f64

Estimate arclength using Gaussian quadrature.

impl ParamCurveArclen for CubicBez

fn arclen(&self, accuracy: f64) -> f64

Arclength of a cubic Bézier segment.

This is an adaptive subdivision approach using Legendre-Gauss quadrature in the base case, and an error estimate to decide when to subdivide.

fn inv_arclen(&self, arclen: f64, accuracy: f64) -> f64

Solve for the parameter that has the given arclength from the start.

impl ParamCurveArea for CubicBez

fn signed_area(&self) -> f64

Compute the signed area under the curve.

impl ParamCurveNearest for CubicBez

fn nearest(&self, p: Point, accuracy: f64) -> (f64, f64)

Find nearest point, using subdivision.

impl ParamCurveCurvature for CubicBez

fn curvature(&self, t: f64) -> f64

Compute the signed curvature at parameter t.

impl ParamCurveExtrema for CubicBez

fn extrema(&self) -> ArrayVec<[f64; 4]>

Compute the extrema of the curve.

fn extrema_ranges(&self) -> ArrayVec<[Range<f64>; 5]>

Return parameter ranges, each of which is monotonic within the range.

fn bounding_box(&self) -> Rect

The smallest rectangle that encloses the curve in the range (0..1).

impl Copy for CubicBez

impl Clone for CubicBez

fn clone(&self) -> CubicBez

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Mul<CubicBez> for Affine

type Output = CubicBez

The resulting type after applying the * operator.

fn mul(self, c: CubicBez) -> CubicBez

Performs the * operation.

impl Debug for CubicBez

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

Formats the value using the given formatter.