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
17<h2>C Specification</h2>
18
19<dl>
20<dd><PRE><CODE>#include &lt;revolution/gx.h&gt;</CODE></PRE>
21  </dd>
22<dd><pre><CODE>void GXClearPixMetric( void );</CODE></pre>
23  </dd>
24</dl>
25
26<h2>Arguments</h2>
27
28<p>None</p>
29
30<h2>Return Values</h2>
31<P>None</P>
32<H2>Description</H2>
33<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 clocks spent copying the Embedded Frame Buffer (EFB) to textures or eXternal Frame Buffer (XFB). This function resets the counters to zero. Call <a href="GXReadPixMetric.html"><code>GXReadPixMetric</code></a> to read the current value of the counters.</P>
34<H3>Example</H3>
35<P><code><font size="3">u32 tpi, tpo, bpi, bpo, cpi, cc;<br> <br> GXClearPixMetric();<br> <br> // Draw Object(s)</font></code></P>
36<P><code><font size="3">// wait until object drawn<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);</font></code></P>
37<P> </P>
38<P>This function reads CPU accessible registers in the GP and so should not be called in a display list.</P>
39
40
41
42
43<h2>See Also</h2>
44
45<p><a href="GXReadMemMetric.html">GXReadMemMetric</a><br> <a href="GXClearMemMetric.html">GXClearMemMetric</a><br> <a href="GXSetVCacheMetric.html">GXSetVCacheMetric</a><br> <a href="GXReadVCacheMetric.html">GXReadVCacheMetric</a><br> <a href="GXClearVCacheMetric.html">GXClearVCacheMetric</a><br> <a href="GXReadGPMetric.html">GXReadGPMetric</a><br> <a href="GXSetGPMetric.html">GXSetGPMetric</a><br> <a href="GXClearGPMetric.html">GXClearGPMetric</a></p>
46<H2>Revision History</H2>
47<P>03/01/2006 Initial version</P>