1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="Microsoft FrontPage 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>GXClearPixMetric</title>
10</head>
11
12<body>
13
14<h1 align="left">GXClearPixMetric</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/gx.h&gt;
19
20void GXClearPixMetric( void );
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<p>None.</p>
25
26<h2>Return Values</h2>
27<P>None.</P>
28
29<H2>Description</H2>
30<P>The graphics processor (GP) can count many internal events that give detailed information on performance.&nbsp;The pixel counters count the number of pixels processed in the GP pipeline and the number of clock cycles spent copying the embedded frame buffer (EFB) to textures or external frame buffer (XFB). This function resets the counters to zero. Call the <A href="GXReadPixMetric.html"><CODE>GXReadPixMetric</CODE></A> function to read the current value of the counters.</P>
31
32<H3>Example</H3>
33<DL><DD><CODE>u32 tpi, tpo, bpi bpo, cpi, cc;<BR> <BR> GXClearPixMetric();<BR> <BR> // Render Object(s)</CODE></DD></DL>
34<DL><DD><CODE>// wait until object(s) rendered<BR> GXSetDrawSync(0xbeef);<BR> while (0xbeef != GXReadDrawSync())<BR> &nbsp;&nbsp;&nbsp; ;<BR> <BR> GXReadPixMetric(&amp;tpi, &amp;tpo, &amp;bpi, &amp;bpo, &amp;cpi, &amp;cc);&nbsp;&nbsp; // returns request counter<BR> <BR> OSReport(&quot;Number of copy clocks:&nbsp; %d\n&quot;,cc);</CODE></DD></DL>
35
36<P>This function reads CPU accessible registers in the GP and so should not be called in a display list.</P>
37
38<h2>See Also</h2>
39<P class="reference">
40<a href="GXReadMemMetric.html">GXReadMemMetric</a>,
41<a href="GXClearMemMetric.html">GXClearMemMetric</a>,
42<a href="GXSetVCacheMetric.html">GXSetVCacheMetric</a>,
43<a href="GXReadVCacheMetric.html">GXReadVCacheMetric</a>,
44<a href="GXClearVCacheMetric.html">GXClearVCacheMetric</a>,
45<a href="GXReadGPMetric.html">GXReadGPMetric</a>,
46<a href="GXSetGPMetric.html">GXSetGPMetric</a>,
47<a href="GXClearGPMetric.html">GXClearGPMetric</a>
48</p>
49
50<H2>Revision History</H2>
51<P>
522006/03/01 Initial version.<br>
53</P>
54
55<hr><p>CONFIDENTIAL</p></body>
56</html>