Struct piet::StrokeStyle
source · pub struct StrokeStyle {
pub line_join: LineJoin,
pub line_cap: LineCap,
pub dash_pattern: StrokeDash,
pub dash_offset: f64,
}
Expand description
Options for drawing stroked lines.
You may configure particular aspects of the style by using the methods described below.
Defaults
Currently, the style (and its various consituent parts) have Default
impls that conform to the defaults described in the
Postscript Language Manual, 3rd Edition; that document is the
basis for the choice of these types, and can be consulted for detailed
explanations and illustrations.
It is possible that in the future certain of these defaults may change; if you are particular about your style you can create the various types explicitly instead of relying on the default impls.
use piet::{LineJoin, StrokeStyle};
const CONST_STLYE: StrokeStyle = StrokeStyle::new()
.dash_pattern(&[5.0, 1.0, 2.0])
.line_join(LineJoin::Round);
let style = StrokeStyle::new()
.dash_pattern(&[10.0, 5.0, 2.0])
.dash_offset(5.0);
Fields§
§line_join: LineJoin
How to join segments of the path.
By default, this is LineJoin::Miter
with a limit
of 10.0
.
line_cap: LineCap
§dash_pattern: StrokeDash
The sequence of alternating dashes and gaps uses to draw the line.
If the sequence is not empty, all numbers should be finite and non-negative, and the sequence should not be all zeros.
On platforms that do not support an odd number of lengths in the array, the implementation may concatenate two copies of the array to reach an even count.
By default, this is empty (&[]
), indicating a solid line.
dash_offset: f64
The distance into the dash_pattern
at which drawing begins.
By default, this is 0.0
.
Implementations§
source§impl StrokeStyle
impl StrokeStyle
sourcepub const fn new() -> StrokeStyle
pub const fn new() -> StrokeStyle
Create a new StrokeStyle
with the provided pattern.
For no pattern (a solid line) pass &[]
.
This is available in a const
context and does not allocate;
the other methods for setting the dash pattern do allocate, for
annoying reasons.
Example
use piet::{LineJoin, StrokeStyle};
const STYLE: StrokeStyle = StrokeStyle::new()
.dash_pattern(&[4.0, 2.0])
.dash_offset(8.0)
.line_join(LineJoin::Round);
sourcepub const fn line_join(self, line_join: LineJoin) -> Self
pub const fn line_join(self, line_join: LineJoin) -> Self
Builder-style method to set the LineJoin
.
sourcepub const fn line_cap(self, line_cap: LineCap) -> Self
pub const fn line_cap(self, line_cap: LineCap) -> Self
Builder-style method to set the LineCap
.
sourcepub const fn dash_offset(self, offset: f64) -> Self
pub const fn dash_offset(self, offset: f64) -> Self
Builder-style method to set the dash_offset
.
sourcepub const fn dash_pattern(self, lengths: &'static [f64]) -> Self
pub const fn dash_pattern(self, lengths: &'static [f64]) -> Self
Builder-style method to set the dash_pattern
.
This method takes a &'static [f64]
, and does not allocate. If you
do not have a static slice, you may use set_dash_pattern
instead,
which does allocate.
sourcepub fn set_line_join(&mut self, line_join: LineJoin)
pub fn set_line_join(&mut self, line_join: LineJoin)
Set the LineJoin
.
sourcepub fn set_line_cap(&mut self, line_cap: LineCap)
pub fn set_line_cap(&mut self, line_cap: LineCap)
Set the LineCap
.
sourcepub fn set_dash_offset(&mut self, offset: f64)
pub fn set_dash_offset(&mut self, offset: f64)
Set the dash offset.
sourcepub fn set_dash_pattern(&mut self, lengths: impl Into<Rc<[f64]>>)
pub fn set_dash_pattern(&mut self, lengths: impl Into<Rc<[f64]>>)
Set the dash pattern.
This method always allocates. To construct without allocating, use the
dash_pattern
builder method.
sourcepub fn miter_limit(&self) -> Option<f64>
pub fn miter_limit(&self) -> Option<f64>
If the current LineJoin
is LineJoin::Miter
return the miter limit.
Trait Implementations§
source§impl Clone for StrokeStyle
impl Clone for StrokeStyle
source§fn clone(&self) -> StrokeStyle
fn clone(&self) -> StrokeStyle
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for StrokeStyle
impl Debug for StrokeStyle
source§impl Default for StrokeStyle
impl Default for StrokeStyle
source§fn default() -> StrokeStyle
fn default() -> StrokeStyle
source§impl PartialEq<StrokeStyle> for StrokeStyle
impl PartialEq<StrokeStyle> for StrokeStyle
source§fn eq(&self, other: &StrokeStyle) -> bool
fn eq(&self, other: &StrokeStyle) -> bool
self
and other
values to be equal, and is used
by ==
.