glutEnterGameMode.man
上传用户:xk288cn
上传日期:2007-05-28
资源大小:4876k
文件大小:4k
源码类别:

GIS编程

开发平台:

Visual C++

  1. ."
  2. ." Copyright (c) Mark J. Kilgard, 1998.
  3. ."
  4. .TH glutEnterGameMode 3GLUT "3.7" "GLUT" "GLUT"
  5. .SH NAME
  6. glutEnterGameMode, glutLeaveGameMode - enters and leaves GLUT's game mode.
  7. .SH SYNTAX
  8. .nf
  9. .LP
  10. void glutEnterGameMode(void);
  11. void glutLeaveGameMode(void);
  12. .fi
  13. .SH DESCRIPTION
  14. glutEnterGameMode is designed to enable high-performance fullscreen GLUT rendering, possibly
  15. at a different screen display format.  Calling glutEnterGameMode creates a
  16. special fullscreen GLUT window (with its own callbacks and OpenGL rendering context
  17. state).  If the game mode string describes a possible screen display format,
  18. GLUT also changes the screen display format to the one described by the
  19. game mode string.  glutLeaveGameMode leaves the GLUT game mode and returns the
  20. screen display format to its default format.
  21. When game mode is entered, certain GLUT functionality is disable to facilitate
  22. high-performance fullscreen rendering.  GLUT pop-up menus are not available
  23. while in game mode.  Other created windows and subwindows are not displayed
  24. in GLUT game mode.  Game mode will also hide all other applications running
  25. on the computer's display screen.
  26. The intent of these restrictions is to eliminate window
  27. clipping issues, permit screen display format changes,
  28. and permit fullscreen
  29. rendering optimization such as page flipping for fullscreen buffer swaps.
  30. After leaving game mode, the GLUT functionality disabled in game mode is
  31. available again.  The game mode window (and its OpenGL rendering state) is
  32. destroyed when leaving game mode.  Any windows and subwindows created before
  33. entering the game mode are displayed in their previous locations.  The OpenGL
  34. state of normal GLUT windows and subwindows is not disturbed by entering
  35. and/or leaving game mode.
  36. The following GLUT routines are ignored in game mode:  glutFullScreen,
  37. glutSetWindowTitle, glutSetIconTitle, glutPositionWindow, glutReshapeWindow,
  38. glutPopWindow, glutPushWindow, glutIconifyWindow, glutShowWindow,
  39. glutHideWindow.
  40. glutEnterGameMode can be called when already in game mode.  This will destroy
  41. the previous game mode window (including any OpenGL rendering state) and
  42. create a new game mode window with a new OpenGL rendering context.
  43. Also if glutEnterGameMode is called when already in game mode and if the game mode
  44. string has changed and describes a possible screen display format, the new
  45. screen display format takes effect.  A reshape callback is generated if the 
  46. game mode window changes size due to a screen display format change.
  47. Re-entering game mode provides a mechanism for changing the screen display
  48. format while already in game mode.  Note though that the game mode window's
  49. OpenGL state is lost in this process and the application is responsible for
  50. re-initializing the newly created game mode window OpenGL state when
  51. re-entering game mode.
  52. Game mode cannot be entered while pop-up menus are in use.
  53. Note that the glutEnterGameMode and glutFullScreen routines operate differently.
  54. glutFullScreen simply makes the current window match the size of the screen.
  55. glutFullScreen does not change the screen display format and does not disable
  56. any GLUT features such as pop-up menus; glutFullScreen continues to operate
  57. in a "windowed" mode of operation.  glutEnterGameMode creates a new window
  58. style, possibly changes the screen display mode, limits GLUT functionality,
  59. and hides other applications.
  60. .SH SEE ALSO
  61. glutGameModeGet, glutGameModeString, glutInitDisplayString
  62. .SH AUTHOR
  63. Mark J. Kilgard (mjk@nvidia.com)