← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/doc/man/GL/gl/multitexcoordARB.3gl

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/doc/man/GL/gl/multitexcoordARB.3gl
 
1
'\" te
 
2
'\"! tbl|eqn | mmdoc
 
3
'\"macro stdmacro
 
4
.ds Vn Version 1.2
 
5
.ds Dt 24 September 1999
 
6
.ds Re Release 1.2.1
 
7
.ds Dp Jan 14 19:43
 
8
.ds Dm 01 multitexc
 
9
.ds Xs 22 5 multitexcoordARB.gl
 
10
.TH GLMULTITEXCOORDARB 3G
 
11
.SH NAME
 
12
.B "glMultiTexCoord1dARB, glMultiTexCoord1fARB, glMultiTexCoord1iARB, glMultiTexCoord1sARB, glMultiTexCoord2dARB, glMultiTexCoord2fARB, glMultiTexCoord2iARB, glMultiTexCoord2sARB, glMultiTexCoord3dARB, glMultiTexCoord3fARB, glMultiTexCoord3iARB, glMultiTexCoord3sARB, glMultiTexCoord4dARB, glMultiTexCoord4fARB, glMultiTexCoord4iARB, glMultiTexCoord4sARB, glMultiTexCoord1dvARB, glMultiTexCoord1fvARB, glMultiTexCoord1ivARB, glMultiTexCoord1svARB, glMultiTexCoord2dvARB, glMultiTexCoord2fvARB, glMultiTexCoord2ivARB, glMultiTexCoord2svARB, glMultiTexCoord3dvARB, glMultiTexCoord3fvARB, glMultiTexCoord3ivARB, glMultiTexCoord3svARB, glMultiTexCoord4dvARB, glMultiTexCoord4fvARB, glMultiTexCoord4ivARB, glMultiTexCoord4svARB
 
13
\- set the current texture coordinates
 
14
 
 
15
.SH C SPECIFICATION
 
16
void \f3glMultiTexCoord1dARB\fP(
 
17
GLenum \fItarget\fP,
 
18
.nf
 
19
.ta \w'\f3void \fPglMultiTexCoord1dARB( 'u
 
20
        GLdouble \fIs\fP )
 
21
.fi
 
22
void \f3glMultiTexCoord1fARB\fP(
 
23
GLenum \fItarget\fP,
 
24
.nf
 
25
.ta \w'\f3void \fPglMultiTexCoord1fARB( 'u
 
26
        GLfloat \fIs\fP )
 
27
.fi
 
28
void \f3glMultiTexCoord1iARB\fP(
 
29
GLenum \fItarget\fP,
 
30
.nf
 
31
.ta \w'\f3void \fPglMultiTexCoord1iARB( 'u
 
32
        GLint \fIs\fP )
 
33
.fi
 
34
void \f3glMultiTexCoord1sARB\fP(
 
35
GLenum \fItarget\fP,
 
36
.nf
 
37
.ta \w'\f3void \fPglMultiTexCoord1sARB( 'u
 
38
        GLshort \fIs\fP )
 
39
.fi
 
40
void \f3glMultiTexCoord2dARB\fP(
 
41
GLenum \fItarget\fP,
 
42
.nf
 
43
.ta \w'\f3void \fPglMultiTexCoord2dARB( 'u
 
44
        GLdouble \fIs\fP,
 
45
        GLdouble \fIt\fP )
 
46
.fi
 
47
void \f3glMultiTexCoord2fARB\fP(
 
48
GLenum \fItarget\fP,
 
49
.nf
 
50
.ta \w'\f3void \fPglMultiTexCoord2fARB( 'u
 
51
        GLfloat \fIs\fP,
 
52
        GLfloat \fIt\fP )
 
53
.fi
 
54
void \f3glMultiTexCoord2iARB\fP(
 
55
GLenum \fItarget\fP,
 
56
.nf
 
57
.ta \w'\f3void \fPglMultiTexCoord2iARB( 'u
 
58
        GLint \fIs\fP,
 
59
        GLint \fIt\fP )
 
60
.fi
 
