GXSetNumChans

Syntax

#include <revolution/gx.h>

void GXSetNumChans( u8 nChans );

Arguments

nChans Number of color channels to rasterize. Minimum value is 0; maximum value is 2.

Return Values

None.

Description

This function sets the number of color channels that are output to the Texture Environment (TEV) stages. Color channels are the mechanism used to compute per-vertex lighting effects. Color channels are controlled using the GXSetChanCtrl function. Color channels are linked to specific texture environment (TEV) stages with the GXSetTevOrder function.

This function basically defines the number of per-vertex colors that get rasterized. If nChans is set to 0, at least one texture coordinate must be generated. This is set using the GXSetNumTexGens function (see the GXSetNumTexGens function). If nChans is set to 1, channel GX_COLOR0A0 will be rasterized. If nChans is set to 2 (the maximum value), GX_COLOR0A0 and GX_COLOR1A1 will be rasterized.

See Also

GXSetChanCtrl

Revision History

2006/03/01 Initial version.


CONFIDENTIAL