mode property
Gets a value that indicates one of the image-blending modes.
This property is read-only.
.png){kind=icon} .png){kind=icon} |
Syntax
HRESULT get_mode(
[out] SVGAnimatedEnumeration **normal | multiply | screen | darken | lighten
);
Property values
Type: SVGAnimatedEnumeration
One of the following image-blending mode values.
The image-blending modes are defined by formulas that use the following shorthand values:
- cr = Result color (RGB) - premultiplied
- qa = Opacity value at a given pixel for image A
- qb = Opacity value at a given pixel for image B
- ca = Color (RGB) at a given pixel for image A - premultiplied
- cb = Color (RGB) at a given pixel for image B - premultiplied
| Value | Condition |
|---|---|
| normal normal | Indicates the following formula is used for computing result color: cr = (1 - qa) * cb + ca The normal blend mode is equivalent to operator="over" on the feComposite filter primitive, matches the blending method used by the feMerge filter, and matches the simple alpha compositing technique used in SVG for all compositing outside of filter effects. |
| multiply multiply | Indicates the following formula is used for computing result color: cr = (1-qa)*cb + (1-qb)*ca + ca*cb |
| screen screen | Indicates the following formula is used for computing result color: cr = cb + ca - ca * cb |
| darken darken | Indicates the following formula is used for computing result color: cr = Min ((1 - qa) * cb + ca, (1 - qb) * ca + cb) |
| lighten lighten | Indicates the following formula is used for computing result color: cr = Max ((1 - qa) * cb + ca, (1 - qb) * ca + cb) |
String format
normal | multiply | screen | darken | lighten
Standards information
- Scalable Vector Graphics: Filter Effects, Section 15.25.3
Remarks
If the mode attribute is not specified, then the effect is as if a value of normal were specified.