Enum piet_common::kurbo::PathSeg

pub enum PathSeg {
    Line(Line),
    Quad(QuadBez),
    Cubic(CubicBez),
}

A segment of a Bézier path.

Variants

Line(Line)

A line segment.

Quad(QuadBez)

A quadratic bezier segment.

Cubic(CubicBez)

A cubic bezier segment.

Implementations

impl PathSeg

pub fn reverse(&self) -> PathSeg

Returns a new PathSeg describing the same path as self, but with the points reversed.

pub fn to_cubic(&self) -> CubicBez

Convert this segment to a cubic bezier.

pub fn intersect_line(&self, line: Line) -> ArrayVec<[LineIntersection; 3]>

Compute intersections against a line.

Returns a vector of the intersections. For each intersection, the t value of the segment and line are given.

Note: This test is designed to be inclusive of points near the endpoints of the segment. This is so that testing a line against multiple contiguous segments of a path will be guaranteed to catch at least one of them. In such cases, use higher level logic to coalesce the hits (the t value may be slightly outside the range of 0..1).

Examples

let seg = PathSeg::Line(Line::new((0.0, 0.0), (2.0, 0.0)));
let line = Line::new((1.0, 2.0), (1.0, -2.0));
let intersection = seg.intersect_line(line);
assert_eq!(intersection.len(), 1);
let intersection = intersection[0];
assert_eq!(intersection.segment_t, 0.5);
assert_eq!(intersection.line_t, 0.5);

let point = seg.eval(intersection.segment_t);
assert_eq!(point, Point::new(1.0, 0.0));

pub fn is_finite(&self) -> bool

Is this Bezier path finite?

pub fn is_nan(&self) -> bool

Is this Bezier path NaN?

Trait Implementations

impl Clone for PathSeg

pub fn clone(&self) -> PathSeg

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for PathSeg

impl Debug for PathSeg

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

Formats the value using the given formatter.

impl From<CubicBez> for PathSeg

pub fn from(cubic_bez: CubicBez) -> PathSeg

Performs the conversion.

impl From<Line> for PathSeg

pub fn from(line: Line) -> PathSeg

Performs the conversion.

impl From<QuadBez> for PathSeg

pub fn from(quad_bez: QuadBez) -> PathSeg

Performs the conversion.

impl Mul<PathSeg> for TranslateScale

type Output = PathSeg

The resulting type after applying the * operator.

pub fn mul(self, other: PathSeg) -> PathSeg

Performs the * operation.

impl Mul<PathSeg> for Affine

type Output = PathSeg

The resulting type after applying the * operator.

pub fn mul(self, other: PathSeg) -> PathSeg

Performs the * operation.

impl ParamCurve for PathSeg

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

Evaluate the curve at parameter t.

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

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

pub fn subdivide(&self) -> (Self, Self)

Subdivide into (roughly) halves.

pub fn start(&self) -> Point

The start point.

pub fn end(&self) -> Point

The end point.

impl ParamCurveArclen for PathSeg

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

The arc length of the curve.

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

Solve for the parameter that has the given arc length from the start.

impl ParamCurveArea for PathSeg

pub fn signed_area(&self) -> f64

Compute the signed area under the curve.

impl ParamCurveExtrema for PathSeg

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

Compute the extrema of the curve.

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

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

pub fn bounding_box(&self) -> Rect

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

impl ParamCurveNearest for PathSeg

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

Find the position on the curve that is nearest to the given point.

impl PartialEq<PathSeg> for PathSeg

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Shape for PathSeg

type PathElementsIter = PathSegIter

The iterator returned by the path_elements method.

pub fn path_elements(&self, _tolerance: f64) -> PathSegIter

Returns an iterator over this shape expressed as PathEls; that is, as Bézier path elements.

pub fn area(&self) -> f64

The area under the curve.

We could just return 0, but this seems more useful.

pub fn perimeter(&self, accuracy: f64) -> f64

Total length of perimeter.

pub fn winding(&self, _pt: Point) -> i32

The winding number of a point.

pub fn bounding_box(&self) -> Rect

The smallest rectangle that encloses the shape.

pub fn as_line(&self) -> Option<Line>

If the shape is a line, make it available.

pub fn to_path(&self, tolerance: f64) -> BezPath

Convert to a Bézier path.

pub fn into_path(self, tolerance: f64) -> BezPath

Convert into a Bézier path.

pub fn path_segments(&self, tolerance: f64) -> Segments<Self::PathElementsIter>

Returns an iterator over this shape expressed as Bézier path segments (PathSegs).

pub fn contains(&self, pt: Point) -> bool

Returns true if the Point is inside this shape.

pub fn as_rect(&self) -> Option<Rect>

If the shape is a rectangle, make it available.

pub fn as_rounded_rect(&self) -> Option<RoundedRect>

If the shape is a rounded rectangle, make it available.

pub fn as_circle(&self) -> Option<Circle>

If the shape is a circle, make it available.

pub fn as_path_slice(&self) -> Option<&[PathEl]>

If the shape is stored as a slice of path elements, make that available.

impl StructuralPartialEq for PathSeg