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>nngxSetGasAutoAccumulationUpdate</title>
8  </head>
9  <body>
10<h1><CODE>nngxSetGasAutoAccumulationUpdate</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL void NNGX_APIENTRY nngxSetGasAutoAccumulationUpdate(
15     GLint id
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th>id</th>
32<td>ID of the command request for the interrupt handler to update.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">There is no return value. </div>
37<h2>Description</h2>
38    <div class="section">
39<p>Updates the additive blending results from gas density rendering.</p><P>
40Updates the <CODE>INVERTED_ACC_MAX1</CODE> value related to additive blending results from gas density rendering. For more details on <CODE>INVERTED_ACC_MAX1</CODE>, see the DMPGL 2.0 Specifications.
41</P><P>The <CODE>nngxSetGasAutoAccumulationUpdate</CODE> function first determines the maximum value of D1, which is a result of additive blending when gas density information is rendered. Upon completion of the <SPAN class="argument">id</SPAN>th command request in the bound command-list object, the interrupt handler that is invoked applies the maximum value to <CODE>INVERTED_ACC_MAX1</CODE>.
42</P><P>For example, when <SPAN class="argument">id</SPAN> is <CODE>1</CODE> this setting affects the first command request, when <SPAN class="argument">id</SPAN> is <CODE>2</CODE> this setting affects the second command request, and so on. You must specify a command request that is a 3D execution command.
43</P><P>This function is required to implement the functionality of the fragment shader uniform <CODE>dmp_Gas.autoAcc</CODE> using commands generated by the application. You must clear the maximum value saved for the additive blending result D1 to 0 before you start rendering gas density information. The maximum value is cleared (initialized) with bits [15:0] of register <CODE>0x125</CODE>. After rendering the gas density information and before you start gas shading, call this function again to update <CODE>INVERTED_ACC_MAX1</CODE>.
44</P><P><CODE>INVERTED_ACC_MAX1</CODE> is updated correctly when this function is called by a command request that includes a command to render gas density information. However, note that it is impossible to update <CODE>INVERTED_ACC_MAX1</CODE> before gas shading when this function is called by a command request that includes both a command to render gas density information <I>and</I> a command to start gas shading. If a value is written to bits [15:0] of register <CODE>0x0e5</CODE> after this function has updated <CODE>INVERTED_ACC_MAX1</CODE>, this function's settings are overwritten and invalidated.
45            </P><P>
46You can perform settings specific to the updating of additive blend result for gas density information rendering in the <CODE>nngxSetCmdlistParameteri</CODE> function. For more information, see the description of <CODE>NN_GX_CMDLIST_GAS_UPDATE</CODE> in the <CODE>nngxSetCmdlistParameteri</CODE> function.
47            </P><P>
48The following errors occur with this function.
49<TABLE><TR><TH>GL_ERROR_806D_DMP</TH><TD><CODE>0</CODE> is bound to the command list object.</TD></TR><TR><TH>GL_ERROR_806E_DMP</TH><TD>The <SPAN class="argument">id</SPAN> value is invalid (due to the following reasons).
50<UL><LI>The value is 0 or less.</LI><LI>The value specified is greater than the number of accumulated command requests.</LI><LI>The specified command request is not a 3D execution command.</LI></UL></TD></TR></TABLE></P></div>
51<h2>See Also</h2>
52    <div class="section">
53<p class="reference"><a href="../nn_gx/nngxSetCmdlistParameteri.html"><CODE>nngxSetCmdlistParameteri</CODE></a><br /> </p>
54    </div>
55<h2>Revision History</h2>
56    <div class="section">
57      <dl class="history">
58        <dt>2011/02/01</dt>
59<dd>Added information about the <CODE>NN_GX_CMDLIST_GAS_UPDATE</CODE> pname in the <CODE>nngxSetCmdlistParameteri</CODE> function.<br />
60        </dd>
61        <dt>2010/09/15</dt>
62<dd>Initial version.<br />
63        </dd>
64      </dl>
65    </div>
66  <hr><p>CONFIDENTIAL</p></body>
67</html>
68