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="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8<TITLE>GXWaitDrawDone</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">GXWaitDrawDone</H1> 12<H2>C Specification</H2> 13<DL> 14 <DD> 15<PRE><CODE>#include <revolution/gx.h></CODE></PRE> 16 <DD> 17<PRE><CODE>void GXWaitDrawDone( 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. It will wait (stall) until the <em>DrawDone</em> command set by <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> has been executed. It means all graphics commands sent before this <em>DrawDone</em> command have executed, and the last pixel has written to the frame buffer. You may want to execute some non-graphics operations between executing <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> and <a href="GXWaitDrawDone.html"><code>GXWaitDrawDone</code></a>. But if you simply want to wait and have nothing to execute, you can use <code><a href="GXDrawDone.html">GXDrawDone</a></code>.</P> 25<P>This function is normally used in <em>immediate-mode</em>, see <code><a href="../GfxFIFO/GXSetCPUFifo.html">GXSetCPUFifo</a></code>. In multi-buffer mode, sending the '<em>done</em>' command is separated from polling the '<em>done</em>' status, see <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> and <a href="GXWaitDrawDone.html"><code>GXWaitDrawDone</code></a>.</P> 26<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> 27 28<H2>See Also</H2> 29<P> 30<A href="GXFlush.html"><CODE>GXFlush</CODE></A><br><A href="../../os/Interrupt/intro.html">Interrupts and Callback Functions</A> 31</P> 32<H2>Revision History</H2> 33<p> 342007/09/25 Added information on the sleep status of threads.<br>2006/03/01 Initial version.<br> 35</p> 36<hr><p>CONFIDENTIAL</p></body> 37</HTML>