4 * Freeglut state query methods.
6 * Copyright (c) 1999-2000 Pawel W. Olszta. All Rights Reserved.
7 * Written by Pawel W. Olszta, <olszta@sourceforge.net>
8 * Creation date: Thu Dec 16 1999
10 * Permission is hereby granted, free of charge, to any person obtaining a
11 * copy of this software and associated documentation files (the "Software"),
12 * to deal in the Software without restriction, including without limitation
13 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
14 * and/or sell copies of the Software, and to permit persons to whom the
15 * Software is furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice shall be included
18 * in all copies or substantial portions of the Software.
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
21 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * PAWEL W. OLSZTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
24 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
25 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 #include <GL/freeglut.h>
29 #include "fg_internal.h"
32 * TODO BEFORE THE STABLE RELEASE:
34 * glutGet() -- X11 tests passed, but check if all enums
35 * handled (what about Win32?)
36 * glutDeviceGet() -- X11 tests passed, but check if all enums
37 * handled (what about Win32?)
38 * glutGetModifiers() -- OK, but could also remove the limitation
39 * glutLayerGet() -- what about GLUT_NORMAL_DAMAGED?
41 * The fail-on-call policy will help adding the most needed things imho.
44 extern int fgPlatformGlutGet ( GLenum eWhat );
45 extern int fgPlatformGlutDeviceGet ( GLenum eWhat );
46 extern int *fgPlatformGlutGetModeValues(GLenum eWhat, int *size);
49 /* -- LOCAL DEFINITIONS ---------------------------------------------------- */
51 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
54 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
57 * General settings assignment method
59 void FGAPIENTRY glutSetOption( GLenum eWhat, int value )
61 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutSetOption" );
64 * XXX In chronological code add order. (WHY in that order?)
68 case GLUT_INIT_WINDOW_X:
69 fgState.Position.X = (GLint)value;
72 case GLUT_INIT_WINDOW_Y:
73 fgState.Position.Y = (GLint)value;
76 case GLUT_INIT_WINDOW_WIDTH:
77 fgState.Size.X = (GLint)value;
80 case GLUT_INIT_WINDOW_HEIGHT:
81 fgState.Size.Y = (GLint)value;
84 case GLUT_INIT_DISPLAY_MODE:
85 fgState.DisplayMode = (unsigned int)value;
88 case GLUT_ACTION_ON_WINDOW_CLOSE:
89 fgState.ActionOnWindowClose = value;
92 case GLUT_RENDERING_CONTEXT:
93 fgState.UseCurrentContext =
94 ( value == GLUT_USE_CURRENT_CONTEXT ) ? GL_TRUE : GL_FALSE;
97 case GLUT_DIRECT_RENDERING:
98 fgState.DirectContext = value;
101 case GLUT_WINDOW_CURSOR:
102 if( fgStructure.CurrentWindow != NULL )
103 fgStructure.CurrentWindow->State.Cursor = value;
107 fgState.AuxiliaryBufferNumber = value;
110 case GLUT_MULTISAMPLE:
111 fgState.SampleNumber = value;
114 case GLUT_SKIP_STALE_MOTION_EVENTS:
115 fgState.SkipStaleMotion = value;
118 case GLUT_GEOMETRY_VISUALIZE_NORMALS:
119 if( fgStructure.CurrentWindow != NULL )
120 fgStructure.CurrentWindow->State.VisualizeNormals = value;
124 fgWarning( "glutSetOption(): missing enum handle %d", eWhat );
130 * General settings query method
132 int FGAPIENTRY glutGet( GLenum eWhat )
136 case GLUT_INIT_STATE:
137 return fgState.Initialised;
139 /* Although internally the time store is 64bits wide, the return value
140 * here still wraps every 49.7 days. Integer overflows cancel however
141 * when subtracting an initial start time, unless the total time exceeds
142 * 32-bit, so you can still work with this.
143 * XXX: a glutGet64 to return the time might be an idea...
145 case GLUT_ELAPSED_TIME:
146 return (int) fgElapsedTime();
149 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutGet" );
151 /* XXX In chronological code add order. (WHY in that order?) */
154 /* Following values are stored in fgState and fgDisplay global structures */
155 case GLUT_SCREEN_WIDTH: return fgDisplay.ScreenWidth ;
156 case GLUT_SCREEN_HEIGHT: return fgDisplay.ScreenHeight ;
157 case GLUT_SCREEN_WIDTH_MM: return fgDisplay.ScreenWidthMM ;
158 case GLUT_SCREEN_HEIGHT_MM: return fgDisplay.ScreenHeightMM;
159 case GLUT_INIT_WINDOW_X: return fgState.Position.Use ?
160 fgState.Position.X : -1 ;
161 case GLUT_INIT_WINDOW_Y: return fgState.Position.Use ?
162 fgState.Position.Y : -1 ;
163 case GLUT_INIT_WINDOW_WIDTH: return fgState.Size.Use ?
164 fgState.Size.X : -1 ;
165 case GLUT_INIT_WINDOW_HEIGHT: return fgState.Size.Use ?
166 fgState.Size.Y : -1 ;
167 case GLUT_INIT_DISPLAY_MODE: return fgState.DisplayMode ;
168 case GLUT_INIT_MAJOR_VERSION: return fgState.MajorVersion ;
169 case GLUT_INIT_MINOR_VERSION: return fgState.MinorVersion ;
170 case GLUT_INIT_FLAGS: return fgState.ContextFlags ;
171 case GLUT_INIT_PROFILE: return fgState.ContextProfile ;
173 /* The window structure queries */
174 case GLUT_WINDOW_PARENT:
175 if( fgStructure.CurrentWindow == NULL ) return 0;
176 if( fgStructure.CurrentWindow->Parent == NULL ) return 0;
177 return fgStructure.CurrentWindow->Parent->ID;
179 case GLUT_WINDOW_NUM_CHILDREN:
180 if( fgStructure.CurrentWindow == NULL )
182 return fgListLength( &fgStructure.CurrentWindow->Children );
184 case GLUT_WINDOW_CURSOR:
185 if( fgStructure.CurrentWindow == NULL )
187 return fgStructure.CurrentWindow->State.Cursor;
189 case GLUT_MENU_NUM_ITEMS:
190 if( fgStructure.CurrentMenu == NULL )
192 return fgListLength( &fgStructure.CurrentMenu->Entries );
194 case GLUT_ACTION_ON_WINDOW_CLOSE:
195 return fgState.ActionOnWindowClose;
198 return VERSION_MAJOR * 10000 + VERSION_MINOR * 100 + VERSION_PATCH;
200 case GLUT_RENDERING_CONTEXT:
201 return fgState.UseCurrentContext ? GLUT_USE_CURRENT_CONTEXT
202 : GLUT_CREATE_NEW_CONTEXT;
204 case GLUT_DIRECT_RENDERING:
205 return fgState.DirectContext;
207 case GLUT_FULL_SCREEN:
208 return fgStructure.CurrentWindow->State.IsFullscreen;
211 return fgState.AuxiliaryBufferNumber;
213 case GLUT_MULTISAMPLE:
214 return fgState.SampleNumber;
216 case GLUT_SKIP_STALE_MOTION_EVENTS:
217 return fgState.SkipStaleMotion;
219 case GLUT_GEOMETRY_VISUALIZE_NORMALS:
220 if( fgStructure.CurrentWindow == NULL )
222 return fgStructure.CurrentWindow->State.VisualizeNormals;
225 return fgPlatformGlutGet ( eWhat );
232 * Returns various device information.
234 int FGAPIENTRY glutDeviceGet( GLenum eWhat )
236 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutDeviceGet" );
238 /* XXX WARNING: we are mostly lying in this function. */
241 case GLUT_HAS_JOYSTICK:
242 return fgJoystickDetect ();
244 case GLUT_OWNS_JOYSTICK:
245 return fgState.JoysticksInitialised;
247 case GLUT_JOYSTICK_POLL_RATE:
248 return fgStructure.CurrentWindow ? fgStructure.CurrentWindow->State.JoystickPollRate : 0;
250 /* XXX The following two are only for Joystick 0 but this is an improvement */
251 case GLUT_JOYSTICK_BUTTONS:
252 return glutJoystickGetNumButtons ( 0 );
254 case GLUT_JOYSTICK_AXES:
255 return glutJoystickGetNumAxes ( 0 );
257 case GLUT_HAS_DIAL_AND_BUTTON_BOX:
258 return fgInputDeviceDetect ();
261 if ( fgState.InputDevsInitialised ) return 8;
264 case GLUT_NUM_BUTTON_BOX_BUTTONS:
267 case GLUT_HAS_SPACEBALL:
268 return fgHasSpaceball();
270 case GLUT_HAS_TABLET:
273 case GLUT_NUM_SPACEBALL_BUTTONS:
274 return fgSpaceballNumButtons();
276 case GLUT_NUM_TABLET_BUTTONS:
279 case GLUT_DEVICE_IGNORE_KEY_REPEAT:
280 return fgStructure.CurrentWindow ? fgStructure.CurrentWindow->State.IgnoreKeyRepeat : 0;
282 case GLUT_DEVICE_KEY_REPEAT:
283 return fgState.KeyRepeat;
286 return fgPlatformGlutDeviceGet ( eWhat );
289 /* And now -- the failure. */
294 * This should return the current state of ALT, SHIFT and CTRL keys.
296 int FGAPIENTRY glutGetModifiers( void )
298 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutGetModifiers" );
299 if( fgState.Modifiers == INVALID_MODIFIERS )
301 fgWarning( "glutGetModifiers() called outside an input callback" );
305 return fgState.Modifiers;
309 * Return the state of the GLUT API overlay subsystem. A misery ;-)
311 int FGAPIENTRY glutLayerGet( GLenum eWhat )
313 FREEGLUT_EXIT_IF_NOT_INITIALISED ( "glutLayerGet" );
316 * This is easy as layers are not implemented and
317 * overlay support is not planned. E.g. on Windows,
318 * overlay requests in PFDs are ignored
319 * (see iLayerType at http://msdn.microsoft.com/en-us/library/dd368826(v=vs.85).aspx)
324 case GLUT_OVERLAY_POSSIBLE:
327 case GLUT_LAYER_IN_USE:
330 case GLUT_HAS_OVERLAY:
333 case GLUT_TRANSPARENT_INDEX:
335 * Return just anything, which is always defined as zero
341 case GLUT_NORMAL_DAMAGED:
342 /* XXX Actually I do not know. Maybe. */
345 case GLUT_OVERLAY_DAMAGED:
349 fgWarning( "glutLayerGet(): missing enum handle %d", eWhat );
353 /* And fail. That's good. Programs do love failing. */
357 int * FGAPIENTRY glutGetModeValues(GLenum eWhat, int *size)
361 FREEGLUT_EXIT_IF_NOT_INITIALISED("glutGetModeValues");
364 array = fgPlatformGlutGetModeValues ( eWhat, size );
369 /*** END OF FILE ***/