1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../css/manpage.css" type="text/css" />
7<title>nngxStartCmdlistSave</title>
8  </head>
9  <body>
10<h1><CODE>nngxStartCmdlistSave</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL void NNGX_APIENTRY nngxStartCmdlistSave(
15     void
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21<p>None.</p>
22    </div>
23<h2>Return Values</h2>
24<div class="section">No values are returned. </div>
25<h2>Description</h2>
26    <div class="section">
27<p>Starts saving command list objects.</p><P>
28Starts saving the current command list object.
29            </P><P>
30Use <CODE>nngxStopCmdlistSave</CODE> to get the saved information. It is assumed that saved commands will be reused. Because there is no way of knowing what the PICA register values will be when the 3D command buffer is reused, you must save all commands that will need to be reset at that time. If you save commands and then call functions as usual to generate commands, only the commands that are different from the saved commands will be generated. Because only differing commands are generated, it follows that the generated commands correspond only to states whose settings have changed. This means that sometimes not all necessary commands are generated. To generate all of the necessary commands, either use complete commands or configure the command output mode.
31            </P><P>
32<I>Complete commands</I> refers to generating the entire set of commands for each state. Complete commands can result in excessive command generation because it generates all commands for each feature.
33            </P><P>
34You can configure the command output mode to always generate commands related to functions that have been called, regardless of whether their settings changed.
35            </P><P>
36This combination of features allows you to generate and save the appropriate commands as necessary and sufficient.
37            </P><P>
38Calls to this function sometimes cause dummy commands to be generated in the 3D command buffer for padding.
39            </P><P>
40This function generates the following errors.
41<TABLE><TR><TH>GL_ERROR_8034_DMP</TH><TD>This function was called again before the previous call to this function finished saving the command list.</TD></TR><TR><TH>GL_ERROR_8035_DMP</TH><TD>0 is bound to the current command list.</TD></TR></TABLE></P></div>
42<h2>Revision History</h2>
43    <div class="section">
44      <dl class="history">
45        <dt>2010/03/12</dt>
46<dd>Initial version.<br />
47        </dd>
48      </dl>
49    </div>
50  <hr><p>CONFIDENTIAL</p></body>
51</html>