The DDBLTBATCH structure passes blit operations to the IDirectDrawSurface3::BltBatch method.
typedef struct _DDBLTBATCH{
LPRECT lprDest;
LPDIRECTDRAWSURFACE lpDDSSrc;
LPRECT lprSrc;
DWORD dwFlags;
LPDDBLTFX lpDDBltFx;
} DDBLTBATCH,FAR *LPDDBLTBATCH;
Members
lprDest
Address of a RECT structure that defines the destination for the blit.
lpDDSSrc
Address of a DirectDrawSurface object that will be the source of the blit.
lprSrc
Address of a RECT structure that defines the source rectangle of the blit.
dwFlags
Optional control flags.
| DDBLT_ALPHADEST | ||
| Uses either the alpha information in pixel format or the alpha channel surface attached to the destination surface as the alpha channel for this blit. | ||
| DDBLT_ALPHADESTCONSTOVERRIDE | ||
| Uses the dwAlphaDestConst member of the DDBLTFX structure as the alpha channel for the destination surface for this blit. | ||
| DDBLT_ALPHADESTNEG | ||
| Indicates that the destination surface becomes more transparent as the alpha value increases (0 is opaque). | ||
| DDBLT_ALPHADESTSURFACEOVERRIDE | ||
| Uses the lpDDSAlphaDest member of the DDBLTFX structure as the alpha channel for the destination surface for this blit. | ||
| DDBLT_ALPHAEDGEBLEND | ||
| Uses the dwAlphaEdgeBlend member of the DDBLTFX structure as the alpha channel for the edges of the image that border the color key colors. | ||
| DDBLT_ALPHASRC | ||
| Uses either the alpha information in pixel format or the alpha channel surface attached to the source surface as the alpha channel for this blit. | ||
| DDBLT_ALPHASRCCONSTOVERRIDE | ||
| Uses the dwAlphaSrcConst member of the DDBLTFX structure as the source alpha channel for this blit. | ||
| DDBLT_ALPHASRCNEG | ||
| Indicates that the source surface becomes more transparent as the alpha value increases (0 is opaque). | ||
| DDBLT_ALPHASRCSURFACEOVERRIDE | ||
| Uses the lpDDSAlphaSrc member of the DDBLTFX structure as the alpha channel source for this blit. | ||
| DDBLT_ASYNC | ||
| Processes this blit asynchronously through the FIFO hardware in the order received. If there is no room in the FIFO hardware, the call fails. | ||
| DDBLT_COLORFILL | ||
| Uses the dwFillColor member of the DDBLTFX structure as the RGB color that fills the destination rectangle on the destination surface. | ||
| DDBLT_DDFX | ||
| Uses the dwDDFX member of the DDBLTFX structure to specify the effects to be used for this blit. | ||
| DDBLT_DDROPS | ||
| Uses the dwDDROPS member of the DDBLTFX structure to specify the raster operations (ROPs) that are not part of the Win32 API. | ||
| DDBLT_KEYDEST | ||
| Uses the color key associated with the destination surface. | ||
| DDBLT_KEYDESTOVERRIDE | ||
| Uses the dckDestColorkey member of the DDBLTFX structure as the color key for the destination surface. | ||
| DDBLT_KEYSRC | ||
| Uses the color key associated with the source surface. | ||
| DDBLT_KEYSRCOVERRIDE | ||
| Uses the dckSrcColorkey member of the DDBLTFX structure as the color key for the source surface. | ||
| DDBLT_ROP | ||
| Uses the dwROP member of the DDBLTFX structure for the ROP for this blit. The ROPs are the same as those defined in the Win32 API. | ||
| DDBLT_ROTATIONANGLE | ||
| Uses the dwRotationAngle member of the DDBLTFX structure as the rotation angle (specified in 1/100th of a degree) for the surface. | ||
| DDBLT_ZBUFFER | ||
| Performs a z-buffered blit using the z-buffers attached to the source and destination surfaces and the dwZBufferOpCode member of the DDBLTFX structure as the z-buffer opcode. | ||
| DDBLT_ZBUFFERDESTCONSTOVERRIDE | ||
| Performs a z-buffered blit using the dwZDestConst and dwZBufferOpCode members of the DDBLTFX structure as the z-buffer and z-buffer opcode, respectively, for the destination. | ||
| DDBLT_ZBUFFERDESTOVERRIDE | ||
| Performs a z-buffered blit using the lpDDSZBufferDest and dwZBufferOpCode members of the DDBLTFX structure as the z-buffer and z-buffer opcode, respectively, for the destination. | ||
| DDBLT_ZBUFFERSRCCONSTOVERRIDE | ||
| Performs a z-buffered blit using the dwZSrcConst and dwZBufferOpCode members of the DDBLTFX structure as the z-buffer and z-buffer opcode, respectively, for the source. | ||
| DDBLT_ZBUFFERSRCOVERRIDE | ||
| A z-buffered blit using the lpDDSZBufferSrc and dwZBufferOpCode members of the DDBLTFX structure as the z-buffer and z-buffer opcode, respectively, for the source. | ||
lpDDBltFx
Address of a DDBLTFX structure specifying additional blit effects.
QuickInfo
Windows NT: Use version 4.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in ddraw.h.