G3*_TexCoord

C Specification

#include <nitro/gx/g3imm.h>
#include <nitro/gx/g3b.h>
#include <nitro/gx/g3c.h>

void G3_TexCoord(fx32 s, fx32 t);

// Below are APIs for creating the display list (command list)
void G3B_TexCoord(GXDLInfo* info, fx32 s, fx32 t);
void G3C_TexCoord(GXDLInfo* info, fx32 s, fx32 t);
void G3BS_TexCoord(GXDLInfo* info, fx32 s, fx32 t);
void G3CS_TexCoord(GXDLInfo* info, fx32 s, fx32 t);

Arguments

info Command List Information
s S coordinate
t T coordinate

Return Values

None.

Description

Both s and t must be between -2048 (0xFF8000000 and 2047.9735 (0x007FFF00). It is converted to a fixed-point decimal (sign + 11-bit integer + 4-bit decimal) and packed into a 1-word parameter. The texture coordinates remain valid until the next G3*_TexCoord command resets the current texture coordinates. Therefore, multiple vertices can share the texture coordinates. When performing texture mapping, the geometry engine will process faster if you issue the commands in this order: G3*_TexCoord, G3*_Normal, and then G3*_Vtx.

See Also

G3*_Normal, G3*_Vtx

Revision History

01/19/2004 Initial version