glMultiTexCoordARB.3G - Man Page

set the current texture coordinates

C Specification

void glMultiTexCoord1dARB( GLenum target,

	GLdouble s )

void glMultiTexCoord1fARB( GLenum target,

	GLfloat s )

void glMultiTexCoord1iARB( GLenum target,

	GLint s )

void glMultiTexCoord1sARB( GLenum target,

	GLshort s )

void glMultiTexCoord2dARB( GLenum target,

	GLdouble s,
	GLdouble t )

void glMultiTexCoord2fARB( GLenum target,

	GLfloat s,
	GLfloat t )

void glMultiTexCoord2iARB( GLenum target,

	GLint s,
	GLint t )

void glMultiTexCoord2sARB( GLenum target,

	GLshort s,
	GLshort t )

void glMultiTexCoord3dARB( GLenum target,

	GLdouble s,
	GLdouble t,
	GLdouble r )

void glMultiTexCoord3fARB( GLenum target,

	GLfloat s,
	GLfloat t,
	GLfloat r )

void glMultiTexCoord3iARB( GLenum target,

	GLint s,
	GLint t,
	GLint r )

void glMultiTexCoord3sARB( GLenum target,

	GLshort s,
	GLshort t,
	GLshort r )

void glMultiTexCoord4dARB( GLenum target,

	GLdouble s,
	GLdouble t,
	GLdouble r,
	GLdouble q )

void glMultiTexCoord4fARB( GLenum target,

	GLfloat s,
	GLfloat t,
	GLfloat r,
	GLfloat q )

void glMultiTexCoord4iARB( GLenum target,

	GLint s,
	GLint t,
	GLint r,
	GLint q )

void glMultiTexCoord4sARB( GLenum target,

	GLshort s,
	GLshort t,
	GLshort r,
	GLshort q )

Parameters

target

Specifies texture unit whose coordinates should be modified.  The number of texture units is implementation dependent, but must be at least two. Must be one of GL_TEXTUREi_ARB where 0 ≤ i < GL_MAX_TEXTURE_UNITS_ARB, 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 glMultiTexCoord1dvARB( GLenum target,

	const GLdouble *v )

void glMultiTexCoord1fvARB( GLenum target,

	const GLfloat *v )

void glMultiTexCoord1ivARB( GLenum target,

	const GLint *v )

void glMultiTexCoord1svARB( GLenum target,

	const GLshort *v )

void glMultiTexCoord2dvARB( GLenum target,

	const GLdouble *v )

void glMultiTexCoord2fvARB( GLenum target,

	const GLfloat *v )

void glMultiTexCoord2ivARB( GLenum target,

	const GLint *v )

void glMultiTexCoord2svARB( GLenum target,

	const GLshort *v )

void glMultiTexCoord3dvARB( GLenum target,

	const GLdouble *v )

void glMultiTexCoord3fvARB( GLenum target,

	const GLfloat *v )

void glMultiTexCoord3ivARB( GLenum target,

	const GLint *v )

void glMultiTexCoord3svARB( GLenum target,

	const GLshort *v )

void glMultiTexCoord4dvARB( GLenum target,

	const GLdouble *v )

void glMultiTexCoord4fvARB( GLenum target,

	const GLfloat *v )

void glMultiTexCoord4ivARB( GLenum target,

	const GLint *v )

void glMultiTexCoord4svARB( GLenum target,

	const GLshort *v )

Parameters

target

Specifies texture unit whose coordinates should be modified.  The number of texture units is implementation dependent, but must be at least two. Must be one of GL_TEXTUREi_ARB, where 0 ≤ i < the implementation-dependent value of  GL_MAX_TEXTURE_UNITS_ARB.

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

glMultiTexCoordARB specifies texture coordinates in one, two, three, or four dimensions.   glMultiTexCoord1ARB sets the current texture coordinates to (s, 0, 0, 1); a call to glMultiTexCoord2ARB sets them to (st, 0, 1). Similarly, glMultiTexCoord3ARB specifies the texture coordinates as (str, 1), and glMultiTexCoord4ARB defines all four components explicitly as (strq).

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

glMultiTexCoordARB is only supported if GL_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, glMultiTexCoordARB can be called between a call to glBegin and the corresponding call to glEnd.

It is always the case that GL_TEXTUREi_ARB = GL_TEXTURE0_ARB + i.

Associated Gets

glGet with argument GL_CURRENT_TEXTURE_COORDS with appropriate  texture unit selected.

See Also

glActiveTextureARB(3G), glClientActiveTextureARB(3G), glTexCoord(3G), glTexCoordPointer(3G), glVertex(3G)

Referenced By

glActiveTextureARB.3G(3), glClientActiveTextureARB.3G(3).

The man pages glMultiTexCoord1dARB.3G(3), glMultiTexCoord1dvARB.3G(3), glMultiTexCoord1fARB.3G(3), glMultiTexCoord1fvARB.3G(3), glMultiTexCoord1iARB.3G(3), glMultiTexCoord1ivARB.3G(3), glMultiTexCoord1sARB.3G(3), glMultiTexCoord1svARB.3G(3), glMultiTexCoord2dARB.3G(3), glMultiTexCoord2dvARB.3G(3), glMultiTexCoord2fARB.3G(3), glMultiTexCoord2fvARB.3G(3), glMultiTexCoord2iARB.3G(3), glMultiTexCoord2ivARB.3G(3), glMultiTexCoord2sARB.3G(3), glMultiTexCoord2svARB.3G(3), glMultiTexCoord3dARB.3G(3), glMultiTexCoord3dvARB.3G(3), glMultiTexCoord3fARB.3G(3), glMultiTexCoord3fvARB.3G(3), glMultiTexCoord3iARB.3G(3), glMultiTexCoord3ivARB.3G(3), glMultiTexCoord3sARB.3G(3), glMultiTexCoord3svARB.3G(3), glMultiTexCoord4dARB.3G(3), glMultiTexCoord4dvARB.3G(3), glMultiTexCoord4fARB.3G(3), glMultiTexCoord4fvARB.3G(3), glMultiTexCoord4iARB.3G(3), glMultiTexCoord4ivARB.3G(3), glMultiTexCoord4sARB.3G(3) and glMultiTexCoord4svARB.3G(3) are aliases of glMultiTexCoordARB.3G(3).