GXLoadTexObj

C Specification

#include <revolution/gx.h>

void GXLoadTexObj( const GXTexObj* obj, GXTexMapID id );

Arguments

`obj`	Pointer to a texture object.
`id`	Name the texture to be referenced on the TEV stage. Allowable values are: `GX_TEXMAP0, GX_TEXMAP1, GX_TEXMAP2, GX_TEXMAP3, GX_TEXMAP4, GX_TEXMAP5, GX_TEXMAP6, GX_TEXMAP7`.

Return Values

None.

Description

This function loads the state describing a texture into one of eight hardware register sets. Before this happens, the texture object, obj, should be initialized using GXInitTexObj or GXInitTexObjCI. The id argument refers to the texture state register set.

Once loaded, the texture can be used in any Texture Environment (TEV) stage using the GXSetTevOrder function.

GXLoadTexObj will call the functions set by GXSetTexRegionCallBack (and GXSetTlutRegionCallBack if the texture is color-index format) to obtain the texture regions associated with this texture object. These callbacks are set to default functions by GXInit.

Revision History