4 * Various freeglut initialization functions.
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 2 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 #define FREEGLUT_BUILDING_LIB
29 #include <GL/freeglut.h>
30 #include "freeglut_internal.h"
32 #if TARGET_HOST_POSIX_X11
33 #include <limits.h> /* LONG_MAX */
37 * TODO BEFORE THE STABLE RELEASE:
39 * fgDeinitialize() -- Win32's OK, X11 needs the OS-specific
40 * deinitialization done
41 * glutInitDisplayString() -- display mode string parsing
43 * Wouldn't it be cool to use gettext() for error messages? I just love
44 * bash saying "nie znaleziono pliku" instead of "file not found" :)
45 * Is gettext easily portable?
48 /* -- GLOBAL VARIABLES ----------------------------------------------------- */
51 * A structure pointed by g_pDisplay holds all information
52 * regarding the display, screen, root window etc.
54 SFG_Display fgDisplay;
57 * The settings for the current freeglut session
59 SFG_State fgState = { { -1, -1, GL_FALSE }, /* Position */
60 { 300, 300, GL_TRUE }, /* Size */
61 GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH, /* DisplayMode */
62 GL_FALSE, /* Initialised */
63 GLUT_TRY_DIRECT_CONTEXT, /* DirectContext */
64 GL_FALSE, /* ForceIconic */
65 GL_FALSE, /* UseCurrentContext */
66 GL_FALSE, /* GLDebugSwitch */
67 GL_FALSE, /* XSyncSwitch */
68 GLUT_KEY_REPEAT_ON, /* KeyRepeat */
69 INVALID_MODIFIERS, /* Modifiers */
74 { NULL, NULL }, /* Timers */
75 { NULL, NULL }, /* FreeTimers */
76 NULL, /* IdleCallback */
78 NULL, /* MenuStateCallback */
79 NULL, /* MenuStatusCallback */
80 { 640, 480, GL_TRUE }, /* GameModeSize */
81 16, /* GameModeDepth */
82 72, /* GameModeRefresh */
83 GLUT_ACTION_EXIT, /* ActionOnWindowClose */
84 GLUT_EXEC_STATE_INIT, /* ExecState */
85 NULL, /* ProgramName */
86 GL_FALSE, /* JoysticksInitialised */
87 GL_FALSE, /* InputDevsInitialised */
88 1, /* AuxiliaryBufferNumber */
93 0 /* ContextProfile */
97 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
99 #if TARGET_HOST_POSIX_X11
101 /* Return the atom associated with "name". */
102 static Atom fghGetAtom(const char * name)
104 return XInternAtom(fgDisplay.Display, name, False);
108 * Check if "property" is set on "window". The property's values are returned
109 * through "data". If the property is set and is of type "type", return the
110 * number of elements in "data". Return zero otherwise. In both cases, use
111 * "Xfree()" to free "data".
113 static int fghGetWindowProperty(Window window,
116 unsigned char ** data)
119 * Caller always has to use "Xfree()" to free "data", since
120 * "XGetWindowProperty() always allocates one extra byte in prop_return
121 * [i.e. "data"] (even if the property is zero length) [..]".
124 int status; /* Returned by "XGetWindowProperty". */
127 int temp_format; /* Not used. */
128 unsigned long number_of_elements;
129 unsigned long temp_bytes_after; /* Not used. */
132 status = XGetWindowProperty(fgDisplay.Display,
145 FREEGLUT_INTERNAL_ERROR_EXIT(status == Success,
146 "XGetWindowProperty failled",
147 "fghGetWindowProperty");
149 if (type_returned != type)
151 number_of_elements = 0;
154 return number_of_elements;
157 /* Check if the window manager is NET WM compliant. */
158 static int fghNetWMSupported(void)
161 Window ** window_ptr_1;
163 int number_of_windows;
164 int net_wm_supported;
167 net_wm_supported = 0;
169 wm_check = fghGetAtom("_NET_SUPPORTING_WM_CHECK");
170 window_ptr_1 = malloc(sizeof(Window *));
173 * Check that the window manager has set this property on the root window.
174 * The property must be the ID of a child window.
176 number_of_windows = fghGetWindowProperty(fgDisplay.RootWindow,
179 (unsigned char **) window_ptr_1);
180 if (number_of_windows == 1)
182 Window ** window_ptr_2;
184 window_ptr_2 = malloc(sizeof(Window *));
186 /* Check that the window has the same property set to the same value. */
187 number_of_windows = fghGetWindowProperty(**window_ptr_1,
190 (unsigned char **) window_ptr_2);
191 if ((number_of_windows == 1) && (**window_ptr_1 == **window_ptr_2))
193 /* NET WM compliant */
194 net_wm_supported = 1;
197 XFree(*window_ptr_2);
201 XFree(*window_ptr_1);
204 return net_wm_supported;
207 /* Check if "hint" is present in "property" for "window". */
208 int fgHintPresent(Window window, Atom property, Atom hint)
217 atoms_ptr = malloc(sizeof(Atom *));
218 number_of_atoms = fghGetWindowProperty(window,
221 (unsigned char **) atoms_ptr);
222 for (i = 0; i < number_of_atoms; i++)
224 if ((*atoms_ptr)[i] == hint)
234 #endif /* TARGET_HOST_POSIX_X11 */
238 * A call to this function should initialize all the display stuff...
240 static void fghInitialize( const char* displayName )
242 #if TARGET_HOST_POSIX_X11
243 fgDisplay.Display = XOpenDisplay( displayName );
245 if( fgDisplay.Display == NULL )
246 fgError( "failed to open display '%s'", XDisplayName( displayName ) );
248 if( !glXQueryExtension( fgDisplay.Display, NULL, NULL ) )
249 fgError( "OpenGL GLX extension not supported by display '%s'",
250 XDisplayName( displayName ) );
252 fgDisplay.Screen = DefaultScreen( fgDisplay.Display );
253 fgDisplay.RootWindow = RootWindow(
258 fgDisplay.ScreenWidth = DisplayWidth(
262 fgDisplay.ScreenHeight = DisplayHeight(
267 fgDisplay.ScreenWidthMM = DisplayWidthMM(
271 fgDisplay.ScreenHeightMM = DisplayHeightMM(
276 fgDisplay.Connection = ConnectionNumber( fgDisplay.Display );
278 /* Create the window deletion atom */
279 fgDisplay.DeleteWindow = fghGetAtom("WM_DELETE_WINDOW");
281 /* Create the state and full screen atoms */
282 fgDisplay.State = None;
283 fgDisplay.StateFullScreen = None;
285 if (fghNetWMSupported())
287 const Atom supported = fghGetAtom("_NET_SUPPORTED");
288 const Atom state = fghGetAtom("_NET_WM_STATE");
290 /* Check if the state hint is supported. */
291 if (fgHintPresent(fgDisplay.RootWindow, supported, state))
293 const Atom full_screen = fghGetAtom("_NET_WM_STATE_FULLSCREEN");
295 fgDisplay.State = state;
297 /* Check if the window manager supports full screen. */
298 /** Check "_NET_WM_ALLOWED_ACTIONS" on our window instead? **/
299 if (fgHintPresent(fgDisplay.RootWindow, supported, full_screen))
301 fgDisplay.StateFullScreen = full_screen;
306 #elif TARGET_HOST_MS_WINDOWS
311 /* What we need to do is to initialize the fgDisplay global structure here. */
312 fgDisplay.Instance = GetModuleHandle( NULL );
314 atom = GetClassInfo( fgDisplay.Instance, _T("FREEGLUT"), &wc );
318 ZeroMemory( &wc, sizeof(WNDCLASS) );
321 * Each of the windows should have its own device context, and we
322 * want redraw events during Vertical and Horizontal Resizes by
325 * XXX Old code had "| CS_DBCLCKS" commented out. Plans for the
326 * XXX future? Dead-end idea?
328 wc.lpfnWndProc = fgWindowProc;
331 wc.hInstance = fgDisplay.Instance;
332 wc.hIcon = LoadIcon( fgDisplay.Instance, _T("GLUT_ICON") );
334 #if defined(_WIN32_WCE)
335 wc.style = CS_HREDRAW | CS_VREDRAW;
337 wc.style = CS_OWNDC | CS_HREDRAW | CS_VREDRAW;
339 wc.hIcon = LoadIcon( NULL, IDI_WINLOGO );
342 wc.hCursor = LoadCursor( NULL, IDC_ARROW );
343 wc.hbrBackground = NULL;
344 wc.lpszMenuName = NULL;
345 wc.lpszClassName = _T("FREEGLUT");
347 /* Register the window class */
348 atom = RegisterClass( &wc );
349 FREEGLUT_INTERNAL_ERROR_EXIT ( atom, "Window Class Not Registered", "fghInitialize" );
352 /* The screen dimensions can be obtained via GetSystemMetrics() calls */
353 fgDisplay.ScreenWidth = GetSystemMetrics( SM_CXSCREEN );
354 fgDisplay.ScreenHeight = GetSystemMetrics( SM_CYSCREEN );
357 HWND desktop = GetDesktopWindow( );
358 HDC context = GetDC( desktop );
360 fgDisplay.ScreenWidthMM = GetDeviceCaps( context, HORZSIZE );
361 fgDisplay.ScreenHeightMM = GetDeviceCaps( context, VERTSIZE );
363 ReleaseDC( desktop, context );
366 /* Set the timer granularity to 1 ms */
367 timeBeginPeriod ( 1 );
371 fgState.Initialised = GL_TRUE;
373 /* InputDevice uses GlutTimerFunc(), so fgState.Initialised must be TRUE */
374 fgInitialiseInputDevices();
378 * Perform the freeglut deinitialization...
380 void fgDeinitialize( void )
384 if( !fgState.Initialised )
386 fgWarning( "fgDeinitialize(): "
387 "no valid initialization has been performed" );
391 /* If there was a menu created, destroy the rendering context */
392 if( fgStructure.MenuContext )
394 #if TARGET_HOST_POSIX_X11
395 /* Note that the MVisualInfo is not owned by the MenuContext! */
396 glXDestroyContext( fgDisplay.Display, fgStructure.MenuContext->MContext );
398 free( fgStructure.MenuContext );
399 fgStructure.MenuContext = NULL;
402 fgDestroyStructure( );
404 while( ( timer = fgState.Timers.First) )
406 fgListRemove( &fgState.Timers, &timer->Node );
410 while( ( timer = fgState.FreeTimers.First) )
412 fgListRemove( &fgState.FreeTimers, &timer->Node );
416 #if !defined(_WIN32_WCE)
417 if ( fgState.JoysticksInitialised )
420 if ( fgState.InputDevsInitialised )
421 fgInputDeviceClose( );
422 #endif /* !defined(_WIN32_WCE) */
423 fgState.JoysticksInitialised = GL_FALSE;
424 fgState.InputDevsInitialised = GL_FALSE;
426 fgState.MajorVersion = 1;
427 fgState.MinorVersion = 0;
428 fgState.ContextFlags = 0;
429 fgState.ContextProfile = 0;
431 fgState.Initialised = GL_FALSE;
433 fgState.Position.X = -1;
434 fgState.Position.Y = -1;
435 fgState.Position.Use = GL_FALSE;
437 fgState.Size.X = 300;
438 fgState.Size.Y = 300;
439 fgState.Size.Use = GL_TRUE;
441 fgState.DisplayMode = GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH;
443 fgState.DirectContext = GLUT_TRY_DIRECT_CONTEXT;
444 fgState.ForceIconic = GL_FALSE;
445 fgState.UseCurrentContext = GL_FALSE;
446 fgState.GLDebugSwitch = GL_FALSE;
447 fgState.XSyncSwitch = GL_FALSE;
448 fgState.ActionOnWindowClose = GLUT_ACTION_EXIT;
449 fgState.ExecState = GLUT_EXEC_STATE_INIT;
451 fgState.KeyRepeat = GLUT_KEY_REPEAT_ON;
452 fgState.Modifiers = INVALID_MODIFIERS;
454 fgState.GameModeSize.X = 640;
455 fgState.GameModeSize.Y = 480;
456 fgState.GameModeDepth = 16;
457 fgState.GameModeRefresh = 72;
459 fgListInit( &fgState.Timers );
460 fgListInit( &fgState.FreeTimers );
462 fgState.IdleCallback = NULL;
463 fgState.MenuStateCallback = ( FGCBMenuState )NULL;
464 fgState.MenuStatusCallback = ( FGCBMenuStatus )NULL;
466 fgState.SwapCount = 0;
467 fgState.SwapTime = 0;
468 fgState.FPSInterval = 0;
470 if( fgState.ProgramName )
472 free( fgState.ProgramName );
473 fgState.ProgramName = NULL;
476 #if TARGET_HOST_POSIX_X11
479 * Make sure all X-client data we have created will be destroyed on
482 XSetCloseDownMode( fgDisplay.Display, DestroyAll );
485 * Close the display connection, destroying all windows we have
488 XCloseDisplay( fgDisplay.Display );
490 #elif TARGET_HOST_MS_WINDOWS
492 /* Reset the timer granularity */
497 fgState.Initialised = GL_FALSE;
501 * Everything inside the following #ifndef is copied from the X sources.
504 #if TARGET_HOST_MS_WINDOWS
508 Copyright 1985, 1986, 1987,1998 The Open Group
510 Permission to use, copy, modify, distribute, and sell this software and its
511 documentation for any purpose is hereby granted without fee, provided that
512 the above copyright notice appear in all copies and that both that
513 copyright notice and this permission notice appear in supporting
516 The above copyright notice and this permission notice shall be included
517 in all copies or substantial portions of the Software.
519 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
520 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
521 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
522 IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
523 OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
524 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
525 OTHER DEALINGS IN THE SOFTWARE.
527 Except as contained in this notice, the name of The Open Group shall
528 not be used in advertising or otherwise to promote the sale, use or
529 other dealings in this Software without prior written authorization
534 #define NoValue 0x0000
535 #define XValue 0x0001
536 #define YValue 0x0002
537 #define WidthValue 0x0004
538 #define HeightValue 0x0008
539 #define AllValues 0x000F
540 #define XNegative 0x0010
541 #define YNegative 0x0020
544 * XParseGeometry parses strings of the form
545 * "=<width>x<height>{+-}<xoffset>{+-}<yoffset>", where
546 * width, height, xoffset, and yoffset are unsigned integers.
547 * Example: "=80x24+300-49"
548 * The equal sign is optional.
549 * It returns a bitmask that indicates which of the four values
550 * were actually found in the string. For each value found,
551 * the corresponding argument is updated; for each value
552 * not found, the corresponding argument is left unchanged.
556 ReadInteger(char *string, char **NextString)
558 register int Result = 0;
563 else if (*string == '-')
568 for (; (*string >= '0') && (*string <= '9'); string++)
570 Result = (Result * 10) + (*string - '0');
572 *NextString = string;
579 static int XParseGeometry (
583 unsigned int *width, /* RETURN */
584 unsigned int *height) /* RETURN */
587 register char *strind;
588 unsigned int tempWidth = 0, tempHeight = 0;
589 int tempX = 0, tempY = 0;
592 if ( (string == NULL) || (*string == '\0'))
595 string++; /* ignore possible '=' at beg of geometry spec */
597 strind = (char *)string;
598 if (*strind != '+' && *strind != '-' && *strind != 'x') {
599 tempWidth = ReadInteger(strind, &nextCharacter);
600 if (strind == nextCharacter)
602 strind = nextCharacter;
606 if (*strind == 'x' || *strind == 'X') {
608 tempHeight = ReadInteger(strind, &nextCharacter);
609 if (strind == nextCharacter)
611 strind = nextCharacter;
615 if ((*strind == '+') || (*strind == '-')) {
616 if (*strind == '-') {
618 tempX = -ReadInteger(strind, &nextCharacter);
619 if (strind == nextCharacter)
621 strind = nextCharacter;
627 tempX = ReadInteger(strind, &nextCharacter);
628 if (strind == nextCharacter)
630 strind = nextCharacter;
633 if ((*strind == '+') || (*strind == '-')) {
634 if (*strind == '-') {
636 tempY = -ReadInteger(strind, &nextCharacter);
637 if (strind == nextCharacter)
639 strind = nextCharacter;
645 tempY = ReadInteger(strind, &nextCharacter);
646 if (strind == nextCharacter)
648 strind = nextCharacter;
654 /* If strind isn't at the end of the string the it's an invalid
655 geometry specification. */
657 if (*strind != '\0') return 0;
663 if (mask & WidthValue)
665 if (mask & HeightValue)
666 *height = tempHeight;
671 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
674 * Perform initialization. This usually happens on the program startup
675 * and restarting after glutMainLoop termination...
677 void FGAPIENTRY glutInit( int* pargc, char** argv )
679 char* displayName = NULL;
680 char* geometry = NULL;
681 int i, j, argc = *pargc;
683 /* will return true for VC8 (VC2005) and higher */
684 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
689 if( fgState.Initialised )
690 fgError( "illegal glutInit() reinitialization attempt" );
692 if (pargc && *pargc && argv && *argv && **argv)
694 fgState.ProgramName = strdup (*argv);
696 if( !fgState.ProgramName )
697 fgError ("Could not allocate space for the program's name.");
700 fgCreateStructure( );
703 fgState.Time = fgSystemTime();
705 /* check if GLUT_FPS env var is set */
708 /* will return true for VC8 (VC2005) and higher */
709 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
711 err = _dupenv_s( &fps, &sLen, "GLUT_FPS" );
713 fgError("Error getting GLUT_FPS environment variable");
715 const char *fps = getenv( "GLUT_FPS" );
720 sscanf( fps, "%d", &interval );
723 fgState.FPSInterval = 5000; /* 5000 millisecond default */
725 fgState.FPSInterval = interval;
727 /* will return true for VC8 (VC2005) and higher */
728 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
729 free ( fps ); fps = NULL; /* dupenv_s allocates a string that we must free */
733 /* will return true for VC8 (VC2005) and higher */
734 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
735 err = _dupenv_s( &displayName, &sLen, "DISPLAY" );
737 fgError("Error getting DISPLAY environment variable");
739 displayName = getenv( "DISPLAY" );
742 for( i = 1; i < argc; i++ )
744 if( strcmp( argv[ i ], "-display" ) == 0 )
747 fgError( "-display parameter must be followed by display name" );
749 displayName = argv[ i ];
751 argv[ i - 1 ] = NULL;
755 else if( strcmp( argv[ i ], "-geometry" ) == 0 )
758 fgError( "-geometry parameter must be followed by window "
759 "geometry settings" );
761 geometry = argv[ i ];
763 argv[ i - 1 ] = NULL;
767 else if( strcmp( argv[ i ], "-direct" ) == 0)
769 if( fgState.DirectContext == GLUT_FORCE_INDIRECT_CONTEXT )
770 fgError( "parameters ambiguity, -direct and -indirect "
771 "cannot be both specified" );
773 fgState.DirectContext = GLUT_FORCE_DIRECT_CONTEXT;
777 else if( strcmp( argv[ i ], "-indirect" ) == 0 )
779 if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )
780 fgError( "parameters ambiguity, -direct and -indirect "
781 "cannot be both specified" );
783 fgState.DirectContext = GLUT_FORCE_INDIRECT_CONTEXT;
787 else if( strcmp( argv[ i ], "-iconic" ) == 0 )
789 fgState.ForceIconic = GL_TRUE;
793 else if( strcmp( argv[ i ], "-gldebug" ) == 0 )
795 fgState.GLDebugSwitch = GL_TRUE;
799 else if( strcmp( argv[ i ], "-sync" ) == 0 )
801 fgState.XSyncSwitch = GL_TRUE;
807 /* Compact {argv}. */
808 for( i = j = 1; i < *pargc; i++, j++ )
810 /* Guaranteed to end because there are "*pargc" arguments left */
811 while ( argv[ j ] == NULL )
814 argv[ i ] = argv[ j ];
817 #endif /* _WIN32_WCE */
820 * Have the display created now. If there wasn't a "-display"
821 * in the program arguments, we will use the DISPLAY environment
822 * variable for opening the X display (see code above):
824 fghInitialize( displayName );
825 /* will return true for VC8 (VC2005) and higher */
826 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
827 free ( displayName ); displayName = NULL; /* dupenv_s allocates a string that we must free */
831 * Geometry parsing deffered until here because we may need the screen
837 unsigned int parsedWidth, parsedHeight;
838 int mask = XParseGeometry( geometry,
839 &fgState.Position.X, &fgState.Position.Y,
840 &parsedWidth, &parsedHeight );
841 /* TODO: Check for overflow? */
842 fgState.Size.X = parsedWidth;
843 fgState.Size.Y = parsedHeight;
845 if( (mask & (WidthValue|HeightValue)) == (WidthValue|HeightValue) )
846 fgState.Size.Use = GL_TRUE;
848 if( mask & XNegative )
849 fgState.Position.X += fgDisplay.ScreenWidth - fgState.Size.X;
851 if( mask & YNegative )
852 fgState.Position.Y += fgDisplay.ScreenHeight - fgState.Size.Y;
854 if( (mask & (XValue|YValue)) == (XValue|YValue) )
855 fgState.Position.Use = GL_TRUE;
859 #if TARGET_HOST_MS_WINDOWS
860 void (__cdecl *__glutExitFunc)( int return_value ) = NULL;
862 void FGAPIENTRY __glutInitWithExit( int *pargc, char **argv, void (__cdecl *exit_function)(int) )
864 __glutExitFunc = exit_function;
865 glutInit(pargc, argv);
870 * Undoes all the "glutInit" stuff
872 void FGAPIENTRY glutExit ( void )
878 * Sets the default initial window position for new windows
880 void FGAPIENTRY glutInitWindowPosition( int x, int y )
882 fgState.Position.X = x;
883 fgState.Position.Y = y;
885 if( ( x >= 0 ) && ( y >= 0 ) )
886 fgState.Position.Use = GL_TRUE;
888 fgState.Position.Use = GL_FALSE;
892 * Sets the default initial window size for new windows
894 void FGAPIENTRY glutInitWindowSize( int width, int height )
896 fgState.Size.X = width;
897 fgState.Size.Y = height;
899 if( ( width > 0 ) && ( height > 0 ) )
900 fgState.Size.Use = GL_TRUE;
902 fgState.Size.Use = GL_FALSE;
906 * Sets the default display mode for all new windows
908 void FGAPIENTRY glutInitDisplayMode( unsigned int displayMode )
910 /* We will make use of this value when creating a new OpenGL context... */
911 fgState.DisplayMode = displayMode;
915 /* -- INIT DISPLAY STRING PARSING ------------------------------------------ */
917 static char* Tokens[] =
919 "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double",
920 "green", "index", "num", "red", "rgba", "rgb", "luminance", "stencil",
921 "single", "stereo", "samples", "slow", "win32pdf", "win32pfd", "xvisual",
922 "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",
923 "xtruecolor", "xdirectcolor",
924 "xstaticgrey", "xgreyscale", "xstaticcolour", "xpseudocolour",
925 "xtruecolour", "xdirectcolour", "borderless", "aux"
927 #define NUM_TOKENS (sizeof(Tokens) / sizeof(*Tokens))
929 void FGAPIENTRY glutInitDisplayString( const char* displayMode )
931 int glut_state_flag = 0 ;
933 * Unpack a lot of options from a character string. The options are
934 * delimited by blanks or tabs.
937 /* will return true for VC8 (VC2005) and higher */
938 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
939 char *next_token = NULL;
941 size_t len = strlen ( displayMode );
942 char *buffer = (char *)malloc ( (len+1) * sizeof(char) );
943 memcpy ( buffer, displayMode, len );
946 /* will return true for VC8 (VC2005) and higher */
947 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
948 token = strtok_s ( buffer, " \t", &next_token );
950 token = strtok ( buffer, " \t" );
954 /* Process this token */
957 /* Temporary fix: Ignore any length specifications and at least
958 * process the basic token
959 * TODO: Fix this permanently
961 size_t cleanlength = strcspn ( token, "=<>~!" );
963 for ( i = 0; i < NUM_TOKENS; i++ )
965 if ( strncmp ( token, Tokens[i], cleanlength ) == 0 ) break ;
970 case 0 : /* "alpha": Alpha color buffer precision in bits */
971 glut_state_flag |= GLUT_ALPHA ; /* Somebody fix this for me! */
974 case 1 : /* "acca": Red, green, blue, and alpha accumulation buffer
978 case 2 : /* "acc": Red, green, and blue accumulation buffer precision
979 in bits with zero bits alpha */
980 glut_state_flag |= GLUT_ACCUM ; /* Somebody fix this for me! */
983 case 3 : /* "blue": Blue color buffer precision in bits */
986 case 4 : /* "buffer": Number of bits in the color index color buffer
990 case 5 : /* "conformant": Boolean indicating if the frame buffer
991 configuration is conformant or not */
994 case 6 : /* "depth": Number of bits of precsion in the depth buffer */
995 glut_state_flag |= GLUT_DEPTH ; /* Somebody fix this for me! */
998 case 7 : /* "double": Boolean indicating if the color buffer is
1000 glut_state_flag |= GLUT_DOUBLE ;
1003 case 8 : /* "green": Green color buffer precision in bits */
1006 case 9 : /* "index": Boolean if the color model is color index or not
1008 glut_state_flag |= GLUT_INDEX ;
1011 case 10 : /* "num": A special capability name indicating where the
1012 value represents the Nth frame buffer configuration
1013 matching the description string */
1016 case 11 : /* "red": Red color buffer precision in bits */
1019 case 12 : /* "rgba": Number of bits of red, green, blue, and alpha in
1020 the RGBA color buffer */
1021 glut_state_flag |= GLUT_RGBA ; /* Somebody fix this for me! */
1024 case 13 : /* "rgb": Number of bits of red, green, and blue in the
1025 RGBA color buffer with zero bits alpha */
1026 glut_state_flag |= GLUT_RGB ; /* Somebody fix this for me! */
1029 case 14 : /* "luminance": Number of bits of red in the RGBA and zero
1030 bits of green, blue (alpha not specified) of color buffer
1032 glut_state_flag |= GLUT_LUMINANCE ; /* Somebody fix this for me! */
1035 case 15 : /* "stencil": Number of bits in the stencil buffer */
1036 glut_state_flag |= GLUT_STENCIL; /* Somebody fix this for me! */
1039 case 16 : /* "single": Boolean indicate the color buffer is single
1041 glut_state_flag |= GLUT_SINGLE ;
1044 case 17 : /* "stereo": Boolean indicating the color buffer supports
1045 OpenGL-style stereo */
1046 glut_state_flag |= GLUT_STEREO ;
1049 case 18 : /* "samples": Indicates the number of multisamples to use
1050 based on GLX's SGIS_multisample extension (for
1052 glut_state_flag |= GLUT_MULTISAMPLE ; /*Somebody fix this for me!*/
1055 case 19 : /* "slow": Boolean indicating if the frame buffer
1056 configuration is slow or not */
1059 case 20 : /* "win32pdf": (incorrect spelling but was there before */
1060 case 21 : /* "win32pfd": matches the Win32 Pixel Format Descriptor by
1062 #if TARGET_HOST_MS_WINDOWS
1066 case 22 : /* "xvisual": matches the X visual ID by number */
1067 #if TARGET_HOST_POSIX_X11
1071 case 23 : /* "xstaticgray": */
1072 case 29 : /* "xstaticgrey": boolean indicating if the frame buffer
1073 configuration's X visual is of type StaticGray */
1074 #if TARGET_HOST_POSIX_X11
1078 case 24 : /* "xgrayscale": */
1079 case 30 : /* "xgreyscale": boolean indicating if the frame buffer
1080 configuration's X visual is of type GrayScale */
1081 #if TARGET_HOST_POSIX_X11
1085 case 25 : /* "xstaticcolor": */
1086 case 31 : /* "xstaticcolour": boolean indicating if the frame buffer
1087 configuration's X visual is of type StaticColor */
1088 #if TARGET_HOST_POSIX_X11
1092 case 26 : /* "xpseudocolor": */
1093 case 32 : /* "xpseudocolour": boolean indicating if the frame buffer
1094 configuration's X visual is of type PseudoColor */
1095 #if TARGET_HOST_POSIX_X11
1099 case 27 : /* "xtruecolor": */
1100 case 33 : /* "xtruecolour": boolean indicating if the frame buffer
1101 configuration's X visual is of type TrueColor */
1102 #if TARGET_HOST_POSIX_X11
1106 case 28 : /* "xdirectcolor": */
1107 case 34 : /* "xdirectcolour": boolean indicating if the frame buffer
1108 configuration's X visual is of type DirectColor */
1109 #if TARGET_HOST_POSIX_X11
1113 case 35 : /* "borderless": windows should not have borders */
1114 #if TARGET_HOST_POSIX_X11
1118 case 36 : /* "aux": some number of aux buffers */
1119 glut_state_flag |= GLUT_AUX;
1122 case 37 : /* Unrecognized */
1123 fgWarning ( "WARNING - Display string token not recognized: %s",
1128 /* will return true for VC8 (VC2005) and higher */
1129 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
1130 token = strtok_s ( NULL, " \t", &next_token );
1132 token = strtok ( NULL, " \t" );
1138 /* We will make use of this value when creating a new OpenGL context... */
1139 fgState.DisplayMode = glut_state_flag;
1142 /* -- SETTING OPENGL 3.0 CONTEXT CREATION PARAMETERS ---------------------- */
1144 void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion )
1146 /* We will make use of these valuse when creating a new OpenGL context... */
1147 fgState.MajorVersion = majorVersion;
1148 fgState.MinorVersion = minorVersion;
1152 void FGAPIENTRY glutInitContextFlags( int flags )
1154 /* We will make use of this value when creating a new OpenGL context... */
1155 fgState.ContextFlags = flags;
1158 void FGAPIENTRY glutInitContextProfile( int profile )
1160 /* We will make use of this value when creating a new OpenGL context... */
1161 fgState.ContextProfile = profile;
1164 /*** END OF FILE ***/