238 lines
4.8 KiB
Plaintext
238 lines
4.8 KiB
Plaintext
|
'\" te
|
||
|
|
'\"! tbl|eqn | mmdoc
|
||
|
|
'\"macro stdmacro
|
||
|
|
.ds Vn Version 1.2
|
||
|
|
.ds Dt 24 September 1999
|
||
|
|
.ds Re Release 1.2.1
|
||
|
|
.ds Dp Jan 14 18:30
|
||
|
|
.ds Dm 01 texcoord.
|
||
|
|
.ds Xs 3537 4 texcoord.gl
|
||
|
|
.TH GLTEXCOORD 3G
|
||
|
|
.SH NAME
|
||
|
|
.B "glTexCoord1d, glTexCoord1f, glTexCoord1i, glTexCoord1s, glTexCoord2d, glTexCoord2f, glTexCoord2i, glTexCoord2s, glTexCoord3d, glTexCoord3f, glTexCoord3i, glTexCoord3s, glTexCoord4d, glTexCoord4f, glTexCoord4i, glTexCoord4s, glTexCoord1dv, glTexCoord1fv, glTexCoord1iv, glTexCoord1sv, glTexCoord2dv, glTexCoord2fv, glTexCoord2iv, glTexCoord2sv, glTexCoord3dv, glTexCoord3fv, glTexCoord3iv, glTexCoord3sv, glTexCoord4dv, glTexCoord4fv, glTexCoord4iv, glTexCoord4sv
|
||
|
|
\- set the current texture coordinates
|
||
|
|
|
||
|
|
.SH C SPECIFICATION
|
||
|
|
void \f3glTexCoord1d\fP(
|
||
|
|
GLdouble \fIs\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord1f\fP(
|
||
|
|
GLfloat \fIs\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord1i\fP(
|
||
|
|
GLint \fIs\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord1s\fP(
|
||
|
|
GLshort \fIs\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2d\fP(
|
||
|
|
GLdouble \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord2d( 'u
|
||
|
|
GLdouble \fIt\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2f\fP(
|
||
|
|
GLfloat \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord2f( 'u
|
||
|
|
GLfloat \fIt\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2i\fP(
|
||
|
|
GLint \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord2i( 'u
|
||
|
|
GLint \fIt\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2s\fP(
|
||
|
|
GLshort \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord2s( 'u
|
||
|
|
GLshort \fIt\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3d\fP(
|
||
|
|
GLdouble \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord3d( 'u
|
||
|
|
GLdouble \fIt\fP,
|
||
|
|
GLdouble \fIr\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3f\fP(
|
||
|
|
GLfloat \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord3f( 'u
|
||
|
|
GLfloat \fIt\fP,
|
||
|
|
GLfloat \fIr\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3i\fP(
|
||
|
|
GLint \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord3i( 'u
|
||
|
|
GLint \fIt\fP,
|
||
|
|
GLint \fIr\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3s\fP(
|
||
|
|
GLshort \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord3s( 'u
|
||
|
|
GLshort \fIt\fP,
|
||
|
|
GLshort \fIr\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4d\fP(
|
||
|
|
GLdouble \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord4d( 'u
|
||
|
|
GLdouble \fIt\fP,
|
||
|
|
GLdouble \fIr\fP,
|
||
|
|
GLdouble \fIq\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4f\fP(
|
||
|
|
GLfloat \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord4f( 'u
|
||
|
|
GLfloat \fIt\fP,
|
||
|
|
GLfloat \fIr\fP,
|
||
|
|
GLfloat \fIq\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4i\fP(
|
||
|
|
GLint \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord4i( 'u
|
||
|
|
GLint \fIt\fP,
|
||
|
|
GLint \fIr\fP,
|
||
|
|
GLint \fIq\fP )
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4s\fP(
|
||
|
|
GLshort \fIs\fP,
|
||
|
|
.nf
|
||
|
|
.ta \w'\f3void \fPglTexCoord4s( 'u
|
||
|
|
GLshort \fIt\fP,
|
||
|
|
GLshort \fIr\fP,
|
||
|
|
GLshort \fIq\fP )
|
||
|
|
.fi
|
||
|
|
|
||
|
|
.SH PARAMETERS
|
||
|
|
.TP \w'\f2s\fP\ \f2t\fP\ \f2r\fP\ \f2q\fP\ \ 'u
|
||
|
|
\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP
|
||
|
|
Specify \f2s\fP, \f2t\fP, \f2r\fP, and \f2q\fP texture coordinates.
|
||
|
|
Not all parameters are present in all forms of the command.
|
||
|
|
.SH C SPECIFICATION
|
||
|
|
void \f3glTexCoord1dv\fP(
|
||
|
|
const GLdouble \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord1fv\fP(
|
||
|
|
const GLfloat \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord1iv\fP(
|
||
|
|
const GLint \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord1sv\fP(
|
||
|
|
const GLshort \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2dv\fP(
|
||
|
|
const GLdouble \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2fv\fP(
|
||
|
|
const GLfloat \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2iv\fP(
|
||
|
|
const GLint \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord2sv\fP(
|
||
|
|
const GLshort \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3dv\fP(
|
||
|
|
const GLdouble \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3fv\fP(
|
||
|
|
const GLfloat \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3iv\fP(
|
||
|
|
const GLint \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord3sv\fP(
|
||
|
|
const GLshort \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4dv\fP(
|
||
|
|
const GLdouble \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4fv\fP(
|
||
|
|
const GLfloat \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4iv\fP(
|
||
|
|
const GLint \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
void \f3glTexCoord4sv\fP(
|
||
|
|
const GLshort \fI*v\fP )
|
||
|
|
.nf
|
||
|
|
.fi
|
||
|
|
|
||
|
|
.SH PARAMETERS
|
||
|
|
.TP
|
||
|
|
\f2v\fP
|
||
|
|
Specifies a pointer to an array of one, two, three, or four elements,
|
||
|
|
which in turn specify the
|
||
|
|
\f2s\fP,
|
||
|
|
\f2t\fP,
|
||
|
|
\f2r\fP, and
|
||
|
|
\f2q\fP texture coordinates.
|
||
|
|
.SH DESCRIPTION
|
||
|
|
\%\f3glTexCoord\fP specifies texture coordinates in
|
||
|
|
one,
|
||
|
|
two,
|
||
|
|
three, or
|
||
|
|
four dimensions.
|
||
|
|
\%\f3glTexCoord1\fP sets the current texture coordinates to
|
||
|
|
(\f2s\fP, 0, 0, 1);
|
||
|
|
a call to
|
||
|
|
.br
|
||
|
|
\%\f3glTexCoord2\fP sets them to
|
||
|
|
(\f2s\fP, \f2t\fP, 0, 1).
|
||
|
|
.BP
|
||
|
|
Similarly, \%\f3glTexCoord3\fP specifies the texture coordinates as
|
||
|
|
(\f2s\fP, \f2t\fP, \f2r\fP, 1), and
|
||
|
|
\%\f3glTexCoord4\fP defines all four components explicitly as
|
||
|
|
(\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP).
|
||
|
|
.P
|
||
|
|
The current texture coordinates are part of the data
|
||
|
|
that is associated with each vertex and with the current
|
||
|
|
raster position.
|
||
|
|
Initially, the values for
|
||
|
|
\f2s\fP,
|
||
|
|
\f2t\fP,
|
||
|
|
\f2r\fP, and
|
||
|
|
\f2q\fP
|
||
|
|
are (0, 0, 0, 1).
|
||
|
|
.P
|
||
|
|
.SH NOTES
|
||
|
|
The current texture coordinates can be updated at any time.
|
||
|
|
In particular,
|
||
|
|
\%\f3glTexCoord\fP can be called between a call to \%\f3glBegin\fP and the corresponding
|
||
|
|
call to \%\f3glEnd\fP.
|
||
|
|
.P
|
||
|
|
When the \%\f3GL_ARB_imaging\fP extension is supported, \%\f3glTexCoord\fP always
|
||
|
|
updates texture unit \%\f3GL_TEXTURE0_ARB\fP.
|
||
|
|
.SH ASSOCIATED GETS
|
||
|
|
\%\f3glGet\fP with argument \%\f3GL_CURRENT_TEXTURE_COORDS\fP
|
||
|
|
.SH SEE ALSO
|
||
|
|
\%\f3glTexCoordPointer(3G)\fP,
|
||
|
|
\%\f3glVertex(3G)\fP
|