Struct Stroke

pub struct Stroke { /* private fields */ }

Available on crate feature v4_14 only.

Collects the parameters that influence the operation of stroking a path.

GLib type: Boxed type with copy-on-clone semantics.

Implementations

impl Stroke

pub fn as_ptr(&self) -> *mut GskStroke

Return the inner pointer to the underlying C value.

pub unsafe fn from_glib_ptr_borrow(ptr: &*mut GskStroke) -> &Self

Borrows the underlying C value.

pub unsafe fn from_glib_ptr_borrow_mut(ptr: &mut *mut GskStroke) -> &mut Self

Borrows the underlying C value mutably.

impl Stroke

pub fn new(line_width: f32) -> Stroke

Creates a new Stroke with the given @line_width.

line_width

line width of the stroke. Must be > 0

Returns

a new Stroke

pub fn dash(&self) -> Vec<f32>

Gets the dash array in use.

Returns

the dash array or NULL if the dash array is empty

pub fn dash_offset(&self) -> f32

Gets the dash offset.

Returns

the dash offset

pub fn line_cap(&self) -> LineCap

Gets the line cap used.

See LineCap for details.

Returns

the line cap

pub fn line_join(&self) -> LineJoin

Gets the line join used.

See LineJoin for details.

Returns

the line join

pub fn line_width(&self) -> f32

Gets the line width used.

Returns

the line width

pub fn miter_limit(&self) -> f32

Gets the miter limit.

Returns

the miter limit

pub fn set_dash(&self, dash: &[f32])

Sets the dash pattern to use.

A dash pattern is specified by an array of alternating non-negative values. Each value provides the length of alternate “on” and “off” portions of the stroke.

Each “on” segment will have caps applied as if the segment were a separate contour. In particular, it is valid to use an “on” length of 0 with [enum@Gsk.LineCap.round] or [enum@Gsk.LineCap.square] to draw dots or squares along a path.

If @n_dash is 0, if all elements in @dash are 0, or if there are negative values in @dash, then dashing is disabled.

If @n_dash is 1, an alternating “on” and “off” pattern with the single dash length provided is assumed.

If @n_dash is uneven, the dash array will be used with the first element in @dash defining an “on” or “off” in alternating passes through the array.

You can specify a starting offset into the dash with set_dash_offset().

dash

the array of dashes

pub fn set_dash_offset(&self, offset: f32)

Sets the offset into the dash pattern where dashing should begin.

This is an offset into the length of the path, not an index into the array values of the dash array.

See set_dash() for more details on dashing.

offset

offset into the dash pattern

pub fn set_line_cap(&self, line_cap: LineCap)

Sets the line cap to be used when stroking.

See LineCap for details.

line_cap

the line cap

pub fn set_line_join(&self, line_join: LineJoin)

Sets the line join to be used when stroking.

See LineJoin for details.

line_join

the line join to use

pub fn set_line_width(&self, line_width: f32)

Sets the line width to be used when stroking.

The line width must be > 0.

line_width

width of the line in pixels

pub fn set_miter_limit(&self, limit: f32)

Sets the miter limit to be used when stroking.

The miter limit is the distance from the corner where sharp turns of joins get cut off.

The limit is specfied in units of line width and must be non-negative.

For joins of type [enum@Gsk.LineJoin.miter] that exceed the miter limit, the join gets rendered as if it was of type [enum@Gsk.LineJoin.bevel].

limit

the miter limit

pub fn to_cairo(&self, cr: &Context)

A helper function that sets the stroke parameters of a cairo context from a Stroke.

cr

the cairo context to configure

impl Stroke

pub fn builder(line_width: f32) -> StrokeBuilder

Creates a new builder-pattern struct instance to construct a Stroke.

This method returns an instance of StrokeBuilder which can be used to create a Stroke.

Trait Implementations

impl Clone for Stroke

fn clone(&self) -> Self

Copies the boxed type with the type-specific copy function.

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

Performs copy-assignment from source.

impl Debug for Stroke

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

Formats the value using the given formatter.

impl From<Stroke> for Value

fn from(o: Stroke) -> Self

Converts to this type from the input type.

impl HasParamSpec for Stroke

type ParamSpec = ParamSpecBoxed

type SetValue = Stroke

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecBoxedBuilder<'_, Stroke>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for Stroke

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Stroke

fn cmp(&self, other: &Stroke) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Stroke

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Stroke

fn partial_cmp(&self, other: &Stroke) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Stroke

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Stroke