Chapter 639: BlendMode
Core Idea
Represents blending configuration.
This class encapsulates all blending-related properties that control how a material's colors are combined with the colors already in the frame buffer.
Key Concepts
- blendDst : ZeroFactor | OneFactor | SrcColorFactor | OneMinusSrcColorFactor | SrcAlphaFactor | OneMinusSrcAlphaFactor | DstAlphaFactor | OneMinusDstAlphaFactor | DstColorFactor | OneMinusDstColorFactor | SrcAlphaSaturateFactor | ConstantColorFactor | OneMinusConstantColorFactor | ConstantAlphaFactor | OneMinusConstantAlphaFactor: Defines the blending destination factor.
- blendDstAlpha : ZeroFactor | OneFactor | SrcColorFactor | OneMinusSrcColorFactor | SrcAlphaFactor | OneMinusSrcAlphaFactor | DstAlphaFactor | OneMinusDstAlphaFactor | DstColorFactor | OneMinusDstColorFactor | SrcAlphaSaturateFactor | ConstantColorFactor | OneMinusConstantColorFactor | ConstantAlphaFactor | OneMinusConstantAlphaFactor: Defines the blending destination alpha factor.
- blendEquation : AddEquation | SubtractEquation | ReverseSubtractEquation | MinEquation | MaxEquation: Defines the blending equation.
- blendEquationAlpha : AddEquation | SubtractEquation | ReverseSubtractEquation | MinEquation | MaxEquation: Defines the blending equation of the alpha channel.
- blendSrc : ZeroFactor | OneFactor | SrcColorFactor | OneMinusSrcColorFactor | SrcAlphaFactor | OneMinusSrcAlphaFactor | DstAlphaFactor | OneMinusDstAlphaFactor | DstColorFactor | OneMinusDstColorFactor | SrcAlphaSaturateFactor | ConstantColorFactor | OneMinusConstantColorFactor | ConstantAlphaFactor | OneMinusConstantAlphaFactor: Defines the blending source factor.
- blendSrcAlpha : ZeroFactor | OneFactor | SrcColorFactor | OneMinusSrcColorFactor | SrcAlphaFactor | OneMinusSrcAlphaFactor | DstAlphaFactor | OneMinusDstAlphaFactor | DstColorFactor | OneMinusDstColorFactor | SrcAlphaSaturateFactor | ConstantColorFactor | OneMinusConstantColorFactor | ConstantAlphaFactor | OneMinusConstantAlphaFactor: Defines the blending source alpha factor.
- blending : NoBlending | NormalBlending | AdditiveBlending | SubtractiveBlending | MultiplyBlending | CustomBlending | MaterialBlending: Defines the blending type.
- premultiplyAlpha : boolean: Defines whether to premultiply the alpha (transparency) value.
Reference Tables
Constructor
| Signature |
|---|
| `new BlendMode( blending : NoBlending |
Properties
| Property | Description |
|---|
| `.blendDst : ZeroFactor | OneFactor |
| `.blendDstAlpha : ZeroFactor | OneFactor |
| `.blendEquation : AddEquation | SubtractEquation |
| `.blendEquationAlpha : AddEquation | SubtractEquation |
| `.blendSrc : ZeroFactor | OneFactor |
| `.blendSrcAlpha : ZeroFactor | OneFactor |
| `.blending : NoBlending | NormalBlending |
.premultiplyAlpha : boolean | Defines whether to premultiply the alpha (transparency) value. |
Methods
| Method | Description |
|---|
.clone() : BlendMode | Returns a clone of this blending configuration. |
.copy( source : BlendMode ) : BlendMode | Copies the blending properties from the given source to this instance. |
Key Takeaways
- Most relevant properties: blendDst, blendDstAlpha, blendEquation, blendEquationAlpha.
- Key methods: clone, copy.
Connects To