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>nngxStartProfiling</title>
8  </head>
9  <body>
10<h1><CODE>nngxStartProfiling</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14NNGX_APICALL void NNGX_APIENTRY nngxStartProfiling(
15     GLenum item
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><CODE>item</CODE></th>
32<td>Profiling functionality</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>Starts sampling profile information.</p><p>
40Starts the profiling functionality specified in <CODE>item</CODE>.
41            </p><p>
42You can set the following values in <CODE>item</CODE>.
43<TABLE><TR><TH><CODE>NN_GX_PROFILING_BUSY</CODE></TH><TD>
44Starts incrementing the busy counter. Execution stops when the amount of time (measurement interval * sampling count) set in the <CODE><a href="../nn_gx/nngxSetProfilingParameter.html">nngxSetProfilingParameter</a></CODE> function has elapsed or when the <CODE><a href="../nn_gx/nngxStopProfiling.html">nngxStopProfiling</a></CODE> function is called. When the sampling count is <CODE>0</CODE>, execution does not stop until the <a href="../nn_gx/nngxStopProfiling.html"><CODE>nngxStopProfiling</CODE></a> function is called. Operation is undefined when starting profiling without configuring the relevant parameters by calling the <a href="../nn_gx/nngxSetProfilingParameter.html"><CODE>nngxSetProfilingParameter</CODE></a> function. Be sure to configure the parameters with appropriate values before starting.
45</TD></TR><TR><TH><CODE>NN_GX_PROFILING_VERTEX_CACHE</CODE></TH><TD>
46Starts the vertex cache input vertex count counter. Execution stops when the <a href="../nn_gx/nngxStopProfiling.html"><CODE>nngxStopProfiling</CODE></a> function is called. Power consumption may rise when this feature starts. Always stop execution if this feature is not going to be used.
47                    </TD></TR></TABLE></p><p>
48Some profiling items require the specification of start and stop times for the sampling of profiling information. If a profile item is not listed in the above table, the counter runs continuously for that item. The results of profiling can be obtained even if sampling is not explicitly started using this function.
49            </p><p>
50If the vertex cache input count counter is not started using this function, you can still obtain a profiling result as if the counter were running, but the value may not be correct. Always start the counter by calling this function to get the correct profiling results.
51            </p><p>
52Do not call this function while the GPU is executing (executing a command list). Although errors will not occur if called during GPU execution, the GPU may perform illegal operations.
53            </p><p>
54This function generates the following errors.
55<TABLE><TR><TH><CODE>GL_ERROR_80A2_DMP</CODE></TH><TD>An illegal value was specified in <CODE>item</CODE>.</TD></TR></TABLE></p></div>
56<h2>See Also</h2>
57    <div class="section">
58<p class="reference"><a href="../nn_gx/nngxStopProfiling.html"><CODE>nngxStopProfiling</CODE></a><br /> </p>
59    </div>
60<h2>Revision History</h2>
61    <div class="section">
62      <dl class="history">
63        <dt>2011/08/24</dt>
64<dd>Added explanation that parameters must be configured before starting the busy counter.<br />
65        </dd>
66        <dt>2011/07/28</dt>
67<dd>Initial version.<br />
68        </dd>
69      </dl>
70    </div>
71  <hr><p>CONFIDENTIAL</p></body>
72</html>