SkBlendMode.h File Reference

#include "include/core/SkTypes.h"

Include dependency graph for SkBlendMode.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Enumerations
enum class	SkBlendMode {   kClear , kSrc , kDst , kSrcOver ,   kDstOver , kSrcIn , kDstIn , kSrcOut ,   kDstOut , kSrcATop , kDstATop , kXor ,   kPlus , kModulate , kScreen , kOverlay ,   kDarken , kLighten , kColorDodge , kColorBurn ,   kHardLight , kSoftLight , kDifference , kExclusion ,   kMultiply , kHue , kSaturation , kColor ,   kLuminosity , kLastCoeffMode = kScreen , kLastSeparableMode = kMultiply , kLastMode = kLuminosity }
	Blends are operators that take in two colors (source, destination) and return a new color. More...
enum class	SkBlendModeCoeff {   kZero , kOne , kSC , kISC ,   kDC , kIDC , kSA , kISA ,   kDA , kIDA , kCoeffCount }
	For Porter-Duff SkBlendModes (those <= kLastCoeffMode), these coefficients describe the blend equation used. More...

Functions
SK_API bool	SkBlendMode_AsCoeff (SkBlendMode mode, SkBlendModeCoeff *src, SkBlendModeCoeff *dst)
	Returns true if 'mode' is a coefficient-based blend mode (<= kLastCoeffMode). More...
SK_API const char *	SkBlendMode_Name (SkBlendMode blendMode)
	Returns name of blendMode as null-terminated C string. More...

Variables
static constexpr int	kSkBlendModeCount = static_cast<int>(SkBlendMode::kLastMode) + 1

Enumeration Type Documentation

SkBlendMode

enum SkBlendMode

strong

Blends are operators that take in two colors (source, destination) and return a new color.

Many of these operate the same on all 4 components: red, green, blue, alpha. For these, we just document what happens to one component, rather than naming each one separately.

Different SkColorTypes have different representations for color components: 8-bit: 0..255 6-bit: 0..63 5-bit: 0..31 4-bit: 0..15 floats: 0...1

The documentation is expressed as if the component values are always 0..1 (floats).

For brevity, the documentation uses the following abbreviations s : source d : destination sa : source alpha da : destination alpha

Results are abbreviated r : if all 4 components are computed in the same manner ra : result alpha component rc : result "color": red, green, blue components

Enumerator
kClear	r = 0
kSrc	r = s
kDst	r = d
kSrcOver	r = s + (1-sa)*d
kDstOver	r = d + (1-da)*s
kSrcIn	r = s * da
kDstIn	r = d * sa
kSrcOut	r = s * (1-da)
kDstOut	r = d * (1-sa)
kSrcATop	r = s*da + d*(1-sa)
kDstATop	r = d*sa + s*(1-da)
kXor	r = s*(1-da) + d*(1-sa)
kPlus	r = min(s + d, 1)
kModulate	r = s*d
kScreen	r = s + d - s*d
kOverlay	multiply or screen, depending on destination
kDarken	rc = s + d - max(s*da, d*sa), ra = kSrcOver
kLighten	rc = s + d - min(s*da, d*sa), ra = kSrcOver
kColorDodge	brighten destination to reflect source
kColorBurn	darken destination to reflect source
kHardLight	multiply or screen, depending on source
kSoftLight	lighten or darken, depending on source
kDifference	rc = s + d - 2*(min(s*da, d*sa)), ra = kSrcOver
kExclusion	rc = s + d - two(s*d), ra = kSrcOver
kMultiply	r = s*(1-da) + d*(1-sa) + s*d
kHue	hue of source with saturation and luminosity of destination
kSaturation	saturation of source with hue and luminosity of destination
kColor	hue and saturation of source with luminosity of destination
kLuminosity	luminosity of source with hue and saturation of destination
kLastCoeffMode	last porter duff blend mode
kLastSeparableMode	last blend mode operating separately on components
kLastMode	last valid value

SkBlendModeCoeff

enum SkBlendModeCoeff

strong

For Porter-Duff SkBlendModes (those <= kLastCoeffMode), these coefficients describe the blend equation used.

Coefficient-based blend modes specify an equation: ('dstCoeff' * dst + 'srcCoeff' * src), where the coefficient values are constants, functions of the src or dst alpha, or functions of the src or dst color.

Enumerator
kZero
kOne	0
kSC	1
kISC	src color
kDC	inverse src color (i.e. 1 - sc)
kIDC	dst color
kSA	inverse dst color (i.e. 1 - dc)
kISA	src alpha
kDA	inverse src alpha (i.e. 1 - sa)
kIDA	dst alpha
kCoeffCount	inverse dst alpha (i.e. 1 - da)

Function Documentation

SkBlendMode_AsCoeff()

SK_API bool SkBlendMode_AsCoeff	(	SkBlendMode	mode,
		SkBlendModeCoeff *	src,
		SkBlendModeCoeff *	dst
	)

Returns true if 'mode' is a coefficient-based blend mode (<= kLastCoeffMode).

If true is returned, the mode's src and dst coefficient functions are set in 'src' and 'dst'.

SkBlendMode_Name()

SK_API const char* SkBlendMode_Name

(

SkBlendMode

blendMode

)

Returns name of blendMode as null-terminated C string.

Returns

C string

Variable Documentation

kSkBlendModeCount

constexpr int kSkBlendModeCount = static_cast<int>(SkBlendMode::kLastMode) + 1

staticconstexpr