begincurve.3gl 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  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 begincurv
  9. .ds Xs 19309 4 begincurve.gl
  10. .TH GLUBEGINCURVE 3G
  11. .SH NAME
  12. .B "gluBeginCurve, gluEndCurve
  13. \- delimit a NURBS curve definition
  14. .SH C SPECIFICATION
  15. void \f3gluBeginCurve\fP(
  16. GLUnurbs* \fInurb\fP )
  17. .nf
  18. .fi
  19. void \f3gluEndCurve\fP(
  20. GLUnurbs* \fInurb\fP )
  21. .nf
  22. .fi
  23. .EQ
  24. delim $$
  25. .EN
  26. .SH PARAMETERS
  27. .TP \w'\f2nurb\fP\ \ 'u
  28. \f2nurb\fP
  29. Specifies the NURBS object (created with \%\f3gluNewNurbsRenderer\fP).
  30. .SH DESCRIPTION
  31. Use \%\f3gluBeginCurve\fP to mark the beginning of a NURBS
  32. curve definition.
  33. After
  34. calling \%\f3gluBeginCurve\fP, make one or more calls to
  35. \%\f3gluNurbsCurve\fP to define the attributes of the curve.
  36. Exactly one of the calls to \%\f3gluNurbsCurve\fP must have
  37. a curve type of \%\f3GL_MAP1_VERTEX_3\fP or \%\f3GL_MAP1_VERTEX_4\fP.
  38. To mark the end of the NURBS curve definition, call \%\f3gluEndCurve\fP.
  39. .P
  40. GL evaluators are used to render the NURBS curve as a series of line
  41. segments.
  42. Evaluator state is preserved during rendering
  43. with \f3glPushAttrib\fP(\%\f3GL_EVAL_BIT\fP) and
  44. \f3glPopAttrib\fP().
  45. See the \f3glPushAttrib\fP reference page for details on exactly what state
  46. these calls preserve.
  47. .SH EXAMPLE
  48. The following commands render a textured NURBS curve with normals;
  49. texture coordinates and normals are also specified as NURBS curves:
  50. .sp
  51. .Ex
  52. gluBeginCurve(nobj);
  53. gluNurbsCurve(nobj, ..., GL_MAP1_TEXTURE_COORD_2);
  54. gluNurbsCurve(nobj, ..., GL_MAP1_NORMAL);
  55. gluNurbsCurve(nobj, ..., GL_MAP1_VERTEX_4);
  56. gluEndCurve(nobj);
  57. .Ee
  58. .SH SEE ALSO
  59. \%\f3gluBeginSurface(3G)\fP, \%\f3gluBeginTrim(3G)\fP, \%\f3gluNewNurbsRenderer(3G)\fP,
  60. \%\f3gluNurbsCurve(3G)\fP,
  61. \f3glPopAttrib(3G)\fP, \f3glPushAttrib(3G)\fP