GDSetTexPreLoaded

Syntax

#include <revolution/gd.h>

void GDSetTexPreLoaded (
    GXTexMapID id,
    u32 tmem_even,
    u32 tmem_odd );

Arguments

id	The hardware texture map ID to change.
tmem_even	Base pointer in Texture Memory for even LODs (refer to table). Should be 32-byte aligned.
tmem_odd	Base pointer in Texture Memory for the odd LODs (refer to table). Should be 32-byte aligned.

Return Values

None.

Description

This function is used to set a specified hardware texture map ID as preloaded and to bind the texture to a given region of texture memory (TMEM). Unlike the GX library, which uses texture objects, GD functions set the hardware registers directly.

A specified texture map can either be cached or preloaded. A cached texture resides in main memory and uses TMEM as a cache. A preloaded texture resides entirely in TMEM. This function sets the texture map to preload, while GDSetTexCached function sets the texture map to cache. In either case, the texture must be bound to a particular region of TMEM.

TMEM is divided into low order and high order banks. The texture may be split between the banks depending upon the texture format. For the rules governing this, refer to GXInitTexPreLoadRegion function.

Revision History

2006/03/01 Initial version.