Enum PathGradient 

pub enum PathGradient {
    Linear {
        to_color: Color,
        from: Point,
        to: Point,
    },
    Radial {
        to_color: Color,
        center: Point,
        radii: Size,
        inner: f32,
    },
    Ramp(Arc<GradientRamp>),
}

What a layer does at compositing, for painting a scene by hand. How a path’s fill fades: along a line, or outwards from a centre.

The geometry is in the same space as the path, deliberately, so a fade can be aimed at something real — the edge a glow springs from, the ellipse whose cap is the glow — rather than at whatever bounding box the geometry happens to have.

Variants

Linear

The fill colour at from, to_color at to, clamped outside that span.

Fields

to_color: Color

The colour at to. The colour at from is the primitive’s fill.

from: Point

Where the fill colour holds.

to: Point

Where to_color holds.

Radial

The fill colour on the ellipse of radii inner × radii about center, to_color on the ellipse of radii radii, clamped outside.

A curved edge needs this. A linear fade can only reach zero along a line, so a shape whose boundary curves away from that line stops while the fade is unfinished, and the leftover shows as an edge — which is the very thing a glow must not have (milestone 302).

Fields

to_color: Color

The colour on the outer ellipse.

center: Point

The centre of both ellipses.

radii: Size

The outer ellipse’s radii, where to_color holds.

inner: f32

Where the fade starts, as a fraction of radii. 0 fades from the centre outwards; a value near 1 confines it to a thin rind.

Ramp(Arc<GradientRamp>)

Any number of colour stops, along a line or between two circles, in a space of its own — what vector artwork’s gradients are. The primitive’s fill colour multiplies it: white leaves it as it is, and a faded white fades it.

Implementations

impl PathGradient

pub fn scaled_xy(self, sx: f32, sy: f32) -> PathGradient

Scales the geometry per axis, as a DPI or paint scale does.

pub fn translated(self, dx: f32, dy: f32) -> PathGradient

Moves the geometry with the shape it describes.

pub fn to_color(self) -> Color

The colour the fade ends on.

pub fn faded(self, opacity: f32) -> PathGradient

Fades the end colour with the fill it belongs to.

Trait Implementations

impl Clone for PathGradient

fn clone(&self) -> PathGradient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathGradient

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

Formats the value using the given formatter.

impl PartialEq for PathGradient

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PathGradient