initnames.3gl 1.1 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. '\"macro stdmacro
  2. .ds Vn Version 1.2
  3. .ds Dt 24 September 1999
  4. .ds Re Release 1.2.1
  5. .ds Dp Jan 14 18:30
  6. .ds Dm 01 initnames
  7. .ds Xs 2647 3 initnames.gl
  8. .TH GLINITNAMES 3G
  9. .SH NAME
  10. .B "glInitNames
  11. \- initialize the name stack
  12. .SH C SPECIFICATION
  13. void \f3glInitNames\fP( void )
  14. .nf
  15. .fi
  16. .SH DESCRIPTION
  17. The name stack is used during selection mode to allow sets of rendering
  18. commands to be uniquely identified.
  19. It consists of an ordered set of unsigned integers.
  20. \%\f3glInitNames\fP causes the name stack to be initialized to its default empty state.
  21. .P
  22. The name stack is always empty while the render mode is not \%\f3GL_SELECT\fP.
  23. Calls to \%\f3glInitNames\fP while the render mode is not \%\f3GL_SELECT\fP are ignored.
  24. .SH ERRORS
  25. \%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glInitNames\fP
  26. is executed between the execution of \%\f3glBegin\fP and the corresponding execution of
  27. \%\f3glEnd\fP.
  28. .SH ASSOCIATED GETS
  29. \%\f3glGet\fP with argument \%\f3GL_NAME_STACK_DEPTH\fP
  30. .br
  31. \%\f3glGet\fP with argument \%\f3GL_MAX_NAME_STACK_DEPTH\fP
  32. .SH SEE ALSO
  33. \%\f3glLoadName(3G)\fP,
  34. \%\f3glPushName(3G)\fP,
  35. \%\f3glRenderMode(3G)\fP,
  36. \%\f3glSelectBuffer(3G)\fP