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 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>API Prefix to Create Display List</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">API Prefixes for Creating Display Lists<img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
12<h2>Description</h2>
13<H3>API to Generate Display List (Command String)</H3>
14<TABLE border="0" width="100%">
15  <TBODY>
16    <TR>
17      <TH width="75">Prefix</TH>
18      <TH>Example</TH>
19      <TH>Command String Format</TH>
20      <TH>Pointer After Command is Generated</TH>
21    </TR>
22    <TR>
23      <TD width="75"><CODE>G3B_</CODE></TD>
24      <TD><CODE><CODE>G3B_Vtx()</CODE>, <CODE>G3B_LoadMtx43()</CODE></CODE></TD>
25      <TD>Uncompressed</TD>
26      <TD>Set pointer ahead</TD>
27    </TR>
28    <TR>
29      <TD width="75"><CODE>G3C_</CODE></TD>
30      <TD><CODE><CODE>G3C_Vtx()</CODE>, <CODE>G3C_LoadMtx43()</CODE></CODE></TD>
31      <TD>Compressed</TD>
32      <TD>Set pointer ahead</TD>
33    </TR>
34    <TR>
35      <TD width="75"><CODE>G3BS_</CODE></TD>
36      <TD><CODE><CODE>G3BS_Vtx()</CODE>, <CODE>G3BS_LoadMtx43()</CODE></CODE></TD>
37      <TD>Uncompressed</TD>
38      <TD>Do not set pointer ahead</TD>
39    </TR>
40    <TR>
41      <TD width="75"><CODE>G3CS_</CODE></TD>
42      <TD><CODE><CODE>G3CS_Vtx()</CODE>, <CODE>G3CS_LoadMtx43()</CODE></CODE></TD>
43      <TD>Compressed</TD>
44      <TD>Do not set pointer ahead</TD>
45    </TR>
46  </TBODY>
47</TABLE>
48<H3>Reference: API to Directly Transfer Command to Geometry FIFO</H3>
49<TABLE border="0" width="100%">
50  <TBODY>
51    <TR>
52      <TH width="75">Prefix</TH>
53      <TH>Example</TH>
54    </TR>
55    <TR>
56      <TD><CODE>G3_</CODE></TD>
57      <TD><CODE><CODE>G3_Vtx()</CODE>, <CODE>G3_LoadMtx43()</CODE></CODE></TD>
58    </TR>
59  </TBODY>
60</TABLE>
61<H2>Description</H2>
62<P>There are four formats for one function for API to generate a display list as shown in the table above. They are distinguished by prefixes. They correspond to four types of situations to generate a display list.</P>
63<H3>Uncompressed Format vs Compressed Format</H3>
64<P>This corresponds to display list formats supported by Nitro hardware. Normally, it is advantageous to use compressed format.</P>
65<UL>
66  <LI>Uncompressed
67  <DL>
68    <DD>Wastes memory.
69    <DD>Processor's generate process is fast.
70  </DL>
71  <LI>Compressed
72  <DL>
73    <DD>Does not waste memory.
74    <DD>In comparison, the generate process is slow. However, as memory access is minimal, it could be fast overall.
75  </DL>
76</UL>
77<H3>Setting Pointer Ahead vs Not Setting Pointer Ahead</H3>
78<P>When generating the command list, keep the current output buffer pointer using the <code>DLInfo</code> structure. This corresponds to whether or not to move this pointer forward to the next output position aftercommand output. Use it according to the rewriting situation.</P>
79<UL>
80  <LI>Advance pointer
81  <DL>
82    <DD>Suitable for generating command list successively
83  </DL>
84  <LI>Do not advance pointer
85  <DL>
86    <DD>Suitable for rewriting a part of command list after it is generated.
87  </DL>
88</UL>
89<H2>See Also</H2>
90<P><code><A href="../../mi/dma/MI_SendGXCommand.html">MI_SendGXCommand*</A></code>, <code><A href="G3_BeginMakeDL.html">G3_BeginMakeDL</A></code>, <code><A href="G3_EndMakeDL.html">G3_EndMakeDL</A></code></P>
91<H2>Revision History</H2>
92<P>2004/03/29 Initial version.</P>
93<hr><p>CONFIDENTIAL</p></body>
94</HTML>
95