Struct lyon_geom::QuadraticBezierSegment

source ·
pub struct QuadraticBezierSegment<S> {
    pub from: Point<S>,
    pub ctrl: Point<S>,
    pub to: Point<S>,
}
Expand description

A 2d curve segment defined by three points: the beginning of the segment, a control point and the end of the segment.

The curve is defined by equation: ∀ t ∈ [0..1], P(t) = (1 - t)² * from + 2 * (1 - t) * t * ctrl + t² * to

Fields§

§from: Point<S>§ctrl: Point<S>§to: Point<S>

Implementations§

source§

impl<S: Scalar> QuadraticBezierSegment<S>

source

pub fn cast<NewS: NumCast>(self) -> QuadraticBezierSegment<NewS>

source

pub fn sample(&self, t: S) -> Point<S>

Sample the curve at t (expecting t between 0 and 1).

source

pub fn x(&self, t: S) -> S

Sample the x coordinate of the curve at t (expecting t between 0 and 1).

source

pub fn y(&self, t: S) -> S

Sample the y coordinate of the curve at t (expecting t between 0 and 1).

source

pub fn derivative(&self, t: S) -> Vector<S>

Sample the curve’s derivative at t (expecting t between 0 and 1).

source

pub fn dx(&self, t: S) -> S

Sample the x coordinate of the curve’s derivative at t (expecting t between 0 and 1).

source

pub fn dy(&self, t: S) -> S

Sample the y coordinate of the curve’s derivative at t (expecting t between 0 and 1).

source

pub fn flip(&self) -> Self

Swap the beginning and the end of the segment.

source

pub fn y_maximum_t(&self) -> S

Find the advancement of the y-most position in the curve.

This returns the advancement along the curve, not the actual y position.

source

pub fn y_minimum_t(&self) -> S

Find the advancement of the y-least position in the curve.

This returns the advancement along the curve, not the actual y position.

source

pub fn local_y_extremum_t(&self) -> Option<S>

Return the y inflection point or None if this curve is y-monotonic.

source

pub fn x_maximum_t(&self) -> S

Find the advancement of the x-most position in the curve.

This returns the advancement along the curve, not the actual x position.

source

pub fn x_minimum_t(&self) -> S

Find the advancement of the x-least position in the curve.

This returns the advancement along the curve, not the actual x position.

source

pub fn local_x_extremum_t(&self) -> Option<S>

Return the x inflection point or None if this curve is x-monotonic.

source

pub fn split_range(&self, t_range: Range<S>) -> Self

Return the sub-curve inside a given range of t.

This is equivalent splitting at the range’s end points.

source

pub fn split( &self, t: S, ) -> (QuadraticBezierSegment<S>, QuadraticBezierSegment<S>)

Split this curve into two sub-curves.

source

pub fn before_split(&self, t: S) -> QuadraticBezierSegment<S>

Return the curve before the split point.

source

pub fn after_split(&self, t: S) -> QuadraticBezierSegment<S>

Return the curve after the split point.

source

pub fn to_cubic(&self) -> CubicBezierSegment<S>

Elevate this curve to a third order bézier.

source

pub fn baseline(&self) -> LineSegment<S>

source

pub fn is_a_point(&self, tolerance: S) -> bool

Returns whether the curve can be approximated with a single point, given a tolerance threshold.

source

pub fn is_linear(&self, tolerance: S) -> bool

Returns true if the curve can be approximated with a single line segment given a tolerance threshold.

source

pub fn fat_line(&self) -> (LineEquation<S>, LineEquation<S>)

Computes a “fat line” of this segment.

A fat line is two conservative lines between which the segment is fully contained.

source

pub fn transformed<T: Transformation<S>>(&self, transform: &T) -> Self

Applies the transform to this curve and returns the results.

source

pub fn flattening_step(&self, tolerance: S) -> S

Find the interval of the beginning of the curve that can be approximated with a line segment.

source

