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>Command request ID for specifying the interrupt handler for updates.</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> 40 Updates the <CODE>INVERTED_ACC_MAX1</CODE> value related to accumulation blending results from gas density rendering. For more details on <CODE>INVERTED_ACC_MAX1</CODE>, see the DMPGL 2.0 Specifications. 41 </P><P>When called, the <CODE>nngxSetGasAutoAccumulationUpdate</CODE> function configures the maximum value of D1—a result of additive blending when gas density information is rendered—to be applied to <CODE>INVERTED_ACC_MAX1</CODE> within the interrupt handler that is invoked upon completion of the <SPAN class="argument">id</SPAN>th command request accumulated in the bound command list object. 42 </P><P>For example, when <SPAN class="argument">id</SPAN> is 1 this setting affects the first command request, when <SPAN class="argument">id</SPAN> is 2 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 as necessary 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, use this function again to update <CODE>INVERTED_ACC_MAX1</CODE> before you start gas shading. 44 </P><P><CODE>INVERTED_ACC_MAX1</CODE> is updated correctly when this function is called on 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 on a command request that includes both a command to render gas density information and 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> 46 The following errors occur in this function. 47 <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). 48 <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> 49 <h2>Revision History</h2> 50 <div class="section"> 51 <dl class="history"> 52 <dt>2010/09/15</dt> 53 <dd>Initial version.<br /> 54 </dd> 55 </dl> 56 </div> 57 <hr><p>CONFIDENTIAL</p></body> 58</html>