GXInvalidateTexRegion

Syntax

#include <revolution/gx.h>

void GXInvalidateTexRegion( const GXTexRegion* region );

Arguments

Return Values

None.

Description

This function invalidates the texture cache in texture memory (TMEM) specified by region. More accurately, this function invalidates the cache tags, forcing the texture cache to load new data. Call this function if textures in main memory will be manipulated in the CPU, or if loading new textures to a main memory region that may have been cached. Preloaded textures (see the GXPreLoadEntireTexture function) do not use tags.

The texture hardware can disable four tags per each graphics processor (GP) clock cycle. Each tag represents either a superline of TMEM ("superlines" are cache-internal units), or 512 bytes. Therefore, it takes 16 GP clock cycles to disable a 32-KB texture region.

See Also

GXInvalidateTexAll, GXInitTexCacheRegion

Revision History

2006/03/01 Initial version.

CONFIDENTIAL