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>nngxStopCmdlistSave</title>
8  </head>
9  <body>
10<h1><CODE>nngxStopCmdlistSave</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL void NNGX_APIENTRY nngxStopCmdlistSave(
15     GLuint * bufferoffset,
16     GLsizei * buffersize,
17     GLuint * requestid,
18     GLsizei * requestsize
19);
20</pre>
21    </div>
22<h2>Arguments</h2>
23    <div class="section">
24      <table class="arguments">
25        <thead>
26          <tr>
27            <td width="15" />
28<th>Name</th>
29<td>Description</td>
30          </tr>
31        </thead>
32        <tr>
33<td>out</td>
34<th>bufferoffset</th>
35<td>Offset (in bytes) to the address where you started saving the 3D command buffer</td>
36        </tr>
37        <tr>
38<td>out</td>
39<th>buffersize</th>
40<td>Number of bytes saved in the 3D command buffer</td>
41        </tr>
42        <tr>
43<td>out</td>
44<th>requestid</th>
45<td>ID at which you started saving command requests</td>
46        </tr>
47        <tr>
48<td>out</td>
49<th>requestsize</th>
50<td>Number of command requests saved</td>
51        </tr> </table>
52    </div>
53<h2>Return Values</h2>
54<div class="section">No values are returned. </div>
55<h2>Description</h2>
56    <div class="section">
57<p>Stops saving command list objects.</p><P>
58Stops saving the current command list object. When you stop saving, information is returned as follows: <SPAN class="argument">bufferoffset</SPAN> is the offset (in bytes) to the address at which you started saving the 3D command buffer; <SPAN class="argument">buffersize</SPAN> is the number of bytes saved in the 3D command buffer; <SPAN class="argument">requestid</SPAN> is the ID at which you started saving command requests; and <SPAN class="argument">requestsize</SPAN> is the number of command requests saved. Reuse command lists with this information.
59            </P><P>
60The offset (in bytes) to the address at which saving began is returned in <SPAN class="argument">bufferoffset</SPAN>. Add this offset to the starting address of the 3D command buffer to find the actual address at which the 3D command buffer started being saved. To get the starting address of the 3D command buffer maintained by the command list that is currently bound, call <CODE>nngxGetCmdlistParameteri</CODE> with <SPAN class="argument">pname</SPAN> set to <CODE>NN_GX_CMDLIST_TOP_BUFADDR</CODE>.
61            </P><P>
62Calling this function does not cause a split command to be generated in the 3D command buffer. Call <CODE>nngxSplitDrawCmdlist</CODE> explicitly if a split command is required. Command requests for 3D execution commands may not be saved at all if the 3D command buffer has not been split. If the 3D command buffer does not have any split commands, you must copy it in order to reuse commands.
63            </P><P>
64Calls to this function sometimes cause dummy commands to be generated in the 3D command buffer for padding.
65            </P><P>
66This function generates the following errors.
67<TABLE><TR><TH>GL_ERROR_8036_DMP</TH><TD>Saving the command list has not started.</TD></TR></TABLE></P></div>
68<h2>Revision History</h2>
69    <div class="section">
70      <dl class="history">
71        <dt>2010/03/12</dt>
72<dd>Initial version.<br />
73        </dd>
74      </dl>
75    </div>
76  <hr><p>CONFIDENTIAL</p></body>
77</html>