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 13<H2>Syntax</H2> 14<dl><dd><pre class="construction"> 15#include <revolution/gx.h> 16 17inline void GXFastCallDisplayList( const void* list, u32 nbytes ); 18</pre></dd></dl> 19 20<H2>Arguments</H2> 21<TABLE class="arguments" border="1" > 22 <TBODY> 23 <TR> 24<TH>list</TH> 25<TD>Pointer to the display list command. Must be 32-byte aligned.</TD> 26 </TR> 27 <TR> 28<TH>nbytes</TH> 29<TD>Number of bytes in the display list. Must be a multiple of 32.</TD> 30 </TR> 31 </TBODY> 32</TABLE> 33 34<H2>Return Values</H2> 35<P>None.</P> 36 37<H2>Description</H2> 38<P>This function will cause the graphics processor (GP) to execute graphics commands from the display list, <SPAN class="argument">list</SPAN>, instead of from the GP <A href="../list.html#Graphics FIFO">FIFO</A>. When an amount equal to <SPAN class="argument">nbytes</SPAN> (a multiple of 32) has been read, the graphics processor will resume executing commands from the graphics FIFO.</P> 39<P>This command is nearly the same as the <A href="GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A> function; 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> 40<UL> 41 <LI><A href="../Geometry/GXBegin.html"><CODE>GXBegin</CODE></A> / <A href="../Geometry/GXEnd.html"><CODE>GXEnd</CODE></A> 42 <LI><A href="GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A> 43 <LI><CODE><A href="GXBeginDisplayList.html">GXBeginDisplayList</A> / <A href="GXEndDisplayList.html">GXEndDisplayList</A></CODE> 44 <LI><A href="../Management/GXFlush.html"><CODE>GXFlush</CODE></A> 45</UL> 46<P>To learn more about pending GX states, refer to the section on <A href="../GXState.html">GX states</A>.</P> 47<P>The <CODE>GXFastCallDisplayList</CODE> function has all the same additional restrictions as the <A href="GXCallDisplayList.html"><CODE>GXCallDisplayList</CODE></A> function. 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, so any unused memory at the end of a display list should be set to <CODE>GX_NOP</CODE> (zero). If you create a display list using the <A href="GXBeginDisplayList.html"><CODE>GXBeginDisplayList</CODE></A> and <A href="GXEndDisplayList.html"><CODE>GXEndDisplayList</CODE></A> functions, these functions automatically perform padding.</P> 48 49<H2>See Also</H2> 50<P class="reference"> 51<A href="GXCallDisplayList.html">GXCallDisplayList</A> 52</P> 53 54<H2>Revision History</H2> 55<P> 562006/03/01 Initial version.<br> 57</P> 58 59<hr><p>CONFIDENTIAL</p></body> 60</HTML>