Struct DashPattern 

pub struct DashPattern {
    pub on: f64,
    pub off: f64,
    pub phase: f64,
}

A stroke’s dash pattern: an on run, an off gap, and a phase offset into that repeating cycle — all lengths in the pre-transform coordinate space.

One on/off pair rather than an arbitrary-length array: it covers the dashed dividers/outlines/focus rings widgets ask for, stays Copy (so PathStyle and every command holding one stay Copy/allocation-free), and the render crate expands it into a [on, off] slice at encode time.

Fields

on: f64

Length of each painted dash.

off: f64

Length of each gap between dashes.

phase: f64

Distance into the on/off cycle the pattern starts at — animate this to march the dashes along the path.

Implementations

impl DashPattern

pub const fn new(on: f64, off: f64) -> DashPattern

An on/off cycle starting at phase 0.

pub const fn with_phase(self, phase: f64) -> DashPattern

The same pattern offset by phase into its cycle.

pub fn is_effective(&self) -> bool

Whether this pattern actually breaks a stroke into dashes.

A non-positive or non-finite length has no dashed interpretation (a zero off is a solid line; a zero on paints nothing, which a caller never means by “dashed”), so frust-render strokes such a path solid rather than feeding a degenerate cycle to the dash iterator. Additionally, a period (on + off) smaller than [DASH_PERIOD_EPSILON] is too dense to efficiently expand at encode time and is visually indistinguishable from a solid stroke anyway, so the pattern falls back to solid.

Trait Implementations

impl Clone for DashPattern

fn clone(&self) -> DashPattern

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DashPattern

impl Debug for DashPattern

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

Formats the value using the given formatter.

impl PartialEq for DashPattern

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DashPattern