61
void \f3glMultiTexCoord2sARB\fP(
 
62
GLenum \fItarget\fP,
 
63
.nf
 
64
.ta \w'\f3void \fPglMultiTexCoord2sARB( 'u
 
65
        GLshort \fIs\fP,
 
66
        GLshort \fIt\fP )
 
67
.fi
 
68
void \f3glMultiTexCoord3dARB\fP(
 
69
GLenum \fItarget\fP,
 
70
.nf
 
71
.ta \w'\f3void \fPglMultiTexCoord3dARB( 'u
 
72
        GLdouble \fIs\fP,
 
73
        GLdouble \fIt\fP,
 
74
        GLdouble \fIr\fP )
 
75
.fi
 
76
void \f3glMultiTexCoord3fARB\fP(
 
77
GLenum \fItarget\fP,
 
78
.nf
 
79
.ta \w'\f3void \fPglMultiTexCoord3fARB( 'u
 
80
        GLfloat \fIs\fP,
 
81
        GLfloat \fIt\fP,
 
82
        GLfloat \fIr\fP )
 
83
.fi
 
84
void \f3glMultiTexCoord3iARB\fP(
 
85
GLenum \fItarget\fP,
 
86
.nf
 
87
.ta \w'\f3void \fPglMultiTexCoord3iARB( 'u
 
88
        GLint \fIs\fP,
 
89
        GLint \fIt\fP,
 
90
        GLint \fIr\fP )
 
91
.fi
 
92
void \f3glMultiTexCoord3sARB\fP(
 
93
GLenum \fItarget\fP,
 
94
.nf
 
95
.ta \w'\f3void \fPglMultiTexCoord3sARB( 'u
 
96
        GLshort \fIs\fP,
 
97
        GLshort \fIt\fP,
 
98
        GLshort \fIr\fP )
 
99
.fi
 
100
void \f3glMultiTexCoord4dARB\fP(
 
101
GLenum \fItarget\fP,
 
102
.nf
 
103
.ta \w'\f3void \fPglMultiTexCoord4dARB( 'u
 
104
        GLdouble \fIs\fP,
 
105
        GLdouble \fIt\fP,
 
106
        GLdouble \fIr\fP,
 
107
        GLdouble \fIq\fP )
 
108
.fi
 
109
void \f3glMultiTexCoord4fARB\fP(
 
110
GLenum \fItarget\fP,
 
111
.nf
 
112
.ta \w'\f3void \fPglMultiTexCoord4fARB( 'u
 
113
        GLfloat \fIs\fP,
 
114
        GLfloat \fIt\fP,
 
115
        GLfloat \fIr\fP,
 
116
        GLfloat \fIq\fP )
 
117
.fi
 
118
void \f3glMultiTexCoord4iARB\fP(
 
119
GLenum \fItarget\fP,
 
120
.nf
 
121
.ta \w'\f3void \fPglMultiTexCoord4iARB( 'u
 
122
        GLint \fIs\fP,
 
123
        GLint \fIt\fP,
 
124
        GLint \fIr\fP,
 
125
        GLint \fIq\fP )
 
126
.fi
 
127
void \f3glMultiTexCoord4sARB\fP(
 
128
GLenum \fItarget\fP,
 
129
.nf
 
130
.ta \w'\f3void \fPglMultiTexCoord4sARB( 'u
 
131
        GLshort \fIs\fP,
 
132
        GLshort \fIt\fP,
 
133
        GLshort \fIr\fP,
 
134
        GLshort \fIq\fP )
 
135
.fi
 
136
 
 
137
.EQ
 
138
delim $$
 
139
.EN
 
140
.SH PARAMETERS
 
141
.TP \w'\f2target\fP\ \ 'u 
 
142
\f2target\fP
 
143
Specifies texture unit whose coordinates should be modified.  The number
 
144
of texture units is implementation dependent, but must be at least
 
