GM_swapBuffers

Swaps the display buffers for the game

Declaration

void MGLAPI GM_swapBuffers(
MGL_waitVRTFlagType waitVRT)

Prototype In

gm/gm.h

Parameters

waitVRT | Wait for vertical retrace flag

Description

Swaps the display buffers for the Game Framework game. If there are multiple hardware display pages enabled for the game, the waitVRT flag (of MGL_waitVRTFlagType) is used to determine if the MGL should wait for the vertical retrace before swapping display pages or not.

If you started the Game Framework and requested a system memory back buffer, enabled stretching or there was only one hardware display page available, the Game Framework will blit the entire system memory back buffer to the display device context and then perform the hardware page flip.

Note: If you are intentionally using a system memory back buffer, you may want to maintain a set of dirty rectangles for your display pages and call GM_swapDirtyBuffers to swap only the dirty portions of the frames to speed things up. This is most useful for games that don't update large portions of the screen very frequently.

See Also

GM_swapDirtyBuffers, GM_setLeftBuffer, GM_setRightBuffer

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com