# 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 (`0xFF800000`0 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