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>nngxAdd3DCommandNoCacheFlush</title>
8  </head>
9  <body>
10<h1><CODE>nngxAdd3DCommandNoCacheFlush</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL void NNGX_APIENTRY nngxAdd3DCommandNoCacheFlush(
15     const GLvoid * bufferaddr,
16     GLsizei buffersize
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>bufferaddr</th>
33<td>Pointer to the data region where the 3D commands to add are located.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>buffersize</th>
38<td>Size (in bytes) of the 3D commands to add.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">No values are returned. </div>
43<h2>Description</h2>
44    <div class="section">
45<p>Adds the data (3D commands) in the specified region to the current 3D command buffer.</p><P>
46This function performs the same operations as the the <CODE>nngxAdd3DCommand</CODE> function when <CODE>GL_FALSE</CODE> is specified in <SPAN class="argument">copycmd</SPAN>, except that this function does not flush the cache of the region specified by <SPAN class="argument">bufferaddr</SPAN>. This function assumes that 1) <CODE>nngxAdd3DCommand</CODE> has already been called once for this region, or 2) <CODE>nngxUpdateBuffer</CODE> has been explicitly called, or 3) flushing has been made unnecessary in some other way. Operation is not guaranteed if this function is used when this assumption is not true.
47            </P><P>
48A render command request is generated with the region specified by <SPAN class="argument">bufferaddr</SPAN> as its execution address and then added to the current command requests. Set <SPAN class="argument">buffersize</SPAN> equal to the number of bytes in the 3D command buffer to execute. If unsplit 3D commands have accumulated in the current 3D command buffer, this function calls the <CODE>nngxSplitDrawCmdlist</CODE> function and then adds the newly generated render command request. Behavior is not guaranteed if the last command in the specified region is not a split command.
49            </P><P>
50The <SPAN class="argument">buffersize</SPAN> argument must be a positive multiple of 16. The <SPAN class="argument">bufferaddr</SPAN> argument must be a multiple of 16.
51            </P><P>
52This function generates the following errors.
53<TABLE><TR><TH><CODE>GL_ERROR_808C_DMP</CODE></TH><TD>No command list is currently bound.</TD></TR><TR><TH><CODE>GL_ERROR_808D_DMP</CODE></TH><TD>Value specified for <SPAN class="argument">buffersize</SPAN> is either 0, or not a multiple of 16.</TD></TR><TR><TH><CODE>GL_ERROR_808E_DMP</CODE></TH><TD>The <SPAN class="argument">bufferaddr</SPAN> argument is not a multiple of 16.</TD></TR><TR><TH><CODE>GL_ERROR_808F_DMP</CODE></TH><TD>The size is insufficient for the current command requests.</TD></TR></TABLE></P></div>
54<h2>See Also</h2>
55    <div class="section">
56<p class="reference"><a href="../nn_gx/nngxAdd3DCommand.html"><CODE>nngxAdd3DCommand</CODE></a><br /> </p>
57    </div>
58<h2>Revision History</h2>
59    <div class="section">
60      <dl class="history">
61        <dt>2011/03/18</dt>
62<dd>Initial version.<br />
63        </dd>
64      </dl>
65    </div>
66  <hr><p>CONFIDENTIAL</p></body>
67</html>