git.mutantstargoat.com Git - freeglut/blob - src/Common/freeglut_init.c

   1 /*\r
   2  * freeglut_init.c\r
   3  *\r
   4  * Various freeglut initialization functions.\r
   5  *\r
   6  * Copyright (c) 1999-2000 Pawel W. Olszta. All Rights Reserved.\r
   7  * Written by Pawel W. Olszta, <olszta@sourceforge.net>\r
   8  * Creation date: Thu Dec 2 1999\r
   9  *\r
  10  * Permission is hereby granted, free of charge, to any person obtaining a\r
  11  * copy of this software and associated documentation files (the "Software"),\r
  12  * to deal in the Software without restriction, including without limitation\r
  13  * the rights to use, copy, modify, merge, publish, distribute, sublicense,\r
  14  * and/or sell copies of the Software, and to permit persons to whom the\r
  15  * Software is furnished to do so, subject to the following conditions:\r
  16  *\r
  17  * The above copyright notice and this permission notice shall be included\r
  18  * in all copies or substantial portions of the Software.\r
  19  *\r
  20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS\r
  21  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r
  22  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL\r
  23  * PAWEL W. OLSZTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
  24  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
  25  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
  26  */\r
  27 \r
  28 #define FREEGLUT_BUILDING_LIB\r
  29 #include <GL/freeglut.h>\r
  30 #include "freeglut_internal.h"\r
  31 \r
  32 /*\r
  33  * TODO BEFORE THE STABLE RELEASE:\r
  34  *\r
  35  *  fgDeinitialize()        -- Win32's OK, X11 needs the OS-specific\r
  36  *                             deinitialization done\r
  37  *  glutInitDisplayString() -- display mode string parsing\r
  38  *\r
  39  * Wouldn't it be cool to use gettext() for error messages? I just love\r
  40  * bash saying  "nie znaleziono pliku" instead of "file not found" :)\r
  41  * Is gettext easily portable?\r
  42  */\r
  43 \r
  44 /* -- GLOBAL VARIABLES ----------------------------------------------------- */\r
  45 \r
  46 /*\r
  47  * A structure pointed by g_pDisplay holds all information\r
  48  * regarding the display, screen, root window etc.\r
  49  */\r
  50 SFG_Display fgDisplay;\r
  51 \r
  52 /*\r
  53  * The settings for the current freeglut session\r
  54  */\r
  55 SFG_State fgState = { { -1, -1, GL_FALSE },  /* Position */\r
  56                       { 300, 300, GL_TRUE }, /* Size */\r
  57                       GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH,  /* DisplayMode */\r
  58                       GL_FALSE,              /* Initialised */\r
  59                       GLUT_TRY_DIRECT_CONTEXT,  /* DirectContext */\r
  60                       GL_FALSE,              /* ForceIconic */\r
  61                       GL_FALSE,              /* UseCurrentContext */\r
  62                       GL_FALSE,              /* GLDebugSwitch */\r
  63                       GL_FALSE,              /* XSyncSwitch */\r
  64                       GLUT_KEY_REPEAT_ON,    /* KeyRepeat */\r
  65                       INVALID_MODIFIERS,     /* Modifiers */\r
  66                       0,                     /* FPSInterval */\r
  67                       0,                     /* SwapCount */\r
  68                       0,                     /* SwapTime */\r
  69                       0,                     /* Time */\r
  70                       { NULL, NULL },         /* Timers */\r
  71                       { NULL, NULL },         /* FreeTimers */\r
  72                       NULL,                   /* IdleCallback */\r
  73                       0,                      /* ActiveMenus */\r
  74                       NULL,                   /* MenuStateCallback */\r
  75                       NULL,                   /* MenuStatusCallback */\r
  76                       { 640, 480, GL_TRUE },  /* GameModeSize */\r
  77                       16,                     /* GameModeDepth */\r
  78                       72,                     /* GameModeRefresh */\r
  79                       GLUT_ACTION_EXIT,       /* ActionOnWindowClose */\r
  80                       GLUT_EXEC_STATE_INIT,   /* ExecState */\r
  81                       NULL,                   /* ProgramName */\r
  82                       GL_FALSE,               /* JoysticksInitialised */\r
  83                       0,                      /* NumActiveJoysticks */\r
  84                       GL_FALSE,               /* InputDevsInitialised */\r
  85                       0,                      /* MouseWheelTicks */\r
  86                       1,                      /* AuxiliaryBufferNumber */\r
  87                       4,                      /* SampleNumber */\r
  88                       1,                      /* MajorVersion */\r
  89                       0,                      /* MinorVersion */\r
  90                       0,                      /* ContextFlags */\r
  91                       0,                      /* ContextProfile */\r
  92                       NULL,                   /* ErrorFunc */\r
  93                       NULL                    /* WarningFunc */\r
  94 };\r
  95 \r
  96 \r
  97 /* -- PRIVATE FUNCTIONS ---------------------------------------------------- */\r
  98 \r
  99 extern void fgPlatformInitialize( const char* displayName );\r
 100 extern void fgPlatformDeinitialiseInputDevices ( void );\r
 101 extern void fgPlatformCloseDisplay ( void );\r
 102 extern void fgPlatformDestroyContext ( SFG_PlatformDisplay pDisplay, SFG_WindowContextType MContext );\r
 103 \r
 104 \r
 105 void fghParseCommandLineArguments ( int* pargc, char** argv, char **pDisplayName, char **pGeometry )\r
 106 {\r
 107 #ifndef _WIN32_WCE\r
 108     int i, j, argc = *pargc;\r
 109 \r
 110     {\r
 111             /* check if GLUT_FPS env var is set */\r
 112         const char *fps = getenv( "GLUT_FPS" );\r
 113 \r
 114         if( fps )\r
 115         {\r
 116             int interval;\r
 117             sscanf( fps, "%d", &interval );\r
 118 \r
 119             if( interval <= 0 )\r
 120                 fgState.FPSInterval = 5000;  /* 5000 millisecond default */\r
 121             else\r
 122                 fgState.FPSInterval = interval;\r
 123         }\r
 124     }\r
 125 \r
 126     *pDisplayName = getenv( "DISPLAY" );\r
 127 \r
 128     for( i = 1; i < argc; i++ )\r
 129     {\r
 130         if( strcmp( argv[ i ], "-display" ) == 0 )\r
 131         {\r
 132             if( ++i >= argc )\r
 133                 fgError( "-display parameter must be followed by display name" );\r
 134 \r
 135             *pDisplayName = argv[ i ];\r
 136 \r
 137             argv[ i - 1 ] = NULL;\r
 138             argv[ i     ] = NULL;\r
 139             ( *pargc ) -= 2;\r
 140         }\r
 141         else if( strcmp( argv[ i ], "-geometry" ) == 0 )\r
 142         {\r
 143             if( ++i >= argc )\r
 144                 fgError( "-geometry parameter must be followed by window "\r
 145                          "geometry settings" );\r
 146 \r
 147             *pGeometry = argv[ i ];\r
 148 \r
 149             argv[ i - 1 ] = NULL;\r
 150             argv[ i     ] = NULL;\r
 151             ( *pargc ) -= 2;\r
 152         }\r
 153         else if( strcmp( argv[ i ], "-direct" ) == 0)\r
 154         {\r
 155             if( fgState.DirectContext == GLUT_FORCE_INDIRECT_CONTEXT )\r
 156                 fgError( "parameters ambiguity, -direct and -indirect "\r
 157                     "cannot be both specified" );\r
 158 \r
 159             fgState.DirectContext = GLUT_FORCE_DIRECT_CONTEXT;\r
 160             argv[ i ] = NULL;\r
 161             ( *pargc )--;\r
 162         }\r
 163         else if( strcmp( argv[ i ], "-indirect" ) == 0 )\r
 164         {\r
 165             if( fgState.DirectContext == GLUT_FORCE_DIRECT_CONTEXT )\r
 166                 fgError( "parameters ambiguity, -direct and -indirect "\r
 167                     "cannot be both specified" );\r
 168 \r
 169             fgState.DirectContext = GLUT_FORCE_INDIRECT_CONTEXT;\r
 170             argv[ i ] = NULL;\r
 171             (*pargc)--;\r
 172         }\r
 173         else if( strcmp( argv[ i ], "-iconic" ) == 0 )\r
 174         {\r
 175             fgState.ForceIconic = GL_TRUE;\r
 176             argv[ i ] = NULL;\r
 177             ( *pargc )--;\r
 178         }\r
 179         else if( strcmp( argv[ i ], "-gldebug" ) == 0 )\r
 180         {\r
 181             fgState.GLDebugSwitch = GL_TRUE;\r
 182             argv[ i ] = NULL;\r
 183             ( *pargc )--;\r
 184         }\r
 185         else if( strcmp( argv[ i ], "-sync" ) == 0 )\r
 186         {\r
 187             fgState.XSyncSwitch = GL_TRUE;\r
 188             argv[ i ] = NULL;\r
 189             ( *pargc )--;\r
 190         }\r
 191     }\r
 192 \r
 193     /* Compact {argv}. */\r
 194     for( i = j = 1; i < *pargc; i++, j++ )\r
 195     {\r
 196         /* Guaranteed to end because there are "*pargc" arguments left */\r
 197         while ( argv[ j ] == NULL )\r
 198             j++;\r
 199         if ( i != j )\r
 200             argv[ i ] = argv[ j ];\r
 201     }\r
 202 \r
 203 #endif /* _WIN32_WCE */\r
 204 \r
 205 }\r
 206 \r
 207 \r
 208 void fghCloseInputDevices ( void )\r
 209 {\r
 210     if ( fgState.JoysticksInitialised )\r
 211         fgJoystickClose( );\r
 212 \r
 213     if ( fgState.InputDevsInitialised )\r
 214         fgInputDeviceClose( );\r
 215 }\r
 216 \r
 217 \r
 218 /*\r
 219  * Perform the freeglut deinitialization...\r
 220  */\r
 221 void fgDeinitialize( void )\r
 222 {\r
 223     SFG_Timer *timer;\r
 224 \r
 225     if( !fgState.Initialised )\r
 226     {\r
 227         return;\r
 228     }\r
 229 \r
 230         /* If we're in game mode, we want to leave game mode */\r
 231     if( fgStructure.GameModeWindow ) {\r
 232         glutLeaveGameMode();\r
 233     }\r
 234 \r
 235     /* If there was a menu created, destroy the rendering context */\r
 236     if( fgStructure.MenuContext )\r
 237     {\r
 238                 fgPlatformDestroyContext (fgDisplay.pDisplay, fgStructure.MenuContext->MContext );\r
 239         free( fgStructure.MenuContext );\r
 240         fgStructure.MenuContext = NULL;\r
 241     }\r
 242 \r
 243     fgDestroyStructure( );\r
 244 \r
 245     while( ( timer = fgState.Timers.First) )\r
 246     {\r
 247         fgListRemove( &fgState.Timers, &timer->Node );\r
 248         free( timer );\r
 249     }\r
 250 \r
 251     while( ( timer = fgState.FreeTimers.First) )\r
 252     {\r
 253         fgListRemove( &fgState.FreeTimers, &timer->Node );\r
 254         free( timer );\r
 255     }\r
 256 \r
 257         fgPlatformDeinitialiseInputDevices ();\r
 258 \r
 259         fgState.MouseWheelTicks = 0;\r
 260 \r
 261     fgState.MajorVersion = 1;\r
 262     fgState.MinorVersion = 0;\r
 263     fgState.ContextFlags = 0;\r
 264     fgState.ContextProfile = 0;\r
 265 \r
 266     fgState.Initialised = GL_FALSE;\r
 267 \r
 268     fgState.Position.X = -1;\r
 269     fgState.Position.Y = -1;\r
 270     fgState.Position.Use = GL_FALSE;\r
 271 \r
 272     fgState.Size.X = 300;\r
 273     fgState.Size.Y = 300;\r
 274     fgState.Size.Use = GL_TRUE;\r
 275 \r
 276     fgState.DisplayMode = GLUT_RGBA | GLUT_SINGLE | GLUT_DEPTH;\r
 277 \r
 278     fgState.DirectContext  = GLUT_TRY_DIRECT_CONTEXT;\r
 279     fgState.ForceIconic         = GL_FALSE;\r
 280     fgState.UseCurrentContext   = GL_FALSE;\r
 281     fgState.GLDebugSwitch       = GL_FALSE;\r
 282     fgState.XSyncSwitch         = GL_FALSE;\r
 283     fgState.ActionOnWindowClose = GLUT_ACTION_EXIT;\r
 284     fgState.ExecState           = GLUT_EXEC_STATE_INIT;\r
 285 \r
 286     fgState.KeyRepeat       = GLUT_KEY_REPEAT_ON;\r
 287     fgState.Modifiers       = INVALID_MODIFIERS;\r
 288 \r
 289     fgState.GameModeSize.X  = 640;\r
 290     fgState.GameModeSize.Y  = 480;\r
 291     fgState.GameModeDepth   =  16;\r
 292     fgState.GameModeRefresh =  72;\r
 293 \r
 294     fgListInit( &fgState.Timers );\r
 295     fgListInit( &fgState.FreeTimers );\r
 296 \r
 297     fgState.IdleCallback = NULL;\r
 298     fgState.MenuStateCallback = ( FGCBMenuState )NULL;\r
 299     fgState.MenuStatusCallback = ( FGCBMenuStatus )NULL;\r
 300 \r
 301     fgState.SwapCount   = 0;\r
 302     fgState.SwapTime    = 0;\r
 303     fgState.FPSInterval = 0;\r
 304 \r
 305     if( fgState.ProgramName )\r
 306     {\r
 307         free( fgState.ProgramName );\r
 308         fgState.ProgramName = NULL;\r
 309     }\r
 310 \r
 311         fgPlatformCloseDisplay ();\r
 312 \r
 313     fgState.Initialised = GL_FALSE;\r
 314 }\r
 315 \r
 316 \r
 317 #if TARGET_HOST_MS_WINDOWS\r
 318 #define NoValue         0x0000\r
 319 #define XValue          0x0001\r
 320 #define YValue          0x0002\r
 321 #define WidthValue      0x0004\r
 322 #define HeightValue     0x0008\r
 323 #define AllValues       0x000F\r
 324 #define XNegative       0x0010\r
 325 #define YNegative       0x0020\r
 326 \r
 327 extern int XParseGeometry (\r
 328     const char *string,\r
 329     int *x,\r
 330     int *y,\r
 331     unsigned int *width,    /* RETURN */\r
 332     unsigned int *height);    /* RETURN */\r
 333 #endif\r
 334 \r
 335 /* -- INTERFACE FUNCTIONS -------------------------------------------------- */\r
 336 \r
 337 /*\r
 338  * Perform initialization. This usually happens on the program startup\r
 339  * and restarting after glutMainLoop termination...\r
 340  */\r
 341 void FGAPIENTRY glutInit( int* pargc, char** argv )\r
 342 {\r
 343     char* displayName = NULL;\r
 344     char* geometry = NULL;\r
 345     if( fgState.Initialised )\r
 346         fgError( "illegal glutInit() reinitialization attempt" );\r
 347 \r
 348     if (pargc && *pargc && argv && *argv && **argv)\r
 349     {\r
 350         fgState.ProgramName = strdup (*argv);\r
 351 \r
 352         if( !fgState.ProgramName )\r
 353             fgError ("Could not allocate space for the program's name.");\r
 354     }\r
 355 \r
 356     fgCreateStructure( );\r
 357 \r
 358     /* Get start time */\r
 359     fgState.Time = fgSystemTime();\r
 360 \r
 361         fghParseCommandLineArguments ( pargc, argv, &displayName, &geometry );\r
 362 \r
 363     /*\r
 364      * Have the display created now. If there wasn't a "-display"\r
 365      * in the program arguments, we will use the DISPLAY environment\r
 366      * variable for opening the X display (see code above):\r
 367      */\r
 368     fgPlatformInitialize( displayName );\r
 369 \r
 370     /*\r
 371      * Geometry parsing deffered until here because we may need the screen\r
 372      * size.\r
 373      */\r
 374 \r
 375     if (geometry )\r
 376     {\r
 377         unsigned int parsedWidth, parsedHeight;\r
 378         int mask = XParseGeometry( geometry,\r
 379                                    &fgState.Position.X, &fgState.Position.Y,\r
 380                                    &parsedWidth, &parsedHeight );\r
 381         /* TODO: Check for overflow? */\r
 382         fgState.Size.X = parsedWidth;\r
 383         fgState.Size.Y = parsedHeight;\r
 384 \r
 385         if( (mask & (WidthValue|HeightValue)) == (WidthValue|HeightValue) )\r
 386             fgState.Size.Use = GL_TRUE;\r
 387 \r
 388         if( mask & XNegative )\r
 389             fgState.Position.X += fgDisplay.ScreenWidth - fgState.Size.X;\r
 390 \r
 391         if( mask & YNegative )\r
 392             fgState.Position.Y += fgDisplay.ScreenHeight - fgState.Size.Y;\r
 393 \r
 394         if( (mask & (XValue|YValue)) == (XValue|YValue) )\r
 395             fgState.Position.Use = GL_TRUE;\r
 396     }\r
 397 }\r
 398 \r
 399 /*\r
 400  * Undoes all the "glutInit" stuff\r
 401  */\r
 402 void FGAPIENTRY glutExit ( void )\r
 403 {\r
 404   fgDeinitialize ();\r
 405 }\r
 406 \r
 407 /*\r
 408  * Sets the default initial window position for new windows\r
 409  */\r
 410 void FGAPIENTRY glutInitWindowPosition( int x, int y )\r
 411 {\r
 412     fgState.Position.X = x;\r
 413     fgState.Position.Y = y;\r
 414 \r
 415     if( ( x >= 0 ) && ( y >= 0 ) )\r
 416         fgState.Position.Use = GL_TRUE;\r
 417     else\r
 418         fgState.Position.Use = GL_FALSE;\r
 419 }\r
 420 \r
 421 /*\r
 422  * Sets the default initial window size for new windows\r
 423  */\r
 424 void FGAPIENTRY glutInitWindowSize( int width, int height )\r
 425 {\r
 426     fgState.Size.X = width;\r
 427     fgState.Size.Y = height;\r
 428 \r
 429     if( ( width > 0 ) && ( height > 0 ) )\r
 430         fgState.Size.Use = GL_TRUE;\r
 431     else\r
 432         fgState.Size.Use = GL_FALSE;\r
 433 }\r
 434 \r
 435 /*\r
 436  * Sets the default display mode for all new windows\r
 437  */\r
 438 void FGAPIENTRY glutInitDisplayMode( unsigned int displayMode )\r
 439 {\r
 440     /* We will make use of this value when creating a new OpenGL context... */\r
 441     fgState.DisplayMode = displayMode;\r
 442 }\r
 443 \r
 444 \r
 445 /* -- INIT DISPLAY STRING PARSING ------------------------------------------ */\r
 446 \r
 447 static char* Tokens[] =\r
 448 {\r
 449     "alpha", "acca", "acc", "blue", "buffer", "conformant", "depth", "double",\r
 450     "green", "index", "num", "red", "rgba", "rgb", "luminance", "stencil",\r
 451     "single", "stereo", "samples", "slow", "win32pdf", "win32pfd", "xvisual",\r
 452     "xstaticgray", "xgrayscale", "xstaticcolor", "xpseudocolor",\r
 453     "xtruecolor", "xdirectcolor",\r
 454     "xstaticgrey", "xgreyscale", "xstaticcolour", "xpseudocolour",\r
 455     "xtruecolour", "xdirectcolour", "borderless", "aux"\r
 456 };\r
 457 #define NUM_TOKENS             (sizeof(Tokens) / sizeof(*Tokens))\r
 458 \r
 459 void FGAPIENTRY glutInitDisplayString( const char* displayMode )\r
 460 {\r
 461     int glut_state_flag = 0 ;\r
 462     /*\r
 463      * Unpack a lot of options from a character string.  The options are\r
 464      * delimited by blanks or tabs.\r
 465      */\r
 466     char *token ;\r
 467     size_t len = strlen ( displayMode );\r
 468     char *buffer = (char *)malloc ( (len+1) * sizeof(char) );\r
 469     memcpy ( buffer, displayMode, len );\r
 470     buffer[len] = '\0';\r
 471 \r
 472     token = strtok ( buffer, " \t" );\r
 473 \r
 474     while ( token )\r
 475     {\r
 476         /* Process this token */\r
 477         int i ;\r
 478 \r
 479         /* Temporary fix:  Ignore any length specifications and at least\r
 480          * process the basic token\r
 481          * TODO:  Fix this permanently\r
 482          */\r
 483         size_t cleanlength = strcspn ( token, "=<>~!" );\r
 484 \r
 485         for ( i = 0; i < NUM_TOKENS; i++ )\r
 486         {\r
 487             if ( strncmp ( token, Tokens[i], cleanlength ) == 0 ) break ;\r
 488         }\r
 489 \r
 490         switch ( i )\r
 491         {\r
 492         case 0 :  /* "alpha":  Alpha color buffer precision in bits */\r
 493             glut_state_flag |= GLUT_ALPHA ;  /* Somebody fix this for me! */\r
 494             break ;\r
 495 \r
 496         case 1 :  /* "acca":  Red, green, blue, and alpha accumulation buffer\r
 497                      precision in bits */\r
 498             break ;\r
 499 \r
 500         case 2 :  /* "acc":  Red, green, and blue accumulation buffer precision\r
 501                      in bits with zero bits alpha */\r
 502             glut_state_flag |= GLUT_ACCUM ;  /* Somebody fix this for me! */\r
 503             break ;\r
 504 \r
 505         case 3 :  /* "blue":  Blue color buffer precision in bits */\r
 506             break ;\r
 507 \r
 508         case 4 :  /* "buffer":  Number of bits in the color index color buffer\r
 509                    */\r
 510             break ;\r
 511 \r
 512         case 5 :  /* "conformant":  Boolean indicating if the frame buffer\r
 513                      configuration is conformant or not */\r
 514             break ;\r
 515 \r
 516         case 6 : /* "depth":  Number of bits of precsion in the depth buffer */\r
 517             glut_state_flag |= GLUT_DEPTH ;  /* Somebody fix this for me! */\r
 518             break ;\r
 519 \r
 520         case 7 :  /* "double":  Boolean indicating if the color buffer is\r
 521                      double buffered */\r
 522             glut_state_flag |= GLUT_DOUBLE ;\r
 523             break ;\r
 524 \r
 525         case 8 :  /* "green":  Green color buffer precision in bits */\r
 526             break ;\r
 527 \r
 528         case 9 :  /* "index":  Boolean if the color model is color index or not\r
 529                    */\r
 530             glut_state_flag |= GLUT_INDEX ;\r
 531             break ;\r
 532 \r
 533         case 10 :  /* "num":  A special capability  name indicating where the\r
 534                       value represents the Nth frame buffer configuration\r
 535                       matching the description string */\r
 536             break ;\r
 537 \r
 538         case 11 :  /* "red":  Red color buffer precision in bits */\r
 539             break ;\r
 540 \r
 541         case 12 :  /* "rgba":  Number of bits of red, green, blue, and alpha in\r
 542                       the RGBA color buffer */\r
 543             glut_state_flag |= GLUT_RGBA ;  /* Somebody fix this for me! */\r
 544             break ;\r
 545 \r
 546         case 13 :  /* "rgb":  Number of bits of red, green, and blue in the\r
 547                       RGBA color buffer with zero bits alpha */\r
 548             glut_state_flag |= GLUT_RGB ;  /* Somebody fix this for me! */\r
 549             break ;\r
 550 \r
 551         case 14 :  /* "luminance":  Number of bits of red in the RGBA and zero\r
 552                       bits of green, blue (alpha not specified) of color buffer\r
 553                       precision */\r
 554             glut_state_flag |= GLUT_LUMINANCE ; /* Somebody fix this for me! */\r
 555             break ;\r
 556 \r
 557         case 15 :  /* "stencil":  Number of bits in the stencil buffer */\r
 558             glut_state_flag |= GLUT_STENCIL;  /* Somebody fix this for me! */\r
 559             break ;\r
 560 \r
 561         case 16 :  /* "single":  Boolean indicate the color buffer is single\r
 562                       buffered */\r
 563             glut_state_flag |= GLUT_SINGLE ;\r
 564             break ;\r
 565 \r
 566         case 17 :  /* "stereo":  Boolean indicating the color buffer supports\r
 567                       OpenGL-style stereo */\r
 568             glut_state_flag |= GLUT_STEREO ;\r
 569             break ;\r
 570 \r
 571         case 18 :  /* "samples":  Indicates the number of multisamples to use\r
 572                       based on GLX's SGIS_multisample extension (for\r
 573                       antialiasing) */\r
 574             glut_state_flag |= GLUT_MULTISAMPLE ; /*Somebody fix this for me!*/\r
 575             break ;\r
 576 \r
 577         case 19 :  /* "slow":  Boolean indicating if the frame buffer\r
 578                       configuration is slow or not */\r
 579             break ;\r
 580 \r
 581         case 20 :  /* "win32pdf": (incorrect spelling but was there before */\r
 582         case 21 :  /* "win32pfd":  matches the Win32 Pixel Format Descriptor by\r
 583                       number */\r
 584 #if TARGET_HOST_MS_WINDOWS\r
 585 #endif\r
 586             break ;\r
 587 \r
 588         case 22 :  /* "xvisual":  matches the X visual ID by number */\r
 589 #if TARGET_HOST_POSIX_X11\r
 590 #endif\r
 591             break ;\r
 592 \r
 593         case 23 :  /* "xstaticgray": */\r
 594         case 29 :  /* "xstaticgrey":  boolean indicating if the frame buffer\r
 595                       configuration's X visual is of type StaticGray */\r
 596 #if TARGET_HOST_POSIX_X11\r
 597 #endif\r
 598             break ;\r
 599 \r
 600         case 24 :  /* "xgrayscale": */\r
 601         case 30 :  /* "xgreyscale":  boolean indicating if the frame buffer\r
 602                       configuration's X visual is of type GrayScale */\r
 603 #if TARGET_HOST_POSIX_X11\r
 604 #endif\r
 605             break ;\r
 606 \r
 607         case 25 :  /* "xstaticcolor": */\r
 608         case 31 :  /* "xstaticcolour":  boolean indicating if the frame buffer\r
 609                       configuration's X visual is of type StaticColor */\r
 610 #if TARGET_HOST_POSIX_X11\r
 611 #endif\r
 612             break ;\r
 613 \r
 614         case 26 :  /* "xpseudocolor": */\r
 615         case 32 :  /* "xpseudocolour":  boolean indicating if the frame buffer\r
 616                       configuration's X visual is of type PseudoColor */\r
 617 #if TARGET_HOST_POSIX_X11\r
 618 #endif\r
 619             break ;\r
 620 \r
 621         case 27 :  /* "xtruecolor": */\r
 622         case 33 :  /* "xtruecolour":  boolean indicating if the frame buffer\r
 623                       configuration's X visual is of type TrueColor */\r
 624 #if TARGET_HOST_POSIX_X11\r
 625 #endif\r
 626             break ;\r
 627 \r
 628         case 28 :  /* "xdirectcolor": */\r
 629         case 34 :  /* "xdirectcolour":  boolean indicating if the frame buffer\r
 630                       configuration's X visual is of type DirectColor */\r
 631 #if TARGET_HOST_POSIX_X11\r
 632 #endif\r
 633             break ;\r
 634 \r
 635         case 35 :  /* "borderless":  windows should not have borders */\r
 636 #if TARGET_HOST_POSIX_X11\r
 637 #endif\r
 638             break ;\r
 639 \r
 640         case 36 :  /* "aux":  some number of aux buffers */\r
 641             glut_state_flag |= GLUT_AUX;\r
 642             break ;\r
 643 \r
 644         case 37 :  /* Unrecognized */\r
 645             fgWarning ( "WARNING - Display string token not recognized:  %s",\r
 646                         token );\r
 647             break ;\r
 648         }\r
 649 \r
 650         token = strtok ( NULL, " \t" );\r
 651     }\r
 652 \r
 653     free ( buffer );\r
 654 \r
 655     /* We will make use of this value when creating a new OpenGL context... */\r
 656     fgState.DisplayMode = glut_state_flag;\r
 657 }\r
 658 \r
 659 /* -- SETTING OPENGL 3.0 CONTEXT CREATION PARAMETERS ---------------------- */\r
 660 \r
 661 void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion )\r
 662 {\r
 663     /* We will make use of these valuse when creating a new OpenGL context... */\r
 664     fgState.MajorVersion = majorVersion;\r
 665     fgState.MinorVersion = minorVersion;\r
 666 }\r
 667 \r
 668 \r
 669 void FGAPIENTRY glutInitContextFlags( int flags )\r
 670 {\r
 671     /* We will make use of this value when creating a new OpenGL context... */\r
 672     fgState.ContextFlags = flags;\r
 673 }\r
 674 \r
 675 void FGAPIENTRY glutInitContextProfile( int profile )\r
 676 {\r
 677     /* We will make use of this value when creating a new OpenGL context... */\r
 678     fgState.ContextProfile = profile;\r
 679 }\r
 680 \r
 681 /* -------------- User Defined Error/Warning Handler Support -------------- */\r
 682 \r
 683 /*\r
 684  * Sets the user error handler (note the use of va_list for the args to the fmt)\r
 685  */\r
 686 void FGAPIENTRY glutInitErrorFunc( void (* vfgError) ( const char *fmt, va_list ap ) )\r
 687 {\r
 688     /* This allows user programs to handle freeglut errors */\r
 689     fgState.ErrorFunc = vfgError;\r
 690 }\r
 691 \r
 692 /*\r
 693  * Sets the user warning handler (note the use of va_list for the args to the fmt)\r
 694  */\r
 695 void FGAPIENTRY glutInitWarningFunc( void (* vfgWarning) ( const char *fmt, va_list ap ) )\r
 696 {\r
 697     /* This allows user programs to handle freeglut warnings */\r
 698     fgState.WarningFunc = vfgWarning;\r
 699 }\r
 700 \r
 701 /*** END OF FILE ***/\r