[ Previous | Next | Contents | Glossary | Home | Search ]
OpenGL 1.1 for AIX: Reference Manual

gluCylinder Subroutine

Purpose

Draws a cylinder.

Library

OpenGL C bindings library: libGL.a

C Syntax

void gluCylinder(GLUquadricObj *qobj,
   GLdouble BaseRadius, 
   GLdouble TopRadius, 
   GLdouble Height, 
   GLint Slices, 
   GLint Stacks)

Description

The gluCylinder subroutine draws a cylinder that is oriented along the z axis. The base of the cylinder is placed at z=0; the top of the cylinder is placed at z=Height. Like a sphere, the cylinder is subdivided around the z axis into slices and along the z axis into stacks.

Note: If the TopRadius parameter is set to zero, this subroutine will generate a cone.

If the orientation is set to GLU_OUTSIDE (with the gluQuadricOrientation subroutine), any generated normals point away from the z axis. Otherwise, they point toward the z axis.

If texturing is turned on using the gluQuadricTexture subroutine, texture coordinates are generated so that t ranges linearly from 0.0 at z=0 to 1.0 at z=Height, and s ranges from 0.0 at the +y axis to 0.25 at the +x axis, as well as up to 0.5 at the -y axis and 0.75 at the -x axis, then back to 1.0 at the +y axis.

Parameters

qobj Specifies the quadrics object created with the gluNewQuadric subroutine.
BaseRadius Specifies the radius of the cylinder at z=0.
TopRadius Specifies the radius of the cylinder at z=Height. If TopRadius is set to 0, this subroutine generates a cone.
Height Specifies the height of the cylinder.
Slices Specifies the number of subdivisions around the z axis.
Stacks Specifies the number of subdivisions along the z axis.

Return Values

0 Indicates the mipmap images were successfully built. Otherwise, a GLU error code is returned. (See the gluErrorString subroutine for standard GLU error codes.)

Files

/usr/include/GL/gl.h Contains C language constraints, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The gluDisk subroutine, gluNewQuadric subroutine, gluPartialDisk subroutine, gluQuadricOrientation subroutine, gluQuadricTexture subroutine, gluSphere subroutine.

OpenGL Overview.


[ Previous | Next | Contents | Glossary | Home | Search ]