GXClearPixMetric

Syntax

#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 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 GXReadPixMetric function to read the current value of the counters.

Example

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

GXClearPixMetric();

// Render Object(s)

// wait until object(s) rendered
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.

CONFIDENTIAL