Enum BlendMode 

pub enum BlendMode {
    Normal,
    Multiply,
    Add,
    Screen,
    Subtract,
    Min,
    Max,
    Erase,
    Overlay,
    HardLight,
    SoftLight,
    PinLight,
    HardMix,
    VividLight,
    LinearLight,
    ColorBurn,
    ColorDodge,
    LinearBurn,
    LinearDodge,
    Darken,
    Lighten,
    Difference,
    Exclusion,
    Negation,
    Divide,
    Saturation,
    Color,
    Luminosity,
}

Blend mode for compositing a renderable onto its target.

Mirrors the PixiJS v8 catalog. See the module docs for the standard-vs-advanced distinction.

Variants

Normal

Source-over alpha blending. src.a * src + (1 - src.a) * dst.

Multiply

dst * src + (1 - src.a) * dst — darkens.

Add

src + (1 - src.a) * dst — additive.

Screen

1 - (1 - src) * (1 - dst) — softer additive.

Subtract

dst - src clamped to [0, 1].

Min

min(src, dst) per channel.

Max

max(src, dst) per channel.

Erase

dst * (1 - src.a) — erases dst proportional to src alpha.

Overlay

(base < 0.5) ? 2·base·blend : 1 - 2·(1-base)·(1-blend).

HardLight

Overlay with the roles swapped — (blend < 0.5) ? ….

SoftLight

Photoshop’s W3C-defined soft-light formula.

PinLight

Pixel-wise pin: (blend < 0.5) ? min(base, 2·blend) : max(base, 2·blend - 1).

HardMix

VividLight thresholded to {0, 1} per channel.

VividLight

(blend < 0.5) ? color-burn(base, 2·blend) : color-dodge(base, 2·(blend - 0.5)).

LinearLight

base + 2·blend - 1 clamped.

ColorBurn

(blend == 0) ? 0 : 1 - min(1, (1-base) / blend).

ColorDodge

(blend == 1) ? 1 : min(1, base / (1-blend)).

LinearBurn

base + blend - 1 clamped.

LinearDodge

base + blend clamped (a.k.a. linear-dodge / additive).

Darken

min(base, blend).

Lighten

max(base, blend).

Difference

abs(base - blend).

Exclusion

base + blend - 2·base·blend.

Negation

1 - abs(1 - base - blend).

Divide

base / blend. Not GPU-native (needs read-modify-write on dst).

Saturation

HSL: keep saturation of foreground, hue+lum of backdrop.

Color

HSL: keep hue+saturation of foreground, lum of backdrop.

Luminosity

HSL: keep lum of foreground, hue+saturation of backdrop.

Implementations

impl BlendMode

pub const fn is_advanced(self) -> bool

Whether this mode requires the offscreen filter path (Tier C). Modes that don’t require it return Some(BlendState) from Self::native_blend_state.

pub const fn native_blend_state(self) -> Option<BlendState>

The wgpu blend state for this mode, if it can be expressed as a single GPU blend equation. Returns None for advanced modes.

pub const fn css_name(self) -> &'static str

CSS-style kebab-case identifier — matches PixiJS v8’s Container.blendMode string values.

pub fn all() -> impl ExactSizeIterator<Item = BlendMode> + DoubleEndedIterator

Iterate every variant. Useful for table-driven tests + the blend-modes storybook gallery.

Trait Implementations

impl Clone for BlendMode

fn clone(&self) -> BlendMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlendMode

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

Formats the value using the given formatter.

impl Default for BlendMode

fn default() -> BlendMode

Returns the “default value” for a type.

impl Hash for BlendMode

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 PartialEq for BlendMode

fn eq(&self, other: &BlendMode) -> 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 Copy for BlendMode

impl Eq for BlendMode

impl StructuralPartialEq for BlendMode