Enum 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

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

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PathSeg

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl From<CubicBez> for PathSeg

fn from(cubic_bez: CubicBez) -> PathSeg

Performs the conversion.

impl From<Line> for PathSeg

fn from(line: Line) -> PathSeg

Performs the conversion.

impl From<QuadBez> for PathSeg

fn from(quad_bez: QuadBez) -> PathSeg

Performs the conversion.

impl Mul<PathSeg> for Affine

type Output = PathSeg

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<PathSeg> for TranslateScale

type Output = PathSeg

The resulting type after applying the * operator.

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

Performs the * operation.

impl ParamCurve for PathSeg

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

Evaluate the curve at parameter t.

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

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

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

Subdivide into (roughly) halves.

fn start(&self) -> Point

The start point.

fn end(&self) -> Point

The end point.

impl ParamCurveArclen for PathSeg

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

The arc length of the curve.

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

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

impl ParamCurveArea for PathSeg

fn signed_area(&self) -> f64

Compute the signed area under the curve.

impl ParamCurveExtrema for PathSeg

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 ParamCurveNearest for PathSeg

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

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

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

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

This method tests for !=.

impl Serialize for PathSeg

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl Shape for PathSeg

type PathElementsIter = PathSegIter

The iterator returned by the path_elements method.

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

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

fn area(&self) -> f64

The area under the curve.

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

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

Total length of perimeter.

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

The winding number of a point.

fn bounding_box(&self) -> Rect

The smallest rectangle that encloses the shape.

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

If the shape is a line, make it available.

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

Convert to a Bézier path.

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

Convert into a Bézier path.

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

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

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

Returns true if the Point is inside this shape.

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

If the shape is a rectangle, make it available.

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

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

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

If the shape is a circle, make it available.

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