GXClearPixMetric

C Specification

#include <revolution/gx.h>

void GXClearPixMetric( void );

Arguments

None

Return Values

None

Description

The Graphics Processor (GP) can count many internal events that give detailed information on performance. 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 GXReadPixMetric to read the current value of the counters.

Example

u32 tpi, tpo, bpi, bpo, cpi, cc;

GXClearPixMetric();

// Draw Object(s)

// wait until object drawn
GXSetDrawSync(0xbeef);
while (0xbeef != GXReadDrawSync());

GXReadPixMetric(&tpi, &tpo, &bpi, &bpo, &cpi, &cc);   // returns request counter

OSReport("Number of copy clocks:  %d\n",cc);

This function reads CPU accessible registers in the GP and so should not be called in a display list.

See Also

GXReadMemMetric
GXClearMemMetric
GXSetVCacheMetric
GXReadVCacheMetric
GXClearVCacheMetric
GXReadGPMetric
GXSetGPMetric
GXClearGPMetric

Revision History

2006/03/01 Initial version