pub fn for_each_flattened<F>(&self, tolerance: S, callback: &mut F)
where F: FnMut(&LineSegment<S>),

Approximates the curve with sequence of line segments.

The tolerance parameter defines the maximum distance between the curve and its approximation.

This implements the algorithm described by Raph Levien at https://raphlinus.github.io/graphics/curves/2019/12/23/flatten-quadbez.html

source

pub fn for_each_flattened_with_t<F>(&self, tolerance: S, callback: &mut F)
where F: FnMut(&LineSegment<S>, Range<S>),

Compute a flattened approximation of the curve, invoking a callback at each step.

The tolerance parameter defines the maximum distance between the curve and its approximation.

The end of the t parameter range at the final segment is guaranteed to be equal to 1.0.

This implements the algorithm described by Raph Levien at https://raphlinus.github.io/graphics/curves/2019/12/23/flatten-quadbez.html

source

pub fn flattened(&self, tolerance: S) -> Flattened<S>

Returns the flattened representation of the curve as an iterator, starting after the current point.

source

pub fn flattened_t(&self, tolerance: S) -> FlattenedT<S>

Returns the flattened representation of the curve as an iterator, starting after the current point.

source

pub fn for_each_monotonic_range<F>(&self, cb: &mut F)
where F: FnMut(Range<S>),

Invokes a callback for each monotonic part of the segment.

source

pub fn for_each_monotonic<F>(&self, cb: &mut F)

Invokes a callback for each monotonic part of the segment.

source

pub fn for_each_y_monotonic_range<F>(&self, cb: &mut F)
where F: FnMut(Range<S>),

Invokes a callback for each y-monotonic part of the segment.

source

pub fn for_each_y_monotonic<F>(&self, cb: &mut F)

Invokes a callback for each y-monotonic part of the segment.

source

pub fn for_each_x_monotonic_range<F>(&self, cb: &mut F)
where F: FnMut(Range<S>),

Invokes a callback for each x-monotonic part of the segment.

source

pub fn for_each_x_monotonic<F>(&self, cb: &mut F)

Invokes a callback for each x-monotonic part of the segment.

source

pub fn bounding_triangle(&self) -> Triangle<S>

Returns a triangle containing this curve segment.

source

pub fn fast_bounding_box(&self) -> Box2D<S>

Returns a conservative rectangle that contains the curve.

source

pub fn fast_bounding_range_x(&self) -> (S, S)

Returns a conservative range of x that contains this curve.

source

pub fn fast_bounding_range_y(&self) -> (S, S)

Returns a conservative range of y that contains this curve.

source

pub fn bounding_box(&self) -> Box2D<S>

Returns the smallest rectangle the curve is contained in

source

pub fn bounding_range_x(&self) -> (S, S)

Returns the smallest range of x that contains this curve.

source

pub fn bounding_range_y(&self) -> (S, S)

Returns the smallest range of y that contains this curve.

source

pub fn is_x_monotonic(&self) -> bool

Returns whether this segment is monotonic on the x axis.

source

pub fn is_y_monotonic(&self) -> bool

Returns whether this segment is monotonic on the y axis.

source

pub fn is_monotonic(&self) -> bool

Returns whether this segment is fully monotonic.

source

pub fn line_intersections_t(&self, line: &Line<S>) -> ArrayVec<S, 2>

Computes the intersections (if any) between this segment a line.

The result is provided in the form of the t parameters of each point along curve. To get the intersection points, sample the curve at the corresponding values.

source

pub fn line_intersections(&self, line: &Line<S>) -> ArrayVec<Point<S>, 2>

Computes the intersection points (if any) between this segment a line.

source

pub fn line_segment_intersections_t( &self, segment: &LineSegment<S>, ) -> ArrayVec<(S, S), 2>

Computes the intersections (if any) between this segment and a line segment.

The result is provided in the form of the t parameters of each point along curve and segment. To get the intersection points, sample the segments at the corresponding values.

source

pub fn from(&self) -> Point<S>

