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.

Note 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.

Requirements

  Windows NT/2000: Requires Windows NT 3.5 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Glu.h.
  Library: Use Glu32.lib.

See Also

gluDisk, gluNewQuadric, gluPartialDisk, gluQuadricOrientation, gluQuadricTexture, gluSphere


  

Community Additions

Show: