GXPreLoadEntireTexture

Syntax

#include <revolution/gx.h>

void GXPreLoadEntireTexture(
    const GXTexObj*       tex_obj, 
    const GXTexRegion*    region );

Arguments

tex_obj	Pointer to the texture object that describes the texture to be loaded.
region	Texture region in texture memory where the texture is to be loaded.

Return Values

None.

Description

This function loads a given texture from DRAM into the texture memory. Accesses to this texture will bypass the texture-cache-tag look-up and instead read the texels directly from texture memory. The texture region must be the same size as the texture. See the GXInitTexPreLoadRegion function for details.

This function loads the texture into texture memory, but to use it as a source for the texture environment (TEV) unit, you must first call the GXLoadTexObjPreLoaded function. The default configuration of texture memory (as set by the GXInit function) has no preloaded regions, so you must implement your own region allocator callbacks using the GXSetTexRegionCallBack and GXSetTlutRegionCallBack functions.

Revision History

2006/03/01 Initial version.