'\"! tbl|eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.1.0
.ds Dp Mar 17 18:10
.ds Dm  Mar  6 20:0
.ds Xs 58724 3 vertex.gl
.TH GLVERTEX
.SH NAME
.B "glVertex2d, glVertex2f, glVertex2i, glVertex2s, glVertex3d, glVertex3f, glVertex3i, glVertex3s, glVertex4d, glVertex4f, glVertex4i, glVertex4s, glVertex2dv, glVertex2fv, glVertex2iv, glVertex2sv, glVertex3dv, glVertex3fv, glVertex3iv, glVertex3sv, glVertex4dv, glVertex4fv, glVertex4iv, glVertex4sv
\- specify a vertex

.SH C SPECIFICATION
void \f3glVertex2d\fP(
GLdouble \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex2d( 'u
	GLdouble \fIy\fP )
.fi
void \f3glVertex2f\fP(
GLfloat \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex2f( 'u
	GLfloat \fIy\fP )
.fi
void \f3glVertex2i\fP(
GLint \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex2i( 'u
	GLint \fIy\fP )
.fi
void \f3glVertex2s\fP(
GLshort \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex2s( 'u
	GLshort \fIy\fP )
.fi
void \f3glVertex3d\fP(
GLdouble \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex3d( 'u
	GLdouble \fIy\fP,
	GLdouble \fIz\fP )
.fi
void \f3glVertex3f\fP(
GLfloat \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex3f( 'u
	GLfloat \fIy\fP,
	GLfloat \fIz\fP )
.fi
void \f3glVertex3i\fP(
GLint \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex3i( 'u
	GLint \fIy\fP,
	GLint \fIz\fP )
.fi
void \f3glVertex3s\fP(
GLshort \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex3s( 'u
	GLshort \fIy\fP,
	GLshort \fIz\fP )
.fi
void \f3glVertex4d\fP(
GLdouble \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex4d( 'u
	GLdouble \fIy\fP,
	GLdouble \fIz\fP,
	GLdouble \fIw\fP )
.fi
void \f3glVertex4f\fP(
GLfloat \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex4f( 'u
	GLfloat \fIy\fP,
	GLfloat \fIz\fP,
	GLfloat \fIw\fP )
.fi
void \f3glVertex4i\fP(
GLint \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex4i( 'u
	GLint \fIy\fP,
	GLint \fIz\fP,
	GLint \fIw\fP )
.fi
void \f3glVertex4s\fP(
GLshort \fIx\fP,
.nf
.ta \w'\f3void \fPglVertex4s( 'u
	GLshort \fIy\fP,
	GLshort \fIz\fP,
	GLshort \fIw\fP )
.fi

.SH PARAMETERS
.TP \w'\f2x\fP\ \f2y\fP\ \f2z\fP\ \f2w\fP\ \ 'u 
\f2x\fP, \f2y\fP, \f2z\fP, \f2w\fP
Specify \f2x\fP, \f2y\fP, \f2z\fP, and \f2w\fP coordinates of a vertex.
Not all parameters are present in all forms of the command.
.SH C SPECIFICATION
void \f3glVertex2dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glVertex2fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glVertex2iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glVertex2sv\fP(
const GLshort \fI*v\fP )
.nf
.fi
void \f3glVertex3dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glVertex3fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glVertex3iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glVertex3sv\fP(
const GLshort \fI*v\fP )
.nf
.fi
void \f3glVertex4dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glVertex4fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glVertex4iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glVertex4sv\fP(
const GLshort \fI*v\fP )
.nf
.fi

.SH PARAMETERS
.TP
\f2v\fP
Specifies a pointer to an array of two, three, or four elements.
The elements of a two-element array are \f2x\fP and \f2y\fP;
of a three-element array, \f2x\fP, \f2y\fP, and \f2z\fP;
and of a four-element array, \f2x\fP, \f2y\fP, \f2z\fP, and \f2w\fP.
.SH DESCRIPTION
\f3glVertex\fP commands are used within \f3glBegin\fP/\f3glEnd\fP pairs to specify
point, line, and polygon vertices.
The current color,
normal,
and texture coordinates are associated with the vertex when \f3glVertex\fP is called.
.P
When only \f2x\fP and \f2y\fP are specified,
\f2z\fP defaults to 0 and \f2w\fP defaults to 1.
When \f2x, y,\fP and \f2z\fP are specified,
\f2w\fP defaults to 1.
.SH NOTES
Invoking \f3glVertex\fP outside of a \f3glBegin\fP/\f3glEnd\fP pair
results in undefined behavior.
.SH SEE ALSO
\f3glBegin\fP,
\f3glCallList\fP,
\f3glColor\fP,
\f3glEdgeFlag\fP,
\f3glEvalCoord\fP,
\f3glIndex\fP,
\f3glMaterial\fP,
.br
\f3glNormal\fP,
\f3glRect\fP,
\f3glTexCoord\fP,
\f3glVertexPointer\fP