DirectX SDK

DDBLTBATCH

The DDBLTBATCH structure passes bilt block transfer (blit) operations to the IDirectDrawSurface7::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 to be the source of the blit.

lprSrc

Address of a RECT structure that defines the source rectangle of the blit.

dwFlags

Optional control flags. The following values are defined:

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: 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: 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 first in, first out (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 dwDDROP 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 ddckDestColorkey 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 ddckSrcColorkey 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/100s 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: Performs 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.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.