cylinder.3gl   [plain text]


'\" 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