Share via


D3DMBLEND

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This enumeration provides values that identify scaling factors for alpha blending operations. These scaling factors are multiplied by either the source or destination pixel values depending on whether the render states D3DMRS_SRCBLEND or D3DMRS_DESTBLEND (see D3DMRENDERSTATETYPE) are specified. For more information, see Alpha Blending.

There is a blending factor B for each color channel r, g, and b and for the alpha channel a. These blending factors are derived from the source, S, and destination, D, pixel values.

Syntax

typedef enum _D3DMBLEND {
  D3DMBLEND_ZERO         = 1,
  D3DMBLEND_ONE          = 2,
  D3DMBLEND_SRCCOLOR     = 3,
  D3DMBLEND_INVSRCCOLOR  = 4,
  D3DMBLEND_SRCALPHA     = 5,
  D3DMBLEND_INVSRCALPHA  = 6,
  D3DMBLEND_DESTALPHA    = 7,
  D3DMBLEND_INVDESTALPHA = 8,
  D3DMBLEND_DESTCOLOR    = 9,
  D3DMBLEND_INVDESTCOLOR = 10,
  D3DMBLEND_SRCALPHASAT  = 11,
  D3DMBLEND_FORCE_ULONG  = 0x7fffffff,
} D3DMBLEND;

Elements

  • D3DMBLEND_ZERO
    Identifies that the scaling factor is 0 for all channels.

    Br = 0
    Bg = 0
    Bb = 0
    Ba = 0
    
  • D3DMBLEND_ONE
    Identifies that the scaling factor is 1 for all channels. This is equivalent to not performing a scaling multiplication at all.

    Br = 1
    Bg = 1
    Bb = 1
    Ba = 1
    
  • D3DMBLEND_SRCCOLOR
    Identifies that the scaling factor is the source pixel value.

    Br = Sr
    Bg = Sg
    Bb = Sb
    Ba = Sa
    
  • D3DMBLEND_INVSRCCOLOR
    Identifies that the scaling factor is 1 minus the source pixel value, for each color channel.

    Br = 1 – Sr
    Bg = 1 – Sg
    Bb = 1 – Sb
    Ba = 1 – Sa
    
  • D3DMBLEND_SRCALPHA
    Identifies that the scaling factor is the source alpha value for all color channels.

    Br = Sa
    Bg = Sa
    Bb = Sa
    Ba = Sa
    
  • D3DMBLEND_INVSRCALPHA
    Identifies that the scaling factor is one minus the source alpha value for all color channels.

    Br = 1 – Sa
    Bg = 1 – Sa
    Bb = 1 – Sa
    Ba = 1 – Sa
    
  • D3DMBLEND_DESTALPHA
    Identifies that the scaling factor is the destination alpha value for all color channels.

    Br = Da
    Bg = Da
    Bb = Da
    Ba = Da
    
  • D3DMBLEND_INVDESTALPHA
    Identifies that the scaling factor is one minus the destination alpha value for all color channels.

    Br = 1 – Da
    Bg = 1 – Da
    Bb = 1 – Da
    Ba = 1 – Da
    
  • D3DMBLEND_DESTCOLOR
    Identifies that the scaling factor is the destination pixel value.

    Br = Dr
    Bg = Dg
    Bb = Db
    Ba = Da
    
  • D3DMBLEND_INVDESTCOLOR
    Identifies that the scaling factor is 1 minus the destination pixel value, for each color channel.

    Br = 1 – Dr
    Bg = 1 – Dg
    Bb = 1 – Db
    Ba = 1 – Da
    
  • D3DMBLEND_SRCALPHASAT
    Identifies that the scaling factor is determined by the following equations.

    Br = min(Sa, 1–Da)
    Bg = min(Sa, 1–Da)
    Bb = min(Sa, 1–Da)
    Ba = 1
    
  • D3DMBLEND_FORCE_ULONG
    Forces the compiler to interpret the enumeration as a ULONG value. This value is not used directly in Direct3D Mobile programming.

Remarks

The Direct3D Mobile blending functions, D3DMBLENDOP_MIN and D3DMBLENDOP_MAX, are not impacted by the above listed blending factors.

Requirements

Header d3dmtypes.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Direct3D Mobile Enumerations
D3DMRENDERSTATETYPE

Concepts

Alpha Blending