GXPreLoadEntireTexture

C Specification

#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 GXInitTexPreLoadRegion.

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 GXLoadTexObjPreLoaded. The default configuration (as set by GXInit) of texture memory has no preloaded regions, so you must install your own region allocator callbacks using GXSetTexRegionCallBack and GXSetTlutRegionCallBack.

Revision History

2006/03/01 Initial version.