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 * Any cleanup isn't needed on Windows anyway, the OS takes care of it.c
397 * see: http://blogs.msdn.com/b/oldnewthing/archive/2012/01/05/10253268.aspx
399 #if ( TARGET_HOST_MS_WINDOWS == 0 )
400 atexit(fgDeinitialize);
403 /* InputDevice uses GlutTimerFunc(), so fgState.Initialised must be TRUE */
404 fgInitialiseInputDevices();
408 * Perform the freeglut deinitialization...
410 void fgDeinitialize( void )
414 if( !fgState.Initialised )
419 /* If we're in game mode, we want to leave game mode */
420 if( fgStructure.GameModeWindow ) {
424 /* If there was a menu created, destroy the rendering context */
425 if( fgStructure.MenuContext )
427 #if TARGET_HOST_POSIX_X11
428 /* Note that the MVisualInfo is not owned by the MenuContext! */
429 glXDestroyContext( fgDisplay.Display, fgStructure.MenuContext->MContext );
431 free( fgStructure.MenuContext );
432 fgStructure.MenuContext = NULL;
435 fgDestroyStructure( );
437 while( ( timer = fgState.Timers.First) )
439 fgListRemove( &fgState.Timers, &timer->Node );
443 while( ( timer = fgState.FreeTimers.First) )
445 fgListRemove( &fgState.FreeTimers, &timer->Node );
449 #if !defined(_WIN32_WCE)
450 if ( fgState.JoysticksInitialised )
453 if ( fgState.InputDevsInitialised )
454 fgInputDeviceClose( );
455 #endif /* !defined(_WIN32_WCE) */
456 fgState.JoysticksInitialised = GL_FALSE;
457 fgState.InputDevsInitialised = GL_FALSE;
459 fgState.MouseWheelTicks = 0;
461 fgState.MajorVersion = 1;
462 fgState.MinorVersion = 0;
463 fgState.ContextFlags = 0;
464 fgState.ContextProfile = 0;
466 fgState.Initialised = GL_FALSE;
468 fgState.Position.X = -1;
469 fgState.Position.Y = -1;
470 fgState.Position.Use = GL_FALSE;
472 fgState.Size.X = 300;
473 fgState.Size.Y = 300;
474 fgState.Size.Use = GL_TRUE;
476 fgState.DisplayMode = GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH;
478 fgState.DirectContext = GLUT_TRY_DIRECT_CONTEXT;
479 fgState.ForceIconic = GL_FALSE;
480 fgState.UseCurrentContext = GL_FALSE;
481 fgState.GLDebugSwitch = GL_FALSE;
482 fgState.XSyncSwitch = GL_FALSE;
483 fgState.ActionOnWindowClose = GLUT_ACTION_EXIT;
484 fgState.ExecState = GLUT_EXEC_STATE_INIT;
486 fgState.KeyRepeat = GLUT_KEY_REPEAT_ON;
487 fgState.Modifiers = INVALID_MODIFIERS;
489 fgState.GameModeSize.X = 640;
490 fgState.GameModeSize.Y = 480;
491 fgState.GameModeDepth = 16;
492 fgState.GameModeRefresh = 72;
494 fgListInit( &fgState.Timers );
495 fgListInit( &fgState.FreeTimers );
497 fgState.IdleCallback = NULL;
498 fgState.MenuStateCallback = ( FGCBMenuState )NULL;
499 fgState.MenuStatusCallback = ( FGCBMenuStatus )NULL;
501 fgState.SwapCount = 0;
502 fgState.SwapTime = 0;
503 fgState.FPSInterval = 0;
505 if( fgState.ProgramName )
507 free( fgState.ProgramName );
508 fgState.ProgramName = NULL;
511 #if TARGET_HOST_POSIX_X11
514 * Make sure all X-client data we have created will be destroyed on
517 XSetCloseDownMode( fgDisplay.Display, DestroyAll );
520 * Close the display connection, destroying all windows we have
523 XCloseDisplay( fgDisplay.Display );
525 #elif TARGET_HOST_MS_WINDOWS
526 if( fgDisplay.DisplayName )
528 free( fgDisplay.DisplayName );
529 fgDisplay.DisplayName = NULL;
532 /* Reset the timer granularity */
537 fgState.Initialised = GL_FALSE;
541 * Everything inside the following #ifndef is copied from the X sources.
544 #if TARGET_HOST_MS_WINDOWS
548 Copyright 1985, 1986, 1987,1998 The Open Group
550 Permission to use, copy, modify, distribute, and sell this software and its
551 documentation for any purpose is hereby granted without fee, provided that
552 the above copyright notice appear in all copies and that both that
553 copyright notice and this permission notice appear in supporting
556 The above copyright notice and this permission notice shall be included
557 in all copies or substantial portions of the Software.
559 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
560 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
561 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
562 IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
563 OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
564 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
565 OTHER DEALINGS IN THE SOFTWARE.
567 Except as contained in this notice, the name of The Open Group shall
568 not be used in advertising or otherwise to promote the sale, use or
569 other dealings in this Software without prior written authorization
574 #define NoValue 0x0000
575 #define XValue 0x0001
576 #define YValue 0x0002
577 #define WidthValue 0x0004
578 #define HeightValue 0x0008
579 #define AllValues 0x000F
580 #define XNegative 0x0010
581 #define YNegative 0x0020
584 * XParseGeometry parses strings of the form
585 * "=<width>x<height>{+-}<xoffset>{+-}<yoffset>", where
586 * width, height, xoffset, and yoffset are unsigned integers.
587 * Example: "=80x24+300-49"
588 * The equal sign is optional.
589 * It returns a bitmask that indicates which of the four values
590 * were actually found in the string. For each value found,
591 * the corresponding argument is updated; for each value
592 * not found, the corresponding argument is left unchanged.
596 ReadInteger(char *string, char **NextString)
598 register int Result = 0;
603 else if (*string == '-')
608 for (; (*string >= '0') && (*string <= '9'); string++)
610 Result = (Result * 10) + (*string - '0');
612 *NextString = string;
619 static int XParseGeometry (
623 unsigned int *width, /* RETURN */
624 unsigned int *height) /* RETURN */
627 register char *strind;
628 unsigned int tempWidth = 0, tempHeight = 0;
629 int tempX = 0, tempY = 0;
632 if ( (string == NULL) || (*string == '\0'))
635 string++; /* ignore possible '=' at beg of geometry spec */
637 strind = (char *)string;
638 if (*strind != '+' && *strind != '-' && *strind != 'x') {
639 tempWidth = ReadInteger(strind, &nextCharacter);
640 if (strind == nextCharacter)
642 strind = nextCharacter;
646 if (*strind == 'x' || *strind == 'X') {
648 tempHeight = ReadInteger(strind, &nextCharacter);
649 if (strind == nextCharacter)
651 strind = nextCharacter;
655 if ((*strind == '+') || (*strind == '-')) {
656 if (*strind == '-') {
658 tempX = -ReadInteger(strind, &nextCharacter);
659 if (strind == nextCharacter)
661 strind = nextCharacter;
667 tempX = ReadInteger(strind, &nextCharacter);
668 if (strind == nextCharacter)
670 strind = nextCharacter;
673 if ((*strind == '+') || (*strind == '-')) {
674 if (*strind == '-') {
676 tempY = -ReadInteger(strind, &nextCharacter);
677 if (strind == nextCharacter)
679 strind = nextCharacter;
685 tempY = ReadInteger(strind, &nextCharacter);
686 if (strind == nextCharacter)
688 strind = nextCharacter;
694 /* If strind isn't at the end of the string the it's an invalid
695 geometry specification. */
697 if (*strind != '\0') return 0;
703 if (mask & WidthValue)
705 if (mask & HeightValue)
706 *height = tempHeight;
711 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */
714 * Perform initialization. This usually happens on the program startup
715 * and restarting after glutMainLoop termination...
717 void FGAPIENTRY glutInit( int* pargc, char** argv )
719 char* displayName = NULL;
720 char* geometry = NULL;
721 int i, j, argc = *pargc;
723 if( fgState.Initialised )
724 fgError( "illegal glutInit() reinitialization attempt" );
726 if (pargc && *pargc && argv && *argv && **argv)
728 fgState.ProgramName = strdup (*argv);
730 if( !fgState.ProgramName )
731 fgError ("Could not allocate space for the program's name.");
734 fgCreateStructure( );
737 fgState.Time = fgSystemTime();
739 /* check if GLUT_FPS env var is set */
742 const char *fps = getenv( "GLUT_FPS" );
747 sscanf( fps, "%d", &interval );
750 fgState.FPSInterval = 5000; /* 5000 millisecond default */
752 fgState.FPSInterval = interval;
756 displayName = getenv( "DISPLAY" );
758 for( i = 1; i < argc; i++ )
760 if( strcmp( argv[ i ], "-display" ) == 0 )
763 fgError( "-display parameter must be followed by display name" );
765 displayName = argv[ i ];
767 argv[ i - 1 ] = NULL;
771 else if( strcmp( argv[ i ], "-geometry" ) == 0 )
774 fgError( "-geometry parameter must be followed by window "
775 "geometry settings" );
777 geometry = argv[ i ];
779 argv[ i - 1 ] = NULL;
783 else if( strcmp( argv[ i ], "-direct" ) == 0)
785 if( fgState.DirectContext == GLUT_FORCE_INDIRECT_CONTEXT )
786 fgError( "parameters ambiguity, -direct and -indirect "
787 "cannot be both specified" );
789 fgState.DirectContext = GLUT_FORCE_DIRECT_CONTEXT;
793 else if( strcmp( argv[ i ], "-indirect" ) == 0 )
795 if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )
796 fgError( "parameters ambiguity, -direct and -indirect "
797 "cannot be both specified" );
799 fgState.DirectContext = GLUT_FORCE_INDIRECT_CONTEXT;
803 else if( strcmp( argv[ i ], "-iconic" ) == 0 )
805 fgState.ForceIconic = GL_TRUE;
809 else if( strcmp( argv[ i ], "-gldebug" ) == 0 )
811 fgState.GLDebugSwitch = GL_TRUE;
815 else if( strcmp( argv[ i ], "-sync" ) == 0 )
817 fgState.XSyncSwitch = GL_TRUE;
823 /* Compact {argv}. */
824 for( i = j = 1; i < *pargc; i++, j++ )
826 /* Guaranteed to end because there are "*pargc" arguments left */
827 while ( argv[ j ] == NULL )
830 argv[ i ] = argv[ j ];
833 #endif /* _WIN32_WCE */
836 * Have the display created now. If there wasn't a "-display"
837 * in the program arguments, we will use the DISPLAY environment
838 * variable for opening the X display (see code above):
840 fghInitialize( displayName );
843 * Geometry parsing deffered until here because we may need the screen
849 unsigned int parsedWidth, parsedHeight;
850 int mask = XParseGeometry( geometry,
851 &fgState.Position.X, &fgState.Position.Y,
852 &parsedWidth, &parsedHeight );
853 /* TODO: Check for overflow? */
854 fgState.Size.X = parsedWidth;
855 fgState.Size.Y = parsedHeight;
857 if( (mask & (WidthValue|HeightValue)) == (WidthValue|HeightValue) )
858 fgState.Size.Use = GL_TRUE;
860 if( mask & XNegative )
861 fgState.Position.X += fgDisplay.ScreenWidth - fgState.Size.X;
863 if( mask & YNegative )
864 fgState.Position.Y += fgDisplay.ScreenHeight - fgState.Size.Y;
866 if( (mask & (XValue|YValue)) == (XValue|YValue) )
867 fgState.Position.Use = GL_TRUE;
871 #if TARGET_HOST_MS_WINDOWS
872 void (__cdecl *__glutExitFunc)( int return_value ) = NULL;
874 void FGAPIENTRY __glutInitWithExit( int *pargc, char **argv, void (__cdecl *exit_function)(int) )
876 __glutExitFunc = exit_function;
877 glutInit(pargc, argv);
882 * Undoes all the "glutInit" stuff
884 void FGAPIENTRY glutExit ( void )
890 * Sets the default initial window position for new windows
892 void FGAPIENTRY glutInitWindowPosition( int x, int y )
894 fgState.Position.X = x;
895 fgState.Position.Y = y;
897 if( ( x >= 0 ) && ( y >= 0 ) )
898 fgState.Position.Use = GL_TRUE;
900 fgState.Position.Use = GL_FALSE;
904 * Sets the default initial window size for new windows
906 void FGAPIENTRY glutInitWindowSize( int width, int height )
908 fgState.Size.X = width;
909 fgState.Size.Y = height;
911 if( ( width > 0 ) && ( height > 0 ) )
912 fgState.Size.Use = GL_TRUE;
914 fgState.Size.Use = GL_FALSE;
918 * Sets the default display mode for all new windows
920 void FGAPIENTRY glutInitDisplayMode( unsigned int displayMode )
922 /* We will make use of this value when creating a new OpenGL context... */
923 fgState.DisplayMode = displayMode;
927 /* -- INIT DISPLAY STRING PARSING ------------------------------------------ */
929 static char* Tokens[] =
931 "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double",
932 "green", "index", "num", "red", "rgba", "rgb", "luminance", "stencil",
933 "single", "stereo", "samples", "slow", "win32pdf", "win32pfd", "xvisual",
934 "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",
935 "xtruecolor", "xdirectcolor",
936 "xstaticgrey", "xgreyscale", "xstaticcolour", "xpseudocolour",
937 "xtruecolour", "xdirectcolour", "borderless", "aux"
939 #define NUM_TOKENS (sizeof(Tokens) / sizeof(*Tokens))
941 void FGAPIENTRY glutInitDisplayString( const char* displayMode )
943 int glut_state_flag = 0 ;
945 * Unpack a lot of options from a character string. The options are
946 * delimited by blanks or tabs.
949 size_t len = strlen ( displayMode );
950 char *buffer = (char *)malloc ( (len+1) * sizeof(char) );
951 memcpy ( buffer, displayMode, len );
954 token = strtok ( buffer, " \t" );
958 /* Process this token */
961 /* Temporary fix: Ignore any length specifications and at least
962 * process the basic token
963 * TODO: Fix this permanently
965 size_t cleanlength = strcspn ( token, "=<>~!" );
967 for ( i = 0; i < NUM_TOKENS; i++ )
969 if ( strncmp ( token, Tokens[i], cleanlength ) == 0 ) break ;
974 case 0 : /* "alpha": Alpha color buffer precision in bits */
975 glut_state_flag |= GLUT_ALPHA ; /* Somebody fix this for me! */
978 case 1 : /* "acca": Red, green, blue, and alpha accumulation buffer
982 case 2 : /* "acc": Red, green, and blue accumulation buffer precision
983 in bits with zero bits alpha */
984 glut_state_flag |= GLUT_ACCUM ; /* Somebody fix this for me! */
987 case 3 : /* "blue": Blue color buffer precision in bits */
990 case 4 : /* "buffer": Number of bits in the color index color buffer
994 case 5 : /* "conformant": Boolean indicating if the frame buffer
995 configuration is conformant or not */
998 case 6 : /* "depth": Number of bits of precsion in the depth buffer */
999 glut_state_flag |= GLUT_DEPTH ; /* Somebody fix this for me! */
1002 case 7 : /* "double": Boolean indicating if the color buffer is
1004 glut_state_flag |= GLUT_DOUBLE ;
1007 case 8 : /* "green": Green color buffer precision in bits */
1010 case 9 : /* "index": Boolean if the color model is color index or not
1012 glut_state_flag |= GLUT_INDEX ;
1015 case 10 : /* "num": A special capability name indicating where the
1016 value represents the Nth frame buffer configuration
1017 matching the description string */
1020 case 11 : /* "red": Red color buffer precision in bits */
1023 case 12 : /* "rgba": Number of bits of red, green, blue, and alpha in
1024 the RGBA color buffer */
1025 glut_state_flag |= GLUT_RGBA ; /* Somebody fix this for me! */
1028 case 13 : /* "rgb": Number of bits of red, green, and blue in the
1029 RGBA color buffer with zero bits alpha */
1030 glut_state_flag |= GLUT_RGB ; /* Somebody fix this for me! */
1033 case 14 : /* "luminance": Number of bits of red in the RGBA and zero
1034 bits of green, blue (alpha not specified) of color buffer
1036 glut_state_flag |= GLUT_LUMINANCE ; /* Somebody fix this for me! */
1039 case 15 : /* "stencil": Number of bits in the stencil buffer */
1040 glut_state_flag |= GLUT_STENCIL; /* Somebody fix this for me! */
1043 case 16 : /* "single": Boolean indicate the color buffer is single
1045 glut_state_flag |= GLUT_SINGLE ;
1048 case 17 : /* "stereo": Boolean indicating the color buffer supports
1049 OpenGL-style stereo */
1050 glut_state_flag |= GLUT_STEREO ;
1053 case 18 : /* "samples": Indicates the number of multisamples to use
1054 based on GLX's SGIS_multisample extension (for
1056 glut_state_flag |= GLUT_MULTISAMPLE ; /*Somebody fix this for me!*/
1059 case 19 : /* "slow": Boolean indicating if the frame buffer
1060 configuration is slow or not */
1063 case 20 : /* "win32pdf": (incorrect spelling but was there before */
1064 case 21 : /* "win32pfd": matches the Win32 Pixel Format Descriptor by
1066 #if TARGET_HOST_MS_WINDOWS
1070 case 22 : /* "xvisual": matches the X visual ID by number */
1071 #if TARGET_HOST_POSIX_X11
1075 case 23 : /* "xstaticgray": */
1076 case 29 : /* "xstaticgrey": boolean indicating if the frame buffer
1077 configuration's X visual is of type StaticGray */
1078 #if TARGET_HOST_POSIX_X11
1082 case 24 : /* "xgrayscale": */
1083 case 30 : /* "xgreyscale": boolean indicating if the frame buffer
1084 configuration's X visual is of type GrayScale */
1085 #if TARGET_HOST_POSIX_X11
1089 case 25 : /* "xstaticcolor": */
1090 case 31 : /* "xstaticcolour": boolean indicating if the frame buffer
1091 configuration's X visual is of type StaticColor */
1092 #if TARGET_HOST_POSIX_X11
1096 case 26 : /* "xpseudocolor": */
1097 case 32 : /* "xpseudocolour": boolean indicating if the frame buffer
1098 configuration's X visual is of type PseudoColor */
1099 #if TARGET_HOST_POSIX_X11
1103 case 27 : /* "xtruecolor": */
1104 case 33 : /* "xtruecolour": boolean indicating if the frame buffer
1105 configuration's X visual is of type TrueColor */
1106 #if TARGET_HOST_POSIX_X11
1110 case 28 : /* "xdirectcolor": */
1111 case 34 : /* "xdirectcolour": boolean indicating if the frame buffer
1112 configuration's X visual is of type DirectColor */
1113 #if TARGET_HOST_POSIX_X11
1117 case 35 : /* "borderless": windows should not have borders */
1118 #if TARGET_HOST_POSIX_X11
1122 case 36 : /* "aux": some number of aux buffers */
1123 glut_state_flag |= GLUT_AUX;
1126 case 37 : /* Unrecognized */
1127 fgWarning ( "WARNING - Display string token not recognized: %s",
1132 token = strtok ( NULL, " \t" );
1137 /* We will make use of this value when creating a new OpenGL context... */
1138 fgState.DisplayMode = glut_state_flag;
1141 /* -- SETTING OPENGL 3.0 CONTEXT CREATION PARAMETERS ---------------------- */
1143 void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion )
1145 /* We will make use of these valuse when creating a new OpenGL context... */
1146 fgState.MajorVersion = majorVersion;
1147 fgState.MinorVersion = minorVersion;
1151 void FGAPIENTRY glutInitContextFlags( int flags )
1153 /* We will make use of this value when creating a new OpenGL context... */
1154 fgState.ContextFlags = flags;
1157 void FGAPIENTRY glutInitContextProfile( int profile )
1159 /* We will make use of this value when creating a new OpenGL context... */
1160 fgState.ContextProfile = profile;
1163 /* -------------- User Defined Error/Warning Handler Support -------------- */
1166 * Sets the user error handler (note the use of va_list for the args to the fmt)
1168 void FGAPIENTRY glutInitErrorFunc( void (* vfgError) ( const char *fmt, va_list ap ) )
1170 /* This allows user programs to handle freeglut errors */
1171 fgState.ErrorFunc = vfgError;
1175 * Sets the user warning handler (note the use of va_list for the args to the fmt)
1177 void FGAPIENTRY glutInitWarningFunc( void (* vfgWarning) ( const char *fmt, va_list ap ) )
1179 /* This allows user programs to handle freeglut warnings */
1180 fgState.WarningFunc = vfgWarning;
1183 /*** END OF FILE ***/