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=
"glVertex">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>glVertex
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glVertex
</refname>
17 <refpurpose>specify a vertex
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glVertex2s
</function></funcdef>
23 <paramdef>GLshort
<parameter>x
</parameter></paramdef>
24 <paramdef>GLshort
<parameter>y
</parameter></paramdef>
29 <funcdef>void
<function>glVertex2i
</function></funcdef>
30 <paramdef>GLint
<parameter>x
</parameter></paramdef>
31 <paramdef>GLint
<parameter>y
</parameter></paramdef>
36 <funcdef>void
<function>glVertex2f
</function></funcdef>
37 <paramdef>GLfloat
<parameter>x
</parameter></paramdef>
38 <paramdef>GLfloat
<parameter>y
</parameter></paramdef>
43 <funcdef>void
<function>glVertex2d
</function></funcdef>
44 <paramdef>GLdouble
<parameter>x
</parameter></paramdef>
45 <paramdef>GLdouble
<parameter>y
</parameter></paramdef>
50 <funcdef>void
<function>glVertex3s
</function></funcdef>
51 <paramdef>GLshort
<parameter>x
</parameter></paramdef>
52 <paramdef>GLshort
<parameter>y
</parameter></paramdef>
53 <paramdef>GLshort
<parameter>z
</parameter></paramdef>
58 <funcdef>void
<function>glVertex3i
</function></funcdef>
59 <paramdef>GLint
<parameter>x
</parameter></paramdef>
60 <paramdef>GLint
<parameter>y
</parameter></paramdef>
61 <paramdef>GLint
<parameter>z
</parameter></paramdef>
66 <funcdef>void
<function>glVertex3f
</function></funcdef>
67 <paramdef>GLfloat
<parameter>x
</parameter></paramdef>
68 <paramdef>GLfloat
<parameter>y
</parameter></paramdef>
69 <paramdef>GLfloat
<parameter>z
</parameter></paramdef>
74 <funcdef>void
<function>glVertex3d
</function></funcdef>
75 <paramdef>GLdouble
<parameter>x
</parameter></paramdef>
76 <paramdef>GLdouble
<parameter>y
</parameter></paramdef>
77 <paramdef>GLdouble
<parameter>z
</parameter></paramdef>
82 <funcdef>void
<function>glVertex4s
</function></funcdef>
83 <paramdef>GLshort
<parameter>x
</parameter></paramdef>
84 <paramdef>GLshort
<parameter>y
</parameter></paramdef>
85 <paramdef>GLshort
<parameter>z
</parameter></paramdef>
86 <paramdef>GLshort
<parameter>w
</parameter></paramdef>
91 <funcdef>void
<function>glVertex4i
</function></funcdef>
92 <paramdef>GLint
<parameter>x
</parameter></paramdef>
93 <paramdef>GLint
<parameter>y
</parameter></paramdef>
94 <paramdef>GLint
<parameter>z
</parameter></paramdef>
95 <paramdef>GLint
<parameter>w
</parameter></paramdef>
100 <funcdef>void
<function>glVertex4f
</function></funcdef>
101 <paramdef>GLfloat
<parameter>x
</parameter></paramdef>
102 <paramdef>GLfloat
<parameter>y
</parameter></paramdef>
103 <paramdef>GLfloat
<parameter>z
</parameter></paramdef>
104 <paramdef>GLfloat
<parameter>w
</parameter></paramdef>
109 <funcdef>void
<function>glVertex4d
</function></funcdef>
110 <paramdef>GLdouble
<parameter>x
</parameter></paramdef>
111 <paramdef>GLdouble
<parameter>y
</parameter></paramdef>
112 <paramdef>GLdouble
<parameter>z
</parameter></paramdef>
113 <paramdef>GLdouble
<parameter>w
</parameter></paramdef>
117 <refsect1 id=
"parameters"><title>Parameters
</title>
120 <term><parameter>x
</parameter></term>
121 <term><parameter>y
</parameter></term>
122 <term><parameter>z
</parameter></term>
123 <term><parameter>w
</parameter></term>
126 Specify
<emphasis>x
</emphasis>,
<emphasis>y
</emphasis>,
<emphasis>z
</emphasis>, and
<emphasis>w
</emphasis> coordinates of a vertex.
127 Not all parameters are present in all forms of the command.
133 <refsynopsisdiv><title>C Specification
</title>
136 <funcdef>void
<function>glVertex2sv
</function></funcdef>
137 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
142 <funcdef>void
<function>glVertex2iv
</function></funcdef>
143 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
148 <funcdef>void
<function>glVertex2fv
</function></funcdef>
149 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
154 <funcdef>void
<function>glVertex2dv
</function></funcdef>
155 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
160 <funcdef>void
<function>glVertex3sv
</function></funcdef>
161 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
166 <funcdef>void
<function>glVertex3iv
</function></funcdef>
167 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
172 <funcdef>void
<function>glVertex3fv
</function></funcdef>
173 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
178 <funcdef>void
<function>glVertex3dv
</function></funcdef>
179 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
184 <funcdef>void
<function>glVertex4sv
</function></funcdef>
185 <paramdef>const GLshort *
<parameter>v
</parameter></paramdef>
190 <funcdef>void
<function>glVertex4iv
</function></funcdef>
191 <paramdef>const GLint *
<parameter>v
</parameter></paramdef>
196 <funcdef>void
<function>glVertex4fv
</function></funcdef>
197 <paramdef>const GLfloat *
<parameter>v
</parameter></paramdef>
202 <funcdef>void
<function>glVertex4dv
</function></funcdef>
203 <paramdef>const GLdouble *
<parameter>v
</parameter></paramdef>
207 <refsect1 id=
"parameters2"><title>Parameters
</title>
210 <term><parameter>v
</parameter></term>
213 Specifies a pointer to an array of two, three, or four elements.
214 The elements of a two-element array are
215 <inlineequation><mml:math><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math></inlineequation>
217 <inlineequation><mml:math><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math></inlineequation>;
218 of a three-element array,
219 <inlineequation><mml:math><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math></inlineequation>,
220 <inlineequation><mml:math><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math></inlineequation>,
222 <inlineequation><mml:math><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math></inlineequation>;
223 and of a four-element array,
224 <inlineequation><mml:math><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math></inlineequation>,
225 <inlineequation><mml:math><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math></inlineequation>,
226 <inlineequation><mml:math><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math></inlineequation>,
228 <inlineequation><mml:math><mml:mi mathvariant=
"italic">w
</mml:mi></mml:math></inlineequation>.
234 <refsect1 id=
"description"><title>Description
</title>
236 <function>glVertex
</function> commands are used within
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry>/
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry> pairs to specify
237 point, line, and polygon vertices. The current color, normal, texture
238 coordinates, and fog coordinate are associated with the vertex when
<function>glVertex
</function>
243 <inlineequation><mml:math><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math></inlineequation>
245 <inlineequation><mml:math><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math></inlineequation>
247 <inlineequation><mml:math><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math></inlineequation>
249 <inlineequation><mml:math><mml:mi mathvariant=
"italic">w
</mml:mi></mml:math></inlineequation>
251 <inlineequation><mml:math><mml:mi mathvariant=
"italic">x
</mml:mi></mml:math></inlineequation>,
252 <inlineequation><mml:math><mml:mi mathvariant=
"italic">y
</mml:mi></mml:math></inlineequation>,
254 <inlineequation><mml:math><mml:mi mathvariant=
"italic">z
</mml:mi></mml:math></inlineequation>
256 <inlineequation><mml:math><mml:mi mathvariant=
"italic">w
</mml:mi></mml:math></inlineequation>
260 <refsect1 id=
"notes"><title>Notes
</title>
262 Invoking
<function>glVertex
</function> outside of a
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry>/
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry> pair
263 results in undefined behavior.
266 <refsect1 id=
"seealso"><title>See Also
</title>
268 <citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry>,
269 <citerefentry><refentrytitle>glCallList
</refentrytitle></citerefentry>,
270 <citerefentry><refentrytitle>glColor
</refentrytitle></citerefentry>,
271 <citerefentry><refentrytitle>glEdgeFlag
</refentrytitle></citerefentry>,
272 <citerefentry><refentrytitle>glEvalCoord
</refentrytitle></citerefentry>,
273 <citerefentry><refentrytitle>glFogCoord
</refentrytitle></citerefentry>,
274 <citerefentry><refentrytitle>glIndex
</refentrytitle></citerefentry>,
275 <citerefentry><refentrytitle>glMaterial
</refentrytitle></citerefentry>,
276 <citerefentry><refentrytitle>glMultiTexCoord
</refentrytitle></citerefentry>,
277 <citerefentry><refentrytitle>glNormal
</refentrytitle></citerefentry>,
278 <citerefentry><refentrytitle>glRect
</refentrytitle></citerefentry>,
279 <citerefentry><refentrytitle>glTexCoord
</refentrytitle></citerefentry>,
280 <citerefentry><refentrytitle>glVertexPointer
</refentrytitle></citerefentry>
283 <refsect1 id=
"Copyright"><title>Copyright
</title>
285 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
286 Silicon Graphics, Inc. This document is licensed under the SGI
287 Free Software B License. For details, see
288 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.