GXSetTexLookupMode

Syntax

#include <revolution/gd.h>

void GDSetTexLookupMode (
    GXTexMapID    id,
    GXTexWrapMode wrap_s, 
    GXTexWrapMode wrap_t,
    GXTexFilter   min_filt, 
    GXTexFilter   mag_filt, 
    f32           min_lod, 
    f32           max_lod,
    f32           lod_bias,
    GXBool        bias_clamp,
    GXBool        do_edge_lod, 
    GXAnisotropy  max_aniso );

Arguments

id The hardware texture map ID to change.
wrap_s Describes how texture coordinates will be wrapped in the s direction. The following setting values are accepted:GX_CLAMP, GX_REPEAT, GX_MIRROR.
wrap_t Describes how texture coordinates will be wrapped in the t direction. The following setting values are accepted:GX_CLAMP, GX_REPEAT, GX_MIRROR.
min_filt Filter mode to use when the texel/pixel ratio is ≥ 1.0. The following values are accepted: GX_NEAR, GX_LINEAR, GX_NEAR_MIP_NEAR, GX_LIN_MIP_NEAR, GX_NEAR_MIP_LIN, GX_LIN_MIP_LIN.
mag_filt Filter mode to use when the texel/pixel ratio is < 1.0. The following values are accepted: GX_NEAR, GX_LINEAR.
min_lod Minimum LOD value. The hardware uses MAX(min_lod, lod). The range is from 0.0 to 10.0.
max_lod Maximum LOD value. The hardware uses MIN(min_lod, lod). The range is from 0.0 to 10.0.
lod_bias Bias added to calculate the LOD value.
bias_clamp If GX_ENABLE, (LOD + lod_bias) is clamped so that it is never less than the minimum range of the pixels projected in texture space. Prevents over biasing the LOD when the polygon is perpendicular to the view direction.
do_edge_lod If GX_TRUE is set, LOD is calculated using adjacent texels, if GX_TRUE is not set, diagonally opposed texels are used.
max_aniso The maximum anisotropic filter to use.

Return Values

None.

Description

This function is used to set the lookup related parameters for a given hardware texture map ID. Unlike the GX library, which uses texture objects, GD functions set the hardware registers directly. The parameters of this function are all related to texture coordinate processing and texture filtering.

See Also

GXInitTexObj, GXInitTexObjLOD, GDSetTexImgAttr, GDSetTexImgPtr

Revision History

2006/03/01 Initial version.

CONFIDENTIAL