source

pub fn to(&self) -> Point<S>

source

pub fn line_segment_intersections( &self, segment: &LineSegment<S>, ) -> ArrayVec<Point<S>, 2>

Computes the intersection points (if any) between this segment a line segment.

source

pub fn closest_point(&self, pos: Point<S>) -> S

Analytic solution to finding the closest point on the curve to pos.

source

pub fn distance_to_point(&self, pos: Point<S>) -> S

Returns the shortest distance between this segment and a point.

source

pub fn square_distance_to_point(&self, pos: Point<S>) -> S

Returns the shortest squared distance between this segment and a point.

May be useful to avoid the cost of a square root when comparing against a distance that can be squared instead.

source

pub fn drag(&self, t: S, new_position: Point<S>) -> Self

source

pub fn length(&self) -> S

Computes the length of this segment.

Implements Raph Levien’s analytical approach described in https://raphlinus.github.io/curves/2018/12/28/bezier-arclength.html

source

pub fn to_f32(&self) -> QuadraticBezierSegment<f32>

source

pub fn to_f64(&self) -> QuadraticBezierSegment<f64>

Trait Implementations§

source§

impl<S: Clone> Clone for QuadraticBezierSegment<S>

source§

fn clone(&self) -> QuadraticBezierSegment<S>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<S: Debug> Debug for QuadraticBezierSegment<S>

source§

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

Formats the value using the given formatter. Read more
source§

impl<S: PartialEq> PartialEq for QuadraticBezierSegment<S>

source§

fn eq(&self, other: &QuadraticBezierSegment<S>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<S: Scalar> Segment for QuadraticBezierSegment<S>

source§

type Scalar = S

source§

fn from(&self) -> Point<S>

Start of the curve.
source§

fn to(&self) -> Point<S>

End of the curve.
source§

fn sample(&self, t: S) -> Point<S>

Sample the curve at t (expecting t between 0 and 1).
source§

fn x(&self, t: S) -> S

Sample x at t (expecting t between 0 and 1).
source§

fn y(&self, t: S) -> S

Sample y at t (expecting t between 0 and 1).
source§

fn derivative(&self, t: S) -> Vector<S>

Sample the derivative at t (expecting t between 0 and 1).
source§

fn dx(&self, t: S) -> S

Sample x derivative at t (expecting t between 0 and 1).
source§

fn dy(&self, t: S) -> S

Sample y derivative at t (expecting t between 0 and 1).
source§

fn split(&self, t: S) -> (Self, Self)

Split this curve into two sub-curves.
source§

fn before_split(&self, t: S) -> Self

Return the curve before the split point.
source§

fn after_split(&self, t: S) -> Self

Return the curve after the split point.
source§

fn split_range(&self, t_range: Range<S>) -> Self

Return the curve inside a given range of t. Read more
source§

fn flip(&self) -> Self

Swap the direction of the segment.
source§

fn approximate_length(&self, tolerance: S) -> S

Compute the length of the segment using a flattened approximation.
source§

fn for_each_flattened_with_t( &self, tolerance: Self::Scalar, callback: &mut dyn FnMut(&LineSegment<S>, Range<S>), )

Approximates the curve with sequence of line segments. Read more
source§

impl<S: Copy> Copy for QuadraticBezierSegment<S>

source§

impl<S> StructuralPartialEq for QuadraticBezierSegment<S>

Auto Trait Implementations§

§

impl<S> Freeze for QuadraticBezierSegment<S>
where S: Freeze,

§

impl<S> RefUnwindSafe for QuadraticBezierSegment<S>
where S: RefUnwindSafe,

§

impl<S> Send for QuadraticBezierSegment<S>
where S: Send,

§

impl<S> Sync for QuadraticBezierSegment<S>
where S: Sync,

§

impl<S> Unpin for QuadraticBezierSegment<S>
where S: Unpin,

§

impl<S> UnwindSafe for QuadraticBezierSegment<S>
where S: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.