GXWaitDrawDone

Syntax

#include <revolution/gx.h>

void GXWaitDrawDone( void )

Arguments

None.

Return Values

None.

Description

This is a synchronization function. This function will wait (stall) until the DrawDone command set by the GXSetDrawDone function has been executed. This means that all graphics commands sent before this DrawDone command have executed and the last pixel has been written to the frame buffer. You might want to execute some non-graphics commands between executing GXSetDrawDone and GXWaitDrawDone. But if you simply want to wait and have nothing to execute, you can use the GXDrawDone function.

This function is normally used in immediate-mode, see the GXSetCPUFifo function. In multi-buffer mode, sending the 'done' command is separated from polling the 'done' status; see the GXSetDrawDone and GXWaitDrawDone functions.

This function sometimes puts the current thread to sleep, so it cannot be called from callback functions. For precautions when calling similar functions, refer to Interrupts and Callback Functions.

See Also

GXFlush
Interrupts and Callback Functions

Revision History

2007/09/25 Added information on the sleep status of threads.
2006/03/01 Initial version.


CONFIDENTIAL