FORMAT
-
#include <Ninja.h>
Sint32 njSetTextureNum(n);
Uint32 n
PARAMETERS
- n
- texture number
RETURN VALUE
- Successful
- 1
- Failed
- -1
FUNCTION
- Sets texture number n from the current texture list as the current texture.
- Subsequently, this remains the current texture until execution of njSetTextureNum or njSetTextureNumG.
- About the texture number of the current texture
-
As shown in the example below, when textures are created, texture numbers are sequentially allocated in the series 0, 1, 2, 3,... from the beginning of a NJS_TEXNAME structure which is set in the NJS_TEXLIST structure.
NJS_TEXNAME texname[5];
NJS_TEXLIST texlist={texname,5};
/* Texture number 0 */
njSetTextureName(&texname[0],"file1.pvr",10,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX);
/* Texture number 1 */
njSetTextureName(&texname[1],"file2.pvr",11,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX);
/* Texture number 2 */
njSetTextureName(&texname[2],"file1.pvr",12,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX);
/* Texture number 3 */
njSetTextureName(&texname[3],"file2.pvr",13,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX);
/* Texture number 4 */
njSetTextureName(&texname[4],"file1.pvr",14,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX);
EXAMPLE
-
NJS_TEXNAME texname[2];
NJS_TEXNAME texname2[2];
NJS_TEXLIST texlist ={texname,2};
NJS_TEXLIST texlist ={texname2,2};
/* Prepare to load a total of 4 textures */
NJS_TEXMEMLIST texmemlist[4];
njInitTexture(texmemlist,4);
/* Load texture */
njLoadTexture(&texlist);
njSetTextureName(&texname[0],"file1.pvr",0,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX );
njSetTextureName(&texname[1],"file2.pvr",1,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX );
njSetTextureName(&texname2[0],"file3.pvr",2,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX );
njSetTextureName(&texname2[1],"file4.pvr",3,
NJD_TEXATTR_TYPE_FILE |
NJD_TEXATTR_GLOBALINDEX );
/* Load texture */
njLoadTexture(&texlist2);
/* Set current texture list as texlist */
njSetTexture(&texlist);
/* Set texture 0 from texlist as current texture file1.pvr */
njSetTextureNum(0);
:
/* Omitted texture drawing. Drawing with texture file1.pvr */
:
/* Set texlist2 as current texture list */
njSetTexture(&texlist2);
/* Set texture 1 from texlist2 as current texture file4.pvr */
njSetTextureNum(1);
:
/* Omitted texture drawing. Drawing with texture file1.pvr */
:
NOTES
- The specified texture must be present in texture memory.
- For details, see the texture document.
RELATED TOPICS
-
njSetTexture
njSetTextureNumG