xenocara/doc/gl-docs/GL/gl/vertex.3gl

190 lines
3.9 KiB
Plaintext
Raw Normal View History

'\" te
'\"! tbl|eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp Jan 14 18:30
.ds Dm 01 vertex.gl
.ds Xs 13679 4 vertex.gl
.TH GLVERTEX 3G
.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(3G)\fP,
\%\f3glCallList(3G)\fP,
\%\f3glColor(3G)\fP,
\%\f3glEdgeFlag(3G)\fP,
\%\f3glEvalCoord(3G)\fP,
\%\f3glIndex(3G)\fP,
\%\f3glMaterial(3G)\fP,
.br
\%\f3glNormal(3G)\fP,
\%\f3glRect(3G)\fP,
\%\f3glTexCoord(3G)\fP,
\%\f3glVertexPointer(3G)\fP