FLIP

Syntax

INT = FLIP(OPT bFast=FALSE as INT)

Description

Flips the backbuffer to the frontbuffer to show drawing changes.

Parameters

bFast - Specifies a VSYNC (FALSE) or fast flip (TRUE).

Return value

Returns the current FPS (Frames Per Second) of the flip. The FPS is calculated as your program calls FLIP and can be used for controlling the timing of your game or program.

Remarks

The bFast parameter can be TRUE to flip without waiting for the vertical sync signal or FALSE (default) to specify a normal flipping operation. If FALSE then the maximum FPS your program can achieve is the refresh rate of the monitor. If TRUE then your program will flip as fast as the code will allow but may result in image tearing on some video cards.

In windowed mode the FLIP command uses a blitter operation to copy the contents of the backbuffer to the primary display surface. In a full screen program the back buffer is swapped with the front buffer for an instantaneous update.

Example usage

CREATESCREEN 640,480,32
speed = 0
DO
    FILLSCREEN RGB(0,0,255)
    WRITETEXT 0,0,"FPS =" + STR$(speed) + " : Press ESC to close"
    speed = FLIP( TRUE )
UNTIL KEYDOWN(1)
CLOSESCREEN
END