Struct PathBuilder 

pub struct PathBuilder { /* private fields */ }

PathBuilder records commands used to create an immutable Path.

Implementations

impl PathBuilder

pub fn new() -> Self

new creates an empty path builder.

pub fn move_to(&mut self, p: impl Into<Point>) -> &mut Self

move_to starts a new contour at p.

pub fn line_to(&mut self, p: impl Into<Point>) -> &mut Self

line_to adds a straight segment to p.

pub fn quad_to(&mut self, c: impl Into<Point>, p: impl Into<Point>) -> &mut Self

quad_to adds a quadratic Bézier through control point c to p.

pub fn cubic_to( &mut self, c1: impl Into<Point>, c2: impl Into<Point>, p: impl Into<Point>, ) -> &mut Self

cubic_to adds a cubic Bézier through two control points to p.

pub fn close(&mut self) -> &mut Self

close adds a segment back to the current contour’s starting point.

It has no effect when no contour is open.

pub fn rect(&mut self, r: Rect) -> &mut Self

rect adds a closed rectangular contour.

pub fn rrect(&mut self, r: Rect, radius: f32) -> &mut Self

rrect adds a closed rounded rectangle with one corner radius.

pub fn rrect_radii(&mut self, r: Rect, radii: [f32; 4]) -> &mut Self

rrect_radii adds a rounded rectangle with circular corner radii.

radii is ordered clockwise from the top-left.

pub fn rrect_radii_elliptical( &mut self, r: impl Into<Rect>, radii: [[f32; 2]; 4], ) -> &mut Self

rrect_radii_elliptical adds per-corner elliptical radii.

Each corner is [x_radius, y_radius], starting at the top-left. Radii are proportionally reduced when adjacent corners would overlap.

pub fn rrect_radii_elliptical_wound( &mut self, r: impl Into<Rect>, radii: [[f32; 2]; 4], winding: Winding, ) -> &mut Self

rrect_radii_elliptical_wound adds a rounded rectangle with explicit winding.

Opposing contours cancel under FillRule::NonZero, and dashing follows this traversal order.

pub fn arc( &mut self, center: impl Into<Point>, radius: f32, start_angle: f32, sweep_angle: f32, ) -> &mut Self

arc adds a circular arc.

Angles are radians clockwise from +x in Valo’s y-down coordinates. Sweeps are limited to one full turn.

pub fn ellipse( &mut self, center: impl Into<Point>, radii: [f32; 2], x_axis_rotation: f32, start_angle: f32, sweep_angle: f32, ) -> &mut Self

ellipse adds an elliptical arc.

radii are the x and y half-extents, x_axis_rotation turns the ellipse, and angles are radians clockwise from +x. An active contour is connected to the arc’s first point. Sweeps are limited to one full turn.

Non-finite input is ignored. Negative radii trigger a debug assertion and are ignored in release builds.

pub fn arc_to( &mut self, corner: impl Into<Point>, next: impl Into<Point>, radius: f32, ) -> &mut Self

arc_to rounds the corner between the current point, corner, and next.

Zero or negative radius, coincident points, and straight-through corners fall back to a line ending at corner.

pub fn circle(&mut self, center: impl Into<Point>, radius: f32) -> &mut Self

circle adds a closed circular contour.

pub fn append(&mut self, path: &Path, transform: &Matrix) -> &mut Self

append adds a transformed copy of another path.

The appended path’s final contour becomes the current contour for subsequent commands.

pub fn build(self) -> Arc<Path>

build consumes the builder and returns a shared immutable path.

Trait Implementations

impl Clone for PathBuilder

fn clone(&self) -> PathBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for PathBuilder

fn default() -> PathBuilder

Returns the “default value” for a type.