Share via

gluCylinder

  • Article

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