[ Previous | Next | Contents | Glossary | Home | Search ]
OpenGL 1.1 for AIX: Reference Manual

gluDisk Subroutine

Purpose

Draws a disk.

Library

OpenGL C bindings library: libGL.a

C Syntax

void gluDisk(GLquadricObj *qobj, 
   GLdouble InnerRadius, 
   GLdouble OuterRadius, 
   GLint Slices, 
   GLint Loops)

Description

The gluDisk subroutine renders a disk on the z=0 plane. The disk has a radius defined by the OuterRadius parameter and contains a concentric circular hole with a radius defined by the InnerRadius parameter. If the value of InnerRadius is 0, no hole is generated. The disk is subdivided around the z axis into slices and rings (as specified by the Slices and Loops parameters, respectively).

With regard to orientation, the +z side of the disk is considered to be outside. (See the gluQuadricOrientation subroutine for details on specifying quadrics orientation.) If orientation is set to GLU_OUTSIDE, any normals generated point along the +z axis. Otherwise, they point along the -z axis.

If texturing is turned on with the gluQuadricTexture subroutine, texture coordinates are generated linearly such that the value at (r, 0, 0) (where r=OuterRadius) is (1, 0.5).

Under the same definition, the following values also apply:

Coordinates   Value
(0, r, 0)      (0.5, 1)
(-r, 0, 0)      (0, 0.5)
(0, -r, 0)      (0.5, 0)

Parameters

qobj Specifies the quadrics object created with the gluNewQuadric subroutine.
InnerRadius Defines the inner radius of the disk (may be 0).
OuterRadius Defines the outer radius of the disk.
Slices Specifies the number of desired subdivisions around the z axis.
Loops Specifies the number of desired concentric rings about the origin into which the disk is subdivided.

Files

/usr/include/GL/gl.h Contains C language constraints, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The gluCylinder subroutine, gluNewQuadric subroutine, gluPartialDisk subroutine, gluQuadricOrientation subroutine, gluQuadricTexture subroutine, gluSphere subroutine.

OpenGL Overview.


[ Previous | Next | Contents | Glossary | Home | Search ]