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