Microsoft SDK for Java

bltFast

This method of the DirectDrawSurface Class performs a source copy blit or transparent blit by using a source color key or destination color key. This method always attempts an asynchronous blit if it is supported by the hardware.

Syntax

public int bltFast(int dx, int dy, DirectDrawSurface ddS, Rect src, int trans);

Return Value

Returns S_OK or 0 if the operation is successful; otherwise, returns an error code.

Parameters

dx  
dy The x and y-coordinates to blit to on the destination surface.
ddS The DirectDrawSurface object that is the source for the blit operation.
src The Rect object that defines the upper-left and lower-right points of the rectangle on the source surface to be blitted from.
trans One value of DDBLTFAST_ type, specifying the type of transfer.

Remarks

This method works only on display memory surfaces and cannot clip when blitting. The software implementation of bltFast is 10 percent faster than the blt method. However, there is no speed difference between the two if display hardware is being used.

Typically, bltFast returns immediately with an error if the blitter is busy and the blit cannot be set up. You can use the DDBLTFAST_WAIT flag, however, if you want this method to not return until either the blit can be set up or another error occurs.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.