DDGPE::BltExpanded (Compact 2013)
3/26/2014
This method sets up and performs a GPE blit with any acceleration you have added to your concrete DDGPE class.
Syntax
virtual SCODE BltExpanded(
DDGPESurf* pDst,
DDGPESurf* pSrc,
DDGPESurf* pPattern,
DDGPESurf* pMask,
CLIPOBJ* pco,
XLATEOBJ* pxlo,
CONST RECT* prclDst,
CONST RECT* prclSrc,
ULONG solidColor,
ULONG bltFlags,
ULONG rop4
);
virtual SCODE BltExpanded(
DDGPESurf* pDst,
DDGPESurf* pSrc,
DDGPESurf* pPattern,
CONST RECT* prclDst,
CONST RECT* prclSrc,
ULONG solidColor,
ULONG bltFlags,
ULONG rop4
);
Parameters
- pDst
Pointer to the surface that the blit will modify. This is the destination surface.
- pSrc
Pointer to the surface containing the source data.
- pPattern
Pointer to the surface object containing a pattern to be used in a PATCOPY blit.
- pMask
Optional. A pointer to a surface that provides a mask for the source. The mask is defined by a logic map, which is a bitmap with one bit per pixel (bpp). The mask will always be large enough to contain the relevant source; tiling is unnecessary. This parameter can be used by the hardware blit, or if the current blit is not supported by hardware, it will be passed to the standard GPE blit emulation functions. If no mask is desired, set this parameter to NULL.
- pco
Optional. A pointer to a CLIPOBJ blit that limits the area to be modified in the destination. If the hardware implementation does not support the current blit, this parameter will be passed on to the emulated blit in GPE. If no clipping is required, set this parameter to NULL.
- pxlo
Optional. A pointer to an XLATEOBJ blit that specifies how to translate color indexes between the source and target surfaces. If this parameter is not required for a particular blit, set it to NULL.
- prclDst
Pointer to a rectangle in the destination surface that encloses the area to modify.
- prclSrc
Pointer to the rectangle in the source surface that encloses the bits to use in the blit.
- solidColor
Color to use in solid-fill blit operations.
- bltFlags
Flags for the blit.
- rop4
The raster operation that should be performed.
Return Value
The return value is S_OK, if the function is successful. Otherwise, an error code is returned.
Remarks
Typically, you use this function to execute a GPE blit from your DirectDraw hardware abstraction layer (DDHAL) implementation in your display driver.
Link Library: Ddgpe.lib.
Requirements
Header |
ddgpe.h |
Library |
Ddgpe.lib |