public:
     virtual bool __fastcall BltFast( dword pX, dword pY, TDx_DrawSurface* pSrcSurface, TRect* pSrcRect, dword pTrans );

• Description
• Parameters
• See Also

If you would like to submit additions or improvements to this page, click: admin@bcb-tools.com.

The TDx_DrawSurface::BltFast method can perform source copy or color keyed blits.

The blit will always be unclipped and only works for display memory surfaces. A 10% speed benefit is gained by using this method but only when there is no hardware blitter.
An asychronous blit will be attempted if supported by the hardware, with the method returning immediately unless DDBLTFAST_WAIT is specified.

If the method call fails, the OnError event will be triggered with one of the following values:
DDERR_EXCEPTION
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOBLTHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

X
The X parameter defines the destination surface X coordinate for the blit.

Y
The Y parameter defines the destination surface Y coordinate for the blit.

SrcSurface
The SrcSurface parameter references the source surface to be blitted from.

SrcRect
The SrcRect parameter references a TRect defining the source rectangle to be blitted from.
Set this parameter to NULL to blit from the whole source surface.

Trans
The Trans parameter defines flags indicating the type of blit to be performed.
The described effect applies when the flag is set.

DDBLTFAST_DESTCOLORKEY
The blit is to be performed using the destination color key.

DDBLTFAST_NOCOLORKEY
The blit is a normal copy blit.

DDBLTFAST_SRCCOLORKEY
The blit is to be performed using the source color key.

DDBLTFAST_WAIT
The blit will wait until it can be set up or an error other than DDERR_WASSTILLDRAWING occurs.

TDx_DrawSurface
TDx_DrawSurface::OnSurfaceLost()