Section 3: library functions
glutGameModeString – Set the game mode display string LibraryOpenGLUT – gamemode SynopsisIn openglut.h Ft void Fn glutGameModeString const char *string ParametersBf Em string Ef A configuration parameter as a string. DescriptionSets the gamemode status according to an undocumented string. Glancing at old GLUT 3.7, the freeglut codebase that we inherited does not implement more than…
glutGameModeGet – Return the value of a game mode parameter LibraryOpenGLUT – gamemode SynopsisIn openglut.h Ft int Fn glutGameModeGet GLenum pname ParametersBf Em pname Ef The parameter value to be returned DescriptionBf Sy pname Ef is one of: – Bf Sy GLUT_GAME_MODE_ACTIVE Ef Return non-zero if we are presently in gamemode. – Bf Sy…
glutFullScreen – Resize the current window to cover the entire screen LibraryOpenGLUT – window SynopsisIn openglut.h Ft void Fn glutFullScreen void DescriptionThe glutFullScreen() function resizes the window to cover the entire screen and hide window decorations such as title bars and icons. CaveatsThe desktop resolution is not affected by a call to glutReshapeWindow() or glutFullScreen()….
glutForceJoystickFunc – Forces a joystick poll and callback. LibraryOpenGLUT – input SynopsisIn openglut.h Ft void Fn glutForceJoystickFunc void DescriptionForces the OpenGLUT joystick code to poll your joystick(s) and to call your joystick callbacks with the result. The operation completes, including callbacks, before glutForceJoystickFunc() returns. BugsThe original WINCE import used a #if to turn this function…
glutExtensionSupported – Determine if an OpenGL extension is available. LibraryOpenGLUT – opengl SynopsisIn openglut.h Ft int Fn glutExtensionSupported const char *extension ParametersBf Em extension Ef A string-name of an extension. DescriptionReturns 0 if OpenGLUT cannot determine that the requested extension is definitely present. Only checks extensions from glGetString(). TodoWouldn’t this be simpler and clearer if…
glutEstablishOverlay – Creates an overlay. LibraryOpenGLUT – overlays SynopsisIn openglut.h Ft void Fn glutEstablishOverlay void DescriptionCreates an overlay associated with the Bf Li current window Ef . CaveatsUnimplemented. Old GLUT would terminate the program when an overlay was not possible. freeglut ignores the request; OpenGLUT ignores the request as well. See AlsoglutRemoveOverlay(3) glutUseLayer(3) glutPostOverlayRedisplay(3) glutPostWindowOverlayRedisplay(3)…
glutEntryFunc – Window mouse entry/leave callback. LibraryOpenGLUT – input SynopsisIn openglut.h Ft void Fn glutEntryFunc void( *callback )( int state ) ParametersBf Em callback Ef Client window-entry hook. DescriptionWhen the mouse enters or exits a window (or sub-window), OpenGLUT can report this transition via the Entry callback. Bf Sy state Ef is one of Bf…
glutEnterGameMode – Enter game mode LibraryOpenGLUT – gamemode SynopsisIn openglut.h Ft int Fn glutEnterGameMode void DescriptionAny combination of the following may apply: – Resolution change, possibly to the requested resolution, possibly to a "nearest match". – Refresh frequency change. – A window with a drawable area equal to the requested screen resolution will be opened….
glutDisplayFunc – Sets the Display callback for the current window. LibraryOpenGLUT – windowcallback SynopsisIn openglut.h Ft void Fn glutDisplayFunc void( *callback )( void ) ParametersBf Em callback Ef Client function for normal redisplay event. DescriptionSets the display callback for the Bf Li current window Ef . All windows, including subwindows, Bf Em must Ef have…
glutDialsFunc – Sets a dials-box button callback. LibraryOpenGLUT – input SynopsisIn openglut.h Ft void Fn glutDialsFunc void( *callback )( int dial int value ) ParametersBf Em callback Ef Client dials-box dial hook. DescriptionA dials-and-buttons box has dials numbered from 1 to glutDeviceGet( Bf Sy GLUT_NUM_BUTTON_BOX_DIALS), Ef inclusive. The parameters to Bf Sy callback Ef are…
glutDeviceGet – Allows you to get some device state/option variables. LibraryOpenGLUT – inputstate SynopsisIn openglut.h Ft int Fn glutDeviceGet GLenum eWhat ParametersBf Em eWhat Ef Enumerated parameter ID. DescriptionRetrieves some system-specific information about attached devices. Supported device queries are: – Bf Sy GLUT_HAS_JOYSTICK Ef Return non-zero if there is a joystick. – Bf Sy…
glutDetachMenu – Detach menu from the current window. LibraryOpenGLUT – menus SynopsisIn openglut.h Ft void Fn glutDetachMenu int button ParametersBf Em button Ef Mouse button to unbind from. DescriptionIf the given Bf Sy button Ef has a menu bound to it, this breaks the assocation. See AlsoglutCreateMenu(3) glutDestroyMenu(3) glutAttachMenu(3)
glutDestroyWindow – Destroy a window and associated subwindows LibraryOpenGLUT – window SynopsisIn openglut.h Ft void Fn glutDestroyWindow int windowID ParametersBf Em windowID Ef Window identifier DescriptionAfter this function is invoked, the only further event that may be delivered for your window is the one for its destruction. All other events should be discarded. Once a…
glutDestroyMenu – Destroy a menu. LibraryOpenGLUT – menus SynopsisIn openglut.h Ft void Fn glutDestroyMenu int menuID ParametersBf Em menuID Ef The menu to destroy. DescriptionDestroys a given menu object by its ID. See AlsoglutCreateMenu(3)
glutCreateWindow – Create a new top-level window LibraryOpenGLUT – window SynopsisIn openglut.h Ft int Fn glutCreateWindow const char* title ParametersBf Em title Ef Title for created window DescriptionThis function sends a request for a window to be constructed. OpenGLUT immediately constructs a data structure to track further events with the window, on the theory that…
glutCreateSubWindow – Create a subwindow LibraryOpenGLUT – window SynopsisIn openglut.h Ft int Fn glutCreateSubWindow int parentID int x int y int w int h ParametersBf Em parentID Ef Parent window identifier Bf Em x Ef Horizontal position of subwindow Bf Em y Ef Vertical position of subwindow Bf Em w Ef Width of subwindow Bf…
glutCreateMenuWindow – Create a client-controlled menu window. LibraryOpenGLUT – experimental SynopsisIn openglut.h Ft int Fn glutCreateMenuWindow int parentID int x int y int w int h ParametersBf Em parentID Ef Parent window identifier. Bf Em x Ef Horizontal coordinate on the screen. Bf Em y Ef Vertical coordinate on the screen. Bf Em w Ef…
glutCreateMenu – Create a new menu. LibraryOpenGLUT – menus SynopsisIn openglut.h Ft int Fn glutCreateMenu void( *callback )( int value ) ParametersBf Em callback Ef Client hook for the new menu. DescriptionCreate a menu with a callback bound to Bf Sy callback, Ef and return the menu’s integer id. When the user makes a selection…
glutCopyColormap – Copies a color map between windows. LibraryOpenGLUT – colormap SynopsisIn openglut.h Ft void Fn glutCopyColormap int window ParametersBf Em window Ef The window to copy Bf Li to Ef DescriptionAllows you to copy an entire color map from one window to another. This function copies Bf Em from Ef the Bf Li…
glutCloseFunc – Window destruction callback. LibraryOpenGLUT – windowcallback SynopsisIn openglut.h Ft void Fn glutCloseFunc void( *callback )( void ) ParametersBf Em callback Ef Client window destruction hook. DescriptionWhen a window is destroyed by user-action in traditional GLUT, the application terminates. In freeglut and OpenGLUT, the application can choose to persist and treat the window close…