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.
32 #define G_LOG_DOMAIN "freeglut-init"
34 #include "../include/GL/freeglut.h"
35 #include "freeglut_internal.h"
38 * TODO BEFORE THE STABLE RELEASE:
40 * fgDeinitialize() -- Win32's OK, X11 needs the OS-specific deinitialization done
41 * glutInitDisplayString() -- display mode string parsing
43 * Wouldn't it be cool to use gettext() for error messages? I just love bash saying
44 * "nie znaleziono pliku" instead of "file not found" :) 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, FALSE }, /* Position */
59 { 300, 300, TRUE }, /* Size */
60 GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH, /* DisplayMode */
61 FALSE, /* ForceDirectContext */
62 TRUE, /* TryDirectContext */
63 FALSE, /* ForceIconic */
64 FALSE, /* UseCurrentContext */
65 FALSE, /* GLDebugSwitch */
66 FALSE, /* XSyncSwitch */
67 TRUE, /* IgnoreKeyRepeat */
71 #ifdef TARGET_HOST_WIN32
72 { 0, FALSE }, /* Time */
76 { NULL, NULL }, /* Timers */
77 NULL, /* IdleCallback */
78 FALSE, /* BuildingAMenu */
79 NULL, /* MenuStateCallback */
80 NULL, /* MenuStatusCallback */
81 { 640, 480, TRUE }, /* GameModeSize */
82 16, /* GameModeDepth */
83 72, /* GameModeRefresh */
84 GLUT_ACTION_EXIT, /* ActionOnWindowClose */
85 GLUT_EXEC_STATE_INIT /* ExecState */
89 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
92 * A call to this function should initialize all the display stuff...
94 void fgInitialize( const char* displayName )
96 #if TARGET_HOST_UNIX_X11
98 * Have the display created
100 fgDisplay.Display = XOpenDisplay( displayName );
102 if( fgDisplay.Display == NULL )
105 * Failed to open a display. That's no good.
107 fgError( "failed to open display '%s'", XDisplayName( displayName ) );
111 * Check for the OpenGL GLX extension availability:
113 if( !glXQueryExtension( fgDisplay.Display, NULL, NULL ) )
116 * GLX extensions have not been found...
118 fgError( "OpenGL GLX extension not supported by display '%s'", XDisplayName( displayName ) );
122 * Grab the default screen for the display we have just opened
124 fgDisplay.Screen = DefaultScreen( fgDisplay.Display );
127 * The same applying to the root window
129 fgDisplay.RootWindow = RootWindow(
135 * Grab the logical screen's geometry
137 fgDisplay.ScreenWidth = DisplayWidth(
142 fgDisplay.ScreenHeight = DisplayHeight(
148 * Grab the physical screen's geometry
150 fgDisplay.ScreenWidthMM = DisplayWidthMM(
155 fgDisplay.ScreenHeightMM = DisplayHeightMM(
161 * The display's connection number
163 fgDisplay.Connection = ConnectionNumber( fgDisplay.Display );
166 * Create the window deletion atom
168 fgDisplay.DeleteWindow = XInternAtom(
174 #elif TARGET_HOST_WIN32
180 * What we need to do is to initialize the fgDisplay global structure here...
182 fgDisplay.Instance = GetModuleHandle( NULL );
185 * Check if the freeglut window class has been registered before...
187 atom = GetClassInfo( fgDisplay.Instance, "FREEGLUT", &wc );
190 * ...nope, it has not, and we have to do it right now:
195 * Make sure the unitialized fields are reset to zero
197 ZeroMemory( &wc, sizeof(WNDCLASS) );
200 * Each of the windows should have its own device context...
203 wc.lpfnWndProc = fgWindowProc;
206 wc.hInstance = fgDisplay.Instance;
207 wc.hIcon = LoadIcon( fgDisplay.Instance, "GLUT_ICON" );
209 wc.hIcon = LoadIcon( NULL, IDI_WINLOGO );
211 wc.hCursor = LoadCursor( NULL, IDC_ARROW );
212 wc.hbrBackground = NULL;
213 wc.lpszMenuName = NULL;
214 wc.lpszClassName = "FREEGLUT";
217 * Register the window class
219 atom = RegisterClass( &wc );
224 * The screen dimensions can be obtained via GetSystemMetrics() calls
226 fgDisplay.ScreenWidth = GetSystemMetrics( SM_CXSCREEN );
227 fgDisplay.ScreenHeight = GetSystemMetrics( SM_CYSCREEN );
231 * Checking the display's size in millimeters isn't too hard, too:
233 HWND desktop = GetDesktopWindow();
234 HDC context = GetDC( desktop );
237 * Grab the appropriate values now (HORZSIZE and VERTSIZE respectably):
239 fgDisplay.ScreenWidthMM = GetDeviceCaps( context, HORZSIZE );
240 fgDisplay.ScreenHeightMM = GetDeviceCaps( context, VERTSIZE );
243 * Whoops, forgot to release the device context :)
245 ReleaseDC( desktop, context );
251 * Have the joystick device initialized now
257 * Perform the freeglut deinitialization...
259 void fgDeinitialize( void )
264 * Check if initialization has been performed before
266 if( !fgState.Time.Set )
268 fgWarning( "fgDeinitialize(): fgState.Timer is null => no valid initialization has been performed" );
273 * If there was a menu created, destroy the rendering context
275 if ( fgStructure.MenuContext )
277 free ( fgStructure.MenuContext ) ;
278 fgStructure.MenuContext = NULL ;
282 * Perform the freeglut structure deinitialization
284 fgDestroyStructure();
287 * Delete all the timers and their storage list
289 while ( (timer = fgState.Timers.First) != NULL )
291 fgListRemove ( &fgState.Timers, &timer->Node ) ;
296 * Deinitialize the joystick device
301 * Reset the state structure
304 fgState.Position.X = -1 ;
305 fgState.Position.Y = -1 ;
306 fgState.Position.Use = FALSE ;
308 fgState.Size.X = 300 ;
309 fgState.Size.Y = 300 ;
310 fgState.Size.Use = TRUE ;
313 * The default display mode to be used
315 fgState.DisplayMode = GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH;
317 fgState.ForceDirectContext = FALSE;
318 fgState.TryDirectContext = TRUE;
319 fgState.ForceIconic = FALSE;
320 fgState.UseCurrentContext = FALSE;
321 fgState.GLDebugSwitch = FALSE;
322 fgState.XSyncSwitch = FALSE;
323 fgState.ActionOnWindowClose = GLUT_ACTION_EXIT ;
324 fgState.ExecState = GLUT_EXEC_STATE_INIT ;
327 * Assume we want to ignore the automatic key repeat
329 fgState.IgnoreKeyRepeat = TRUE;
332 * Set the default game mode settings
334 fgState.GameModeSize.X = 640;
335 fgState.GameModeSize.Y = 480;
336 fgState.GameModeDepth = 16;
337 fgState.GameModeRefresh = 72;
339 fgState.Time.Set = FALSE ;
341 fgState.Timers.First = fgState.Timers.Last = NULL ;
342 fgState.IdleCallback = NULL ;
343 fgState.MenuStateCallback = (FGCBmenuState)NULL ;
344 fgState.MenuStatusCallback = (FGCBmenuStatus)NULL ;
349 fgState.SwapCount = 0;
350 fgState.SwapTime = 0;
351 fgState.FPSInterval = 0;
354 #if TARGET_HOST_UNIX_X11
357 * Make sure all X-client data we have created will be destroyed on display closing
359 XSetCloseDownMode( fgDisplay.Display, DestroyAll );
362 * Close the display connection, destroying all windows we have created so far
364 XCloseDisplay( fgDisplay.Display );
370 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
373 * Perform initialization. This usually happens on the program startup
374 * and restarting after glutMainLoop termination...
376 void FGAPIENTRY glutInit( int* pargc, char** argv )
378 char* displayName = NULL;
379 int i, j, argc = *pargc;
382 * Do not allow multiple initialization of the library
384 if( fgState.Time.Set )
387 * We can't have multiple initialization performed
389 fgError( "illegal glutInit() reinitialization attemp" );
393 * Have the internal freeglut structure initialized now
398 * Remember the function's call time
400 #if TARGET_HOST_UNIX_X11
401 gettimeofday(&fgState.Time.Value, NULL);
402 #elif TARGET_HOST_WIN32
403 fgState.Time.Value = timeGetTime();
405 fgState.Time.Set = TRUE;
407 /* check if GLUT_FPS env var is set */
409 const char *fps = getenv ( "GLUT_FPS" );
412 sscanf ( fps, "%d", &fgState.FPSInterval ) ;
413 if ( fgState.FPSInterval <= 0 )
414 fgState.FPSInterval = 5000 ; /* 5000 milliseconds */
419 * Grab the environment variable indicating the X display to use.
420 * This is harmless under Win32, so let's let it stay here...
422 #if TARGET_HOST_WIN32
423 if ( !getenv ( "DISPLAY" ) )
424 displayName = strdup ( "" ) ;
427 displayName = strdup( getenv( "DISPLAY" ) );
430 * Have the program arguments parsed.
432 for( i=1; i<argc; i++ )
435 * The X display name settings
437 if( strcmp( argv[ i ], "-display" ) == 0 )
440 * Check for possible lack of the next argument
443 fgError( "-display parameter must be followed by display name" );
446 * Release the previous display name (the one from app's environment)
451 * Make a working copy of the name for us to use
453 displayName = strdup( argv[ i ] );
456 * Have both arguments removed
458 argv[ i - 1 ] = NULL;
464 * The geometry settings
466 else if( strcmp( argv[ i ], "-geometry" ) == 0 )
472 * Again, check if there is at least one more argument
475 fgError( "-geometry parameter must be followed by window geometry settings" );
478 * Otherwise scan the geometry settings...
480 result = sscanf ( argv[i], "%dx%d+%d+%d", &x, &y, &w, &h );
483 * Check what we have been supplied with...
494 fgState.Position.Y = fgDisplay.ScreenHeight + y - fgState.Size.Y;
496 fgState.Position.Y = y;
502 fgState.Position.X = fgDisplay.ScreenWidth + x - fgState.Size.X;
504 fgState.Position.X = x;
508 * Have both arguments removed
510 argv[ i - 1 ] = NULL;
516 * The direct/indirect OpenGL contexts settings
518 else if( strcmp( argv[ i ], "-direct" ) == 0)
521 * We try to force direct rendering...
523 if( fgState.TryDirectContext == FALSE )
524 fgError( "parameters ambiguity, -direct and -indirect cannot be both specified" );
526 fgState.ForceDirectContext = TRUE;
530 else if( strcmp( argv[ i ], "-indirect" ) == 0 )
533 * We try to force indirect rendering...
535 if( fgState.ForceDirectContext == TRUE )
536 fgError( "parameters ambiguity, -direct and -indirect cannot be both specified" );
538 fgState.TryDirectContext = FALSE;
544 * The '-iconic' parameter makes all new top-level
545 * windows created in iconified state...
547 else if( strcmp( argv[ i ], "-iconic" ) == 0 )
549 fgState.ForceIconic = TRUE;
555 * The '-gldebug' option activates some OpenGL state debugging features
557 else if( strcmp( argv[ i ], "-gldebug" ) == 0 )
559 fgState.GLDebugSwitch = TRUE;
565 * The '-sync' option activates X protocol synchronization (for debugging purposes)
567 else if( strcmp( argv[ i ], "-sync" ) == 0 )
569 fgState.XSyncSwitch = TRUE;
576 * Have the arguments list compacted now
579 for( i = 1; i < *pargc; i++, j++ )
581 if( argv[ i ] == NULL )
583 while ( argv[j] == NULL ) j++ ; /* Guaranteed to end because there are "*pargc" arguments left */
589 * Have the display created now. As I am too lazy to implement
590 * the program arguments parsing, we will have the DISPLAY
591 * environment variable used for opening the X display:
593 fgInitialize( displayName );
596 * Check for the minus one settings for both position and size...
598 if( fgState.Position.X < 0 || fgState.Position.Y < 0 )
599 fgState.Position.Use = FALSE;
601 if( fgState.Size.X < 0 || fgState.Size.Y < 0 )
602 fgState.Size.Use = FALSE;
605 * Do not forget about releasing the display name string
611 * Sets the default initial window position for new windows
613 void FGAPIENTRY glutInitWindowPosition( int x, int y )
616 * The settings can be disables when both coordinates are negative
618 if( (x >= 0) && (y >= 0) )
621 * We want to specify the initial position of each of the windows
623 fgState.Position.X = x;
624 fgState.Position.Y = y;
625 fgState.Position.Use = TRUE;
630 * The initial position of each of the windows is specified by the wm
632 fgState.Position.X = -1;
633 fgState.Position.Y = -1;
634 fgState.Position.Use = FALSE;
639 * Sets the default initial window size for new windows
641 void FGAPIENTRY glutInitWindowSize( int width, int height )
644 * The settings can be disables when both values are negative
646 if( (width > 0) && (height > 0) )
649 * We want to specify the initial size of each of the windows
651 fgState.Size.X = width;
652 fgState.Size.Y = height;
653 fgState.Size.Use = TRUE;
658 * The initial size of each of the windows is specified by the wm (officially this is an error condition)
662 fgState.Size.Use = FALSE;
667 * Sets the default display mode for all new windows
669 void FGAPIENTRY glutInitDisplayMode( unsigned int displayMode )
672 * We will make use of this value when creating a new OpenGL context...
674 fgState.DisplayMode = displayMode;
678 /* -- INIT DISPLAY STRING PARSING ------------------------------------------ */
680 #if 0 /* FIXME: CJP */
682 * There is a discrete number of comparison operators we can encounter:
684 * comparison ::= "=" | "!=" | "<" | ">" | "<=" | ">=" | "~"
686 #define FG_NONE 0x0000
687 #define FG_EQUAL 0x0001
688 #define FG_NOT_EQUAL 0x0002
689 #define FG_LESS 0x0003
690 #define FG_MORE 0x0004
691 #define FG_LESS_OR_EQUAL 0x0005
692 #define FG_MORE_OR_EQUAL 0x0006
693 #define FG_CLOSEST 0x0007
696 * The caller can feed us with a number of capability tokens:
698 * capability ::= "alpha" | "acca" | "acc" | "blue" | "buffer" | "conformant" | "depth" | "double" |
699 * "green" | "index" | "num" | "red" | "rgba" | "rgb" | "luminance" | "stencil" |
700 * "single" | "stereo" | "samples" | "slow" | "win32pdf" | "xvisual" | "xstaticgray" |
701 * "xgrayscale" | "xstaticcolor" | "xpseudocolor" | "xtruecolor" | "xdirectcolor"
703 static gchar* g_Tokens[] =
705 "none", "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double", "green",
706 "index", "num", "red", "rgba", "rgb", "luminance", "stencil", "single", "stereo", "samples",
707 "slow", "win32pdf", "xvisual", "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",
708 "xtruecolor", "xdirectcolor", NULL
712 * The structure to hold the parsed display string tokens
714 typedef struct tagSFG_Capability SFG_Capability;
715 struct tagSFG_Capability
717 gint capability; /* the capability token enumerator */
718 gint comparison; /* the comparison operator used */
719 gint value; /* the value we're comparing to */
723 * The scanner configuration for the init display string
725 static GScannerConfig fgInitDisplayStringScannerConfig =
727 ( " \t\r\n" ) /* cset_skip_characters */,
732 ) /* cset_identifier_first */,
740 ) /* cset_identifier_nth */,
741 ( "#\n" ) /* cpair_comment_single */,
742 FALSE /* case_sensitive */,
743 TRUE /* skip_comment_multi */,
744 TRUE /* skip_comment_single */,
745 TRUE /* scan_comment_multi */,
746 TRUE /* scan_identifier */,
747 FALSE /* scan_identifier_1char */,
748 FALSE /* scan_identifier_NULL */,
749 TRUE /* scan_symbols */,
750 FALSE /* scan_binary */,
751 TRUE /* scan_octal */,
752 TRUE /* scan_float */,
754 FALSE /* scan_hex_dollar */,
755 TRUE /* scan_string_sq */,
756 TRUE /* scan_string_dq */,
757 TRUE /* numbers_2_int */,
758 FALSE /* int_2_float */,
759 FALSE /* identifier_2_string */,
760 TRUE /* char_2_token */,
761 FALSE /* symbol_2_token */,
762 FALSE /* scope_0_fallback */,
766 * Sets the default display mode for all new windows using a string
768 void FGAPIENTRY glutInitDisplayString( char* displayMode )
771 * display_string ::= (switch)
772 * switch ::= capability [comparison value]
773 * comparison ::= "=" | "!=" | "<" | ">" | "<=" | ">=" | "~"
774 * capability ::= "alpha" | "acca" | "acc" | "blue" | "buffer" | "conformant" |
775 * "depth" | "double" | "green" | "index" | "num" | "red" | "rgba" |
776 * "rgb" | "luminance" | "stencil" | "single" | "stereo" |
777 * "samples" | "slow" | "win32pdf" | "xvisual" | "xstaticgray" |
778 * "xgrayscale" | "xstaticcolor" | "xpseudocolor" |
779 * "xtruecolor" | "xdirectcolor"
780 * value ::= 0..9 [value]
782 * The display string grammar. This should be EBNF, but I couldn't find the definitions so, to
783 * clarify: (expr) means 0 or more times the expression, [expr] means 0 or 1 times expr.
785 * Create a new GLib lexical analyzer to process the display mode string
787 GScanner* scanner = g_scanner_new( &fgInitDisplayStringScannerConfig );
792 * Fail if the display mode string is empty or the scanner failed to initialize
794 freeglut_return_if_fail( (scanner != NULL) && (strlen( displayMode ) > 0) );
797 * Set the scanner's input name (for debugging)
799 scanner->input_name = "glutInitDisplayString";
802 * Start the lexical analysis of the extensions string
804 g_scanner_input_text( scanner, displayMode, strlen( displayMode ) );
807 * While there are any more tokens to be checked...
809 while( !g_scanner_eof( scanner ) )
812 * Actually we're expecting only string tokens
814 GTokenType tokenType = g_scanner_get_next_token( scanner );
817 * We are looking for identifiers
819 if( tokenType == G_TOKEN_IDENTIFIER )
821 gchar* capability = NULL; /* the capability identifier string (always present) */
822 gint capID = 0; /* the capability identifier value (from g_Tokens) */
823 gint comparison = 0; /* the comparison operator value, see definitions */
824 gchar* valueString = NULL; /* if the previous one is present, this is needed */
825 gint value = 0; /* the integer value converted using a strtol call */
826 SFG_Capability* capStruct; /* the capability description structure */
829 * OK. The general rule of thumb that we always should be getting a capability identifier
830 * string (see the grammar description). If it is followed by a comparison identifier, then
831 * there must follow an integer value we're comparing the capability to...
833 * Have the current token analyzed with that in mind...
835 for( i=0; i<(gint) strlen( scanner->value.v_identifier ); i++ )
837 gchar c = scanner->value.v_identifier[ i ];
839 if( (c == '=') || (c == '!') || (c == '<') || (c == '>') || (c == '~') )
844 * Here we go with the length of the capability identifier string.
845 * In the worst of cases, it is as long as the token identifier.
847 capability = g_strndup( scanner->value.v_identifier, i );
850 * OK. Is there a chance for comparison and value identifiers to follow?
851 * Note: checking against i+1 as this handles two cases: single character
852 * comparison operator and first of value's digits, which must always be
853 * there, or the two-character comparison operators.
855 if( (i + 1) < (gint) strlen( scanner->value.v_identifier ) )
858 * Yeah, indeed, it is the i-th character to start the identifier, then.
860 gchar c1 = scanner->value.v_identifier[ i + 0 ];
861 gchar c2 = scanner->value.v_identifier[ i + 1 ];
863 if( (c1 == '=') ) { i += 1; comparison = FG_EQUAL; } else
864 if( (c1 == '!') && (c2 == '=') ) { i += 2; comparison = FG_NOT_EQUAL; } else
865 if( (c1 == '<') && (c2 == '=') ) { i += 2; comparison = FG_LESS_OR_EQUAL; } else
866 if( (c1 == '>') && (c2 == '=') ) { i += 2; comparison = FG_MORE_OR_EQUAL; } else
867 if( (c1 == '<') ) { i += 1; comparison = FG_LESS; } else
868 if( (c1 == '>') ) { i += 1; comparison = FG_MORE; } else
869 if( (c1 == '~') ) { i += 1; comparison = FG_CLOSEST; } else
870 g_warning( "invalid comparison operator in token `%s'", scanner->value.v_identifier );
874 * Grab the value string that must follow the comparison operator...
876 if( comparison != FG_NONE && i < (gint) strlen( scanner->value.v_identifier ) )
877 valueString = strdup( scanner->value.v_identifier + i );
880 * If there was a value string, convert it to integer...
882 if( comparison != FG_NONE && strlen( valueString ) > 0 )
883 value = strtol( valueString, NULL, 0 );
886 * Now we need to match the capability string and its ID
888 for( i=0; g_Tokens[ i ]!=NULL; i++ )
890 if( strcmp( capability, g_Tokens[ i ] ) == 0 )
893 * Looks like we've found the one we were looking for
901 * Create a new capability description structure
903 capStruct = g_new0( SFG_Capability, 1 );
906 * Fill in the cap's values, as we have parsed it:
908 capStruct->capability = capID;
909 capStruct->comparison = comparison;
910 capStruct->value = value;
913 * Add the new capabaility to the caps list
915 caps = g_list_append( caps, capStruct );
918 * Clean up the local mess and keep rolling on
920 g_free( valueString );
921 g_free( capability );
926 * Now that we have converted the string into somewhat more machine-friendly
927 * form, proceed with matching the frame buffer configuration...
929 * The caps list could be passed to a function that would try finding the closest
930 * matching pixel format, visual, frame buffer configuration or whatever. It would
931 * be good to convert the glutInitDisplayMode() to use the same method.
934 g_message( "found %i capability preferences", g_list_length( caps ) );
936 g_message( "token `%s': cap: %i, com: %i, val: %i",
937 scanner->value.v_identifier,
938 capStruct->capability,
939 capStruct->comparison,
945 * Free the capabilities we have parsed
947 for( i=0; i<(gint) g_list_length( caps ); i++ )
948 g_free( g_list_nth( caps, i )->data );
951 * Destroy the capabilities list itself
956 * Free the lexical scanner now...
958 g_scanner_destroy( scanner );
962 #define NUM_TOKENS 28
963 static char* Tokens[] =
965 "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double", "green",
966 "index", "num", "red", "rgba", "rgb", "luminance", "stencil", "single", "stereo", "samples",
967 "slow", "win32pdf", "xvisual", "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",
968 "xtruecolor", "xdirectcolor"
971 static int TokenLengths[] =
973 5, 4, 3, 4, 6, 10, 5, 6, 5,
974 5, 3, 3, 4, 3, 9, 7, 6, 6, 7,
975 4, 8, 7, 11, 10, 12, 12,
979 void FGAPIENTRY glutInitDisplayString( const char* displayMode )
981 int glut_state_flag = 0 ;
983 * Unpack a lot of options from a character string. The options are delimited by blanks or tabs.
986 int len = strlen ( displayMode ) ;
987 char *buffer = malloc ( (len+1) * sizeof(char) ) ;
988 memcpy ( buffer, displayMode, len ) ;
991 token = strtok ( buffer, " \t" ) ;
998 for ( i = 0; i < NUM_TOKENS; i++ )
1000 if ( strncmp ( token, Tokens[i], TokenLengths[i] ) == 0 ) break ;
1005 case 0 : /* "alpha": Alpha color buffer precision in bits */
1006 glut_state_flag |= GLUT_ALPHA ; /* Somebody fix this for me! */
1009 case 1 : /* "acca": Red, green, blue, and alpha accumulation buffer precision in bits */
1012 case 2 : /* "acc": Red, green, and blue accumulation buffer precision in bits with zero bits alpha */
1013 glut_state_flag |= GLUT_ACCUM ; /* Somebody fix this for me! */
1016 case 3 : /* "blue": Blue color buffer precision in bits */
1019 case 4 : /* "buffer": Number of bits in the color index color buffer */
1022 case 5 : /* "conformant": Boolean indicating if the frame buffer configuration is conformant or not */
1025 case 6 : /* "depth": Number of bits of precsion in the depth buffer */
1026 glut_state_flag |= GLUT_DEPTH ; /* Somebody fix this for me! */
1029 case 7 : /* "double": Boolean indicating if the color buffer is double buffered */
1030 glut_state_flag |= GLUT_DOUBLE ;
1033 case 8 : /* "green": Green color buffer precision in bits */
1036 case 9 : /* "index": Boolean if the color model is color index or not */
1037 glut_state_flag |= GLUT_INDEX ;
1040 case 10 : /* "num": A special capability name indicating where the value represents the Nth frame buffer configuration matching the description string */
1043 case 11 : /* "red": Red color buffer precision in bits */
1046 case 12 : /* "rgba": Number of bits of red, green, blue, and alpha in the RGBA color buffer */
1047 glut_state_flag |= GLUT_RGBA ; /* Somebody fix this for me! */
1050 case 13 : /* "rgb": Number of bits of red, green, and blue in the RGBA color buffer with zero bits alpha */
1051 glut_state_flag |= GLUT_RGB ; /* Somebody fix this for me! */
1054 case 14 : /* "luminance": Number of bits of red in the RGBA and zero bits of green, blue (alpha not specified) of color buffer precision */
1055 glut_state_flag |= GLUT_LUMINANCE ; /* Somebody fix this for me! */
1058 case 15 : /* "stencil": Number of bits in the stencil buffer */
1059 glut_state_flag |= GLUT_STENCIL ; /* Somebody fix this for me! */
1062 case 16 : /* "single": Boolean indicate the color buffer is single buffered */
1063 glut_state_flag |= GLUT_SINGLE ;
1066 case 17 : /* "stereo": Boolean indicating the color buffer supports OpenGL-style stereo */
1067 glut_state_flag |= GLUT_STEREO ;
1070 case 18 : /* "samples": Indicates the number of multisamples to use based on GLX's SGIS_multisample extension (for antialiasing) */
1071 glut_state_flag |= GLUT_MULTISAMPLE ; /* Somebody fix this for me! */
1074 case 19 : /* "slow": Boolean indicating if the frame buffer configuration is slow or not */
1077 case 20 : /* "win32pdf": matches the Win32 Pixel Format Descriptor by number */
1078 #ifdef TARGET_HOST_WIN32
1082 case 21 : /* "xvisual": matches the X visual ID by number */
1083 #ifdef TARGET_HOST_UNIX_X11
1087 case 22 : /* "xstaticgray": boolean indicating if the frame buffer configuration's X visual is of type StaticGray */
1088 #ifdef TARGET_HOST_UNIX_X11
1092 case 23 : /* "xgrayscale": boolean indicating if the frame buffer configuration's X visual is of type GrayScale */
1093 #ifdef TARGET_HOST_UNIX_X11
1097 case 24 : /* "xstaticcolor": boolean indicating if the frame buffer configuration's X visual is of type StaticColor */
1098 #ifdef TARGET_HOST_UNIX_X11
1102 case 25 : /* "xpseudocolor": boolean indicating if the frame buffer configuration's X visual is of type PseudoColor */
1103 #ifdef TARGET_HOST_UNIX_X11
1107 case 26 : /* "xtruecolor": boolean indicating if the frame buffer configuration's X visual is of type TrueColor */
1108 #ifdef TARGET_HOST_UNIX_X11
1112 case 27 : /* "xdirectcolor": boolean indicating if the frame buffer configuration's X visual is of type DirectColor */
1113 #ifdef TARGET_HOST_UNIX_X11
1117 case 28 : /* Unrecognized */
1118 printf ( "WARNING - Display string token not recognized: %s\n", token ) ;
1122 token = strtok ( NULL, " \t" ) ;
1128 * We will make use of this value when creating a new OpenGL context...
1130 fgState.DisplayMode = glut_state_flag;
1133 /*** END OF FILE ***/