gluCylinder

The gluCylinder function draws a cylinder.

void gluCylinder(
  GLUquadricObj * qobj,  
  GLdouble baseRadius,   
  GLdouble topRadius,    
  GLdouble height,       
  GLint slices,          
  GLint stacks           
);
 

Parameters

qobj

The quadric object (created with gluNewQuadric).

baseRadius

The radius of the cylinder at z = 0.

topRadius

The radius of the cylinder at z = height.

height

The height of the cylinder.

slices

The number of subdivisions around the z-axis.

stacks

The number of subdivisions along the z-axis.

Remarks

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

Notice that if topRadius is set to zero, then this routine will generate a cone.

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

If texturing is turned on (with gluQuadricTexture): 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 positive y-axis, to 0.25 at the positive x-axis, to 0.5 at the negative y-axis, to 0.75 at the positive x-axis, and back to 1.0 at the positive y-axis.

QuickInfo

  Windows NT: Use version 3.5 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in glu.h.
  Import Library: Link with glu32.lib.

See Also

gluDisk, gluNewQuadric, gluPartialDisk, gluQuadricOrientation, gluQuadricTexture, gluSphere