GXSetTevIndirect

C Specification

#include <revolution/gx.h>

void GXSetTevIndirect (GXTevStageID tev_stage, 
                       GXIndTexStageID ind_stage,
                       GXIndTexFormat format,
                       GXIndTexBiasSel bias_sel, 
                       GXIndTexMtxID matrix_sel,
                       GXIndTexWrap wrap_s,
                       GXIndTexWrap wrap_t,
                       GXBool add_prev, 
                       GXBool utc_lod, 
                       GXIndTexAlphaSel alpha_sel);

Arguments

tev_stage TEV stage to be set
Accepted values are:
GX_TEVSTAGE0, GX_TEVSTAGE1, GX_TEVSTAGE2 through GX_TEVSTAGE15.

ind_stage The indirect stage results used with this TEV stage.
Accepted values are:
GX_INDTEXSTAGE0, GX_INDTEXSTAGE1, GX_INDTEXSTAGE2 and GX_INDTEXSTAGE3.

format

Indicates how many bits to extract from the indirect result color for use in indirect offsets and the indirect bump alpha.
Accepted values are:

Name	Indirect Offset Data and Bump Alpha
`GX_ITF_8`	Use all 8 bits as indirect offset data. The same data (upper 5 bits) is duplicated to bump alpha.
`GX_ITF_5`	Use the lower 5 bits as indirect offset data. The remaining 3 bits are bump alpha.
`GX_ITF_4`	Use the lower 4 bits as indirect offset data. The remaining 4 bits are bump alpha.
`GX_ITF_3`	Use the lower 3 bits as indirect offset data. The remaining 5 bits are bump alpha.

bias_sel

Indicates whether a bias is applied to each component of the indirect offset.
Accepted values are:

Name	Bias-applied Components
`GX_ITB_NONE`	none
`GX_ITB_S`	S component only
`GX_ITB_T`	T component only
`GX_ITB_U`	U component only
`GX_ITB_ST`	S and T components
`GX_ITB_SU`	S and U components
`GX_ITB_TU`	T and U components
`GX_ITB_STU`	all S/T/U components

The bias is -128 for the GX_ITF_8 format, +1 for other formats.

matrix_sel

Indicates which indirect matrix and scale value to use to multiply the offsets.
Accepted values are:

Name	Indirect Matrix and Scale Value Used
`GX_ITM_OFF`	zero matrix
`GX_ITM_0`	indirect matrix 0 and matrix scale value 0
`GX_ITM_1`	indirect matrix 1 and matrix scale value 1
`GX_ITM_2`	indirect matrix 2 and matrix scale value 2
`GX_ITM_S0`	dynamic S matrix and matrix scale value 0
`GX_ITM_S1`	dynamic S matrix and matrix scale value 1
`GX_ITM_S2`	dynamic S matrix and matrix scale value 2
`GX_ITM_T0`	dynamic T matrix and matrix scale value 0
`GX_ITM_T1`	dynamic T matrix and matrix scale value 1
`GX_ITM_T2`	dynamic T matrix and matrix scale value 2

wrap_s

indicates the wrapping factor to use with S components of regular texture coordinates
Accepted values are:

Name	Wrap Value
`GX_ITW_OFF`	no wrapping
`GX_ITW_256`	wraps at 256
`GX_ITW_128`	wraps at 128
`GX_ITW_64`	wraps at 64
`GX_ITW_32`	wraps at 32
`GX_ITW_16`	wraps at 16
`GX_ITW_0`	zeroes the output coordinates

wrap_t Indicates the wrapping factor to use with the T component of regular texture coordinates.
Accepted values are similar to those for wrap_s.

add_prev Specifies whether the texture coordinate results from the previous TEV stage should be added.

utc_lod Indicates whether to use the unmodified (GX_TRUE) or modified (GX_FALSE) texture coordinates for mipmap LOD calculations.

alpha_sel

Indicates which offset component will supply the indirect bump alpha, if any.
Accepted values are:

Name	Bump Alpha Source
`GX_ITBA_OFF`	no bump alpha
`GX_ITBA_S`	S component supplies bump alpha
`GX_ITBA_T`	T component supplies bump alpha
`GX_ITBA_U`	U component supplies bump alpha

Return Values

None.

Description

This is a general-purpose function used to control how results from an indirect lookup will be used to modify a given regular TEV stage lookup.

Revision History

2006/03/01 Initial version.