1991-2006 Silicon Graphics, Inc.

gluCylinder

3G

gluCylinder

draw a cylinder

# C Specification

                    void gluCylinder
                    GLUquadric* quad
                    GLdouble base
                    GLdouble top
                    GLdouble height
                    GLint slices
                    GLint stacks

## Parameters

`quad`

- Specifies the quadrics object (created with

  gluNewQuadric

  ).

`base`

- Specifies the radius of the cylinder at z = 0.

`top`

- Specifies the radius of the cylinder at z = `height`.

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

## Description

`gluCylinder` 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 `top` is set to 0.0, this routine generates 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

), then 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, to 0.5 at the -y axis, to 0.75 at the \-x axis, and back to 1.0 at the +y axis.

## See Also

gluDisk

,

gluNewQuadric

,

gluPartialDisk

,

gluQuadricTexture

,

gluSphere

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.