gluCylinder function

The gluCylinder function draws a cylinder.

Syntax

void WINAPI gluCylinder(
   GLUquadric *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.

Return value

This function does not return a value.

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 negative x-axis, and back to 1.0 at the positive y-axis.

Requirements

See also

gluDisk

gluNewQuadric

gluPartialDisk

gluQuadricOrientation

gluQuadricTexture

gluSphere