GXDrawDone

C Specification

#include <revolution/gx.h>
void GXDrawDone( void )

Arguments

None.

Return Values

None.

Description

This is a synchronization function that calls GXSetDrawDone and GXWaitDrawDone in succession. As a result, it will wait (stall) until all graphics commands have executed, and the last pixel has written to the frame buffer. This function flushes the write-gather FIFO in the CPU to make sure that all commands are sent to the graphics processor before the stall.

The net effect is that this function will send a DrawDone command to the Graphics Processor, execute GXFlush, and wait until it has been executed.

This function should only be used in immediate-mode, as the command processor will continue to execute commands from the current FIFO.

This function may put the current thread to sleep. 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