1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<TITLE>GXDrawDone</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">GXDrawDone</H1>
12<H2>C Specification</H2>
13<DL>
14  <DD>
15<PRE><CODE>#include &lt;revolution/gx.h&gt;</CODE></PRE>
16  <DD>
17<PRE><CODE>void GXDrawDone( void )</CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<P>None.</P>
21<H2>Return Values</H2>
22<P>None.</P>
23<H2>Description</H2>
24<P>This is a synchronization function that calls <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> and <a href="GXWaitDrawDone.html"><code>GXWaitDrawDone</code></a> 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.&nbsp;This function flushes the write-gather FIFO in the CPU to&nbsp;make sure that all commands are sent to the graphics processor before the stall.</P>
25<P>The net effect is that this function will send a <em>DrawDone </em>command to the Graphics Processor, execute <code><a href="GXFlush.html">GXFlush</a></code>, and wait until it has been executed.</P>
26<P>This function should only be used in <em>immediate-mode</em>, as the command processor will continue to execute commands from the current FIFO.</P>
27<P>This function may put the current thread to sleep. For precautions when calling similar functions, refer to <A href="../../os/Interrupt/intro.html">Interrupts and Callback Functions</A>.</P>
28
29<H2>See Also</H2>
30<P>
31<A href="GXFlush.html"><CODE>GXFlush</CODE></A><br><A href="../../os/Interrupt/intro.html">Interrupts and Callback Functions</A>
32</P>
33
34<H2>Revision History</H2>
35<p>
362007/09/25 Added information on the sleep status of threads.<br>2006/03/01 Initial version.<br>
37</p>
38<hr><p>CONFIDENTIAL</p></body>
39</HTML>