145
two. Must be one of \%\f3GL_TEXTURE\fP$i$\f3_ARB\fP where 0 \(<= $ i $ <
 
146
\%\f3GL_MAX_TEXTURE_UNITS_ARB\fP, which is an implementation-dependent value.
 
147
.TP
 
148
\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP
 
149
Specify \f2s\fP, \f2t\fP, \f2r\fP, and \f2q\fP texture coordinates for
 
150
\f2target\fP texture unit.  Not all parameters are present in all forms
 
151
of the command.
 
152
.SH C SPECIFICATION
 
153
void \f3glMultiTexCoord1dvARB\fP(
 
154
GLenum \fItarget\fP,
 
155
.nf
 
156
.ta \w'\f3void \fPglMultiTexCoord1dvARB( 'u
 
157
        const GLdouble \fI*v\fP )
 
158
.fi
 
159
void \f3glMultiTexCoord1fvARB\fP(
 
160
GLenum \fItarget\fP,
 
161
.nf
 
162
.ta \w'\f3void \fPglMultiTexCoord1fvARB( 'u
 
163
        const GLfloat \fI*v\fP )
 
164
.fi
 
165
void \f3glMultiTexCoord1ivARB\fP(
 
166
GLenum \fItarget\fP,
 
167
.nf
 
168
.ta \w'\f3void \fPglMultiTexCoord1ivARB( 'u
 
169
        const GLint \fI*v\fP )
 
170
.fi
 
171
void \f3glMultiTexCoord1svARB\fP(
 
172
GLenum \fItarget\fP,
 
173
.nf
 
174
.ta \w'\f3void \fPglMultiTexCoord1svARB( 'u
 
175
        const GLshort \fI*v\fP )
 
176
.fi
 
177
void \f3glMultiTexCoord2dvARB\fP(
 
178
GLenum \fItarget\fP,
 
179
.nf
 
180
.ta \w'\f3void \fPglMultiTexCoord2dvARB( 'u
 
181
        const GLdouble \fI*v\fP )
 
182
.fi
 
183
void \f3glMultiTexCoord2fvARB\fP(
 
184
GLenum \fItarget\fP,
 
185
.nf
 
186
.ta \w'\f3void \fPglMultiTexCoord2fvARB( 'u
 
187
        const GLfloat \fI*v\fP )
 
188
.fi
 
189
void \f3glMultiTexCoord2ivARB\fP(
 
190
GLenum \fItarget\fP,
 
191
.nf
 
192
.ta \w'\f3void \fPglMultiTexCoord2ivARB( 'u
 
193
        const GLint \fI*v\fP )
 
194
.fi
 
195
void \f3glMultiTexCoord2svARB\fP(
 
196
GLenum \fItarget\fP,
 
197
.nf
 
198
.ta \w'\f3void \fPglMultiTexCoord2svARB( 'u
 
199
        const GLshort \fI*v\fP )
 
200
.fi
 
201
void \f3glMultiTexCoord3dvARB\fP(
 
202
GLenum \fItarget\fP,
 
203
.nf
 
204
.ta \w'\f3void \fPglMultiTexCoord3dvARB( 'u
 
205
        const GLdouble \fI*v\fP )
 
206
.fi
 
207
void \f3glMultiTexCoord3fvARB\fP(
 
208
GLenum \fItarget\fP,
 
209
.nf
 
210
.ta \w'\f3void \fPglMultiTexCoord3fvARB( 'u
 
211
        const GLfloat \fI*v\fP )
 
212
.fi
 
213
void \f3glMultiTexCoord3ivARB\fP(
 
214
GLenum \fItarget\fP,
 
215
.nf
 
216
.ta \w'\f3void \fPglMultiTexCoord3ivARB( 'u
 
217
        const GLint \fI*v\fP )
 
218
.fi
 
219
void \f3glMultiTexCoord3svARB\fP(
 
220
GLenum \fItarget\fP,
 
221
.nf
 
222
.ta \w'\f3void \fPglMultiTexCoord3svARB( 'u
 
223
        const GLshort \fI*v\fP )
 
224
.fi
 
225
void \f3glMultiTexCoord4dvARB\fP(
 
226
GLenum \fItarget\fP,
 
227
.nf
 
228
.ta \w'\f3void \fPglMultiTexCoord4dvARB( 'u
 
229
        const GLdouble \fI*v\fP )
 
230
.fi
 
231
void \f3glMultiTexCoord4fvARB\fP(
 
232
GLenum \fItarget\fP,
 
233
.nf
 
234
.ta \w'\f3void \fPglMultiTexCoord4fvARB( 'u
 
235
        const GLfloat \fI*v\fP )
 
236
.fi
 
237
void \f3glMultiTexCoord4ivARB\fP(
 
238
GLenum \fItarget\fP,
 
239
.nf
 
240
.ta \w'\f3void \fPglMultiTexCoord4ivARB( 'u
 
241
        const GLint \fI*v\fP )
 
242
.fi
 
243
void \f3glMultiTexCoord4svARB\fP(
 
244
GLenum \fItarget\fP,
 
245
.nf
 
246
.ta \w'\f3void \fPglMultiTexCoord4svARB( 'u
 
247
        const GLshort \fI*v\fP )
 
248
.fi
 
249
 
 
250
.SH PARAMETERS
 
251
.TP
 
252
\f2target\fP
 
253
Specifies texture unit whose coordinates should be modified.  The number
 
254
of texture units is implementation dependent, but must be at least
 
255
two. Must be one of \%\f3GL_TEXTURE\fP$i$\f3_ARB\fP,
 
256
where 0 \(<= $ i $ < the implementation-dependent value of 
 
257
\%\f3GL_MAX_TEXTURE_UNITS_ARB\fP.
 
258
.TP
 
259
\f2v\fP
 
260
Specifies a pointer to an array of one, two, three, or four elements,
 
261
which in turn specify the \f2s\fP, \f2t\fP, \f2r\fP,
 
262
and \f2q\fP texture coordinates.
 
263
.SH DESCRIPTION
 
264
\%\f3glMultiTexCoordARB\fP specifies texture coordinates in one, two, three, or four
 
265
dimensions.  
 
266
\%\f3glMultiTexCoord1ARB\fP sets the current texture
 
267
coordinates to (\f2s\fP,\ 0,\ 0,\ 1);
 
268
a call to \%\f3glMultiTexCoord2ARB\fP
 
269
sets them to (\f2s\fP,\ \f2t\fP,\ 0,\ 1).
 
270
Similarly, \%\f3glMultiTexCoord3ARB\fP specifies the texture coordinates as
 
271
(\f2s\fP,\ \f2t\fP,\ \f2r\fP,\ 1), and
 
272
\%\f3glMultiTexCoord4ARB\fP
 
273
defines all four components explicitly as
 
274
(\f2s\fP,\ \f2t\fP,\ \f2r\fP,\ \f2q\fP).
 
275
.P
 
276
The current texture coordinates are part of the data
 
277
that is associated with each vertex and with the current
 
278
raster position. 
 
279
Initially, the values for 
 
280
\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP are (0,\ 0,\ 0,\ 1). 
 
281
.P
 
282
.SH NOTES
 
283
\%\f3glMultiTexCoordARB\fP is only supported if \%\f3GL_ARB_multitexture\fP is included in the
 
284
string returned by \%\f3glGetString\fP when called with the argument
 
285
\%\f3GL_EXTENSIONS\fP.
 
286
.P
 
287
The current texture coordinates can be updated at any time.
 
288
In particular,
 
289
\%\f3glMultiTexCoordARB\fP can be called between a call to \%\f3glBegin\fP and the corresponding
 
290
call to \%\f3glEnd\fP.
 
291
.P
 
292
It is always the case that \%\f3GL_TEXTURE\fP$i$\f3_ARB\fP = \%\f3GL_TEXTURE0_ARB\fP + $i$.
 
293
.SH ASSOCIATED GETS
 
294
\%\f3glGet\fP with argument \%\f3GL_CURRENT_TEXTURE_COORDS\fP with appropriate 
 
295
texture unit selected.
 
296
.SH SEE ALSO
 
297
\%\f3glActiveTextureARB(3G)\fP,
 
298
\%\f3glClientActiveTextureARB(3G)\fP,
 
299
\%\f3glTexCoord(3G)\fP,
 
300
\%\f3glTexCoordPointer(3G)\fP,
 
301
\%\f3glVertex(3G)\fP