 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The DDBLTFXstructure passes raster operations, effects, and override information to the IDirectDrawSurface5::Bltmethod.
typedef struct _DDBLTFX{ DWORD
dwSize
;
DWORD
dwDDFX
;
DWORD
dwROP
;
DWORD
dwDDROP
;
DWORD
dwRotationAngle
;
DWORD
dwZBufferOpCode
;
DWORD
dwZBufferLow
;
DWORD
dwZBufferHigh
;
DWORD
dwZBufferBaseDest
;
DWORD
dwZDestConstBitDepth
;
union
{
DWORD
dwZDestConst
;
LPDIRECTDRAWSURFACE
lpDDSZBufferDest
;
} DUMMYUNIONNAMEN(1);
DWORD
dwZSrcConstBitDepth
;
union
{
DWORD
dwZSrcConst
;
LPDIRECTDRAWSURFACE
lpDDSZBufferSrc
;
} DUMMYUNIONNAMEN(2);
DWORD
dwAlphaEdgeBlendBitDepth
;
DWORD
dwAlphaEdgeBlend
;
DWORD
dwReserved
;
DWORD
dwAlphaDestConstBitDepth
;
union
{
DWORD
dwAlphaDestConst
;
LPDIRECTDRAWSURFACE
lpDDSAlphaDest
;
} DUMMYUNIONNAMEN(3);
DWORD dwAlphaSrcConstBitDepth;
union
{
DWORD
dwAlphaSrcConst
;
LPDIRECTDRAWSURFACE
lpDDSAlphaSrc
;
} DUMMYUNIONNAMEN(4);
union
{
DWORD
dwFillColor
;
DWORD
dwFillDepth
;
DWORD
dwFillPixel
;
LPDIRECTDRAWSURFACE
lpDDSPattern
;
} DUMMYUNIONNAMEN(5);
DDCOLORKEY
ddckDestColorkey
;
DDCOLORKEY
ddckSrcColorkey
;
} DDBLTFX,FAR* LPDDBLTFX;
Members
- dwSize
- Size of the structure, in bytes. This member must be initialized before the structure is used.
- dwDDFX
- Type of FX operations.
DDBLTFX_ARITHSTRETCHY Uses arithmetic stretching along the y-axis for this blit. DDBLTFX_MIRRORLEFTRIGHT Turns the surface on its y-axis. This blit mirrors the surface from left to right. DDBLTFX_MIRRORUPDOWN Turns the surface on its x-axis. This blit mirrors the surface from top to bottom. DDBLTFX_NOTEARING Schedules this blit to avoid tearing. DDBLTFX_ROTATE180 Rotates the surface 180 degrees clockwise during this blit. DDBLTFX_ROTATE270 Rotates the surface 270 degrees clockwise during this blit. DDBLTFX_ROTATE90 Rotates the surface 90 degrees clockwise during this blit. DDBLTFX_ZBUFFERBASEDEST Adds the dwZBufferBaseDestmember to each of the source Z-values before comparing them with the destination Z-values during this Z-blit. DDBLTFX_ZBUFFERRANGE Uses the dwZBufferLowand dwZBufferHighmembers as range values to specify limits to the bits copied from a source surface during this Z-blit. - dwROP
- Win32 raster operations. You can retrieve a list of supported raster operations by calling the IDirectDraw4::GetCapsmethod.
- dwDDROP
- DirectDraw raster operations.
- dwRotationAngle
- Rotation angle for the blit.
- dwZBufferOpCode
- Z-buffer compares.
- dwZBufferLow
- Low limit of a Z-buffer.
- dwZBufferHigh
- High limit of a Z-buffer.
- dwZBufferBaseDest
- Destination base value of a Z-buffer.
- dwZDestConstBitDepth
- Bit depth of the destination Z-constant.
- dwZDestConst
- Constant used as the Z-buffer destination.
- lpDDSZBufferDest
- Surface used as the Z-buffer destination.
- dwZSrcConstBitDepth
- Bit depth of the source Z-constant.
- dwZSrcConst
- Constant used as the Z-buffer source.
- lpDDSZBufferSrc
- Surface used as the Z-buffer source.
- dwAlphaEdgeBlendBitDepth
- Bit depth of the constant for an alpha edge blend.
- dwAlphaEdgeBlend
- Alpha constant used for edge blending.
- dwReserved
- Reserved for future use.
- dwAlphaDestConstBitDepth
- Bit depth of the destination alpha constant.
- dwAlphaDestConst
- Constant used as the alpha channel destination.
- lpDDSAlphaDest
- Surface used as the alpha channel destination.
- dwAlphaSrcConstBitDepth
- Bit depth of the source alpha constant.
- dwAlphaSrcConst
- Constant used as the alpha channel source.
- lpDDSAlphaSrc
- Surface used as the alpha channel source.
- dwFillColor
- Color used to fill a surface when DDBLT_COLORFILL is specified. This value must be a pixel appropriate to the pixel format of the destination surface. For a palletized surface it would be a palette index, and for a 16-bit RGB surface it would be a 16-bit pixel value.
- dwFillDepth
- Depth value for the Z-buffer.
- dwFillPixel
- Pixel value for RGBA or RGBZ fills. Applications that use RGBZ fills should use this member, not dwFillColoror dwFillDepth.
- lpDDSPattern
- Surface to use as a pattern. The pattern can be used in certain blit operations that combine a source and a destination.
- ddckDestColorkey
- Destination color key override.
- ddckSrcColorkey
- Source color key override.
Remarks
The unions in this structure have been updated to work with compilers that don't support nameless unions. If your compiler doesn't support nameless unions, define the NONAMELESSUNION token before including the Ddraw.h header file.
Requirements
Runs on Versions Declared in Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. ddraw.h