Struct Cubic 

pub struct Cubic { /* private fields */ }

One cubic Bézier segment: two anchor points with two control points between them.

Stored as the same flat eight-float array upstream uses ([a0x, a0y, c0x, c0y, c1x, c1y, a1x, a1y]), which is also the layout a morph’s element-wise interpolation wants.

Implementations

impl Cubic

pub const fn new( anchor0: Point, control0: Point, control1: Point, anchor1: Point, ) -> Cubic

A cubic from its four points, in path order.

pub const fn from_raw(points: [f64; 8]) -> Cubic

A cubic from the raw [a0x, a0y, c0x, c0y, c1x, c1y, a1x, a1y] layout.

pub const fn points(&self) -> &[f64; 8]

The raw [a0x, a0y, c0x, c0y, c1x, c1y, a1x, a1y] layout.

pub fn straight_line(p0: Point, p1: Point) -> Cubic

A straight line between the anchors, with the controls placed a third and two thirds of the way along it.

pub fn empty(p: Point) -> Cubic

A zero-length cubic at p.

pub fn circular_arc(center: Point, p0: Point, p1: Point) -> Cubic

A cubic approximating the circular arc from p0 to p1 around center, taking the shorter of the two ways round.

p0 and p1 are expected to be equidistant from center; arcs beyond 180° need more than one segment. Near-coincident endpoints degrade to a straight line.

pub const fn anchor0(&self) -> Point

The curve’s starting anchor.

pub const fn control0(&self) -> Point

The control point governing the slope at Cubic::anchor0.

pub const fn control1(&self) -> Point

The control point governing the slope at Cubic::anchor1.

pub const fn anchor1(&self) -> Point

The curve’s ending anchor.

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

The point at parameter t, where 0 is Cubic::anchor0 and 1 is Cubic::anchor1.

pub fn zero_length(&self) -> bool

Whether both anchors sit on the same point, within DISTANCE_EPSILON. Such curves paint nothing and are dropped from a polygon’s cubic list.

pub fn split(&self, t: f64) -> (Cubic, Cubic)

Splits the curve at parameter t into two curves covering the same path.

pub fn reversed(&self) -> Cubic

The same curve traversed in the opposite direction.

pub fn transformed_with(&self, f: impl Fn(Point) -> Point) -> Cubic

This curve with every anchor and control point mapped through f.

pub fn approximate_bounds(&self) -> Rect

The bounding box of the four defining points — cheap, and never smaller than Cubic::exact_bounds.

pub fn exact_bounds(&self) -> Rect

The true bounding box of the curve, solving the derivative for its extrema on each axis.

Trait Implementations

impl Clone for Cubic

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Cubic

impl Debug for Cubic

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

Formats the value using the given formatter.

impl PartialEq for Cubic

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Cubic