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 http-equiv="Content-Style-Type" content="text/css"> 6<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 7<title>GXSetDrawDone</title> 8</head> 9<body> 10<h1 align="left">GXSetDrawDone</h1> 11<h2>C Specification</h2> 12<dl> 13<dd><PRE><CODE>#include <revolution/gx.h></CODE></PRE> 14 </dd> 15<dd><pre><CODE>void GXSetDrawDone( void )</CODE></pre> 16 </dd> 17</dl> 18 19<h2>Arguments</h2> 20<p>None</p> 21 22<h2>Return Values</h2> 23<p>None</p> 24<H2>Description</H2> 25<P>This is part of a synchronization function. <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> will send a <em>DrawDone</em> command down the graphics processor's pipeline. When all previous commands have been processed and the pipeline is empty, a <em>DrawDone</em> status bit will be set, and an interrupt will occur. You can receive notification of this event by installing a callback on the interrupt with <code><a href="GXSetDrawDoneCallback.html">GXSetDrawDoneCallback</a></code>, or you can poll the status bit with <a href="GXWaitDrawDone.html"><code>GXWaitDrawDone</code></a>. <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> flushes the write-gather FIFO in the CPU to make sure that all commands are sent to the graphics processor.</P> 26<P>This function is normally used in <em>multibuffer-mode</em>, see <code><a href="../GfxFIFO/GXSetCPUFifo.html">GXSetCPUFifo</a></code>. In <em>immediate-mode</em>, the <a href="GXDrawDone.html"><code>GXDrawDone</code></a> command can be used, which both sends the command and passes time until the <em>DrawDone</em> status is true.</P> 27<P><B>Note:</B> Once the interrupt has fired, command processing will continue. In <em>immediate-mode</em>, this is not an issue since there should be no further commands in the FIFO. However, in <em>multi-buffer</em> mode, you may need to place a breakpoint after calling <a href="GXSetDrawDone.html"><code>GXSetDrawDone</code></a> to ensure that commands for subsequent frames are not executed.</P> 28<h2>See Also</h2> 29<p><a href="GXFlush.html"><CODE>GXFlush</CODE></a></p> 30<H2>Revision History</H2> 31<P>03/01/2006 Initial version.</P> 32</BODY> 33</HTML>