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 as_path_el(&self) -> PathEl

Get the PathEl that is equivalent to discarding the segment start point.

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?

pub fn min_dist(&self, other: PathSeg, accuracy: f64) -> MinDistance

Minimum distance between two PathSegs.

Returns a tuple of the distance, the path time t1 of the closest point on the first PathSeg, and the path time t2 of the closest point on the second PathSeg.

Trait Implementations

impl Clone for PathSeg

fn clone(&self) -> PathSeg

Returns a copy of the value.

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

Performs copy-assignment from source.

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

Converts to this type from the input type.

impl From<Line> for PathSeg

fn from(line: Line) -> PathSeg

Converts to this type from the input type.

impl From<QuadBez> for PathSeg

fn from(quad_bez: QuadBez) -> PathSeg

Converts to this type from the input type.

impl JsonSchema for PathSeg

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

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 arc length 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, MAX_EXTREMA>

Compute the extrema of the curve.

fn extrema_ranges(&self) -> ArrayVec<Range<f64>, { _ }>

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 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: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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

fn area(&self) -> f64

The area under the curve.

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

type PathElementsIter<'iter> = 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 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 Copy for PathSeg

impl StructuralPartialEq for PathSeg