Struct Path 

pub struct Path { /* private fields */ }

A 2D geometric path.

Implementations

impl Path

pub fn new() -> Self

Create a new empty path.

pub const fn fill_type(&self) -> FillType

Get the fill type.

pub const fn set_fill_type(&mut self, fill_type: FillType)

Set the fill type.

pub fn is_empty(&self) -> bool

Check if the path is empty.

pub fn verb_count(&self) -> usize

Get the number of verbs.

pub fn point_count(&self) -> usize

Get the number of points.

pub fn bounds(&self) -> Rect

Get the bounds of the path.

pub fn reset(&mut self)

Clear the path.

pub const fn iter(&self) -> PathIter<'_>

Iterate over the path elements.

pub fn verbs(&self) -> &[Verb]

Get the verbs slice.

pub fn points(&self) -> &[Point]

Get the points slice.

pub fn last_point(&self) -> Option<Point>

Get the last point in the path.

pub fn contour_count(&self) -> usize

Get the number of contours in the path.

pub fn is_closed(&self) -> bool

Check if the path is closed.

pub fn is_line(&self) -> bool

Check if the path represents a line.

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

Check if the path represents a rectangle.

Ported from SkPathPriv::IsRectContour (single contour, allowPartial = false) with the trivial_rect fast-path: accepts the crate’s own add_rect output (Move + 3 Lines + Close) and rejects non-rectangular horizontal/vertical staircases by counting direction changes and validating closure.

pub fn is_oval(&self) -> bool

Returns true if this path is a simple oval (ellipse).

Verifies both verb structure (Move, 4 curves, Close) AND that the curve endpoints lie on the cardinal points of the bounding ellipse (left, right, top, bottom). This rejects 4-cubic paths that share the verb pattern but have arbitrary geometry.

pub fn convexity(&self) -> PathConvexity

Get the convexity of the path.

Ported from SkPathPriv::ComputeConvexity: per-contour and verb-aware. Any second contour is Concave; convexity along a single contour is determined by cross-product direction changes (including the closing edges) via the Convexicator, with no fixed magnitude threshold.

pub fn is_convex(&self) -> bool

Check if the path is convex.

pub fn direction(&self) -> Option<PathDirection>

Get the first direction of the path.

Ported from SkPathPriv::ComputeFirstDirection: loops over all contours and keeps the cross product of the contour that contains the global y-max (bottom-most point in y-down device space); cross > 0 => CW.

pub fn reverse(&mut self)

Reverse the path direction.

Ported from SkPathPriv::ReverseAddPath: walks contours back-to-front, emitting Move first, points in reverse order with per-verb point-count handling, and preserving one Close per originally-closed contour.

pub fn transform(&mut self, matrix: &Matrix)

Transform the path by a matrix.

pub fn transformed(&self, matrix: &Matrix) -> Self

Create a transformed copy of the path.

pub fn offset(&mut self, dx: Scalar, dy: Scalar)

Offset the path by (dx, dy).

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

Check if a point is inside the path (using the fill rule).

Ported from SkPathPriv::Contains: accumulates signed winding (+1/-1 per crossing direction) via winding_line on each edge, treats every contour as implicitly closed for hit-testing (like SkPathEdgeIter), uses inclusive bounds for the early-out, and XORs the result with the inverse-fill flag.

pub fn tight_bounds(&self) -> Rect

Returns the tight bounding rectangle of this path.

Unlike bounds(), this computes the bounds from the actual curve extents, not the control-point bounding box. For cubic and quadratic Bezier curves with control points outside the actual curve range, tight_bounds() may be significantly smaller than bounds().

Conics fall back to control-polygon bounds (exact extrema for rational curves would require solving a quartic).

pub fn length(&self) -> Scalar

Get the total length of the path.

Trait Implementations

impl Clone for Path

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Path

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

Formats the value using the given formatter.

impl Default for Path

fn default() -> Self

Returns the “default value” for a type.

impl<'a> IntoIterator for &'a Path

type Item = PathElement

The type of the elements being iterated over.

type IntoIter = PathIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> PathIter<'a>

Creates an iterator from a value.

impl PartialEq for Path

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

Equality operator ==.

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

Inequality operator !=.