GXSetNumChans

C Specification

#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 GXSetChanCtrl. Color channels are linked to specific Texture Environment (TEV) stages using GXSetTevOrder.

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. Use the GXSetNumTexGens function to set it (see GXSetNumTexGens). 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.

Revision History

2006/03/01 Initial version.