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>GXFastCallDisplayList</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">GXFastCallDisplayList</H1> 12<H2>C Specification</H2> 13<DL> 14 <DD> 15<PRE><CODE>#include <revolution/gx.h></CODE></PRE> 16 <DD> 17<pre><CODE>inline void GXFastCallDisplayList( const void* list, u32 nbytes );</CODE></pre> 18</DL> 19<H2>Arguments</H2> 20<TABLE border="1" cellpadding="3" cellspacing="0.1"> 21 <TBODY> 22 <TR> 23<TD width="120" bgcolor="#ffffe8"><EM><CODE><STRONG>list</STRONG></FONT></EM></TD> 24<TD width="520">pointer to the display list command. <BR>Must be 32-byte aligned.</TD> 25 </TR> 26 <TR> 27<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>nbytes</FONT></STRONG></EM></TD> 28<TD width="520">number of bytes in the display list <BR>Must be in multiples of 32.</TD> 29 </TR> 30 </TBODY> 31</TABLE> 32<H2>Return Values</H2> 33<P>None.</P> 34<H2>Description</H2> 35<P>This function will cause the graphics processor (GP) to execute graphics commands from the display list, <CODE><EM><STRONG>list</STRONG></EM></CODE>, instead of from the GP <a href="../list.html#Graphics FIFO">FIFO</a>. When a value of <CODE><EM><STRONG>nbytes</STRONG></EM></CODE> (a multiple of 32) has been read, the GP will resume executing commands from the graphics FIFO.</P> 36<P>This command is nearly the same as <a href="GXCallDisplayList.html"><code>GXCallDisplayList</code></a>; there are some important differences, however. Primary among them is that this command does not flush any pending GX state before placing the call command into the FIFO. This means that if this function is invoked prior to pending states being flushed, the effect of certain earlier GX calls will not be in place during the execution of the called display list. To be safe, this function should only be called after any pending <a href="../GXState.html">GX state</a> is guaranteed to have been flushed. one of the following actions does so:</P> 37<UL> 38<LI><A href="../Geometry/GXBegin.html"><CODE>GXBegin</CODE></A>/<A href="../Geometry/GXEnd.html"><CODE>GXEnd</CODE></A> 39<LI><A href="GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A> 40<LI><CODE><A href="GXBeginDisplayList.html">GXBeginDisplayList</A>/<A href="GXEndDisplayList.html">GXEndDisplayList</A></CODE> 41<LI><A href="../Management/GXFlush.html"><CODE>GXFlush</CODE></A> 42</UL> 43<P>To learn more about pending GX states, refer to the section on <a href="../GXState.html">GX State</a>.</P> 44<P><CODE>GXFastCallDisplayList</CODE> has all the same additional restrictions as <CODE><A href="GXCallDisplayList.html">GXCallDisplayList</A></CODE>. A display list cannot call another display list. The display list must be padded to a length of 32 bytes. All the data in the display list is interpreted by the graphics processor; any unused memory at the end of a display list should be set to <code>GX_NOP</code> (zero). 45If you create a display list using <code><a href="GXBeginDisplayList.html">GXBeginDisplayList</a>/<a href="GXEndDisplayList.html">GXEndDisplayList</a></code>, padding is done automatically.</P> 46<H2>See Also</H2> 47<P><A href="GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A></P> 48<H2>Revision History</H2> 49<p>2006/03/01 Initial version.</P> 50<hr> 51<P>CONFIDENTIAL</p> 52</BODY> 53</HTML> 54