Struct PathBuilder 

pub struct PathBuilder { /* private fields */ }

A helper for incrementally constructing a kurbo::BezPath.

This is a thin convenience wrapper around BezPath that records the current subpath state and provides ergonomic builder methods. It is purely advisory — the underlying BezPath can always be extracted with PathBuilder::build.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.line_to(Point::new(10.0, 0.0));
builder.quad_to(Point::new(15.0, 5.0), Point::new(10.0, 10.0));
builder.line_to(Point::new(0.0, 10.0));
builder.close_path();

let path = builder.build();
// move + 2 lines + quad + close = 5 elements.
assert_eq!(path.elements().len(), 5);

Implementations

impl PathBuilder

pub fn new() -> Self

Creates a new, empty path builder.

Examples

use martensite_render::PathBuilder;

let builder = PathBuilder::new();
assert!(builder.elements().is_empty());

pub fn move_to(&mut self, p: Point)

Begins a new subpath at p.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(5.0, 5.0));
assert_eq!(builder.elements().len(), 1);

pub fn line_to(&mut self, p: Point)

Adds a line segment to p.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.line_to(Point::new(10.0, 0.0));
assert_eq!(builder.elements().len(), 2);

pub fn quad_to(&mut self, p1: Point, p2: Point)

Adds a quadratic Bézier segment with control point p1 and end p2.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.quad_to(Point::new(5.0, 5.0), Point::new(10.0, 0.0));
assert_eq!(builder.elements().len(), 2);

pub fn curve_to(&mut self, p1: Point, p2: Point, p3: Point)

Adds a cubic Bézier segment with control points p1, p2 and end p3.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.curve_to(
    Point::new(5.0, 0.0),
    Point::new(10.0, 5.0),
    Point::new(15.0, 0.0),
);
assert_eq!(builder.elements().len(), 2);

pub fn close_path(&mut self)

Closes the current subpath.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.line_to(Point::new(10.0, 0.0));
builder.close_path();
// move + line + close = 3 elements
assert_eq!(builder.elements().len(), 3);

pub fn elements(&self) -> &[PathEl]

Returns a reference to the underlying path elements.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.line_to(Point::new(10.0, 0.0));
let elements = builder.elements();
assert_eq!(elements.len(), 2);

pub fn build(self) -> BezPath

Finalizes the builder and returns the constructed BezPath.

Examples

use martensite_render::PathBuilder;
use kurbo::Point;

let mut builder = PathBuilder::new();
builder.move_to(Point::new(0.0, 0.0));
builder.line_to(Point::new(10.0, 0.0));
builder.close_path();
let path = builder.build();
// move + line + close = 3 elements
assert_eq!(path.elements().len(), 3);

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.

impl Default for PathBuilder

fn default() -> PathBuilder

Returns the “default value” for a type.