Package icyllis.arc3d.core

Enum Class BlendMode

java.lang.Object

java.lang.Enum<BlendMode>

icyllis.arc3d.core.BlendMode

All Implemented Interfaces:

Blender, RefCounted, Serializable, Comparable<BlendMode>, Constable

public enum BlendMode
extends Enum<BlendMode>
implements Blender

Blend modes, all the blend equations apply to premultiplied colors. Source color refers to blend color or paint color, destination color refers to base color or canvas color (the color of the current render target).

Non-clamped blend modes ≤ MODULATE, plus SCREEN are Porter-Duff blend modes. They can be directly implemented by GPU hardware. The others are advanced blend equations, which need to be implemented in fragment shaders, or require an extension.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
CLEAR	Destination pixels covered by the source are cleared to 0.
COLOR	Replaces hue and saturation of destination with hue and saturation of source, leaving luminosity unchanged.
COLOR_BURN	Makes destination darker to reflect source.
COLOR_DODGE	Makes destination brighter to reflect source.
DARKEN	Retains the smallest component of the source and destination pixels.
DARKER_COLOR	Similar to DARKEN, but darkens on the composite channel, instead of separate RGB color channels.
DIFFERENCE	Subtracts darker from lighter with higher contrast.
DIVIDE	Divides the destination pixels by the source pixels and saturates the result.
DST	The source pixels are discarded, leaving the destination intact.
DST_ATOP	Discards the destination pixels that are not covered by source pixels.
DST_IN	Keeps the destination pixels that cover source pixels, discards the remaining source and destination pixels.
DST_OUT	Keeps the destination pixels that are not covered by source pixels.
DST_OVER	The source pixels are drawn behind the destination pixels.
EXCLUSION	Subtracts darker from lighter with lower contrast.
HARD_LIGHT	Makes destination lighter or darker, depending on source.
HARD_MIX	Adds two images together, setting each color channel value to either 0 or 1.
HUE	Replaces hue of destination with hue of source, leaving saturation and luminosity unchanged.
LIGHTEN	Retains the largest component of the source and destination pixel.
LIGHTER_COLOR	Similar to LIGHTEN, but lightens on the composite channel, instead of separate RGB color channels.
LINEAR_BURN	Darkens the destination pixels to reflect the source pixels while also increasing contrast.
LINEAR_DODGE	Lightens the destination pixels to reflect the source pixels while also increasing contrast.
LINEAR_LIGHT	Burns or dodges colors by changing brightness, depending on the blend color.
LUMINOSITY	Replaces luminosity of destination with luminosity of source, leaving hue and saturation unchanged.
MINUS	Subtracts the source pixels from the destination pixels, without alpha blending.
MINUS_CLAMPED	Subtracts the source pixels from the destination pixels and saturates the result, without alpha blending.
MODULATE	Multiplies the source and destination pixels, without alpha blending.
MULTIPLY	Multiplies the source and destination pixels.
OVERLAY	Multiplies or screens the source and destination depending on the destination color.
PIN_LIGHT	Conditionally replaces destination pixels with source pixels depending on the brightness of the source pixels.
PLUS	Adds the source pixels to the destination pixels, without alpha blending.
PLUS_CLAMPED	Adds the source pixels to the destination pixels and saturates the result, without alpha blending.
SATURATION	Replaces saturation of destination saturation hue of source, leaving hue and luminosity unchanged.
SCREEN	Adds the source and destination pixels, then subtracts the source pixels multiplied by the destination.
SOFT_LIGHT	Makes destination lighter or darker, depending on source.
SRC	The source pixels replace the destination pixels.
SRC_ATOP	Discards the source pixels that do not cover destination pixels.
SRC_IN	Keeps the source pixels that cover the destination pixels, discards the remaining source and destination pixels.
SRC_OUT	Keeps the source pixels that do not cover destination pixels.
SRC_OVER	The source pixels are drawn over the destination pixels.
SUBTRACT	Subtracts the source pixels from the destination pixels and saturates the result, with alpha blending.
VIVID_LIGHT	Burns or dodges colors by changing contrast, depending on the blend color.
XOR	Discards the source and destination pixels where source pixels cover destination pixels.

Field Summary

Fields

Modifier and Type	Field	Description
static final BlendMode	ADD	Name alias of LINEAR_DODGE.
static final int	COUNT	Number of blend modes, runtime constant.

Method Summary

