Struct Path 

pub struct Path<P: Clone + Debug + Default + PartialEq> {
    pub id: PathId,
    pub order: DrawOrder,
    pub bounds: Bounds<P>,
    pub content_mask: ContentMask<P>,
    pub vertices: Vec<PathVertex<P>>,
    pub color: Background,
    /* private fields */
}

A filled shape, stored as a triangle mesh.

Use crate::PathBuilder to build a path from lines and curves, and crate::Window::paint_path to paint it. The methods on this type add triangles one at a time, which is lower level than crate::PathBuilder.

Examples

let mut path = Path::new(point(px(0.), px(0.)));
path.line_to(point(px(10.), px(0.)));
path.line_to(point(px(10.), px(10.)));
assert_eq!(path.vertices.len(), 3);

Fields

id: PathId

The index this path had in Scene::paths when it was inserted.

order: DrawOrder

The draw order. Scene::insert_primitive assigns it.

bounds: Bounds<P>

The bounding box of all vertices.

content_mask: ContentMask<P>

The region that clips this path.

vertices: Vec<PathVertex<P>>

The triangle vertices, three per triangle.

color: Background

The fill color or gradient.

Implementations

impl Path<Pixels>

pub fn new(start: Point<Pixels>) -> Self

Creates an empty path whose current point is start. The path has no area until it has a second segment.

pub fn scale(&self, factor: f32) -> Path<ScaledPixels>

Returns a copy of this path with every coordinate multiplied by factor. Use it to convert logical pixels to scaled pixels.

pub fn move_to(&mut self, to: Point<Pixels>)

Moves the current point to to and starts a new contour there. Nothing is drawn.

pub fn line_to(&mut self, to: Point<Pixels>)

Draws a straight line from the current point to to.

The first call after Path::new only moves the current point. Each later call adds a triangle made from the contour’s start point, the current point and to.

pub fn curve_to(&mut self, to: Point<Pixels>, ctrl: Point<Pixels>)

Draws a quadratic curve from the current point to to, bent toward the control point ctrl.

pub fn push_triangle( &mut self, xy: (Point<Pixels>, Point<Pixels>, Point<Pixels>), st: (Point<f32>, Point<f32>, Point<f32>), )

Appends one triangle, with positions and shader coordinates for each corner, and grows Path::bounds to include it.

impl<T> Path<T>

where T: Clone + Debug + Default + PartialEq + PartialOrd + Add<T, Output = T> + Sub<Output = T>,

pub fn clipped_bounds(&self) -> Bounds<T>

Returns Path::bounds intersected with the content mask.

Trait Implementations

impl<P: Clone + Clone + Debug + Default + PartialEq> Clone for Path<P>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug + Clone + Debug + Default + PartialEq> Debug for Path<P>

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

Formats the value using the given formatter.

impl From<Path<ScaledPixels>> for Primitive

fn from(path: Path<ScaledPixels>) -> Self

Converts to this type from the input type.