[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
OpenGL 1.2 for AIX: Reference Manual

gluCylinder Subroutine

Purpose

Draws a cylinder.

Library

OpenGL C bindings library: libGL.a

C Syntax

void gluCylinder(GLUquadric*quad,
   GLdouble base, 
   GLdouble top, 
   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 top 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

quad Specifies the quadrics object created with the gluNewQuadric subroutine.
base Specifies the radius of the cylinder at z=0.
top Specifies the radius of the cylinder at z=Height. If top 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.

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.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]