GXLoadTexObj

Syntax

#include <revolution/gx.h>

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

Arguments

obj Pointer to a texture object.
id Attaches a name to the texture so that it may be referenced on the TEV stage. Applicable values are GX_TEXMAP0, GX_TEXMAP1, GX_TEXMAP2, GX_TEXMAP3, GX_TEXMAP4, GX_TEXMAP5, GX_TEXMAP6 and 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 the GXInitTexObj or GXInitTexObjCI function. 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.

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

See Also

GXSetTevOrder, GXInit, GXInitTexObj, GXInitTexObjCI, GXSetTexRegionCallBack, GXSetTlutRegionCallBack

Revision History

2006/03/01 Initial version.


CONFIDENTIAL