Gl.MultiTexCoord2f (gb.opengl)

Set the current texture coordinates.

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.TEXTURE$\mathit{i}$, 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.

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.TEXTURE$\mathit{i}$, 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 $\mathit{s}$, $\mathit{t}$, $\mathit{r}$, and $\mathit{q}$ texture coordinates.

Description

Gl.MultiTexCoord specifies texture coordinates in one, two, three, or four dimensions. Gl.MultiTexCoord1 sets the current texture coordinates to $\left(\mathit{s},0,0,1\right)$; a call to Gl.MultiTexCoord2 sets them to $\left(\mathit{s},\mathit{t},0,1\right)$. Similarly, Gl.MultiTexCoord3 specifies the texture coordinates as $\left(\mathit{s},\mathit{t},\mathit{r},1\right)$, and Gl.MultiTexCoord4 defines all four components explicitly as $\left(\mathit{s},\mathit{t},\mathit{r},\mathit{q}\right)$.

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 $\left(\mathit{s},\mathit{t},\mathit{r},\mathit{q}\right)$ are $\left(0,0,0,1\right)$.

Notes

Gl.MultiTexCoord is only supported if the GL version is 1.3 or greater, or if ARB_multitexture is included in the string returned by Gl.GetString when called with the argument Gl.EXTENSIONS.

The current texture coordinates can be updated at any time. In particular, Gl.MultiTexCoord can be called between a call to Gl.Begin and the corresponding call to Gl.End.

It is always the case that Gl.TEXTURE $\mathit{i}$ = Gl.TEXTURE0 + $\mathit{i}$.

Associated Gets

Gl.Get with argument Gl.CURRENT_TEXTURE_COORDS with appropriate texture unit selected.

Gl.Get with argument Gl.MAX_TEXTURE_COORDS

See also

See original documentation on OpenGL website