| GrayDBufToggleSync | Function (Macro)

gray.h

void GrayDBufToggleSync (void);

Synchronizes and toggles the currently visible double buffer.

GrayDBufToggleSync waits until the next plane switch occurs (using GrayWaitNSwitches) and calls GrayDBufToggle. Due to grayscale routine implementation differences, the order of the synchronizing and switching depends on the hardware version. On HW1, the toggles are effective only after a plane switch, so GrayDBufToggleSync toggles first and waits for synchronization afterwards so as to keep you from writing into the "hidden" planes before they are actually hidden. On HW2 and higher, GrayDBufToggleSync waits for synchronization before toggling. This way you can make sure that the switch is not performed during an update of the screen, which would cause unwanted distortion effects.

See also: GrayDBufToggle, GrayDBufSetActiveIdxSync, GrayDBufSetActiveIdx