DDPIXELFORMAT (Windows CE 5.0)
This structure describes the pixel format of a DirectDrawSurface object for the IDirectDrawSurface5::GetPixelFormat method.
typedef struct _DDPIXELFORMAT {DWORDdwSize;DWORDdwFlags;DWORDdwFourCC;union{DWORDdwRGBBitCount;DWORDdwYUVBitCount;DWORDdwZBufferBitDepth;DWORDdwAlphaBitDepth;DWORDdwLuminanceBitCount;DWORDdwBumpBitCount;DWORDdwPrivateFormatBitCount;};union{DWORDdwRBitMask;DWORDdwYBitMask;DWORDdwStencilBitDepth;DWORDdwLuminanceBitMask;DWORDdwBumpDuBitMask;DWORDdwOperations;};union{DWORDdwGBitMask;DWORDdwUBitMask;DWORDdwZBitMask;DWORDdwBumpDvBitMask;struct{WORDwFlipMSTypes;WORDwBltMSTypes;}MultiSampleCaps;};union{DWORDdwBBitMask;DWORDdwVBitMask;DWORDdwStencilBitMask;DWORDdwBumpLuminanceBitMask;};union{DWORDdwRGBAlphaBitMask;DWORDdwYUVAlphaBitMask;DWORDdwLuminanceAlphaBitMask;DWORDdwRGBZBitMask;DWORDdwYUVZBitMask;};} DDPIXELFORMAT, FAR* LPDDPIXELFORMAT;
Members
dwSize
Specifies the size, in bytes, of the DDPIXELFORMAT structure.This member must be initialized before the structure is used.
dwFlags
Set of flags that specify optional control flags.This member is a bitwise OR of any of the flags shown in the following table.
Flag Description DDPF_ALPHA The pixel format describes an alpha-only surface. DDPF_ALPHAPIXELS The surface has alpha channel information in the pixel format. DDPF_ALPHAPREMULT The color components in the pixel are premultiplied by the alpha value in the pixel. If this flag is set, the DDPF_ALPHAPIXELS flag must also be set.
If this flag is not set but the DDPF_ALPHAPIXELS flag is set, the color components in the pixel format are not premultiplied by alpha.
In this case, the color components must be multiplied by the alpha value at the time that an alpha-blending operation is performed.
DDPF_BUMPDUDV Not supported. DDPF_BUMPHEIGHT Not supported. DDPF_COMPRESSED Not supported. DDPF_FOURCC The FourCC code is valid. DDPF_LUMINANCE Not supported. DDPF_LUMINANCEPIXELS Not supported. DDPF_PALETTEINDEXED1 The surface is 1-bit color indexed. DDPF_PALETTEINDEXED2 The surface is 2-bit color indexed. DDPF_PALETTEINDEXED4 The surface is 4-bit color indexed. DDPF_PALETTEINDEXED8 The surface is 8-bit color indexed. DDPF_PALETTEINDEXEDTO8 The surface is 1-, 2-, or 4-bit color indexed to an 8-bit palette. DDPF_RGB The RGB data in the pixel format structure is valid. DDPF_RGBTOYUV The surface accepts RGB data and translates it during the write operation to YUV data. The format of the data to be written is contained in the pixel format structure.
The DDPF_RGB flag is set.
DDPF_STENCILPIXELS Not supported. DDPF_YUV The YUV data in the pixel format structure is valid. DDPF_ZBUFFER Not supported. DDPF_ZPIXELS Not supported. dwFourCC
Specifies the FourCC code.dwRGBBitCount
Specifies the number of RGB bits per pixel (4, 8, 16, 24, or 32).dwYUVBitCount
Specifies the number of YUV bits per pixel.dwZBufferBitDepth
Not supported.dwAlphaBitDepth
Specifies the Alpha channel bit depth.dwLuminanceBitCount
Not supported.dwBumpBitCount
Not supported.dwPrivateFormatBitCount
Not supported.dwRBitMask
Specifies the mask for red bits.dwYBitMask
Specifies the mask for Y bits.dwStencilBitDepth
Not supported.dwLuminanceBitMask
Specifies the mask for luminance bits.dwBumpDuBitMask
Not supported.dwOperations
Not supported.dwGBitMask
Specifies the mask for green bits.dwUBitMask
Not supported.dwZBitMask
Not supported.dwBumpDvBitMask
Not supported.wFlipMSTypes
Not supported.wBltMSTypes
Not supported.dwBBitMask
Specifies the mask for blue bits.dwVBitMask
Not supporteddwStencilBitMask
Not supported.dwBumpLuminanceBitMask
Not supported.dwRGBAlphaBitMask
Specify the masks for alpha channel.dwYUVAlphaBitMask
Specify the masks for alpha channel.dwLuminanceAlphaBitMask
Not supported.dwRGBZBitMask
Not supported.dwYUVZBitMask
Not supported.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Ddraw.h.
See Also
Creating an Off-Screen Surface
Send Feedback on this topic to the authors