NNS_G3dTexLoad

C Specification

#include <nnsys/g3d/kernel.h>
void
NNS_G3dTexLoad(
NNSG3dResTex* pTex,
BOOL exec_begin_end
);

Arguments

pTex Pointer to the texture resource
exec_begin_end When TRUE, calls the GX_BeginLoadTex() and GX_EndLoadTex() functions of NITRO-SDK

Return Values

None.

Description

The texture data from the texture resource is loaded in VRAM area where the texture key indicates. Also, sets the flag indicating that the texture is loaded. The texture key must be configured with NNS_G3dTexSetTexKey() before calling this function.

When exec_begin_end = TRUE, the NITRO-SDK API functions GX_BeginLoadTex() and GX_EndLoadTex() are called automatically before and after loading texture data to the VRAM. When exec_begin_end = FALSE, the GX_BeginLoadTex() and GX_EndLoadTex() functions must be called on the user side. When continuously loading texture data, it is more efficient to designate FALSE in exec_begin_end and call the GX_BeginLoadTex() and GX_EndLoadTex() functions on the user side.

See Also

NNS_G3dTexSetTexKey, NNS_G3dTexReleaseTexKey

Revision History

08/19/2004 Corrected errors in the explanatory text.
08/02/2004 Initial version.


CONFIDENTIAL