71 lines
2.0 KiB
Plaintext
71 lines
2.0 KiB
Plaintext
'\" e
|
|
'\"! eqn | mmdoc
|
|
'\"macro stdmacro
|
|
.ds Vn Version 1.2
|
|
.ds Dt 6 March 1997
|
|
.ds Re Release 1.2.0
|
|
.ds Dp May 02 11:53
|
|
.ds Dm 37 cylinder.
|
|
.ds Xs 15544 4 cylinder.gl
|
|
.TH GLUCYLINDER 3G
|
|
.SH NAME
|
|
.B "gluCylinder
|
|
\- draw a cylinder
|
|
|
|
.SH C SPECIFICATION
|
|
void \f3gluCylinder\fP(
|
|
GLUquadric* \fIquad\fP,
|
|
.nf
|
|
.ta \w'\f3void \fPgluCylinder( 'u
|
|
GLdouble \fIbase\fP,
|
|
GLdouble \fItop\fP,
|
|
GLdouble \fIheight\fP,
|
|
GLint \fIslices\fP,
|
|
GLint \fIstacks\fP )
|
|
.fi
|
|
|
|
.EQ
|
|
delim $$
|
|
.EN
|
|
.SH PARAMETERS
|
|
.TP \w'\fIheight\fP\ \ 'u
|
|
\f2quad\fP
|
|
Specifies the quadrics object (created with \%\f3gluNewQuadric\fP).
|
|
.TP
|
|
\f2base\fP
|
|
Specifies the radius of the cylinder at \f2z\fP = 0.
|
|
.TP
|
|
\f2top\fP
|
|
Specifies the radius of the cylinder at \f2z\fP = \f2height\fP.
|
|
.TP
|
|
\f2height\fP
|
|
Specifies the height of the cylinder.
|
|
.TP
|
|
\f2slices\fP
|
|
Specifies the number of subdivisions around the \f2z\fP axis.
|
|
.TP
|
|
\f2stacks\fP
|
|
Specifies the number of subdivisions along the \f2z\fP axis.
|
|
.SH DESCRIPTION
|
|
\%\f3gluCylinder\fP draws a cylinder oriented along the \f2z\fP axis. The base of the cylinder
|
|
is placed at \f2z\fP = 0, and the top at $ z ~=~ "height" $. Like a sphere,
|
|
a cylinder is subdivided around the \f2z\fP axis into slices, and along the
|
|
\f2z\fP axis into stacks.
|
|
.P
|
|
Note that if \f2top\fP is set to 0.0, this routine generates a cone.
|
|
.P
|
|
If the orientation is set to \%\f3GLU_OUTSIDE\fP
|
|
(with \%\f3gluQuadricOrientation\fP), then any generated normals
|
|
point away from the \f2z\fP axis. Otherwise, they point toward the
|
|
\f2z\fP axis.
|
|
.P
|
|
If texturing is turned on (with \%\f3gluQuadricTexture\fP), then texture
|
|
coordinates are generated so that \f2t\fP ranges linearly from 0.0
|
|
at \f2z\fP = 0 to 1.0 at \f2z\fP = \f2height\fP, and \f2s\fP
|
|
ranges from 0.0 at the +\f2y\fP axis, to 0.25 at the +\f2x\fP axis,
|
|
to 0.5 at the -\f2y\fP axis, to 0.75 at the \-\f2x\fP axis,
|
|
and back to 1.0 at the +\f2y\fP axis.
|
|
.SH SEE ALSO
|
|
\%\f3gluDisk(3G)\fP, \%\f3gluNewQuadric(3G)\fP, \%\f3gluPartialDisk(3G)\fP, \%\f3gluQuadricTexture(3G)\fP,
|
|
\%\f3gluSphere(3G)\fP
|