1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 <refentry id=
"glTexCoord">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>glTexCoord
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glTexCoord
</refname>
17 <refpurpose>set the current texture coordinates
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glTexCoord1s
</function></funcdef>
23 <paramdef>GLshort
<parameter>s
</parameter></paramdef>
28 <funcdef>void
<function>glTexCoord1i
</function></funcdef>
29 <paramdef>GLint
<parameter>s
</parameter></paramdef>
34 <funcdef>void
<function>glTexCoord1f
</function></funcdef>
35 <paramdef>GLfloat
<parameter>s
</parameter></paramdef>
40 <funcdef>void
<function>glTexCoord1d
</function></funcdef>
41 <paramdef>GLdouble
<parameter>s
</parameter></paramdef>
46 <funcdef>void
<function>glTexCoord2s
</function></funcdef>
47 <paramdef>GLshort
<parameter>s
</parameter></paramdef>
48 <paramdef>GLshort
<parameter>t
</parameter></paramdef>
53 <funcdef>void
<function>glTexCoord2i
</function></funcdef>
54 <paramdef>GLint
<parameter>s
</parameter></paramdef>
55 <paramdef>GLint
<parameter>t
</parameter></paramdef>
60 <funcdef>void
<function>glTexCoord2f
</function></funcdef>
61 <paramdef>GLfloat
<parameter>s
</parameter></paramdef>
62 <paramdef>GLfloat
<parameter>t
</parameter></paramdef>
67 <funcdef>void
<function>glTexCoord2d
</function></funcdef>
68 <paramdef>GLdouble
<parameter>s
</parameter></paramdef>
69 <paramdef>GLdouble
<parameter>t
</parameter></paramdef>
74 <funcdef>void
<function>glTexCoord3s
</function></funcdef>
75 <paramdef>GLshort
<parameter>s
</parameter></paramdef>
76 <paramdef>GLshort
<parameter>t
</parameter></paramdef>
77 <paramdef>GLshort
<parameter>r
</parameter></paramdef>
82 <funcdef>void
<function>glTexCoord3i
</function></funcdef>
83 <paramdef>GLint
<parameter>s
</parameter></paramdef>
84 <paramdef>GLint
<parameter>t
</parameter></paramdef>
85 <paramdef>GLint
<parameter>r
</parameter></paramdef>
90 <funcdef>void
<function>glTexCoord3f
</function></funcdef>
91 <paramdef>GLfloat
<parameter>s
</parameter></paramdef>
92 <paramdef>GLfloat
<parameter>t
</parameter></paramdef>
93 <paramdef>GLfloat
<parameter>r
</parameter></paramdef>
98 <funcdef>void
<function>glTexCoord3d
</function></funcdef>
99 <paramdef>GLdouble
<parameter>s
</parameter></paramdef>
100 <paramdef>GLdouble
<parameter>t
</parameter></paramdef>
101 <paramdef>GLdouble
<parameter>r
</parameter></paramdef>
106 <funcdef>void
<function>glTexCoord4s
</function></funcdef>
107 <paramdef>GLshort
<parameter>s
</parameter></paramdef>
108 <paramdef>GLshort
<parameter>t
</parameter></paramdef>
109 <paramdef>GLshort
<parameter>r
</parameter></paramdef>
110 <paramdef>GLshort
<parameter>q
</parameter></paramdef>
115 <funcdef>void
<function>glTexCoord4i
</function></funcdef>
116 <paramdef>GLint
<parameter>s
</parameter></paramdef>
117 <paramdef>GLint
<parameter>t
</parameter></paramdef>
118 <paramdef>GLint
<parameter>r
</parameter></paramdef>
119 <paramdef>GLint
<parameter>q
</parameter></paramdef>
124 <funcdef>void
<function>glTexCoord4f
</function></funcdef>
125 <paramdef>GLfloat
<parameter>s
</parameter></paramdef>
126 <paramdef>GLfloat
<parameter>t
</parameter></paramdef>
127 <paramdef>GLfloat
<parameter>r
</parameter></paramdef>
128 <paramdef>GLfloat
<parameter>q
</parameter></paramdef>
133 <funcdef>void
<function>glTexCoord4d
</function></funcdef>
134 <paramdef>GLdouble
<parameter>s
</parameter></paramdef>
135 <paramdef>GLdouble
<parameter>t
</parameter></paramdef>
136 <paramdef>GLdouble
<parameter>r
</parameter></paramdef>
137 <paramdef>GLdouble
<parameter>q
</parameter></paramdef>
141 <refsect1 id=
"parameters"><title>Parameters
</title>
144 <term><parameter>s
</parameter></term>
145 <term><parameter>t
</parameter></term>
146 <term><parameter>r
</parameter></term>
147 <term><parameter>q
</parameter></term>
150 Specify
<emphasis>s
</emphasis>,
<emphasis>t
</emphasis>,
<emphasis>r
</emphasis>, and
<emphasis>q
</emphasis> texture coordinates.
151 Not all parameters are present in all forms of the command.
157 <refsynopsisdiv><title>C Specification
</title>
160 <funcdef>void
<function>glTexCoord1sv
</function></funcdef>
161 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
166 <funcdef>void
<function>glTexCoord1iv
</function></funcdef>
167 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
172 <funcdef>void
<function>glTexCoord1fv
</function></funcdef>
173 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
178 <funcdef>void
<function>glTexCoord1dv
</function></funcdef>
179 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
184 <funcdef>void
<function>glTexCoord2sv
</function></funcdef>
185 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
190 <funcdef>void
<function>glTexCoord2iv
</function></funcdef>
191 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
196 <funcdef>void
<function>glTexCoord2fv
</function></funcdef>
197 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
202 <funcdef>void
<function>glTexCoord2dv
</function></funcdef>
203 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
208 <funcdef>void
<function>glTexCoord3sv
</function></funcdef>
209 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
214 <funcdef>void
<function>glTexCoord3iv
</function></funcdef>
215 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
220 <funcdef>void
<function>glTexCoord3fv
</function></funcdef>
221 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
226 <funcdef>void
<function>glTexCoord3dv
</function></funcdef>
227 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
232 <funcdef>void
<function>glTexCoord4sv
</function></funcdef>
233 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
238 <funcdef>void
<function>glTexCoord4iv
</function></funcdef>
239 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
244 <funcdef>void
<function>glTexCoord4fv
</function></funcdef>
245 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
250 <funcdef>void
<function>glTexCoord4dv
</function></funcdef>
251 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
255 <refsect1 id=
"parameters2"><title>Parameters
</title>
258 <term><parameter>v
</parameter></term>
261 Specifies a pointer to an array of one, two, three, or four elements,
262 which in turn specify the
263 <emphasis>s
</emphasis>,
264 <emphasis>t
</emphasis>,
265 <emphasis>r
</emphasis>, and
266 <emphasis>q
</emphasis> texture coordinates.
272 <refsect1 id=
"description"><title>Description
</title>
274 <function>glTexCoord
</function> specifies texture coordinates in
279 <function>glTexCoord1
</function> sets the current texture coordinates to
280 <inlineequation><mml:math>
281 <!-- eqn: (s, 0, 0, 1):-->
282 <mml:mfenced open=
"(" close=
")">
283 <mml:mi mathvariant=
"italic">s
</mml:mi>
288 </mml:math></inlineequation>;
290 <function>glTexCoord2
</function> sets them to
291 <inlineequation><mml:math>
292 <!-- eqn: (s, t, 0, 1):-->
293 <mml:mfenced open=
"(" close=
")">
294 <mml:mi mathvariant=
"italic">s
</mml:mi>
295 <mml:mi mathvariant=
"italic">t
</mml:mi>
299 </mml:math></inlineequation>.
300 Similarly,
<function>glTexCoord3
</function> specifies the texture coordinates as
301 <inlineequation><mml:math>
302 <!-- eqn: (s, t, r, 1):-->
303 <mml:mfenced open=
"(" close=
")">
304 <mml:mi mathvariant=
"italic">s
</mml:mi>
305 <mml:mi mathvariant=
"italic">t
</mml:mi>
306 <mml:mi mathvariant=
"italic">r
</mml:mi>
309 </mml:math></inlineequation>,
311 <function>glTexCoord4
</function> defines all four components explicitly as
312 <inlineequation><mml:math>
313 <!-- eqn: (s, t, r, q):-->
314 <mml:mfenced open=
"(" close=
")">
315 <mml:mi mathvariant=
"italic">s
</mml:mi>
316 <mml:mi mathvariant=
"italic">t
</mml:mi>
317 <mml:mi mathvariant=
"italic">r
</mml:mi>
318 <mml:mi mathvariant=
"italic">q
</mml:mi>
320 </mml:math></inlineequation>.
323 The current texture coordinates are part of the data
324 that is associated with each vertex and with the current
326 Initially, the values for
327 <emphasis>s
</emphasis>,
328 <emphasis>t
</emphasis>,
329 <emphasis>r
</emphasis>, and
330 <emphasis>q
</emphasis>
336 <refsect1 id=
"notes"><title>Notes
</title>
338 The current texture coordinates can be updated at any time.
340 <function>glTexCoord
</function> can be called between a call to
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry> and the corresponding
341 call to
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry>.
344 When the
<code>ARB_imaging
</code> extension is supported,
<function>glTexCoord
</function> always
345 updates texture unit
<constant>GL_TEXTURE0
</constant>.
348 <refsect1 id=
"associatedgets"><title>Associated Gets
</title>
350 <citerefentry><refentrytitle>glGet
</refentrytitle></citerefentry> with argument
<constant>GL_CURRENT_TEXTURE_COORDS
</constant>
353 <refsect1 id=
"seealso"><title>See Also
</title>
355 <citerefentry><refentrytitle>glMultiTexCoord
</refentrytitle></citerefentry>,
356 <function>glTexCoordPointer
</function>,
357 <citerefentry><refentrytitle>glVertex
</refentrytitle></citerefentry>
360 <refsect1 id=
"Copyright"><title>Copyright
</title>
362 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
363 Silicon Graphics, Inc. This document is licensed under the SGI
364 Free Software B License. For details, see
365 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.