+In developing the freeglut library, we have taken careful steps +to ensure consistency in function operation across the board, in such a +manner as to maintain compatibility with GLUT's behavior whenever +possible. In this section some of the important conventions of FreeGLUT, +and their compatibility with GLUT, are made explicit. +
+ +
+There is considerable confusion about the "right thing to do" concerning
+window size and position. GLUT itself is not consistent between
+Windows and UNIX/X11; since platform independence is a virtue for
+freeglut, we decided to break with GLUT's behaviour.
+Under UNIX/X11, it is apparently not possible to get the window border
+sizes in order to subtract them off the window's initial position until
+some time after the window has been created. Therefore we decided on
+the following behavior, both under Windows and under UNIX/X11:
+
+Function to leave fullscreen window mode, glutLeaveFullScreen, +or to toggle between fullscreen and normal window mode, +glutFullScreenToggle, have been added. +
+ +Several new callbacks have been added and several callbacks which were specific @@ -315,7 +352,7 @@ callbacks. If the user has a need for an unsupported callback he should contact the freeglut development team.
-New functions have been added to render full character strings (including @@ -324,14 +361,14 @@ functions return the widths of character strings and the font heights, in pixels for bitmapped fonts and in OpenGL units for the stroke fonts.
-Two functions have been added to render a wireframe and a solid rhombic dodecahedron.
-glutGetProcAddress is a wrapper for the glXGetProcAddressARB and wglGetProcAddress @@ -364,8 +401,8 @@ functions specify a desired position and size for windows that The position is measured in pixels from the upper left hand corner of the screen, with "x" increasing to the right and "y" increasing towards the bottom of the screen. The size is measured in pixels. Freeglut - does not promise to follow these specifications in creating its windows, -it certainly makes an attempt to. +does not promise to follow these specifications in creating its windows, +but it certainly makes an attempt to.
@@ -373,10 +410,14 @@ The position and size of a window are a matter of some subtlety. Most
windows have a usable area surrounded by a border and with a title bar
on the top. The border and title bar are commonly called "decorations."
The position of the window unfortunately varies with the operating system.
-On Linux, it is the coordinates of the upper left-hand corner of its
-decorations. On Windows, it is the coordinates of the upper left hand
-corner of its usable interior. For both operating systems, the size of
-the window is the size of the usable interior.
+On both Linux and Windows, you specify the coordinates of the upper
+left-hand corner of the window's decorations. Also for both operating
+systems, the size of the window is the size of the usable interior.
+With glutGet information can be acquired about the current
+window's size, position and decorations. Note however that according to
+FreeGLUT's conventions, the information
+returned about the window coordinates does not correspond to the
+coordinates used when setting window position.
@@ -535,7 +576,40 @@ Consortium and ask for the code to be fixed.
+The glutFullScreen, glutLeaveFullScreen and +glutFullScreenToggle functions are used to transition the +current window between fullscreen and normal mode. +
+ +Usage
+ +void glutFullScreen ( void );
+void glutLeaveFullScreen ( void );
+void glutFullScreenToggle ( void );
+
Description
+ +
+The glutFullScreen function causes the current window to enter
+fullscreen mode, glutLeaveFullScreen to go back to the window
+size and position as it was before entering fullscreen mode, and
+glutFullScreenToggle toggles between fullscreen and normal
+mode.
+In multi-monitor setups on Windows 2000 and newer, the window will
+become fullscreen on the monitor that it overlaps the most.
+Calls to these functions are ignored for gamemode and child windows.
+Use glutGet(GLUT_FULL_SCREEN) to query fullscreen state of
+current window.
+
Changes From GLUT
+ +GLUT does not include the glutLeaveFullScreen and +glutFullScreenToggle functions.
+example:
+int windowLeft = glutGet(GLUT_WINDOW_X);
+
These queries are with respect to the current window:
@@ -1180,7 +1262,8 @@ These queries do not depend on the current window.
+Specify the display mode that should be entered when GameMode is +entered. Default is the current display mode of the monitor on which the +GameMode screen will be opened. +
+ +Usage
+A string is passed to this function that specifies a combination of
+resolution, pixel depth (ignored on Linux) and refresh rate. Valid
+formats are:
+
+Attempt to change to the requested display mode and open the GameMode +window, or close the GameMode window and return to the original display +mode. +For multi-monitor display setups, freeglut can be told on which +monitor the gamemode window should be opened by providing the +-display command line option to glutInit. +
++The following state variables may be queried with glutGet. +The returned value is an integer. +
+ +
+example:
+int windowLeft = glutGet(GLUT_WINDOW_X);
+
+These queries return information about the current display mode if in +GameMode, or about the requested display mode before entering +GameMode: +
+ +These functions are not implemented in freeglut.
+