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 #include <GL/freeglut.h>
29 #include "freeglut_internal.h"
31 #if TARGET_HOST_POSIX_X11
32 #include <limits.h> /* LONG_MAX */
36 * TODO BEFORE THE STABLE RELEASE:
38 * fgDeinitialize() -- Win32's OK, X11 needs the OS-specific
39 * deinitialization done
40 * glutInitDisplayString() -- display mode string parsing
42 * Wouldn't it be cool to use gettext() for error messages? I just love
43 * bash saying "nie znaleziono pliku" instead of "file not found" :)
44 * Is gettext easily portable?
47 /* -- GLOBAL VARIABLES ----------------------------------------------------- */
50 * A structure pointed by g_pDisplay holds all information
51 * regarding the display, screen, root window etc.
53 SFG_Display fgDisplay;
56 * The settings for the current freeglut session
58 SFG_State fgState = { { -1, -1, GL_FALSE }, /* Position */
59 { 300, 300, GL_TRUE }, /* Size */
60 GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH, /* DisplayMode */
61 GL_FALSE, /* Initialised */
62 GLUT_TRY_DIRECT_CONTEXT, /* DirectContext */
63 GL_FALSE, /* ForceIconic */
64 GL_FALSE, /* UseCurrentContext */
65 GL_FALSE, /* GLDebugSwitch */
66 GL_FALSE, /* XSyncSwitch */
67 GLUT_KEY_REPEAT_ON, /* KeyRepeat */
68 INVALID_MODIFIERS, /* Modifiers */
73 { NULL, NULL }, /* Timers */
74 { NULL, NULL }, /* FreeTimers */
75 NULL, /* IdleCallback */
77 NULL, /* MenuStateCallback */
78 NULL, /* MenuStatusCallback */
79 { 640, 480, GL_TRUE }, /* GameModeSize */
80 16, /* GameModeDepth */
81 72, /* GameModeRefresh */
82 GLUT_ACTION_EXIT, /* ActionOnWindowClose */
83 GLUT_EXEC_STATE_INIT, /* ExecState */
84 NULL, /* ProgramName */
85 GL_FALSE, /* JoysticksInitialised */
86 GL_FALSE, /* InputDevsInitialised */
87 1, /* AuxiliaryBufferNumber */
95 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
97 #if TARGET_HOST_POSIX_X11
99 /* Return the atom associated with "name". */
100 static Atom fghGetAtom(const char * name)
102 return XInternAtom(fgDisplay.Display, name, False);
106 * Check if "property" is set on "window". The property's values are returned
107 * through "data". If the property is set and is of type "type", return the
108 * number of elements in "data". Return zero otherwise. In both cases, use
109 * "Xfree()" to free "data".
111 static int fghGetWindowProperty(Window window,
114 unsigned char ** data)
117 * Caller always has to use "Xfree()" to free "data", since
118 * "XGetWindowProperty() always allocates one extra byte in prop_return
119 * [i.e. "data"] (even if the property is zero length) [..]".
122 int status; /* Returned by "XGetWindowProperty". */
125 int temp_format; /* Not used. */
126 unsigned long number_of_elements;
127 unsigned long temp_bytes_after; /* Not used. */
130 status = XGetWindowProperty(fgDisplay.Display,
143 FREEGLUT_INTERNAL_ERROR_EXIT(status == Success,
144 "XGetWindowProperty failled",
145 "fghGetWindowProperty");
147 if (type_returned != type)
149 number_of_elements = 0;
152 return number_of_elements;
155 /* Check if the window manager is NET WM compliant. */
156 static int fghNetWMSupported(void)
159 Window ** window_ptr_1;
161 int number_of_windows;
162 int net_wm_supported;
165 net_wm_supported = 0;
167 wm_check = fghGetAtom("_NET_SUPPORTING_WM_CHECK");
168 window_ptr_1 = malloc(sizeof(Window *));
171 * Check that the window manager has set this property on the root window.
172 * The property must be the ID of a child window.
174 number_of_windows = fghGetWindowProperty(fgDisplay.RootWindow,
177 (unsigned char **) window_ptr_1);
178 if (number_of_windows == 1)
180 Window ** window_ptr_2;
182 window_ptr_2 = malloc(sizeof(Window *));
184 /* Check that the window has the same property set to the same value. */
185 number_of_windows = fghGetWindowProperty(**window_ptr_1,
188 (unsigned char **) window_ptr_2);
189 if ((number_of_windows == 1) && (**window_ptr_1 == **window_ptr_2))
191 /* NET WM compliant */
192 net_wm_supported = 1;
195 XFree(*window_ptr_2);
199 XFree(*window_ptr_1);
202 return net_wm_supported;
205 /* Check if "hint" is present in "property" for "window". */
206 int fgHintPresent(Window window, Atom property, Atom hint)
215 atoms_ptr = malloc(sizeof(Atom *));
216 number_of_atoms = fghGetWindowProperty(window,
219 (unsigned char **) atoms_ptr);
220 for (i = 0; i < number_of_atoms; i++)
222 if ((*atoms_ptr)[i] == hint)
232 #endif /* TARGET_HOST_POSIX_X11 */
236 * A call to this function should initialize all the display stuff...
238 static void fghInitialize( const char* displayName )
240 #if TARGET_HOST_POSIX_X11
241 fgDisplay.Display = XOpenDisplay( displayName );
243 if( fgDisplay.Display == NULL )
244 fgError( "failed to open display '%s'", XDisplayName( displayName ) );
246 if( !glXQueryExtension( fgDisplay.Display, NULL, NULL ) )
247 fgError( "OpenGL GLX extension not supported by display '%s'",
248 XDisplayName( displayName ) );
250 fgDisplay.Screen = DefaultScreen( fgDisplay.Display );
251 fgDisplay.RootWindow = RootWindow(
256 fgDisplay.ScreenWidth = DisplayWidth(
260 fgDisplay.ScreenHeight = DisplayHeight(
265 fgDisplay.ScreenWidthMM = DisplayWidthMM(
269 fgDisplay.ScreenHeightMM = DisplayHeightMM(
274 fgDisplay.Connection = ConnectionNumber( fgDisplay.Display );
276 /* Create the window deletion atom */
277 fgDisplay.DeleteWindow = fghGetAtom("WM_DELETE_WINDOW");
279 /* Create the state and full screen atoms */
280 fgDisplay.State = None;
281 fgDisplay.StateFullScreen = None;
283 if (fghNetWMSupported())
285 const Atom supported = fghGetAtom("_NET_SUPPORTED");
286 const Atom state = fghGetAtom("_NET_WM_STATE");
288 /* Check if the state hint is supported. */
289 if (fgHintPresent(fgDisplay.RootWindow, supported, state))
291 const Atom full_screen = fghGetAtom("_NET_WM_STATE_FULLSCREEN");
293 fgDisplay.State = state;
295 /* Check if the window manager supports full screen. */
296 /** Check "_NET_WM_ALLOWED_ACTIONS" on our window instead? **/
297 if (fgHintPresent(fgDisplay.RootWindow, supported, full_screen))
299 fgDisplay.StateFullScreen = full_screen;
304 #elif TARGET_HOST_MS_WINDOWS
309 /* What we need to do is to initialize the fgDisplay global structure here. */
310 fgDisplay.Instance = GetModuleHandle( NULL );
312 atom = GetClassInfo( fgDisplay.Instance, _T("FREEGLUT"), &wc );
316 ZeroMemory( &wc, sizeof(WNDCLASS) );
319 * Each of the windows should have its own device context, and we
320 * want redraw events during Vertical and Horizontal Resizes by
323 * XXX Old code had "| CS_DBCLCKS" commented out. Plans for the
324 * XXX future? Dead-end idea?
326 wc.lpfnWndProc = fgWindowProc;
329 wc.hInstance = fgDisplay.Instance;
330 wc.hIcon = LoadIcon( fgDisplay.Instance, _T("GLUT_ICON") );
332 #if defined(_WIN32_WCE)
333 wc.style = CS_HREDRAW | CS_VREDRAW;
335 wc.style = CS_OWNDC | CS_HREDRAW | CS_VREDRAW;
337 wc.hIcon = LoadIcon( NULL, IDI_WINLOGO );
340 wc.hCursor = LoadCursor( NULL, IDC_ARROW );
341 wc.hbrBackground = NULL;
342 wc.lpszMenuName = NULL;
343 wc.lpszClassName = _T("FREEGLUT");
345 /* Register the window class */
346 atom = RegisterClass( &wc );
347 FREEGLUT_INTERNAL_ERROR_EXIT ( atom, "Window Class Not Registered", "fghInitialize" );
350 /* The screen dimensions can be obtained via GetSystemMetrics() calls */
351 fgDisplay.ScreenWidth = GetSystemMetrics( SM_CXSCREEN );
352 fgDisplay.ScreenHeight = GetSystemMetrics( SM_CYSCREEN );
355 HWND desktop = GetDesktopWindow( );
356 HDC context = GetDC( desktop );
358 fgDisplay.ScreenWidthMM = GetDeviceCaps( context, HORZSIZE );
359 fgDisplay.ScreenHeightMM = GetDeviceCaps( context, VERTSIZE );
361 ReleaseDC( desktop, context );
364 /* Set the timer granularity to 1 ms */
365 timeBeginPeriod ( 1 );
369 fgState.Initialised = GL_TRUE;
371 /* InputDevice uses GlutTimerFunc(), so fgState.Initialised must be TRUE */
372 fgInitialiseInputDevices();
376 * Perform the freeglut deinitialization...
378 void fgDeinitialize( void )
382 if( !fgState.Initialised )
384 fgWarning( "fgDeinitialize(): "
385 "no valid initialization has been performed" );
389 /* If there was a menu created, destroy the rendering context */
390 if( fgStructure.MenuContext )
392 #if TARGET_HOST_POSIX_X11
393 /* Note that the MVisualInfo is not owned by the MenuContext! */
394 glXDestroyContext( fgDisplay.Display, fgStructure.MenuContext->MContext );
396 free( fgStructure.MenuContext );
397 fgStructure.MenuContext = NULL;
400 fgDestroyStructure( );
402 while( ( timer = fgState.Timers.First) )
404 fgListRemove( &fgState.Timers, &timer->Node );
408 while( ( timer = fgState.FreeTimers.First) )
410 fgListRemove( &fgState.FreeTimers, &timer->Node );
414 #if !defined(_WIN32_WCE)
415 if ( fgState.JoysticksInitialised )
418 if ( fgState.InputDevsInitialised )
419 fgInputDeviceClose( );
420 #endif /* !defined(_WIN32_WCE) */
421 fgState.JoysticksInitialised = GL_FALSE;
422 fgState.InputDevsInitialised = GL_FALSE;
424 fgState.MajorVersion = 1;
425 fgState.MinorVersion = 0;
426 fgState.ContextFlags = 0;
428 fgState.Initialised = GL_FALSE;
430 fgState.Position.X = -1;
431 fgState.Position.Y = -1;
432 fgState.Position.Use = GL_FALSE;
434 fgState.Size.X = 300;
435 fgState.Size.Y = 300;
436 fgState.Size.Use = GL_TRUE;
438 fgState.DisplayMode = GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH;
440 fgState.DirectContext = GLUT_TRY_DIRECT_CONTEXT;
441 fgState.ForceIconic = GL_FALSE;
442 fgState.UseCurrentContext = GL_FALSE;
443 fgState.GLDebugSwitch = GL_FALSE;
444 fgState.XSyncSwitch = GL_FALSE;
445 fgState.ActionOnWindowClose = GLUT_ACTION_EXIT;
446 fgState.ExecState = GLUT_EXEC_STATE_INIT;
448 fgState.KeyRepeat = GLUT_KEY_REPEAT_ON;
449 fgState.Modifiers = INVALID_MODIFIERS;
451 fgState.GameModeSize.X = 640;
452 fgState.GameModeSize.Y = 480;
453 fgState.GameModeDepth = 16;
454 fgState.GameModeRefresh = 72;
456 fgListInit( &fgState.Timers );
457 fgListInit( &fgState.FreeTimers );
459 fgState.IdleCallback = NULL;
460 fgState.MenuStateCallback = ( FGCBMenuState )NULL;
461 fgState.MenuStatusCallback = ( FGCBMenuStatus )NULL;
463 fgState.SwapCount = 0;
464 fgState.SwapTime = 0;
465 fgState.FPSInterval = 0;
467 if( fgState.ProgramName )
469 free( fgState.ProgramName );
470 fgState.ProgramName = NULL;
473 #if TARGET_HOST_POSIX_X11
476 * Make sure all X-client data we have created will be destroyed on
479 XSetCloseDownMode( fgDisplay.Display, DestroyAll );
482 * Close the display connection, destroying all windows we have
485 XCloseDisplay( fgDisplay.Display );
487 #elif TARGET_HOST_MS_WINDOWS
489 /* Reset the timer granularity */
494 fgState.Initialised = GL_FALSE;
498 * Everything inside the following #ifndef is copied from the X sources.
501 #if TARGET_HOST_MS_WINDOWS
505 Copyright 1985, 1986, 1987,1998 The Open Group
507 Permission to use, copy, modify, distribute, and sell this software and its
508 documentation for any purpose is hereby granted without fee, provided that
509 the above copyright notice appear in all copies and that both that
510 copyright notice and this permission notice appear in supporting
513 The above copyright notice and this permission notice shall be included
514 in all copies or substantial portions of the Software.
516 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
517 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
518 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
519 IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
520 OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
521 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
522 OTHER DEALINGS IN THE SOFTWARE.
524 Except as contained in this notice, the name of The Open Group shall
525 not be used in advertising or otherwise to promote the sale, use or
526 other dealings in this Software without prior written authorization
531 #define NoValue 0x0000
532 #define XValue 0x0001
533 #define YValue 0x0002
534 #define WidthValue 0x0004
535 #define HeightValue 0x0008
536 #define AllValues 0x000F
537 #define XNegative 0x0010
538 #define YNegative 0x0020
541 * XParseGeometry parses strings of the form
542 * "=<width>x<height>{+-}<xoffset>{+-}<yoffset>", where
543 * width, height, xoffset, and yoffset are unsigned integers.
544 * Example: "=80x24+300-49"
545 * The equal sign is optional.
546 * It returns a bitmask that indicates which of the four values
547 * were actually found in the string. For each value found,
548 * the corresponding argument is updated; for each value
549 * not found, the corresponding argument is left unchanged.
553 ReadInteger(char *string, char **NextString)
555 register int Result = 0;
560 else if (*string == '-')
565 for (; (*string >= '0') && (*string <= '9'); string++)
567 Result = (Result * 10) + (*string - '0');
569 *NextString = string;
576 static int XParseGeometry (
580 unsigned int *width, /* RETURN */
581 unsigned int *height) /* RETURN */
584 register char *strind;
585 unsigned int tempWidth = 0, tempHeight = 0;
586 int tempX = 0, tempY = 0;
589 if ( (string == NULL) || (*string == '\0'))
592 string++; /* ignore possible '=' at beg of geometry spec */
594 strind = (char *)string;
595 if (*strind != '+' && *strind != '-' && *strind != 'x') {
596 tempWidth = ReadInteger(strind, &nextCharacter);
597 if (strind == nextCharacter)
599 strind = nextCharacter;
603 if (*strind == 'x' || *strind == 'X') {
605 tempHeight = ReadInteger(strind, &nextCharacter);
606 if (strind == nextCharacter)
608 strind = nextCharacter;
612 if ((*strind == '+') || (*strind == '-')) {
613 if (*strind == '-') {
615 tempX = -ReadInteger(strind, &nextCharacter);
616 if (strind == nextCharacter)
618 strind = nextCharacter;
624 tempX = ReadInteger(strind, &nextCharacter);
625 if (strind == nextCharacter)
627 strind = nextCharacter;
630 if ((*strind == '+') || (*strind == '-')) {
631 if (*strind == '-') {
633 tempY = -ReadInteger(strind, &nextCharacter);
634 if (strind == nextCharacter)
636 strind = nextCharacter;
642 tempY = ReadInteger(strind, &nextCharacter);
643 if (strind == nextCharacter)
645 strind = nextCharacter;
651 /* If strind isn't at the end of the string the it's an invalid
652 geometry specification. */
654 if (*strind != '\0') return 0;
660 if (mask & WidthValue)
662 if (mask & HeightValue)
663 *height = tempHeight;
668 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
671 * Perform initialization. This usually happens on the program startup
672 * and restarting after glutMainLoop termination...
674 void FGAPIENTRY glutInit( int* pargc, char** argv )
676 char* displayName = NULL;
677 char* geometry = NULL;
678 int i, j, argc = *pargc;
680 /* will return true for VC8 (VC2005) and higher */
681 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
686 if( fgState.Initialised )
687 fgError( "illegal glutInit() reinitialization attempt" );
689 if (pargc && *pargc && argv && *argv && **argv)
691 fgState.ProgramName = strdup (*argv);
693 if( !fgState.ProgramName )
694 fgError ("Could not allocate space for the program's name.");
697 fgCreateStructure( );
700 fgState.Time = fgSystemTime();
702 /* check if GLUT_FPS env var is set */
705 /* will return true for VC8 (VC2005) and higher */
706 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
708 err = _dupenv_s( &fps, &sLen, "GLUT_FPS" );
710 fgError("Error getting GLUT_FPS environment variable");
712 const char *fps = getenv( "GLUT_FPS" );
717 sscanf( fps, "%d", &interval );
720 fgState.FPSInterval = 5000; /* 5000 millisecond default */
722 fgState.FPSInterval = interval;
724 /* will return true for VC8 (VC2005) and higher */
725 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
726 free ( fps ); fps = NULL; /* dupenv_s allocates a string that we must free */
730 /* will return true for VC8 (VC2005) and higher */
731 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
732 err = _dupenv_s( &displayName, &sLen, "DISPLAY" );
734 fgError("Error getting DISPLAY environment variable");
736 displayName = getenv( "DISPLAY" );
739 for( i = 1; i < argc; i++ )
741 if( strcmp( argv[ i ], "-display" ) == 0 )
744 fgError( "-display parameter must be followed by display name" );
746 displayName = argv[ i ];
748 argv[ i - 1 ] = NULL;
752 else if( strcmp( argv[ i ], "-geometry" ) == 0 )
755 fgError( "-geometry parameter must be followed by window "
756 "geometry settings" );
758 geometry = argv[ i ];
760 argv[ i - 1 ] = NULL;
764 else if( strcmp( argv[ i ], "-direct" ) == 0)
766 if( fgState.DirectContext == GLUT_FORCE_INDIRECT_CONTEXT )
767 fgError( "parameters ambiguity, -direct and -indirect "
768 "cannot be both specified" );
770 fgState.DirectContext = GLUT_FORCE_DIRECT_CONTEXT;
774 else if( strcmp( argv[ i ], "-indirect" ) == 0 )
776 if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )
777 fgError( "parameters ambiguity, -direct and -indirect "
778 "cannot be both specified" );
780 fgState.DirectContext = GLUT_FORCE_INDIRECT_CONTEXT;
784 else if( strcmp( argv[ i ], "-iconic" ) == 0 )
786 fgState.ForceIconic = GL_TRUE;
790 else if( strcmp( argv[ i ], "-gldebug" ) == 0 )
792 fgState.GLDebugSwitch = GL_TRUE;
796 else if( strcmp( argv[ i ], "-sync" ) == 0 )
798 fgState.XSyncSwitch = GL_TRUE;
804 /* Compact {argv}. */
805 for( i = j = 1; i < *pargc; i++, j++ )
807 /* Guaranteed to end because there are "*pargc" arguments left */
808 while ( argv[ j ] == NULL )
811 argv[ i ] = argv[ j ];
814 #endif /* _WIN32_WCE */
817 * Have the display created now. If there wasn't a "-display"
818 * in the program arguments, we will use the DISPLAY environment
819 * variable for opening the X display (see code above):
821 fghInitialize( displayName );
822 /* will return true for VC8 (VC2005) and higher */
823 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
824 free ( displayName ); displayName = NULL; /* dupenv_s allocates a string that we must free */
828 * Geometry parsing deffered until here because we may need the screen
834 unsigned int parsedWidth, parsedHeight;
835 int mask = XParseGeometry( geometry,
836 &fgState.Position.X, &fgState.Position.Y,
837 &parsedWidth, &parsedHeight );
838 /* TODO: Check for overflow? */
839 fgState.Size.X = parsedWidth;
840 fgState.Size.Y = parsedHeight;
842 if( (mask & (WidthValue|HeightValue)) == (WidthValue|HeightValue) )
843 fgState.Size.Use = GL_TRUE;
845 if( mask & XNegative )
846 fgState.Position.X += fgDisplay.ScreenWidth - fgState.Size.X;
848 if( mask & YNegative )
849 fgState.Position.Y += fgDisplay.ScreenHeight - fgState.Size.Y;
851 if( (mask & (XValue|YValue)) == (XValue|YValue) )
852 fgState.Position.Use = GL_TRUE;
857 * Undoes all the "glutInit" stuff
859 void FGAPIENTRY glutExit ( void )
865 * Sets the default initial window position for new windows
867 void FGAPIENTRY glutInitWindowPosition( int x, int y )
869 fgState.Position.X = x;
870 fgState.Position.Y = y;
872 if( ( x >= 0 ) && ( y >= 0 ) )
873 fgState.Position.Use = GL_TRUE;
875 fgState.Position.Use = GL_FALSE;
879 * Sets the default initial window size for new windows
881 void FGAPIENTRY glutInitWindowSize( int width, int height )
883 fgState.Size.X = width;
884 fgState.Size.Y = height;
886 if( ( width > 0 ) && ( height > 0 ) )
887 fgState.Size.Use = GL_TRUE;
889 fgState.Size.Use = GL_FALSE;
893 * Sets the default display mode for all new windows
895 void FGAPIENTRY glutInitDisplayMode( unsigned int displayMode )
897 /* We will make use of this value when creating a new OpenGL context... */
898 fgState.DisplayMode = displayMode;
902 /* -- INIT DISPLAY STRING PARSING ------------------------------------------ */
904 static char* Tokens[] =
906 "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double",
907 "green", "index", "num", "red", "rgba", "rgb", "luminance", "stencil",
908 "single", "stereo", "samples", "slow", "win32pdf", "win32pfd", "xvisual",
909 "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",
910 "xtruecolor", "xdirectcolor",
911 "xstaticgrey", "xgreyscale", "xstaticcolour", "xpseudocolour",
912 "xtruecolour", "xdirectcolour", "borderless", "aux"
914 #define NUM_TOKENS (sizeof(Tokens) / sizeof(*Tokens))
916 void FGAPIENTRY glutInitDisplayString( const char* displayMode )
918 int glut_state_flag = 0 ;
920 * Unpack a lot of options from a character string. The options are
921 * delimited by blanks or tabs.
924 /* will return true for VC8 (VC2005) and higher */
925 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
926 char *next_token = NULL;
928 size_t len = strlen ( displayMode );
929 char *buffer = (char *)malloc ( (len+1) * sizeof(char) );
930 memcpy ( buffer, displayMode, len );
933 /* will return true for VC8 (VC2005) and higher */
934 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
935 token = strtok_s ( buffer, " \t", &next_token );
937 token = strtok ( buffer, " \t" );
941 /* Process this token */
944 /* Temporary fix: Ignore any length specifications and at least
945 * process the basic token
946 * TODO: Fix this permanently
948 size_t cleanlength = strcspn ( token, "=<>~!" );
950 for ( i = 0; i < NUM_TOKENS; i++ )
952 if ( strncmp ( token, Tokens[i], cleanlength ) == 0 ) break ;
957 case 0 : /* "alpha": Alpha color buffer precision in bits */
958 glut_state_flag |= GLUT_ALPHA ; /* Somebody fix this for me! */
961 case 1 : /* "acca": Red, green, blue, and alpha accumulation buffer
965 case 2 : /* "acc": Red, green, and blue accumulation buffer precision
966 in bits with zero bits alpha */
967 glut_state_flag |= GLUT_ACCUM ; /* Somebody fix this for me! */
970 case 3 : /* "blue": Blue color buffer precision in bits */
973 case 4 : /* "buffer": Number of bits in the color index color buffer
977 case 5 : /* "conformant": Boolean indicating if the frame buffer
978 configuration is conformant or not */
981 case 6 : /* "depth": Number of bits of precsion in the depth buffer */
982 glut_state_flag |= GLUT_DEPTH ; /* Somebody fix this for me! */
985 case 7 : /* "double": Boolean indicating if the color buffer is
987 glut_state_flag |= GLUT_DOUBLE ;
990 case 8 : /* "green": Green color buffer precision in bits */
993 case 9 : /* "index": Boolean if the color model is color index or not
995 glut_state_flag |= GLUT_INDEX ;
998 case 10 : /* "num": A special capability name indicating where the
999 value represents the Nth frame buffer configuration
1000 matching the description string */
1003 case 11 : /* "red": Red color buffer precision in bits */
1006 case 12 : /* "rgba": Number of bits of red, green, blue, and alpha in
1007 the RGBA color buffer */
1008 glut_state_flag |= GLUT_RGBA ; /* Somebody fix this for me! */
1011 case 13 : /* "rgb": Number of bits of red, green, and blue in the
1012 RGBA color buffer with zero bits alpha */
1013 glut_state_flag |= GLUT_RGB ; /* Somebody fix this for me! */
1016 case 14 : /* "luminance": Number of bits of red in the RGBA and zero
1017 bits of green, blue (alpha not specified) of color buffer
1019 glut_state_flag |= GLUT_LUMINANCE ; /* Somebody fix this for me! */
1022 case 15 : /* "stencil": Number of bits in the stencil buffer */
1023 glut_state_flag |= GLUT_STENCIL; /* Somebody fix this for me! */
1026 case 16 : /* "single": Boolean indicate the color buffer is single
1028 glut_state_flag |= GLUT_SINGLE ;
1031 case 17 : /* "stereo": Boolean indicating the color buffer supports
1032 OpenGL-style stereo */
1033 glut_state_flag |= GLUT_STEREO ;
1036 case 18 : /* "samples": Indicates the number of multisamples to use
1037 based on GLX's SGIS_multisample extension (for
1039 glut_state_flag |= GLUT_MULTISAMPLE ; /*Somebody fix this for me!*/
1042 case 19 : /* "slow": Boolean indicating if the frame buffer
1043 configuration is slow or not */
1046 case 20 : /* "win32pdf": (incorrect spelling but was there before */
1047 case 21 : /* "win32pfd": matches the Win32 Pixel Format Descriptor by
1049 #if TARGET_HOST_MS_WINDOWS
1053 case 22 : /* "xvisual": matches the X visual ID by number */
1054 #if TARGET_HOST_POSIX_X11
1058 case 23 : /* "xstaticgray": */
1059 case 29 : /* "xstaticgrey": boolean indicating if the frame buffer
1060 configuration's X visual is of type StaticGray */
1061 #if TARGET_HOST_POSIX_X11
1065 case 24 : /* "xgrayscale": */
1066 case 30 : /* "xgreyscale": boolean indicating if the frame buffer
1067 configuration's X visual is of type GrayScale */
1068 #if TARGET_HOST_POSIX_X11
1072 case 25 : /* "xstaticcolor": */
1073 case 31 : /* "xstaticcolour": boolean indicating if the frame buffer
1074 configuration's X visual is of type StaticColor */
1075 #if TARGET_HOST_POSIX_X11
1079 case 26 : /* "xpseudocolor": */
1080 case 32 : /* "xpseudocolour": boolean indicating if the frame buffer
1081 configuration's X visual is of type PseudoColor */
1082 #if TARGET_HOST_POSIX_X11
1086 case 27 : /* "xtruecolor": */
1087 case 33 : /* "xtruecolour": boolean indicating if the frame buffer
1088 configuration's X visual is of type TrueColor */
1089 #if TARGET_HOST_POSIX_X11
1093 case 28 : /* "xdirectcolor": */
1094 case 34 : /* "xdirectcolour": boolean indicating if the frame buffer
1095 configuration's X visual is of type DirectColor */
1096 #if TARGET_HOST_POSIX_X11
1100 case 35 : /* "borderless": windows should not have borders */
1101 #if TARGET_HOST_POSIX_X11
1105 case 36 : /* "aux": some number of aux buffers */
1106 glut_state_flag |= GLUT_AUX;
1109 case 37 : /* Unrecognized */
1110 fgWarning ( "WARNING - Display string token not recognized: %s",
1115 /* will return true for VC8 (VC2005) and higher */
1116 #if TARGET_HOST_MS_WINDOWS && ( _MSC_VER >= 1400 )
1117 token = strtok_s ( NULL, " \t", &next_token );
1119 token = strtok ( NULL, " \t" );
1125 /* We will make use of this value when creating a new OpenGL context... */
1126 fgState.DisplayMode = glut_state_flag;
1129 /* -- SETTING OPENGL 3.0 CONTEXT CREATION PARAMETERS ---------------------- */
1131 void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion )
1133 /* We will make use of these valuse when creating a new OpenGL context... */
1134 fgState.MajorVersion = majorVersion;
1135 fgState.MinorVersion = minorVersion;
1139 void FGAPIENTRY glutInitContextFlags( int flags )
1141 /* We will make use of this value when creating a new OpenGL context... */
1142 fgState.ContextFlags = flags;
1145 /*** END OF FILE ***/