1991-2006
Silicon Graphics, Inc.
glMultiTexCoord
3G
glMultiTexCoord
set the current texture coordinates
C Specification
void glMultiTexCoord1s
GLenum target
GLshort s
void glMultiTexCoord1i
GLenum target
GLint s
void glMultiTexCoord1f
GLenum target
GLfloat s
void glMultiTexCoord1d
GLenum target
GLdouble s
void glMultiTexCoord2s
GLenum target
GLshort s
GLshort t
void glMultiTexCoord2i
GLenum target
GLint s
GLint t
void glMultiTexCoord2f
GLenum target
GLfloat s
GLfloat t
void glMultiTexCoord2d
GLenum target
GLdouble s
GLdouble t
void glMultiTexCoord3s
GLenum target
GLshort s
GLshort t
GLshort r
void glMultiTexCoord3i
GLenum target
GLint s
GLint t
GLint r
void glMultiTexCoord3f
GLenum target
GLfloat s
GLfloat t
GLfloat r
void glMultiTexCoord3d
GLenum target
GLdouble s
GLdouble t
GLdouble r
void glMultiTexCoord4s
GLenum target
GLshort s
GLshort t
GLshort r
GLshort q
void glMultiTexCoord4i
GLenum target
GLint s
GLint t
GLint r
GLint q
void glMultiTexCoord4f
GLenum target
GLfloat s
GLfloat t
GLfloat r
GLfloat q
void glMultiTexCoord4d
GLenum target
GLdouble s
GLdouble t
GLdouble r
GLdouble q
Parameters
target
Specifies the texture unit whose coordinates should be modified. The number
of texture units is implementation dependent, but must be at least
two. Symbolic constant must be one of
GL_TEXTUREi,
where i ranges from 0 to GL_MAX_TEXTURE_COORDS - 1,
which is an implementation-dependent value.
s
t
r
q
Specify s, t, r, and q texture coordinates for
target texture unit. Not all parameters are present in all forms
of the command.
C Specification
void glMultiTexCoord1sv
GLenum target
const GLshort * v
void glMultiTexCoord1iv
GLenum target
const GLint * v
void glMultiTexCoord1fv
GLenum target
const GLfloat * v
void glMultiTexCoord1dv
GLenum target
const GLdouble * v
void glMultiTexCoord2sv
GLenum target
const GLshort * v
void glMultiTexCoord2iv
GLenum target
const GLint * v
void glMultiTexCoord2fv
GLenum target
const GLfloat * v
void glMultiTexCoord2dv
GLenum target
const GLdouble * v
void glMultiTexCoord3sv
GLenum target
const GLshort * v
void glMultiTexCoord3iv
GLenum target
const GLint * v
void glMultiTexCoord3fv
GLenum target
const GLfloat * v
void glMultiTexCoord3dv
GLenum target
const GLdouble * v
void glMultiTexCoord4sv
GLenum target
const GLshort * v
void glMultiTexCoord4iv
GLenum target
const GLint * v
void glMultiTexCoord4fv
GLenum target
const GLfloat * v
void glMultiTexCoord4dv
GLenum target
const GLdouble * v
Parameters
target
Specifies the texture unit whose coordinates should be modified. The number
of texture units is implementation dependent, but must be at least
two. Symbolic constant must be one of
GL_TEXTUREi,
where i ranges from 0 to GL_MAX_TEXTURE_COORDS - 1,
which is an implementation-dependent value.
v
Specifies a pointer to an array of one, two, three, or four elements,
which in turn specify the
s,
t,
r,
and
q
texture coordinates.
Description
glMultiTexCoord specifies texture coordinates in one, two, three, or four
dimensions.
glMultiTexCoord1 sets the current texture
coordinates to
s
0
0
1
;
a call to glMultiTexCoord2
sets them to
s
t
0
1
.
Similarly, glMultiTexCoord3 specifies the texture coordinates as
s
t
r
1
,
and
glMultiTexCoord4
defines all four components explicitly as
s
t
r
q
.
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
s
t
r
q
are
0
0
0
1
.
Notes
glMultiTexCoord is only supported if the GL version is 1.3 or greater, or if
ARB_multitexture
is included in the string returned by
glGetString when called with the argument GL_EXTENSIONS.
The current texture coordinates can be updated at any time.
In particular,
glMultiTexCoord can be called between a call to glBegin and the corresponding
call to glEnd.
It is always the case that GL_TEXTURE
i
= GL_TEXTURE0 +
i.
Associated Gets
glGet with argument GL_CURRENT_TEXTURE_COORDS with appropriate
texture unit selected.
glGet with argument GL_MAX_TEXTURE_COORDS
See Also
glActiveTexture,
glClientActiveTexture,
glTexCoord,
glTexCoordPointer,
glVertex
Copyright
Copyright 1991-2006
Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/.