GXWaitDrawDone

C Specification

#include <revolution/gx.h>

void GXWaitDrawDone( void )

Arguments

None.

Return Values

None.

Description

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

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

This function may put the current thread to sleep. For precautions when calling similar functions, refer to Interrupts and Callback Functions.

Revision History

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