GXSetTevIndirect

Syntax

#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, ... , 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 Specifies indirect offset and how many bits to extract from the indirect-reference colors used with 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 (the upper 5 bits) is copied as the bump alpha.
GX_ITF_5 Use lower 5 bits as indirect offset data. Remaining 3 bits become "bump alpha".
GX_ITF_4 Use lower 4 bits as indirect offset data. Remaining 4 bits become "bump alpha".
GX_ITF_3 Use lower 3 bits as indirect offset data. Remaining 5 bits become "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 components: S, T, and U.
The bias is -128 for the GX_ITF_8 format, +1 for other formats.
matrix_sel Specifies 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 Specifies the wrapping factor to apply to S components of regular texture coordinates. Accepted values are:
Name Wrap Value
GX_ITW_OFF No wrap.
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 Specifies the wrapping factor to apply to T components of regular texture coordinates.
Accepted values are identical 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.

See Also

GXSetTevDirect, GXSetTevIndBumpST, GXSetTevIndBumpXYZ, GXSetTevIndTile, GXSetTevIndWarp

Revision History

2006/03/01 Initial version.

CONFIDENTIAL