disk.3gl 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. '\" e
  2. '\"! eqn | mmdoc
  3. '\"macro stdmacro
  4. .ds Vn Version 1.2
  5. .ds Dt 6 March 1997
  6. .ds Re Release 1.2.0
  7. .ds Dp May 02 11:53
  8. .ds Dm 37 disk.gl -
  9. .ds Xs 8360 4 disk.gl
  10. .TH GLUDISK 3G
  11. .SH NAME
  12. .B "gluDisk
  13. \- draw a disk
  14. .SH C SPECIFICATION
  15. void \f3gluDisk\fP(
  16. GLUquadric* \fIquad\fP,
  17. .nf
  18. .ta \w'\f3void \fPgluDisk( 'u
  19. GLdouble \fIinner\fP,
  20. GLdouble \fIouter\fP,
  21. GLint \fIslices\fP,
  22. GLint \fIloops\fP )
  23. .fi
  24. .EQ
  25. delim $$
  26. .EN
  27. .SH PARAMETERS
  28. .TP \w'\fIslices\fP\ \ 'u
  29. \f2quad\fP
  30. Specifies the quadrics object (created with \%\f3gluNewQuadric\fP).
  31. .TP
  32. \f2inner\fP
  33. Specifies the inner radius of the disk (may be 0).
  34. .TP
  35. \f2outer\fP
  36. Specifies the outer radius of the disk.
  37. .TP
  38. \f2slices\fP
  39. Specifies the number of subdivisions around the \f2z\fP axis.
  40. .TP
  41. \f2loops\fP
  42. Specifies the number of concentric rings about the origin into which
  43. the disk is subdivided.
  44. .SH DESCRIPTION
  45. \%\f3gluDisk\fP renders a disk on the \f2z\fP = 0 plane. The disk has a radius of
  46. \f2outer\fP, and contains a concentric circular hole with a radius
  47. of \f2inner\fP. If \f2inner\fP is 0, then no hole is generated. The disk is
  48. subdivided around the \f2z\fP axis into slices (like pizza slices), and also
  49. about the \f2z\fP axis into rings
  50. (as specified by \f2slices\fP and \f2loops\fP, respectively).
  51. .P
  52. With respect to orientation, the +\f2z\fP side of the disk is considered to be
  53. "outside" (see \%\f3gluQuadricOrientation\fP).
  54. This means that if the
  55. orientation is set to \%\f3GLU_OUTSIDE\fP, then any normals generated
  56. point along the +\f2z\fP axis. Otherwise, they point along the \-\f2z\fP
  57. axis.
  58. .P
  59. If texturing has been turned on (with \%\f3gluQuadricTexture\fP),
  60. texture coordinates are generated
  61. linearly such that where $ r ~=~ "outer" $, the value at (\f2r\fP, 0, 0) is
  62. (1, 0.5), at (0, \f2r\fP, 0) it is (0.5, 1), at (\-\f2r\fP, 0, 0)
  63. it is (0, 0.5), and
  64. at (0, \-\f2r\fP, 0) it is (0.5, 0).
  65. .SH SEE ALSO
  66. \%\f3gluCylinder(3G)\fP, \%\f3gluNewQuadric(3G)\fP, \%\f3gluPartialDisk(3G)\fP,
  67. \%\f3gluQuadricOrientation(3G)\fP,
  68. \%\f3gluQuadricTexture(3G)\fP, \%\f3gluSphere(3G)\fP