Export (0) Print
Expand All

IDXSurfaceFactory::BitBlt Method

This topic documents a feature of Visual Filters and Transitions, which is deprecated as of Windows Internet Explorer 9 and obsolete as of Internet Explorer 10.

Copies samples from one DXSurface to another.

Syntax


HRESULT BitBlt(
    IDXSurface *pDest,
    const DXVEC *pPlacement,
    IDXSurface *pSrc,
    const DXBNDS *pClipBounds,
    DWORD dwFlags
);

Parameters

pDest
[in] Pointer to the destination DXSurface.
pPlacement
[in] Pointer to a DXVEC structure that corresponds to the displaced position of the source surface on the destination surface. If this parameter is NULL, the data is placed at the origin of the destination surface.
pSrc
[in] Pointer to the source DXSurface.
pClipBounds
[in] Pointer to a DXBNDS structure that corresponds to the portion of the source surface to copy to the destination. If this parameter is NULL, the entire source surface is copied.
dwFlags
[in] One of the DXBLTOPTIONS used to specify what type of blit operation to perform.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.

Remarks

This method performs all necessary clipping for the specified placement or clipping bounds. If no data is transferred — that is, the clipping results in an empty region — the call returns S_FALSE.

DXBOF_DO_OVER and DXBOF_DITHER are the two valid flags for this method. These flags can be used independently or in combination. If no flags are specified, the data is simply copied from the source to the destination. If the DXBOF_DO_OVER is set, the source data is blended with the destination data by alpha blending. If DXBOF_DITHER is set and the destination's pixel format has fewer bits per pixel of color information than the source, the data is dithered before being copied to or blended with the destination.

The DXBitBlt helper function provided in Dxhelper.h does a faster blit operation than IDXSurfaceFactory::BitBlt, but with no clipping, parameter validation, or error checking.

Coordinates for both clipping and displacement are relative to the upper-left corner of the surfaces.

See Also

DXBLTOPTIONS

Community Additions

ADD
Show:
© 2014 Microsoft