1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 <refentry id=
"gluDisk">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>gluDisk
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>gluDisk
</refname>
17 <refpurpose>draw a disk
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>gluDisk
</function></funcdef>
23 <paramdef>GLUquadric*
<parameter>quad
</parameter></paramdef>
24 <paramdef>GLdouble
<parameter>inner
</parameter></paramdef>
25 <paramdef>GLdouble
<parameter>outer
</parameter></paramdef>
26 <paramdef>GLint
<parameter>slices
</parameter></paramdef>
27 <paramdef>GLint
<parameter>loops
</parameter></paramdef>
31 <!-- eqn: ignoring delim $$ -->
32 <refsect1 id=
"parameters"><title>Parameters
</title>
35 <term><parameter>quad
</parameter></term>
38 Specifies the quadrics object (created with
<citerefentry><refentrytitle>gluNewQuadric
</refentrytitle></citerefentry>).
43 <term><parameter>inner
</parameter></term>
46 Specifies the inner radius of the disk (may be
0).
51 <term><parameter>outer
</parameter></term>
54 Specifies the outer radius of the disk.
59 <term><parameter>slices
</parameter></term>
62 Specifies the number of subdivisions around the
<emphasis>z
</emphasis> axis.
67 <term><parameter>loops
</parameter></term>
70 Specifies the number of concentric rings about the origin into which
71 the disk is subdivided.
77 <refsect1 id=
"description"><title>Description
</title>
79 <function>gluDisk
</function> renders a disk on the
<emphasis>z
</emphasis> =
0 plane. The disk has a radius of
80 <parameter>outer
</parameter> and contains a concentric circular hole with a radius
81 of
<parameter>inner
</parameter>. If
<parameter>inner
</parameter> is
0, then no hole is generated. The disk is
82 subdivided around the
<emphasis>z
</emphasis> axis into slices (like pizza slices) and also
83 about the
<emphasis>z
</emphasis> axis into rings
84 (as specified by
<parameter>slices
</parameter> and
<parameter>loops
</parameter>, respectively).
87 With respect to orientation, the +
<emphasis>z
</emphasis> side of the disk is considered to be
88 ``outside'' (see
<citerefentry><refentrytitle>gluQuadricOrientation
</refentrytitle></citerefentry>).
89 This means that if the
90 orientation is set to
<constant>GLU_OUTSIDE
</constant>, then any normals generated
91 point along the +
<emphasis>z
</emphasis> axis. Otherwise, they point along the \-
<emphasis>z
</emphasis>
95 If texturing has been turned on (with
<citerefentry><refentrytitle>gluQuadricTexture
</refentrytitle></citerefentry>),
96 texture coordinates are generated
97 linearly such that where
98 <inlineequation><mml:math>
99 <!-- eqn: r = outer:-->
101 <mml:mi mathvariant=
"italic">r
</mml:mi>
103 <mml:mi mathvariant=
"italic">outer
</mml:mi>
105 </mml:math></inlineequation>,
106 the value at (
<emphasis>r
</emphasis>,
0,
0) is
107 (
1,
0.5), at (
0,
<emphasis>r
</emphasis>,
0) it is (
0.5,
1), at (\-
<emphasis>r
</emphasis>,
0,
0)
109 at (
0, \-
<emphasis>r
</emphasis>,
0) it is (
0.5,
0).
112 <refsect1 id=
"seealso"><title>See Also
</title>
114 <citerefentry><refentrytitle>gluCylinder
</refentrytitle></citerefentry>,
115 <citerefentry><refentrytitle>gluNewQuadric
</refentrytitle></citerefentry>,
116 <citerefentry><refentrytitle>gluPartialDisk
</refentrytitle></citerefentry>,
117 <citerefentry><refentrytitle>gluQuadricOrientation
</refentrytitle></citerefentry>,
118 <citerefentry><refentrytitle>gluQuadricTexture
</refentrytitle></citerefentry>,
119 <citerefentry><refentrytitle>gluSphere
</refentrytitle></citerefentry>
122 <refsect1 id=
"Copyright"><title>Copyright
</title>
124 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
125 Silicon Graphics, Inc. This document is licensed under the SGI
126 Free Software B License. For details, see
127 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.