Modifier and Type	Method	Description
final void	apply(float[] src, float[] dst, float[] out)	Applies this blend mode with RGBA colors.
BlendMode	asBlendMode()	Returns the blender's BlendMode in 'mode' if this Blender represents any BlendMode.
static void	blend_color(float[] src, float[] dst, float[] out)	Replaces hue and saturation of destination with hue and saturation of source, leaving luminosity unchanged.
static void	blend_color_burn(float[] src, float[] dst, float[] out)	Makes destination darker to reflect source.
static void	blend_color_dodge(float[] src, float[] dst, float[] out)	Makes destination brighter to reflect source.
static void	blend_darken(float[] src, float[] dst, float[] out)	Retains the smallest component of the source and destination pixels.
static void	blend_darker_color(float[] src, float[] dst, float[] out)	Similar to DARKEN, but darkens on the composite channel, instead of separate RGB color channels.
static void	blend_difference(float[] src, float[] dst, float[] out)	Subtracts darker from lighter with higher contrast.
static void	blend_divide(float[] src, float[] dst, float[] out)	Divides the destination pixels by the source pixels and saturates the result.
static void	blend_dst_atop(float[] src, float[] dst, float[] out)
static void	blend_dst_in(float[] src, float[] dst, float[] out)
static void	blend_dst_out(float[] src, float[] dst, float[] out)
static void	blend_dst_over(float[] src, float[] dst, float[] out)
static void	blend_exclusion(float[] src, float[] dst, float[] out)	Subtracts darker from lighter with lower contrast.
static void	blend_hard_light(float[] src, float[] dst, float[] out)	Makes destination lighter or darker, depending on source.
static void	blend_hard_mix(float[] src, float[] dst, float[] out)	Adds two images together, setting each color channel value to either 0 or 1.
static void	blend_hue(float[] src, float[] dst, float[] out)	Replaces hue of destination with hue of source, leaving saturation and luminosity unchanged.
static void	blend_lighten(float[] src, float[] dst, float[] out)	Retains the largest component of the source and destination pixel.
static void	blend_lighter_color(float[] src, float[] dst, float[] out)	Similar to LIGHTEN, but lightens on the composite channel, instead of separate RGB color channels.
static void	blend_linear_burn(float[] src, float[] dst, float[] out)	Darkens the destination pixels to reflect the source pixels while also increasing contrast.
static void	blend_linear_dodge(float[] src, float[] dst, float[] out)	Lightens the destination pixels to reflect the source pixels while also increasing contrast.
static void	blend_linear_light(float[] src, float[] dst, float[] out)	Burns or dodges colors by changing brightness, depending on the blend color.
static void	blend_luminosity(float[] src, float[] dst, float[] out)	Replaces luminosity of destination with luminosity of source, leaving hue and saturation unchanged.
static void	blend_minus(float[] src, float[] dst, float[] out)	Subtracts the source pixels from the destination pixels, without alpha blending.
static void	blend_minus_clamped(float[] src, float[] dst, float[] out)	Subtracts the source pixels from the destination pixels and saturates the result, without alpha blending.
static void	blend_modulate(float[] src, float[] dst, float[] out)	Multiplies the source and destination pixels, without alpha blending.
static void	blend_multiply(float[] src, float[] dst, float[] out)	Multiplies the source and destination pixels.
static void	blend_overlay(float[] src, float[] dst, float[] out)	Multiplies or screens the source and destination depending on the destination color.
static void	blend_pin_light(float[] src, float[] dst, float[] out)	Conditionally replaces destination pixels with source pixels depending on the brightness of the source pixels.
static void	blend_plus(float[] src, float[] dst, float[] out)	Adds the source pixels to the destination pixels, without alpha blending.
static void	blend_plus_clamped(float[] src, float[] dst, float[] out)	Adds the source pixels to the destination pixels and saturates the result, without alpha blending.
static void	blend_saturation(float[] src, float[] dst, float[] out)	Replaces saturation of destination saturation hue of source, leaving hue and luminosity unchanged.
static void	blend_screen(float[] src, float[] dst, float[] out)	Adds the source and destination pixels, then subtracts the source pixels multiplied by the destination.
static void	blend_soft_light(float[] src, float[] dst, float[] out)	Makes destination lighter or darker, depending on source.
static void	blend_src_atop(float[] src, float[] dst, float[] out)
static void	blend_src_in(float[] src, float[] dst, float[] out)
static void	blend_src_out(float[] src, float[] dst, float[] out)
static void	blend_src_over(float[] src, float[] dst, float[] out)
static void	blend_subtract(float[] src, float[] dst, float[] out)	Subtracts the source pixels from the destination pixels and saturates the result, with alpha blending.
static void	blend_vivid_light(float[] src, float[] dst, float[] out)	Burns or dodges colors by changing contrast, depending on the blend color.
static void	blend_xor(float[] src, float[] dst, float[] out)
String	getBlendFuncName()	Returns the name of blend function.
boolean	isAdvanced()	25 blend modes after MULTIPLY are advanced.
static BlendMode	modeAt(int index)	Returns the value at the given index.
void	ref()	Increases the reference count by 1.
void	unref()	Decreases the reference count by 1.
static BlendMode	valueOf(String name)	Returns the enum constant of this class with the specified name.
static BlendMode[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

CLEAR

public static final BlendMode CLEAR

Destination pixels covered by the source are cleared to 0.

a_out = 0

C_out = 0

SRC

public static final BlendMode SRC

The source pixels replace the destination pixels.

a_out = a_src

C_out = C_src

DST

public static final BlendMode DST

The source pixels are discarded, leaving the destination intact.

a_out = a_dst

C_out = C_dst

SRC_OVER

public static final BlendMode SRC_OVER

The source pixels are drawn over the destination pixels.

a_out = a_src + (1 - a_src) * a_dst

C_out = C_src + (1 - a_src) * C_dst

DST_OVER

public static final BlendMode DST_OVER

The source pixels are drawn behind the destination pixels.

a_out = a_dst + (1 - a_dst) * a_src

C_out = C_dst + (1 - a_dst) * C_src

SRC_IN

public static final BlendMode SRC_IN

Keeps the source pixels that cover the destination pixels, discards the remaining source and destination pixels.

a_out = a_src * a_dst

C_out = C_src * a_dst

DST_IN

public static final BlendMode DST_IN

Keeps the destination pixels that cover source pixels, discards the remaining source and destination pixels.

a_out = a_dst * a_src

C_out = C_dst * a_src

SRC_OUT

public static final BlendMode SRC_OUT

Keeps the source pixels that do not cover destination pixels. Discards source pixels that cover destination pixels. Discards all destination pixels.

a_out = (1 - a_dst) * a_src

C_out = (1 - a_dst) * C_src

DST_OUT

public static final BlendMode DST_OUT

Keeps the destination pixels that are not covered by source pixels. Discards destination pixels that are covered by source pixels. Discards all source pixels.

a_out = (1 - a_src) * a_dst

C_out = (1 - a_src) * C_dst

SRC_ATOP

public static final BlendMode SRC_ATOP

Discards the source pixels that do not cover destination pixels. Draws remaining source pixels over destination pixels.

a_out = a_dst

C_out = a_dst * C_src + (1 - a_src) * C_dst

DST_ATOP

public static final BlendMode DST_ATOP

Discards the destination pixels that are not covered by source pixels. Draws remaining destination pixels over source pixels.

a_out = a_src

C_out = a_src * C_dst + (1 - a_dst) * C_src

XOR

public static final BlendMode XOR

Discards the source and destination pixels where source pixels cover destination pixels. Draws remaining source pixels.

a_out = (1 - a_dst) * a_src + (1 - a_src) * a_dst

C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

PLUS

public static final BlendMode PLUS

Adds the source pixels to the destination pixels, without alpha blending. For floating-point textures, color components may be greater than 1.0.

a_out = a_src + a_dst

C_out = C_src + C_dst

See Also:

• PLUS_CLAMPED
• LINEAR_DODGE

PLUS_CLAMPED

public static final BlendMode PLUS_CLAMPED

Adds the source pixels to the destination pixels and saturates the result, without alpha blending. For unsigned fixed-point textures, this is the same as PLUS. This is a special blend equation.

a_out = max(0, min(a_src + a_dst, 1))

C_out = max(0, min(C_src + C_dst, 1))

See Also:

• PLUS
• LINEAR_DODGE

MINUS

public static final BlendMode MINUS

Subtracts the source pixels from the destination pixels, without alpha blending. For floating-point textures, color components may be less than 0.0.

a_out = a_dst - a_src

C_out = C_dst - C_src

See Also:

• MINUS_CLAMPED
• SUBTRACT

MINUS_CLAMPED

public static final BlendMode MINUS_CLAMPED

Subtracts the source pixels from the destination pixels and saturates the result, without alpha blending. For unsigned fixed-point textures, this is the same as MINUS. This is a special blend equation.

a_out = max(0, min(a_dst - a_src, 1))

C_out = max(0, min(C_dst - C_src, 1))

See Also:

• MINUS
• SUBTRACT

MODULATE

public static final BlendMode MODULATE

Multiplies the source and destination pixels, without alpha blending.

a_out = a_src * a_dst

C_out = C_src * C_dst

See Also:

• MULTIPLY

MULTIPLY

public static final BlendMode MULTIPLY

Multiplies the source and destination pixels. This is MODULATE with alpha blending. If both the source and destination are opaque, then this is the same as MODULATE. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src * C_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

See Also:

• MODULATE

SCREEN

public static final BlendMode SCREEN

Adds the source and destination pixels, then subtracts the source pixels multiplied by the destination.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src + C_dst - C_src * C_dst

OVERLAY

public static final BlendMode OVERLAY

Multiplies or screens the source and destination depending on the destination color. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst ≤ 0.5 * a_dst:
C_out = 2 * C_src * C_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * a_dst - 2 * (a_src - C_src) * (a_dst - C_dst) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

DARKEN

public static final BlendMode DARKEN

Retains the smallest component of the source and destination pixels. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = min(C_src / a_src, C_dst / a_dst) * a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

LIGHTEN

public static final BlendMode LIGHTEN

Retains the largest component of the source and destination pixel. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = max(C_src / a_src, C_dst / a_dst) * a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

COLOR_DODGE

public static final BlendMode COLOR_DODGE

Makes destination brighter to reflect source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst ≤ 0:
C_out = C_src * (1 - a_dst)

if C_src ≥ a_src:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * min(a_dst, C_dst * a_src / (a_src - C_src)) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

COLOR_BURN

public static final BlendMode COLOR_BURN

Makes destination darker to reflect source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst ≥ a_dst:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if C_src ≤ 0:
C_out = C_dst * (1 - a_src)

otherwise:
C_out = a_src * (a_dst - min(a_dst, (a_dst - C_dst) * a_src / C_dst)) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

HARD_LIGHT

public static final BlendMode HARD_LIGHT

Makes destination lighter or darker, depending on source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src ≤ 0.5 * a_src:
C_out = 2 * C_src * C_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * a_dst - 2 * (a_src - C_src) * (a_dst - C_dst) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

SOFT_LIGHT

public static final BlendMode SOFT_LIGHT

Makes destination lighter or darker, depending on source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src ≤ 0.5 * a_src:
C_out = C_dst * C_dst * (a_src - 2 * C_src) / a_dst + (1 - a_dst) * C_src + C_dst * (2 * C_src + 1 - a_src)

if C_dst ≤ 0.25 * a_dst:
C_out = (a_dst * a_dst * (C_src + C_dst * (6 * C_src - 3 * a_src + 1)) + 12 * a_dst * C_dst * C_dst * (a_src - 2 * C_src) - 16 * C_dst * C_dst * C_dst * (a_src - 2 * C_src) - a_dst * a_dst * a_dst * C_src) / a_dst * a_dst

otherwise:
C_out = C_dst * (a_src - 2 * C_src + 1) + C_src * (1 - a_dst) - sqrt(C_dst * a_dst) * (a_src - 2 * C_src)

DIFFERENCE

public static final BlendMode DIFFERENCE

Subtracts darker from lighter with higher contrast. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src + C_dst - 2 * min(C_src * a_dst, C_dst * a_src)

EXCLUSION

public static final BlendMode EXCLUSION

Subtracts darker from lighter with lower contrast. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src + C_dst - 2 * C_src * C_dst

SUBTRACT

public static final BlendMode SUBTRACT

Subtracts the source pixels from the destination pixels and saturates the result, with alpha blending. If both the source and destination are opaque, then this is the same as MINUS_CLAMPED. This is a custom blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst / a_dst - C_src / a_src ≥ 0:
C_out = C_src + C_dst - 2 * C_src * a_dst

otherwise:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

See Also:

• MINUS
• MINUS_CLAMPED

DIVIDE

public static final BlendMode DIVIDE

Divides the destination pixels by the source pixels and saturates the result. For negative and NaN values, the result color is black (XOR). This is a custom blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = pin((C_dst * a_src) / (C_src * a_dst), 0, 1) * a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

LINEAR_DODGE

public static final BlendMode LINEAR_DODGE

Lightens the destination pixels to reflect the source pixels while also increasing contrast. This is PLUS_CLAMPED with alpha blending. If both the source and destination are opaque, then this is the same as PLUS_CLAMPED. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src / a_src + C_dst / a_dst ≤ 1:
C_out = C_src + C_dst

otherwise:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

See Also:

• PLUS
• PLUS_CLAMPED

LINEAR_BURN

public static final BlendMode LINEAR_BURN

Darkens the destination pixels to reflect the source pixels while also increasing contrast. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src / a_src + C_dst / a_dst > 1:
C_out = C_src + C_dst - a_src * a_dst

otherwise:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

VIVID_LIGHT

public static final BlendMode VIVID_LIGHT

Burns or dodges colors by changing contrast, depending on the blend color. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src ≤ 0:
C_out = C_dst * (1 - a_src)

if C_src < 0.5 * a_src:
C_out = a_src * (a_dst - min(a_dst, (a_dst - C_dst) * a_src / (2 * C_dst))) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if C_src ≥ a_src:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * min(a_dst, C_dst * a_src / (2 * (a_src - C_src))) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

LINEAR_LIGHT

public static final BlendMode LINEAR_LIGHT

Burns or dodges colors by changing brightness, depending on the blend color. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if 2 * C_src / a_src + C_dst / a_dst > 2:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if 2 * C_src / a_src + C_dst / a_dst ≤ 1:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = 2 * C_src * a_dst + C_dst * a_src - a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

PIN_LIGHT

public static final BlendMode PIN_LIGHT

Conditionally replaces destination pixels with source pixels depending on the brightness of the source pixels. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if 2 * C_src / a_src - C_dst / a_dst > 1 && C_src < 0.5 * a_src:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

if 2 * C_src / a_src - C_dst / a_dst > 1 && C_src ≥ 0.5 * a_src:
C_out = 2 * C_src * a_dst - a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if 2 * C_src / a_src - C_dst / a_dst ≤ 1 && C_src * a_dst < 0.5 * C_dst * a_src:
C_out = 2 * C_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = C_dst * a_src + (1 - a_dst) * C_src + (1 - a_src) * C_dst

HARD_MIX

public static final BlendMode HARD_MIX

Adds two images together, setting each color channel value to either 0 or 1. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src / a_src + C_dst / a_dst < 1:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

DARKER_COLOR

public static final BlendMode DARKER_COLOR

Similar to DARKEN, but darkens on the composite channel, instead of separate RGB color channels. It compares the source and destination color, and keep the one with lower luminosity between the two.

if lum(C_src) ≤ lum(C_dst):
Equivalent to SRC_OVER

otherwise:
Equivalent to DST_OVER

LIGHTER_COLOR

public static final BlendMode LIGHTER_COLOR

Similar to LIGHTEN, but lightens on the composite channel, instead of separate RGB color channels. It compares the source and destination color, and keep the one with higher luminosity between the two.

if lum(C_src) ≥ lum(C_dst):
Equivalent to SRC_OVER

otherwise:
Equivalent to DST_OVER

HUE

public static final BlendMode HUE

Replaces hue of destination with hue of source, leaving saturation and luminosity unchanged. This is an advanced blend equation.

SATURATION

public static final BlendMode SATURATION

Replaces saturation of destination saturation hue of source, leaving hue and luminosity unchanged. This is an advanced blend equation.

COLOR

public static final BlendMode COLOR

Replaces hue and saturation of destination with hue and saturation of source, leaving luminosity unchanged. This is an advanced blend equation.

LUMINOSITY

public static final BlendMode LUMINOSITY

Replaces luminosity of destination with luminosity of source, leaving hue and saturation unchanged. This is an advanced blend equation.

Field Details

ADD

public static final BlendMode ADD

Name alias of LINEAR_DODGE.

COUNT

public static final int COUNT

Number of blend modes, runtime constant.

Method Details

values

public static BlendMode[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static BlendMode valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

modeAt

@Nonnull
public static BlendMode modeAt(int index)

Returns the value at the given index. This method can only be used at runtime, the return value does not guarantee binary compatibility.

Parameters:

index - the Enum.ordinal()

Returns:

the blend mode

ref

public void ref()

Description copied from interface: RefCounted

Increases the reference count by 1.

Specified by:

ref in interface RefCounted

unref

public void unref()

Description copied from interface: RefCounted

Decreases the reference count by 1.

Specified by:

unref in interface RefCounted

asBlendMode

public BlendMode asBlendMode()

Description copied from interface: Blender

Returns the blender's BlendMode in 'mode' if this Blender represents any BlendMode. Returns null for other types of blends.

Specified by:

asBlendMode in interface Blender

isAdvanced

public boolean isAdvanced()

25 blend modes after MULTIPLY are advanced.

Advanced blend modes are not directly supported by 3D API, they will be implemented with custom fragment shader code and DST read (via texture barrier, input attachment, or image copy). Advanced blend modes should be avoided for operations other than layer compositing. All advanced blend modes are SrcOver-like, then they are alpha conservative.

1. MULTIPLY
2. SCREEN
3. OVERLAY
4. DARKEN
5. LIGHTEN
6. COLOR_DODGE
7. COLOR_BURN
8. HARD_LIGHT
9. SOFT_LIGHT
10. DIFFERENCE
11. EXCLUSION
12. SUBTRACT
13. DIVIDE
14. LINEAR_DODGE
15. LINEAR_BURN
16. VIVID_LIGHT
17. LINEAR_LIGHT
18. PIN_LIGHT
19. HARD_MIX
20. DARKER_COLOR
21. LIGHTER_COLOR
22. HUE
23. SATURATION
24. COLOR
25. LUMINOSITY

getBlendFuncName

public String getBlendFuncName()

Returns the name of blend function.

Raster pipeline implementation and shader implementation must be consistent with this.

apply

public final void apply(@Size(4L)
 float[] src,
 @Size(4L)
 float[] dst,
 @Size(4L)
 float[] out)

Applies this blend mode with RGBA colors. src, dst and out store premultiplied R,G,B,A components from index 0 to 3. src, dst and out can be the same pointer. src and dst are read-only, out may be written multiple times.

This method is mainly used for blending solid colors without using shader code.

This method is final to avoid generating too many anonymous classes.

blend_src_over

public static void blend_src_over(float[] src,
 float[] dst,
 float[] out)

blend_dst_over

public static void blend_dst_over(float[] src,
 float[] dst,
 float[] out)

blend_src_in

public static void blend_src_in(float[] src,
 float[] dst,
 float[] out)

blend_dst_in

public static void blend_dst_in(float[] src,
 float[] dst,
 float[] out)

blend_src_out

public static void blend_src_out(float[] src,
 float[] dst,
 float[] out)

blend_dst_out

public static void blend_dst_out(float[] src,
 float[] dst,
 float[] out)

blend_src_atop

public static void blend_src_atop(float[] src,
 float[] dst,
 float[] out)

blend_dst_atop

public static void blend_dst_atop(float[] src,
 float[] dst,
 float[] out)

blend_xor

public static void blend_xor(float[] src,
 float[] dst,
 float[] out)

blend_plus

public static void blend_plus(float[] src,
 float[] dst,
 float[] out)

Adds the source pixels to the destination pixels, without alpha blending. For floating-point textures, color components may be greater than 1.0.

a_out = a_src + a_dst

C_out = C_src + C_dst

blend_plus_clamped

public static void blend_plus_clamped(float[] src,
 float[] dst,
 float[] out)

Adds the source pixels to the destination pixels and saturates the result, without alpha blending. For unsigned fixed-point textures, this is the same as PLUS. This is a special blend equation.

a_out = max(0, min(a_src + a_dst, 1))

C_out = max(0, min(C_src + C_dst, 1))

blend_minus

public static void blend_minus(float[] src,
 float[] dst,
 float[] out)

Subtracts the source pixels from the destination pixels, without alpha blending. For floating-point textures, color components may be less than 0.0.

a_out = a_dst - a_src

C_out = C_dst - C_src

blend_minus_clamped

public static void blend_minus_clamped(float[] src,
 float[] dst,
 float[] out)

Subtracts the source pixels from the destination pixels and saturates the result, without alpha blending. For unsigned fixed-point textures, this is the same as MINUS. This is a special blend equation.

a_out = max(0, min(a_dst - a_src, 1))

C_out = max(0, min(C_dst - C_src, 1))

blend_modulate

public static void blend_modulate(float[] src,
 float[] dst,
 float[] out)

Multiplies the source and destination pixels, without alpha blending.

a_out = a_src * a_dst

C_out = C_src * C_dst

blend_multiply

public static void blend_multiply(float[] src,
 float[] dst,
 float[] out)

Multiplies the source and destination pixels. This is MODULATE with alpha blending. If both the source and destination are opaque, then this is the same as MODULATE. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src * C_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_screen

public static void blend_screen(float[] src,
 float[] dst,
 float[] out)

Adds the source and destination pixels, then subtracts the source pixels multiplied by the destination.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src + C_dst - C_src * C_dst

blend_overlay

public static void blend_overlay(float[] src,
 float[] dst,
 float[] out)

Multiplies or screens the source and destination depending on the destination color. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst ≤ 0.5 * a_dst:
C_out = 2 * C_src * C_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * a_dst - 2 * (a_src - C_src) * (a_dst - C_dst) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_darken

public static void blend_darken(float[] src,
 float[] dst,
 float[] out)

Retains the smallest component of the source and destination pixels. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = min(C_src / a_src, C_dst / a_dst) * a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_lighten

public static void blend_lighten(float[] src,
 float[] dst,
 float[] out)

Retains the largest component of the source and destination pixel. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = max(C_src / a_src, C_dst / a_dst) * a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_color_dodge

public static void blend_color_dodge(float[] src,
 float[] dst,
 float[] out)

Makes destination brighter to reflect source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst ≤ 0:
C_out = C_src * (1 - a_dst)

if C_src ≥ a_src:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * min(a_dst, C_dst * a_src / (a_src - C_src)) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_color_burn

public static void blend_color_burn(float[] src,
 float[] dst,
 float[] out)

Makes destination darker to reflect source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst ≥ a_dst:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if C_src ≤ 0:
C_out = C_dst * (1 - a_src)

otherwise:
C_out = a_src * (a_dst - min(a_dst, (a_dst - C_dst) * a_src / C_dst)) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_hard_light

public static void blend_hard_light(float[] src,
 float[] dst,
 float[] out)

Makes destination lighter or darker, depending on source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src ≤ 0.5 * a_src:
C_out = 2 * C_src * C_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * a_dst - 2 * (a_src - C_src) * (a_dst - C_dst) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_soft_light

public static void blend_soft_light(float[] src,
 float[] dst,
 float[] out)

Makes destination lighter or darker, depending on source. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src ≤ 0.5 * a_src:
C_out = C_dst * C_dst * (a_src - 2 * C_src) / a_dst + (1 - a_dst) * C_src + C_dst * (2 * C_src + 1 - a_src)

if C_dst ≤ 0.25 * a_dst:
C_out = (a_dst * a_dst * (C_src + C_dst * (6 * C_src - 3 * a_src + 1)) + 12 * a_dst * C_dst * C_dst * (a_src - 2 * C_src) - 16 * C_dst * C_dst * C_dst * (a_src - 2 * C_src) - a_dst * a_dst * a_dst * C_src) / a_dst * a_dst

otherwise:
C_out = C_dst * (a_src - 2 * C_src + 1) + C_src * (1 - a_dst) - sqrt(C_dst * a_dst) * (a_src - 2 * C_src)

blend_difference

public static void blend_difference(float[] src,
 float[] dst,
 float[] out)

Subtracts darker from lighter with higher contrast. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src + C_dst - 2 * min(C_src * a_dst, C_dst * a_src)

blend_exclusion

public static void blend_exclusion(float[] src,
 float[] dst,
 float[] out)

Subtracts darker from lighter with lower contrast. This is an advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = C_src + C_dst - 2 * C_src * C_dst

blend_subtract

public static void blend_subtract(float[] src,
 float[] dst,
 float[] out)

Subtracts the source pixels from the destination pixels and saturates the result, with alpha blending. If both the source and destination are opaque, then this is the same as MINUS_CLAMPED. This is a custom blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_dst / a_dst - C_src / a_src ≥ 0:
C_out = C_src + C_dst - 2 * C_src * a_dst

otherwise:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_divide

public static void blend_divide(float[] src,
 float[] dst,
 float[] out)

Divides the destination pixels by the source pixels and saturates the result. For negative and NaN values, the result color is black (XOR). This is a custom blend equation.

a_out = a_src + a_dst - a_src * a_dst

C_out = pin((C_dst * a_src) / (C_src * a_dst), 0, 1) * a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_linear_dodge

public static void blend_linear_dodge(float[] src,
 float[] dst,
 float[] out)

Lightens the destination pixels to reflect the source pixels while also increasing contrast. This is PLUS_CLAMPED with alpha blending. If both the source and destination are opaque, then this is the same as PLUS_CLAMPED. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src / a_src + C_dst / a_dst ≤ 1:
C_out = C_src + C_dst

otherwise:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_linear_burn

public static void blend_linear_burn(float[] src,
 float[] dst,
 float[] out)

Darkens the destination pixels to reflect the source pixels while also increasing contrast. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src / a_src + C_dst / a_dst > 1:
C_out = C_src + C_dst - a_src * a_dst

otherwise:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_vivid_light

public static void blend_vivid_light(float[] src,
 float[] dst,
 float[] out)

Burns or dodges colors by changing contrast, depending on the blend color. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src ≤ 0:
C_out = C_dst * (1 - a_src)

if C_src < 0.5 * a_src:
C_out = a_src * (a_dst - min(a_dst, (a_dst - C_dst) * a_src / (2 * C_dst))) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if C_src ≥ a_src:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * min(a_dst, C_dst * a_src / (2 * (a_src - C_src))) + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_linear_light

public static void blend_linear_light(float[] src,
 float[] dst,
 float[] out)

Burns or dodges colors by changing brightness, depending on the blend color. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if 2 * C_src / a_src + C_dst / a_dst > 2:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if 2 * C_src / a_src + C_dst / a_dst ≤ 1:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = 2 * C_src * a_dst + C_dst * a_src - a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_pin_light

public static void blend_pin_light(float[] src,
 float[] dst,
 float[] out)

Conditionally replaces destination pixels with source pixels depending on the brightness of the source pixels. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if 2 * C_src / a_src - C_dst / a_dst > 1 && C_src < 0.5 * a_src:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

if 2 * C_src / a_src - C_dst / a_dst > 1 && C_src ≥ 0.5 * a_src:
C_out = 2 * C_src * a_dst - a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

if 2 * C_src / a_src - C_dst / a_dst ≤ 1 && C_src * a_dst < 0.5 * C_dst * a_src:
C_out = 2 * C_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = C_dst * a_src + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_hard_mix

public static void blend_hard_mix(float[] src,
 float[] dst,
 float[] out)

Adds two images together, setting each color channel value to either 0 or 1. This is an extended advanced blend equation.

a_out = a_src + a_dst - a_src * a_dst

if C_src / a_src + C_dst / a_dst < 1:
C_out = (1 - a_dst) * C_src + (1 - a_src) * C_dst

otherwise:
C_out = a_src * a_dst + (1 - a_dst) * C_src + (1 - a_src) * C_dst

blend_darker_color

public static void blend_darker_color(float[] src,
 float[] dst,
 float[] out)

Similar to DARKEN, but darkens on the composite channel, instead of separate RGB color channels. It compares the source and destination color, and keep the one with lower luminosity between the two.

if lum(C_src) ≤ lum(C_dst):
Equivalent to SRC_OVER

otherwise:
Equivalent to DST_OVER

blend_lighter_color

public static void blend_lighter_color(float[] src,
 float[] dst,
 float[] out)

Similar to LIGHTEN, but lightens on the composite channel, instead of separate RGB color channels. It compares the source and destination color, and keep the one with higher luminosity between the two.

if lum(C_src) ≥ lum(C_dst):
Equivalent to SRC_OVER

otherwise:
Equivalent to DST_OVER

blend_hue

public static void blend_hue(float[] src,
 float[] dst,
 float[] out)

Replaces hue of destination with hue of source, leaving saturation and luminosity unchanged. This is an advanced blend equation.

blend_saturation

public static void blend_saturation(float[] src,
 float[] dst,
 float[] out)

Replaces saturation of destination saturation hue of source, leaving hue and luminosity unchanged. This is an advanced blend equation.

blend_color

public static void blend_color(float[] src,
 float[] dst,
 float[] out)

Replaces hue and saturation of destination with hue and saturation of source, leaving luminosity unchanged. This is an advanced blend equation.

blend_luminosity

public static void blend_luminosity(float[] src,
 float[] dst,
 float[] out)

Replaces luminosity of destination with luminosity of source, leaving hue and saturation unchanged. This is an advanced blend equation.