GXLoadTexObjPreLoaded

Syntax

#include <revolution/gx.h>

void GXLoadTexObjPreLoaded(
    const GXTexObj*        obj, 
    const GXTexRegion*     region,
    GXTexMapID             id );

Arguments

`obj`	Pointer to the texture object that describes the texture and its properties.
region	Pointer to a region object that describes the texture memory region.
id	Texture name referenced by the texture environment (TEV) stage

Return Values

None.

Description

This function loads the state describing a preloaded 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. The texture must be loaded beforehand using the GXPreLoadEntireTexture function.

Once loaded, the texture can be used in any texture environment (TEV) stage using the GXSetTevOrder function. The GXInit function initially calls the GXSetTevOrder function to make a simple texture pipeline that associates GX_TEXMAP0 with GX_TEVSTAGE0, GX_TEXMAP1 with GX_TEVSTAGE1, and so on.

Be aware that the GXLoadTexObjPreLoaded function will not call the functions set by the GXSetTexRegionCallBack function (or the GXSetTlutRegionCallBack function, if the texture is color index format). because the region is explicitly set. However, these callback functions must be aware of all regions that are preloaded. The default callbacks set by the GXInit function assume there are no preloaded regions.

Revision History

2006/03/01 Initial version.