Struct Dash 

pub struct Dash {
    pub pattern: [f32; 4],
    pub offset: f32,
}

A stroke’s dash pattern (backlog V2): a mark, a gap, a second mark and a second gap, repeated along the stroke’s length from its first point.

The lengths are the ones seen, in logical px. Every mark is round-capped, as the stroke itself is, so a mark on long is drawn as a capsule whose centre line is on − width long, and a mark no longer than the stroke is wide is a dot. (SVG’s stroke-dasharray measures the centre line instead, which with a round cap makes 4 4 at a width of 4 a solid line; this pattern at any width is SVG’s on − width, off + width.) The first mark’s cap sits where a solid stroke’s would, half the width before the first point.

The pattern runs along the arc length of the whole stroke, so it keeps its phase across the corners of a polyline and the pieces of a curve; on a path it restarts at every subpath, as SVG’s does.

Fields

pattern: [f32; 4]

Mark, gap, mark, gap. A two-length pattern is the same pair twice.

offset: f32

How far into the pattern the stroke starts, in logical px: growing it moves the marks towards the stroke’s first point, which is what a marquee’s marching ants are. Any number; it wraps.

Implementations

impl Dash

pub const SOLID: Dash

No dashes: the stroke unbroken.

pub fn new(on: f32, off: f32) -> Dash

Marks on long with gaps off long between them.

pub fn of(lengths: &[f32]) -> Option<Dash>

The pattern as the bindings spell it: one length (marks and gaps alike), two (a mark and a gap) or four (a mark, a gap, a second mark, a second gap — a dash-dot). None for any other count.

pub fn offset(self, offset: f32) -> Dash

Self::offset set.

pub fn is_solid(&self) -> bool

Whether the pattern leaves the stroke unbroken: no gap in it, or a length that is not a number.

pub fn cut(&self, width: f32) -> Option<Cut>

The pattern as centre-line lengths for a stroke width wide, or None for one that draws solid: a length that is not finite, or no gap anywhere. Negative lengths are zero, and a pair that is zero altogether is the other pair.

Trait Implementations

impl Clone for Dash

fn clone(&self) -> Dash

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Dash

impl Debug for Dash

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

Formats the value using the given formatter.

impl Default for Dash

fn default() -> Dash

Returns the “default value” for a type.

impl PartialEq for Dash

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Dash