Struct PathBuilder 

pub struct PathBuilder { /* private fields */ }

Builder for constructing paths from PDF path operators.

Coordinates are transformed through the CTM before storage.

Implementations

impl PathBuilder

pub fn stroke(&mut self, gs: &GraphicsState) -> PaintedPath

S operator: stroke the current path.

Paints the path outline using the current stroking color and line width. Clears the current path after painting.

pub fn close_and_stroke(&mut self, gs: &GraphicsState) -> PaintedPath

s operator: close the current subpath, then stroke.

Equivalent to h S.

pub fn fill(&mut self, gs: &GraphicsState) -> PaintedPath

f or F operator: fill the current path using the nonzero winding rule.

Any open subpaths are implicitly closed before filling.

pub fn fill_even_odd(&mut self, gs: &GraphicsState) -> PaintedPath

f* operator: fill the current path using the even-odd rule.

pub fn fill_and_stroke(&mut self, gs: &GraphicsState) -> PaintedPath

B operator: fill then stroke the current path (nonzero winding).

pub fn fill_even_odd_and_stroke(&mut self, gs: &GraphicsState) -> PaintedPath

B* operator: fill (even-odd) then stroke the current path.

pub fn close_fill_and_stroke(&mut self, gs: &GraphicsState) -> PaintedPath

b operator: close, fill (nonzero winding), then stroke.

Equivalent to h B.

pub fn close_fill_even_odd_and_stroke( &mut self, gs: &GraphicsState, ) -> PaintedPath

b* operator: close, fill (even-odd), then stroke.

Equivalent to h B*.

pub fn end_path(&mut self) -> Option<PaintedPath>

n operator: end the path without painting.

Discards the current path. Used primarily for clipping paths. Returns None since no painted path is produced.

impl PathBuilder

pub fn new(ctm: Ctm) -> Self

Create a new PathBuilder with the given CTM.

pub fn set_ctm(&mut self, ctm: Ctm)

Update the CTM.

pub fn ctm(&self) -> &Ctm

Get the current CTM.

pub fn move_to(&mut self, x: f64, y: f64)

m operator: move to a new point, starting a new subpath.

pub fn line_to(&mut self, x: f64, y: f64)

l operator: straight line from current point to (x, y).

pub fn curve_to(&mut self, x1: f64, y1: f64, x2: f64, y2: f64, x3: f64, y3: f64)

c operator: cubic Bezier curve with three coordinate pairs.

pub fn curve_to_v(&mut self, x2: f64, y2: f64, x3: f64, y3: f64)

v operator: cubic Bezier where first control point equals current point.

pub fn curve_to_y(&mut self, x1: f64, y1: f64, x3: f64, y3: f64)

y operator: cubic Bezier where last control point equals endpoint.

pub fn close_path(&mut self)

h operator: close the current subpath.

pub fn rectangle(&mut self, x: f64, y: f64, width: f64, height: f64)

re operator: append a rectangle as moveto + 3 lineto + closepath.

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

Get the current point (already CTM-transformed).

pub fn build(self) -> Path

Consume the builder and return the constructed path.

pub fn is_empty(&self) -> bool

Check if the builder has no segments.

pub fn take_and_reset(&mut self) -> Path

Take the accumulated segments as a Path and reset the builder.

After this call, the builder is empty and ready for a new path. The current point and subpath start are also reset.

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 Debug for PathBuilder

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

Formats the value using the given formatter.