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>nngxUpdateState</title>
8  </head>
9  <body>
10<h1><CODE>nngxUpdateState</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL void NNGX_APIENTRY nngxUpdateState(
15     GLbitfield statemask
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>statemask</th>
32<td>State flags to update (specified as a bitwise OR)</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">No values are returned. </div>
37<h2>Description</h2>
38    <div class="section">
39<p>Updates the specified states.</p><P>
40Updates the DMPGL states. Using this function to update the states will cause a complete command to be generated during validation.
41            </P><P>
42The <CODE>glDrawElements</CODE> and <CODE>glDrawArrays</CODE> functions check the DMPGL state and, if it is updated, generate the relevant commands. Commands are not usually generated if the state has not been updated. If you call this function, the states will be updated, and a complete command will be scheduled for generation. This function does not itself generate commands. Call to a function such as <CODE>glDrawElements</CODE> or <CODE>glDrawArrays</CODE> after this function generates commands.
43            </P><P>
44The state in which a complete command is scheduled to be generated will start when this function is called and will continue until the first call to <CODE>glDrawElements</CODE> or <CODE>glDrawArrays</CODE>. If you call <CODE>nngxValidateState</CODE> before <CODE>glDrawElements</CODE> or <CODE>glDrawArrays</CODE>, the commands for each validated state flag will cease to be generated.
45            </P><P>
46Set <SPAN class="argument">statemask</SPAN> equal to a bitwise OR of the state flags to update.
47            </P><P>
48You can use this function in combination with <CODE>nngxValidateState</CODE> to generate complete commands for each state flag.
49            </P><P>
50This function will not generate any errors.
51            </P></div>
52<h2>Revision History</h2>
53    <div class="section">
54      <dl class="history">
55        <dt>2010/03/12</dt>
56<dd>Initial version.<br />
57        </dd>
58      </dl>
59    </div>
60  <hr><p>CONFIDENTIAL</p></body>
61</html>