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 0, /* NumActiveJoysticks */
88 GL_FALSE, /* InputDevsInitialised */
89 0, /* MouseWheelTicks */
90 1, /* AuxiliaryBufferNumber */
95 0, /* ContextProfile */
97 NULL /* WarningFunc */
101 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */
103 #if TARGET_HOST_POSIX_X11
105 /* Return the atom associated with "name". */
106 static Atom fghGetAtom(const char * name)
108 return XInternAtom(fgDisplay.Display, name, False);
112 * Check if "property" is set on "window". The property's values are returned
113 * through "data". If the property is set and is of type "type", return the
114 * number of elements in "data". Return zero otherwise. In both cases, use
115 * "Xfree()" to free "data".
117 static int fghGetWindowProperty(Window window,
120 unsigned char ** data)
123 * Caller always has to use "Xfree()" to free "data", since
124 * "XGetWindowProperty() always allocates one extra byte in prop_return
125 * [i.e. "data"] (even if the property is zero length) [..]".
128 int status; /* Returned by "XGetWindowProperty". */
131 int temp_format; /* Not used. */
132 unsigned long number_of_elements;
133 unsigned long temp_bytes_after; /* Not used. */
136 status = XGetWindowProperty(fgDisplay.Display,
149 FREEGLUT_INTERNAL_ERROR_EXIT(status == Success,
150 "XGetWindowProperty failled",
151 "fghGetWindowProperty");
153 if (type_returned != type)
155 number_of_elements = 0;
158 return number_of_elements;
161 /* Check if the window manager is NET WM compliant. */
162 static int fghNetWMSupported(void)
165 Window ** window_ptr_1;
167 int number_of_windows;
168 int net_wm_supported;
171 net_wm_supported = 0;
173 wm_check = fghGetAtom("_NET_SUPPORTING_WM_CHECK");
174 window_ptr_1 = malloc(sizeof(Window *));
177 * Check that the window manager has set this property on the root window.
178 * The property must be the ID of a child window.
180 number_of_windows = fghGetWindowProperty(fgDisplay.RootWindow,
183 (unsigned char **) window_ptr_1);
184 if (number_of_windows == 1)
186 Window ** window_ptr_2;
188 window_ptr_2 = malloc(sizeof(Window *));
190 /* Check that the window has the same property set to the same value. */
191 number_of_windows = fghGetWindowProperty(**window_ptr_1,
194 (unsigned char **) window_ptr_2);
195 if ((number_of_windows == 1) && (**window_ptr_1 == **window_ptr_2))
197 /* NET WM compliant */
198 net_wm_supported = 1;
201 XFree(*window_ptr_2);
205 XFree(*window_ptr_1);
208 return net_wm_supported;
211 /* Check if "hint" is present in "property" for "window". */
212 int fgHintPresent(Window window, Atom property, Atom hint)
221 number_of_atoms = fghGetWindowProperty(window,
224 (unsigned char **) &atoms);
225 for (i = 0; i < number_of_atoms; i++)
227 if (atoms[i] == hint)
238 #endif /* TARGET_HOST_POSIX_X11 */
242 * A call to this function should initialize all the display stuff...
244 static void fghInitialize( const char* displayName )
246 #if TARGET_HOST_POSIX_X11
247 fgDisplay.Display = XOpenDisplay( displayName );
249 if( fgDisplay.Display == NULL )
250 fgError( "failed to open display '%s'", XDisplayName( displayName ) );
252 if( !glXQueryExtension( fgDisplay.Display, NULL, NULL ) )
253 fgError( "OpenGL GLX extension not supported by display '%s'",
254 XDisplayName( displayName ) );
256 fgDisplay.Screen = DefaultScreen( fgDisplay.Display );
257 fgDisplay.RootWindow = RootWindow(
262 fgDisplay.ScreenWidth = DisplayWidth(
266 fgDisplay.ScreenHeight = DisplayHeight(
271 fgDisplay.ScreenWidthMM = DisplayWidthMM(
275 fgDisplay.ScreenHeightMM = DisplayHeightMM(
280 fgDisplay.Connection = ConnectionNumber( fgDisplay.Display );
282 /* Create the window deletion atom */
283 fgDisplay.DeleteWindow = fghGetAtom("WM_DELETE_WINDOW");
285 /* Create the state and full screen atoms */
286 fgDisplay.State = None;
287 fgDisplay.StateFullScreen = None;
289 if (fghNetWMSupported())
291 const Atom supported = fghGetAtom("_NET_SUPPORTED");
292 const Atom state = fghGetAtom("_NET_WM_STATE");
294 /* Check if the state hint is supported. */
295 if (fgHintPresent(fgDisplay.RootWindow, supported, state))
297 const Atom full_screen = fghGetAtom("_NET_WM_STATE_FULLSCREEN");
299 fgDisplay.State = state;
301 /* Check if the window manager supports full screen. */
302 /** Check "_NET_WM_ALLOWED_ACTIONS" on our window instead? **/
303 if (fgHintPresent(fgDisplay.RootWindow, supported, full_screen))
305 fgDisplay.StateFullScreen = full_screen;
310 #elif TARGET_HOST_MS_WINDOWS
315 /* What we need to do is to initialize the fgDisplay global structure here. */
316 fgDisplay.Instance = GetModuleHandle( NULL );
317 fgDisplay.DisplayName= displayName ? strdup(displayName) : 0 ;
318 atom = GetClassInfo( fgDisplay.Instance, _T("FREEGLUT"), &wc );
322 ZeroMemory( &wc, sizeof(WNDCLASS) );
325 * Each of the windows should have its own device context, and we
326 * want redraw events during Vertical and Horizontal Resizes by
329 * XXX Old code had "| CS_DBCLCKS" commented out. Plans for the
330 * XXX future? Dead-end idea?
332 wc.lpfnWndProc = fgWindowProc;
335 wc.hInstance = fgDisplay.Instance;
336 wc.hIcon = LoadIcon( fgDisplay.Instance, _T("GLUT_ICON") );
338 #if defined(_WIN32_WCE)
339 wc.style = CS_HREDRAW | CS_VREDRAW;
341 wc.style = CS_OWNDC | CS_HREDRAW | CS_VREDRAW;
343 wc.hIcon = LoadIcon( NULL, IDI_WINLOGO );
346 wc.hCursor = LoadCursor( NULL, IDC_ARROW );
347 wc.hbrBackground = NULL;
348 wc.lpszMenuName = NULL;
349 wc.lpszClassName = _T("FREEGLUT");
351 /* Register the window class */
352 atom = RegisterClass( &wc );
353 FREEGLUT_INTERNAL_ERROR_EXIT ( atom, "Window Class Not Registered", "fghInitialize" );
356 /* The screen dimensions can be obtained via GetSystemMetrics() calls */
357 fgDisplay.ScreenWidth = GetSystemMetrics( SM_CXSCREEN );
358 fgDisplay.ScreenHeight = GetSystemMetrics( SM_CYSCREEN );
361 HWND desktop = GetDesktopWindow( );
362 HDC context = GetDC( desktop );
364 fgDisplay.ScreenWidthMM = GetDeviceCaps( context, HORZSIZE );
365 fgDisplay.ScreenHeightMM = GetDeviceCaps( context, VERTSIZE );
367 ReleaseDC( desktop, context );
369 /* If we have a DisplayName try to use it for metrics */
370 if( fgDisplay.DisplayName )
372 HDC context = CreateDC(fgDisplay.DisplayName,0,0,0);
375 fgDisplay.ScreenWidth = GetDeviceCaps( context, HORZRES );
376 fgDisplay.ScreenHeight = GetDeviceCaps( context, VERTRES );
377 fgDisplay.ScreenWidthMM = GetDeviceCaps( context, HORZSIZE );
378 fgDisplay.ScreenHeightMM = GetDeviceCaps( context, VERTSIZE );
382 fgWarning("fghInitialize: "
383 "CreateDC failed, Screen size info may be incorrect\n"
384 "This is quite likely caused by a bad '-display' parameter");
387 /* Set the timer granularity to 1 ms */
388 timeBeginPeriod ( 1 );
392 fgState.Initialised = GL_TRUE;
394 /* Avoid registering atexit callback on Win32 as it results in an access
395 * violation due to calling into a module which has been unloaded. */
396 #if ( TARGET_HOST_MS_WINDOWS == 0 )
397 atexit(fgDeinitialize);
400 /* InputDevice uses GlutTimerFunc(), so fgState.Initialised must be TRUE */
401 fgInitialiseInputDevices();
405 * Perform the freeglut deinitialization...
407 void fgDeinitialize( void )
411 if( !fgState.Initialised )
416 /* If we're in game mode, we want to leave game mode */
417 if( fgStructure.GameModeWindow ) {
421 /* If there was a menu created, destroy the rendering context */
422 if( fgStructure.MenuContext )
424 #if TARGET_HOST_POSIX_X11
425 /* Note that the MVisualInfo is not owned by the MenuContext! */
426 glXDestroyContext( fgDisplay.Display, fgStructure.MenuContext->MContext );
428 free( fgStructure.MenuContext );
429 fgStructure.MenuContext = NULL;
432 fgDestroyStructure( );
434 while( ( timer = fgState.Timers.First) )
436 fgListRemove( &fgState.Timers, &timer->Node );
440 while( ( timer = fgState.FreeTimers.First) )
442 fgListRemove( &fgState.FreeTimers, &timer->Node );
446 #if !defined(_WIN32_WCE)
447 if ( fgState.JoysticksInitialised )
450 if ( fgState.InputDevsInitialised )
451 fgInputDeviceClose( );
452 #endif /* !defined(_WIN32_WCE) */
453 fgState.JoysticksInitialised = GL_FALSE;
454 fgState.InputDevsInitialised = GL_FALSE;
456 fgState.MouseWheelTicks = 0;
458 fgState.MajorVersion = 1;
459 fgState.MinorVersion = 0;
460 fgState.ContextFlags = 0;
461 fgState.ContextProfile = 0;
463 fgState.Initialised = GL_FALSE;
465 fgState.Position.X = -1;
466 fgState.Position.Y = -1;
467 fgState.Position.Use = GL_FALSE;
469 fgState.Size.X = 300;
470 fgState.Size.Y = 300;
471 fgState.Size.Use = GL_TRUE;
473 fgState.DisplayMode = GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH;
475 fgState.DirectContext = GLUT_TRY_DIRECT_CONTEXT;
476 fgState.ForceIconic = GL_FALSE;
477 fgState.UseCurrentContext = GL_FALSE;
478 fgState.GLDebugSwitch = GL_FALSE;
479 fgState.XSyncSwitch = GL_FALSE;
480 fgState.ActionOnWindowClose = GLUT_ACTION_EXIT;
481 fgState.ExecState = GLUT_EXEC_STATE_INIT;
483 fgState.KeyRepeat = GLUT_KEY_REPEAT_ON;
484 fgState.Modifiers = INVALID_MODIFIERS;
486 fgState.GameModeSize.X = 640;
487 fgState.GameModeSize.Y = 480;
488 fgState.GameModeDepth = 16;
489 fgState.GameModeRefresh = 72;
491 fgListInit( &fgState.Timers );
492 fgListInit( &fgState.FreeTimers );
494 fgState.IdleCallback = NULL;
495 fgState.MenuStateCallback = ( FGCBMenuState )NULL;
496 fgState.MenuStatusCallback = ( FGCBMenuStatus )NULL;
498 fgState.SwapCount = 0;
499 fgState.SwapTime = 0;
500 fgState.FPSInterval = 0;
502 if( fgState.ProgramName )
504 free( fgState.ProgramName );
505 fgState.ProgramName = NULL;
508 #if TARGET_HOST_POSIX_X11
511 * Make sure all X-client data we have created will be destroyed on
514 XSetCloseDownMode( fgDisplay.Display, DestroyAll );
517 * Close the display connection, destroying all windows we have
520 XCloseDisplay( fgDisplay.Display );
522 #elif TARGET_HOST_MS_WINDOWS
523 if( fgDisplay.DisplayName )
525 free( fgDisplay.DisplayName );
526 fgDisplay.DisplayName = NULL;
529 /* Reset the timer granularity */
534 fgState.Initialised = GL_FALSE;
538 * Everything inside the following #ifndef is copied from the X sources.
541 #if TARGET_HOST_MS_WINDOWS
545 Copyright 1985, 1986, 1987,1998 The Open Group
547 Permission to use, copy, modify, distribute, and sell this software and its
548 documentation for any purpose is hereby granted without fee, provided that
549 the above copyright notice appear in all copies and that both that
550 copyright notice and this permission notice appear in supporting
553 The above copyright notice and this permission notice shall be included
554 in all copies or substantial portions of the Software.
556 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
557 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
558 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
559 IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
560 OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
561 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
562 OTHER DEALINGS IN THE SOFTWARE.
564 Except as contained in this notice, the name of The Open Group shall
565 not be used in advertising or otherwise to promote the sale, use or
566 other dealings in this Software without prior written authorization
571 #define NoValue 0x0000
572 #define XValue 0x0001
573 #define YValue 0x0002
574 #define WidthValue 0x0004
575 #define HeightValue 0x0008
576 #define AllValues 0x000F
577 #define XNegative 0x0010
578 #define YNegative 0x0020
581 * XParseGeometry parses strings of the form
582 * "=<width>x<height>{+-}<xoffset>{+-}<yoffset>", where
583 * width, height, xoffset, and yoffset are unsigned integers.
584 * Example: "=80x24+300-49"
585 * The equal sign is optional.
586 * It returns a bitmask that indicates which of the four values
587 * were actually found in the string. For each value found,
588 * the corresponding argument is updated; for each value
589 * not found, the corresponding argument is left unchanged.
593 ReadInteger(char *string, char **NextString)
595 register int Result = 0;
600 else if (*string == '-')
605 for (; (*string >= '0') && (*string <= '9'); string++)
607 Result = (Result * 10) + (*string - '0');
609 *NextString = string;
616 static int XParseGeometry (
620 unsigned int *width, /* RETURN */
621 unsigned int *height) /* RETURN */
624 register char *strind;
625 unsigned int tempWidth = 0, tempHeight = 0;
626 int tempX = 0, tempY = 0;
629 if ( (string == NULL) || (*string == '\0'))
632 string++; /* ignore possible '=' at beg of geometry spec */
634 strind = (char *)string;
635 if (*strind != '+' && *strind != '-' && *strind != 'x') {
636 tempWidth = ReadInteger(strind, &nextCharacter);
637 if (strind == nextCharacter)
639 strind = nextCharacter;
643 if (*strind == 'x' || *strind == 'X') {
645 tempHeight = ReadInteger(strind, &nextCharacter);
646 if (strind == nextCharacter)
648 strind = nextCharacter;
652 if ((*strind == '+') || (*strind == '-')) {
653 if (*strind == '-') {
655 tempX = -ReadInteger(strind, &nextCharacter);
656 if (strind == nextCharacter)
658 strind = nextCharacter;
664 tempX = ReadInteger(strind, &nextCharacter);
665 if (strind == nextCharacter)
667 strind = nextCharacter;
670 if ((*strind == '+') || (*strind == '-')) {
671 if (*strind == '-') {
673 tempY = -ReadInteger(strind, &nextCharacter);
674 if (strind == nextCharacter)
676 strind = nextCharacter;
682 tempY = ReadInteger(strind, &nextCharacter);
683 if (strind == nextCharacter)
685 strind = nextCharacter;
691 /* If strind isn't at the end of the string the it's an invalid
692 geometry specification. */
694 if (*strind != '\0') return 0;
700 if (mask & WidthValue)
702 if (mask & HeightValue)
703 *height = tempHeight;
708 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
711 * Perform initialization. This usually happens on the program startup
712 * and restarting after glutMainLoop termination...
714 void FGAPIENTRY glutInit( int* pargc, char** argv )
716 char* displayName = NULL;
717 char* geometry = NULL;
718 int i, j, argc = *pargc;
720 if( fgState.Initialised )
721 fgError( "illegal glutInit() reinitialization attempt" );
723 if (pargc && *pargc && argv && *argv && **argv)
725 fgState.ProgramName = strdup (*argv);
727 if( !fgState.ProgramName )
728 fgError ("Could not allocate space for the program's name.");
731 fgCreateStructure( );
734 fgState.Time = fgSystemTime();
736 /* check if GLUT_FPS env var is set */
739 const char *fps = getenv( "GLUT_FPS" );
744 sscanf( fps, "%d", &interval );
747 fgState.FPSInterval = 5000; /* 5000 millisecond default */
749 fgState.FPSInterval = interval;
753 displayName = getenv( "DISPLAY" );
755 for( i = 1; i < argc; i++ )
757 if( strcmp( argv[ i ], "-display" ) == 0 )
760 fgError( "-display parameter must be followed by display name" );
762 displayName = argv[ i ];
764 argv[ i - 1 ] = NULL;
768 else if( strcmp( argv[ i ], "-geometry" ) == 0 )
771 fgError( "-geometry parameter must be followed by window "
772 "geometry settings" );
774 geometry = argv[ i ];
776 argv[ i - 1 ] = NULL;
780 else if( strcmp( argv[ i ], "-direct" ) == 0)
782 if( fgState.DirectContext == GLUT_FORCE_INDIRECT_CONTEXT )
783 fgError( "parameters ambiguity, -direct and -indirect "
784 "cannot be both specified" );
786 fgState.DirectContext = GLUT_FORCE_DIRECT_CONTEXT;
790 else if( strcmp( argv[ i ], "-indirect" ) == 0 )
792 if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )
793 fgError( "parameters ambiguity, -direct and -indirect "
794 "cannot be both specified" );
796 fgState.DirectContext = GLUT_FORCE_INDIRECT_CONTEXT;
800 else if( strcmp( argv[ i ], "-iconic" ) == 0 )
802 fgState.ForceIconic = GL_TRUE;
806 else if( strcmp( argv[ i ], "-gldebug" ) == 0 )
808 fgState.GLDebugSwitch = GL_TRUE;
812 else if( strcmp( argv[ i ], "-sync" ) == 0 )
814 fgState.XSyncSwitch = GL_TRUE;
820 /* Compact {argv}. */
821 for( i = j = 1; i < *pargc; i++, j++ )
823 /* Guaranteed to end because there are "*pargc" arguments left */
824 while ( argv[ j ] == NULL )
827 argv[ i ] = argv[ j ];
830 #endif /* _WIN32_WCE */
833 * Have the display created now. If there wasn't a "-display"
834 * in the program arguments, we will use the DISPLAY environment
835 * variable for opening the X display (see code above):
837 fghInitialize( displayName );
840 * Geometry parsing deffered until here because we may need the screen
846 unsigned int parsedWidth, parsedHeight;
847 int mask = XParseGeometry( geometry,
848 &fgState.Position.X, &fgState.Position.Y,
849 &parsedWidth, &parsedHeight );
850 /* TODO: Check for overflow? */
851 fgState.Size.X = parsedWidth;
852 fgState.Size.Y = parsedHeight;
854 if( (mask & (WidthValue|HeightValue)) == (WidthValue|HeightValue) )
855 fgState.Size.Use = GL_TRUE;
857 if( mask & XNegative )
858 fgState.Position.X += fgDisplay.ScreenWidth - fgState.Size.X;
860 if( mask & YNegative )
861 fgState.Position.Y += fgDisplay.ScreenHeight - fgState.Size.Y;
863 if( (mask & (XValue|YValue)) == (XValue|YValue) )
864 fgState.Position.Use = GL_TRUE;
868 #if TARGET_HOST_MS_WINDOWS
869 void (__cdecl *__glutExitFunc)( int return_value ) = NULL;
871 void FGAPIENTRY __glutInitWithExit( int *pargc, char **argv, void (__cdecl *exit_function)(int) )
873 __glutExitFunc = exit_function;
874 glutInit(pargc, argv);
879 * Undoes all the "glutInit" stuff
881 void FGAPIENTRY glutExit ( void )
887 * Sets the default initial window position for new windows
889 void FGAPIENTRY glutInitWindowPosition( int x, int y )
891 fgState.Position.X = x;
892 fgState.Position.Y = y;
894 if( ( x >= 0 ) && ( y >= 0 ) )
895 fgState.Position.Use = GL_TRUE;
897 fgState.Position.Use = GL_FALSE;
901 * Sets the default initial window size for new windows
903 void FGAPIENTRY glutInitWindowSize( int width, int height )
905 fgState.Size.X = width;
906 fgState.Size.Y = height;
908 if( ( width > 0 ) && ( height > 0 ) )
909 fgState.Size.Use = GL_TRUE;
911 fgState.Size.Use = GL_FALSE;
915 * Sets the default display mode for all new windows
917 void FGAPIENTRY glutInitDisplayMode( unsigned int displayMode )
919 /* We will make use of this value when creating a new OpenGL context... */
920 fgState.DisplayMode = displayMode;
924 /* -- INIT DISPLAY STRING PARSING ------------------------------------------ */
926 static char* Tokens[] =
928 "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double",
929 "green", "index", "num", "red", "rgba", "rgb", "luminance", "stencil",
930 "single", "stereo", "samples", "slow", "win32pdf", "win32pfd", "xvisual",
931 "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",
932 "xtruecolor", "xdirectcolor",
933 "xstaticgrey", "xgreyscale", "xstaticcolour", "xpseudocolour",
934 "xtruecolour", "xdirectcolour", "borderless", "aux"
936 #define NUM_TOKENS (sizeof(Tokens) / sizeof(*Tokens))
938 void FGAPIENTRY glutInitDisplayString( const char* displayMode )
940 int glut_state_flag = 0 ;
942 * Unpack a lot of options from a character string. The options are
943 * delimited by blanks or tabs.
946 size_t len = strlen ( displayMode );
947 char *buffer = (char *)malloc ( (len+1) * sizeof(char) );
948 memcpy ( buffer, displayMode, len );
951 token = strtok ( buffer, " \t" );
955 /* Process this token */
958 /* Temporary fix: Ignore any length specifications and at least
959 * process the basic token
960 * TODO: Fix this permanently
962 size_t cleanlength = strcspn ( token, "=<>~!" );
964 for ( i = 0; i < NUM_TOKENS; i++ )
966 if ( strncmp ( token, Tokens[i], cleanlength ) == 0 ) break ;
971 case 0 : /* "alpha": Alpha color buffer precision in bits */
972 glut_state_flag |= GLUT_ALPHA ; /* Somebody fix this for me! */
975 case 1 : /* "acca": Red, green, blue, and alpha accumulation buffer
979 case 2 : /* "acc": Red, green, and blue accumulation buffer precision
980 in bits with zero bits alpha */
981 glut_state_flag |= GLUT_ACCUM ; /* Somebody fix this for me! */
984 case 3 : /* "blue": Blue color buffer precision in bits */
987 case 4 : /* "buffer": Number of bits in the color index color buffer
991 case 5 : /* "conformant": Boolean indicating if the frame buffer
992 configuration is conformant or not */
995 case 6 : /* "depth": Number of bits of precsion in the depth buffer */
996 glut_state_flag |= GLUT_DEPTH ; /* Somebody fix this for me! */
999 case 7 : /* "double": Boolean indicating if the color buffer is
1001 glut_state_flag |= GLUT_DOUBLE ;
1004 case 8 : /* "green": Green color buffer precision in bits */
1007 case 9 : /* "index": Boolean if the color model is color index or not
1009 glut_state_flag |= GLUT_INDEX ;
1012 case 10 : /* "num": A special capability name indicating where the
1013 value represents the Nth frame buffer configuration
1014 matching the description string */
1017 case 11 : /* "red": Red color buffer precision in bits */
1020 case 12 : /* "rgba": Number of bits of red, green, blue, and alpha in
1021 the RGBA color buffer */
1022 glut_state_flag |= GLUT_RGBA ; /* Somebody fix this for me! */
1025 case 13 : /* "rgb": Number of bits of red, green, and blue in the
1026 RGBA color buffer with zero bits alpha */
1027 glut_state_flag |= GLUT_RGB ; /* Somebody fix this for me! */
1030 case 14 : /* "luminance": Number of bits of red in the RGBA and zero
1031 bits of green, blue (alpha not specified) of color buffer
1033 glut_state_flag |= GLUT_LUMINANCE ; /* Somebody fix this for me! */
1036 case 15 : /* "stencil": Number of bits in the stencil buffer */
1037 glut_state_flag |= GLUT_STENCIL; /* Somebody fix this for me! */
1040 case 16 : /* "single": Boolean indicate the color buffer is single
1042 glut_state_flag |= GLUT_SINGLE ;
1045 case 17 : /* "stereo": Boolean indicating the color buffer supports
1046 OpenGL-style stereo */
1047 glut_state_flag |= GLUT_STEREO ;
1050 case 18 : /* "samples": Indicates the number of multisamples to use
1051 based on GLX's SGIS_multisample extension (for
1053 glut_state_flag |= GLUT_MULTISAMPLE ; /*Somebody fix this for me!*/
1056 case 19 : /* "slow": Boolean indicating if the frame buffer
1057 configuration is slow or not */
1060 case 20 : /* "win32pdf": (incorrect spelling but was there before */
1061 case 21 : /* "win32pfd": matches the Win32 Pixel Format Descriptor by
1063 #if TARGET_HOST_MS_WINDOWS
1067 case 22 : /* "xvisual": matches the X visual ID by number */
1068 #if TARGET_HOST_POSIX_X11
1072 case 23 : /* "xstaticgray": */
1073 case 29 : /* "xstaticgrey": boolean indicating if the frame buffer
1074 configuration's X visual is of type StaticGray */
1075 #if TARGET_HOST_POSIX_X11
1079 case 24 : /* "xgrayscale": */
1080 case 30 : /* "xgreyscale": boolean indicating if the frame buffer
1081 configuration's X visual is of type GrayScale */
1082 #if TARGET_HOST_POSIX_X11
1086 case 25 : /* "xstaticcolor": */
1087 case 31 : /* "xstaticcolour": boolean indicating if the frame buffer
1088 configuration's X visual is of type StaticColor */
1089 #if TARGET_HOST_POSIX_X11
1093 case 26 : /* "xpseudocolor": */
1094 case 32 : /* "xpseudocolour": boolean indicating if the frame buffer
1095 configuration's X visual is of type PseudoColor */
1096 #if TARGET_HOST_POSIX_X11
1100 case 27 : /* "xtruecolor": */
1101 case 33 : /* "xtruecolour": boolean indicating if the frame buffer
1102 configuration's X visual is of type TrueColor */
1103 #if TARGET_HOST_POSIX_X11
1107 case 28 : /* "xdirectcolor": */
1108 case 34 : /* "xdirectcolour": boolean indicating if the frame buffer
1109 configuration's X visual is of type DirectColor */
1110 #if TARGET_HOST_POSIX_X11
1114 case 35 : /* "borderless": windows should not have borders */
1115 #if TARGET_HOST_POSIX_X11
1119 case 36 : /* "aux": some number of aux buffers */
1120 glut_state_flag |= GLUT_AUX;
1123 case 37 : /* Unrecognized */
1124 fgWarning ( "WARNING - Display string token not recognized: %s",
1129 token = strtok ( NULL, " \t" );
1134 /* We will make use of this value when creating a new OpenGL context... */
1135 fgState.DisplayMode = glut_state_flag;
1138 /* -- SETTING OPENGL 3.0 CONTEXT CREATION PARAMETERS ---------------------- */
1140 void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion )
1142 /* We will make use of these valuse when creating a new OpenGL context... */
1143 fgState.MajorVersion = majorVersion;
1144 fgState.MinorVersion = minorVersion;
1148 void FGAPIENTRY glutInitContextFlags( int flags )
1150 /* We will make use of this value when creating a new OpenGL context... */
1151 fgState.ContextFlags = flags;
1154 void FGAPIENTRY glutInitContextProfile( int profile )
1156 /* We will make use of this value when creating a new OpenGL context... */
1157 fgState.ContextProfile = profile;
1160 /* -------------- User Defined Error/Warning Handler Support -------------- */
1163 * Sets the user error handler (note the use of va_list for the args to the fmt)
1165 void FGAPIENTRY glutInitErrorFunc( void (* vfgError) ( const char *fmt, va_list ap ) )
1167 /* This allows user programs to handle freeglut errors */
1168 fgState.ErrorFunc = vfgError;
1172 * Sets the user warning handler (note the use of va_list for the args to the fmt)
1174 void FGAPIENTRY glutInitWarningFunc( void (* vfgWarning) ( const char *fmt, va_list ap ) )
1176 /* This allows user programs to handle freeglut warnings */
1177 fgState.WarningFunc = vfgWarning;
1180 /*** END OF FILE ***/