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 8.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>G3_BeginMakeDL</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">G3_BeginMakeDL <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;nitro/gx/g3.h&gt;<BR>
16void G3_BeginMakeDL(<A href="../gx/GXDLInfo.html">GXDLInfo</A>* info, void* ptr, u32 length);</CODE></PRE>
17</DL>
18<H2>Arguments</H2>
19<TABLE border="1" width="100%">
20  <TBODY>
21    <TR>
22      <TD width="208"><EM><STRONG><FONT face="Courier New">info</FONT></STRONG></EM></TD>
23      <TD width="945">Pointer to <code><A href="../gx/GXDLInfo.html">GXDLInfo</A></code> structure</TD>
24    </TR>
25    <TR>
26      <TD><EM><STRONG><FONT face="Courier New">ptr</FONT></STRONG></EM></TD>
27      <TD>Pointer to buffer where display list is stored</TD>
28    </TR>
29    <TR>
30      <TD><EM><STRONG><FONT face="Courier New">length</FONT></STRONG></EM></TD>
31      <TD>Size of buffer where display list is stored (in bytes)</TD>
32    </TR>
33  </TBODY>
34</TABLE>
35<H2>Return Values</H2>
36<P>None.</P>
37<H2>Description</H2>
38<P>This function is called before creating the display list (command list) and sets up the <code>GXDLInfo</code> structure. Data from <em><strong><code>ptr</code></strong></em> is stored in order. The buffer must be 4-byte aligned. The display list is created by calling either a <code>G3B_xxxxx</code> (commands are not packed) or <code>G3C_xxxxx</code> (commands are packed) function.</P>
39<P>When linked to the DEBUG version of the library, each display list creation function verifies whether the size of the display list exceeds the size specified by <em><strong><code>length</code></strong></em>. If the size is exceeded, a debug message is output. In both the RELEASE and FINALROM versions of the library, this verification is not performed and the <em><strong><code>length</code></strong></em> setting is ignored.</P>
40<H2>See Also</H2>
41<P><A href="G3_EndMakeDL.html"><CODE>G3_EndMakeDL</code></A>, <CODE><A href="../../mi/dma/MI_SendGXCommand.html">MI_SendGXCommand</A></CODE></P>
42<H2>Revision History</H2>
43<P>2004/01/19 Initial version.</P>
44<hr><p>CONFIDENTIAL</p></body>
45</HTML>
46