| .. _blend: |
| |
| Blend |
| ===== |
| |
| This state controls blending of the final fragments into the target rendering |
| buffers. |
| |
| Blend Factors |
| ------------- |
| |
| The blend factors largely follow the same pattern as their counterparts |
| in other modern and legacy drawing APIs. |
| |
| XXX blurb about dual-source blends |
| |
| Logical Operations |
| ------------------ |
| |
| Logical operations, also known as logicops, lops, or rops, are supported. |
| Only two-operand logicops are available. When logicops are enabled, all other |
| blend state is ignored, including per-render-target state, so logicops are |
| performed on all enabled render targets. |
| |
| XXX do lops still apply if blend_enable isn't set? |
| |
| Members |
| ------- |
| |
| These members affect all render targets. |
| |
| dither |
| %%%%%% |
| |
| Whether dithering is enabled. |
| |
| .. note:: |
| Dithering is completely implementation-dependent. It may be ignored by |
| drivers for any reason, and some render targets may always or never be |
| dithered depending on their format or usage flags. |
| |
| logicop_enable |
| %%%%%%%%%%%%%% |
| |
| Whether the blender should perform a logicop instead of blending. |
| |
| logicop_func |
| %%%%%%%%%%%% |
| |
| The logicop to use. One of ``PIPE_LOGICOP``. |
| |
| independent_blend_enable |
| If enabled, blend state is different for each render target, and |
| for each render target set in the respective member of the rt array. |
| If disabled, blend state is the same for all render targets, and only |
| the first member of the rt array contains valid data. |
| rt |
| Contains the per-rendertarget blend state. |
| |
| Per-rendertarget Members |
| ------------------------ |
| |
| blend_enable |
| If blending is enabled, perform a blend calculation according to blend |
| functions and source/destination factors. Otherwise, the incoming fragment |
| color gets passed unmodified (but colormask still applies). |
| rgb_func |
| The blend function to use for rgb channels. One of PIPE_BLEND. |
| rgb_src_factor |
| The blend source factor to use for rgb channels. One of PIPE_BLENDFACTOR. |
| rgb_dst_factor |
| The blend destination factor to use for rgb channels. One of PIPE_BLENDFACTOR. |
| alpha_func |
| The blend function to use for the alpha channel. One of PIPE_BLEND. |
| alpha_src_factor |
| The blend source factor to use for the alpha channel. One of PIPE_BLENDFACTOR. |
| alpha_dst_factor |
| The blend destination factor to use for alpha channel. One of PIPE_BLENDFACTOR. |
| colormask |
| Bitmask of which channels to write. Combination of PIPE_MASK bits. |