Main/options.cxx

   1 // options.cxx -- class to handle command line options
   2 //
   3 // Written by Curtis Olson, started April 1998.
   4 //
   5 // Copyright (C) 1998  Curtis L. Olson  - curt@me.umn.edu
   6 //
   7 // This program is free software; you can redistribute it and/or
   8 // modify it under the terms of the GNU General Public License as
   9 // published by the Free Software Foundation; either version 2 of the
  10 // License, or (at your option) any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 // General Public License for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License
  18 // along with this program; if not, write to the Free Software
  19 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 //
  21 // $Id$
  22 // (Log is kept at end of this file)
  23
  24
  25 #ifdef HAVE_CONFIG_H
  26 #  include <config.h>
  27 #endif
  28
  29 #if defined(FX) && defined(XMESA)
  30 bool global_fullscreen = true;
  31 #endif
  32
  33 #include <Include/compiler.h>
  34
  35 #include <math.h>            // rint()
  36 #include <stdio.h>
  37 #include <stdlib.h>          // atof(), atoi()
  38 #include <string.h>
  39
  40 #include STL_STRING
  41
  42 #include <Debug/logstream.hxx>
  43 #include <Misc/fgstream.hxx>
  44 #include <FDM/flight.hxx>
  45 #include <Include/fg_constants.h>
  46 #include <Main/options.hxx>
  47
  48 #include "fg_serial.hxx"
  49
  50 FG_USING_STD(string);
  51 FG_USING_NAMESPACE(std);
  52
  53
  54 inline double
  55 atof( const string& str )
  56 {
  57     return ::atof( str.c_str() );
  58 }
  59
  60 inline int
  61 atoi( const string& str )
  62 {
  63     return ::atoi( str.c_str() );
  64 }
  65
  66 // Defined the shared options class here
  67 fgOPTIONS current_options;
  68
  69
  70 // Constructor
  71 fgOPTIONS::fgOPTIONS() :
  72     // starting longitude in degrees (west = -)
  73     // starting latitude in degrees (south = -)
  74
  75     // Default initial position is Globe, AZ (P13)
  76     lon(-110.6642444),
  77     lat(  33.3528917),
  78
  79     // North of the city of Globe
  80     // lon(-110.7),
  81     // lat(  33.4),
  82
  83     // North of the city of Globe
  84     // lon(-110.742578),
  85     // lat(  33.507122),
  86
  87     // Near where I used to live in Globe, AZ
  88     // lon(-110.766000),
  89     // lat(  33.377778),
  90
  91     // 10125 Jewell St. NE
  92     // lon(-93.15),
  93     // lat( 45.15),
  94
  95     // Near KHSP (Hot Springs, VA)
  96     // lon(-79.8338964 + 0.01),
  97     // lat( 37.9514564 + 0.008),
  98
  99     // (SEZ) SEDONA airport
 100     // lon(-111.7884614 + 0.01),
 101     // lat(  34.8486289 - 0.015),
 102
 103     // Jim Brennon's Kingmont Observatory
 104     // lon(-121.1131667),
 105     // lat(  38.8293917),
 106
 107     // Huaras, Peru (S09d 31.871'  W077d 31.498')
 108     // lon(-77.5249667),
 109     // lat( -9.5311833),
 110
 111     // Eclipse Watching w73.5 n10 (approx) 18:00 UT
 112     // lon(-73.5),
 113     // lat( 10.0),
 114
 115     // Timms Hill (WI)
 116     // lon(-90.1953055556),
 117     // lat( 45.4511388889),
 118
 119     // starting altitude in meters (this will be reset to ground level
 120     // if it is lower than the terrain
 121     altitude(-9999.0),
 122
 123     // Initial Orientation
 124     heading(270.0),      // heading (yaw) angle in degress (Psi)
 125     roll(0.0),           // roll angle in degrees (Phi)
 126     pitch(0.424),        // pitch angle in degrees (Theta)
 127
 128     // Miscellaneous
 129     game_mode(0),
 130     splash_screen(1),
 131     intro_music(1),
 132     mouse_pointer(0),
 133     pause(0),
 134
 135     // Features
 136     hud_status(1),
 137     panel_status(0),
 138     sound(1),
 139
 140     // Flight Model options
 141     flight_model(FGInterface::FG_LARCSIM),
 142
 143     // Rendering options
 144     fog(FG_FOG_NICEST),  // nicest
 145     fov(55.0),
 146     fullscreen(0),
 147     shading(1),
 148     skyblend(1),
 149     textures(1),
 150     wireframe(0),
 151     xsize(640),
 152     ysize(480),
 153
 154     // Scenery options
 155     tile_diameter(5),
 156
 157     // HUD options
 158     units(FG_UNITS_FEET),
 159     tris_or_culled(0),
 160
 161     // Time options
 162     time_offset(0)
 163
 164 {
 165     // set initial values/defaults
 166     char* envp = ::getenv( "FG_ROOT" );
 167
 168     if ( envp != NULL ) {
 169         // fg_root could be anywhere, so default to environmental
 170         // variable $FG_ROOT if it is set.
 171         fg_root = envp;
 172     } else {
 173         // Otherwise, default to a random compiled in location if
 174         // $FG_ROOT is not set.  This can still be overridden from the
 175         // command line or a config file.
 176
 177 #if defined(WIN32)
 178         fg_root = "\\FlightGear";
 179 #else
 180         fg_root = "/usr/local/lib/FlightGear";
 181 #endif
 182     }
 183
 184     airport_id = "";  // default airport id
 185
 186     // initialize port config string list
 187     port_options_list.erase ( port_options_list.begin(),
 188                               port_options_list.end() );
 189 }
 190
 191
 192 double
 193 fgOPTIONS::parse_time(const string& time_in) {
 194     char *time_str, num[256];
 195     double hours, minutes, seconds;
 196     double result = 0.0;
 197     int sign = 1;
 198     int i;
 199
 200     time_str = (char *)time_in.c_str();
 201
 202     // printf("parse_time(): %s\n", time_str);
 203
 204     // check for sign
 205     if ( strlen(time_str) ) {
 206         if ( time_str[0] == '+' ) {
 207             sign = 1;
 208             time_str++;
 209         } else if ( time_str[0] == '-' ) {
 210             sign = -1;
 211             time_str++;
 212         }
 213     }
 214     // printf("sign = %d\n", sign);
 215
 216     // get hours
 217     if ( strlen(time_str) ) {
 218         i = 0;
 219         while ( (time_str[0] != ':') && (time_str[0] != '\0') ) {
 220             num[i] = time_str[0];
 221             time_str++;
 222             i++;
 223         }
 224         if ( time_str[0] == ':' ) {
 225             time_str++;
 226         }
 227         num[i] = '\0';
 228         hours = atof(num);
 229         // printf("hours = %.2lf\n", hours);
 230
 231         result += hours;
 232     }
 233
 234     // get minutes
 235     if ( strlen(time_str) ) {
 236         i = 0;
 237         while ( (time_str[0] != ':') && (time_str[0] != '\0') ) {
 238             num[i] = time_str[0];
 239             time_str++;
 240             i++;
 241         }
 242         if ( time_str[0] == ':' ) {
 243             time_str++;
 244         }
 245         num[i] = '\0';
 246         minutes = atof(num);
 247         // printf("minutes = %.2lf\n", minutes);
 248
 249         result += minutes / 60.0;
 250     }
 251
 252     // get seconds
 253     if ( strlen(time_str) ) {
 254         i = 0;
 255         while ( (time_str[0] != ':') && (time_str[0] != '\0') ) {
 256             num[i] = time_str[0];
 257             time_str++;
 258             i++;
 259         }
 260         num[i] = '\0';
 261         seconds = atof(num);
 262         // printf("seconds = %.2lf\n", seconds);
 263
 264         result += seconds / 3600.0;
 265     }
 266
 267     return(sign * result);
 268 }
 269
 270
 271 // parse degree in the form of [+/-]hhh:mm:ss
 272 double
 273 fgOPTIONS::parse_degree( const string& degree_str) {
 274     double result = parse_time( degree_str );
 275
 276     // printf("Degree = %.4f\n", result);
 277
 278     return(result);
 279 }
 280
 281
 282 // parse time offset command line option
 283 int
 284 fgOPTIONS::parse_time_offset( const string& time_str) {
 285     int result;
 286
 287     // printf("time offset = %s\n", time_str);
 288
 289 #ifdef HAVE_RINT
 290     result = (int)rint(parse_time(time_str) * 3600.0);
 291 #else
 292     result = (int)(parse_time(time_str) * 3600.0);
 293 #endif
 294
 295     // printf("parse_time_offset(): %d\n", result);
 296
 297     return( result );
 298 }
 299
 300
 301 // Parse --tile-diameter=n type option
 302
 303 int
 304 fgOPTIONS::parse_tile_radius( const string& arg ) {
 305     int radius = atoi( arg );
 306
 307     if ( radius < FG_RADIUS_MIN ) { radius = FG_RADIUS_MIN; }
 308     if ( radius > FG_RADIUS_MAX ) { radius = FG_RADIUS_MAX; }
 309
 310     // printf("parse_tile_radius(): radius = %d\n", radius);
 311
 312     return(radius);
 313 }
 314
 315
 316 // Parse --fdm=abcdefg type option
 317 int
 318 fgOPTIONS::parse_fdm( const string& fm ) {
 319     // printf("fdm = %s\n", fm);
 320
 321     if ( fm == "slew" ) {
 322         return FGInterface::FG_SLEW;
 323     } else if ( fm == "jsb" ) {
 324         return FGInterface::FG_JSBSIM;
 325     } else if ( (fm == "larcsim") || (fm == "LaRCsim") ) {
 326         return FGInterface::FG_LARCSIM;
 327     } else if ( fm == "external" ) {
 328         return FGInterface::FG_EXTERNAL;
 329     } else {
 330         FG_LOG( FG_GENERAL, FG_ALERT, "Unknown fdm = " << fm );
 331         exit(-1);
 332     }
 333
 334     // we'll never get here, but it makes the compiler happy.
 335     return -1;
 336 }
 337
 338
 339 // Parse --fov=x.xx type option
 340 double
 341 fgOPTIONS::parse_fov( const string& arg ) {
 342     double fov = atof(arg);
 343
 344     if ( fov < FG_FOV_MIN ) { fov = FG_FOV_MIN; }
 345     if ( fov > FG_FOV_MAX ) { fov = FG_FOV_MAX; }
 346
 347     // printf("parse_fov(): result = %.4f\n", fov);
 348
 349     return(fov);
 350 }
 351
 352
 353 // Parse serial port option --serial=/dev/ttyS1,nmea,4800,out
 354 //
 355 // Format is "--serial=device,format,baud,direction" where
 356 //
 357 //  device = OS device name to be open()'ed
 358 //  format = {nmea, fgfs}
 359 //  baud = {300, 1200, 2400, ..., 230400}
 360 //  direction = {in, out, bi}
 361
 362 bool
 363 fgOPTIONS::parse_serial( const string& serial_str ) {
 364     string::size_type pos;
 365
 366     // cout << "Serial string = " << serial_str << endl;
 367
 368     // a flailing attempt to see if the port config string has a
 369     // chance at being valid
 370     pos = serial_str.find(",");
 371     if ( pos == string::npos ) {
 372         FG_LOG( FG_GENERAL, FG_ALERT,
 373                 "Malformed serial port configure string" );
 374         return false;
 375     }
 376
 377     port_options_list.push_back( serial_str );
 378
 379     return true;
 380 }
 381
 382
 383 // Parse a single option
 384 int fgOPTIONS::parse_option( const string& arg ) {
 385     // General Options
 386     if ( (arg == "--help") || (arg == "-h") ) {
 387         // help/usage request
 388         return(FG_OPTIONS_HELP);
 389     } else if ( arg == "--disable-game-mode") {
 390         game_mode = false;
 391     } else if ( arg == "--enable-game-mode" ) {
 392         game_mode = true;
 393     } else if ( arg == "--disable-splash-screen" ) {
 394         splash_screen = false;
 395     } else if ( arg == "--enable-splash-screen" ) {
 396         splash_screen = true;
 397     } else if ( arg == "--disable-intro-music" ) {
 398         intro_music = false;
 399     } else if ( arg == "--enable-intro-music" ) {
 400         intro_music = true;
 401     } else if ( arg == "--disable-mouse-pointer" ) {
 402         mouse_pointer = 1;
 403     } else if ( arg == "--enable-mouse-pointer" ) {
 404         mouse_pointer = 2;
 405     } else if ( arg == "--disable-pause" ) {
 406         pause = false;
 407     } else if ( arg == "--enable-pause" ) {
 408         pause = true;
 409     } else if ( arg == "--disable-hud" ) {
 410         hud_status = false;
 411     } else if ( arg == "--enable-hud" ) {
 412         hud_status = true;
 413     } else if ( arg == "--disable-panel" ) {
 414         panel_status = false;
 415     } else if ( arg == "--enable-panel" ) {
 416         panel_status = true;
 417     } else if ( arg == "--disable-sound" ) {
 418         sound = false;
 419     } else if ( arg == "--enable-sound" ) {
 420         sound = true;
 421     } else if ( arg.find( "--airport-id=") != string::npos ) {
 422         airport_id = arg.substr( 13 );
 423     } else if ( arg.find( "--lon=" ) != string::npos ) {
 424         lon = parse_degree( arg.substr(6) );
 425     } else if ( arg.find( "--lat=" ) != string::npos ) {
 426         lat = parse_degree( arg.substr(6) );
 427     } else if ( arg.find( "--altitude=" ) != string::npos ) {
 428         if ( units == FG_UNITS_FEET ) {
 429             altitude = atof( arg.substr(11) ) * FEET_TO_METER;
 430         } else {
 431             altitude = atof( arg.substr(11) );
 432         }
 433     } else if ( arg.find( "--heading=" ) != string::npos ) {
 434         heading = atof( arg.substr(10) );
 435     } else if ( arg.find( "--roll=" ) != string::npos ) {
 436         roll = atof( arg.substr(7) );
 437     } else if ( arg.find( "--pitch=" ) != string::npos ) {
 438         pitch = atof( arg.substr(8) );
 439     } else if ( arg.find( "--fg-root=" ) != string::npos ) {
 440         fg_root = arg.substr( 10 );
 441     } else if ( arg.find( "--fdm=" ) != string::npos ) {
 442         flight_model = parse_fdm( arg.substr(6) );
 443     } else if ( arg == "--fog-disable" ) {
 444         fog = FG_FOG_DISABLED;
 445     } else if ( arg == "--fog-fastest" ) {
 446         fog = FG_FOG_FASTEST;
 447     } else if ( arg == "--fog-nicest" ) {
 448         fog = FG_FOG_NICEST;
 449     } else if ( arg.find( "--fov=" ) != string::npos ) {
 450         fov = parse_fov( arg.substr(6) );
 451     } else if ( arg == "--disable-fullscreen" ) {
 452         fullscreen = false;
 453     } else if ( arg== "--enable-fullscreen") {
 454         fullscreen = true;
 455     } else if ( arg == "--shading-flat") {
 456         shading = 0;
 457     } else if ( arg == "--shading-smooth") {
 458         shading = 1;
 459     } else if ( arg == "--disable-skyblend") {
 460         skyblend = false;
 461     } else if ( arg== "--enable-skyblend" ) {
 462         skyblend = true;
 463     } else if ( arg == "--disable-textures" ) {
 464         textures = false;
 465     } else if ( arg == "--enable-textures" ) {
 466         textures = true;
 467     } else if ( arg == "--disable-wireframe" ) {
 468         wireframe = false;
 469     } else if ( arg == "--enable-wireframe" ) {
 470         wireframe = true;
 471     } else if ( arg.find( "--geometry=" ) != string::npos ) {
 472         string geometry = arg.substr( 11 );
 473         if ( geometry == "640x480" ) {
 474             xsize = 640;
 475             ysize = 480;
 476         } else if ( geometry == "800x600" ) {
 477             xsize = 800;
 478             ysize = 600;
 479         } else if ( geometry == "1024x768" ) {
 480             xsize = 1024;
 481             ysize = 768;
 482         } else {
 483             FG_LOG( FG_GENERAL, FG_ALERT, "Unknown geometry: " << geometry );
 484             exit(-1);
 485         }
 486     } else if ( arg == "--units-feet" ) {
 487         units = FG_UNITS_FEET;
 488     } else if ( arg == "--units-meters" ) {
 489         units = FG_UNITS_METERS;
 490     } else if ( arg.find( "--tile-radius=" ) != string::npos ) {
 491         tile_radius = parse_tile_radius( arg.substr(14) );
 492         tile_diameter = tile_radius * 2 + 1;
 493     } else if ( arg.find( "--time-offset=" ) != string::npos ) {
 494         time_offset = parse_time_offset( (arg.substr(14)) );
 495     } else if ( arg == "--hud-tris" ) {
 496         tris_or_culled = 0;
 497     } else if ( arg == "--hud-culled" ) {
 498         tris_or_culled = 1;
 499     } else if ( arg.find( "--serial=" ) != string::npos ) {
 500         parse_serial( arg.substr(9) );
 501     } else {
 502         FG_LOG( FG_GENERAL, FG_ALERT, "Unknown option '" << arg << "'" );
 503         return FG_OPTIONS_ERROR;
 504     }
 505
 506     return FG_OPTIONS_OK;
 507 }
 508
 509
 510 // Parse the command line options
 511 int fgOPTIONS::parse_command_line( int argc, char **argv ) {
 512     int i = 1;
 513     int result;
 514
 515     FG_LOG(FG_GENERAL, FG_INFO, "Processing command line arguments");
 516
 517     while ( i < argc ) {
 518         FG_LOG( FG_GENERAL, FG_DEBUG, "argv[" << i << "] = " << argv[i] );
 519
 520         result = parse_option(argv[i]);
 521         if ( (result == FG_OPTIONS_HELP) || (result == FG_OPTIONS_ERROR) ) {
 522             return(result);
 523         }
 524
 525         i++;
 526     }
 527
 528     return(FG_OPTIONS_OK);
 529 }
 530
 531
 532 // Parse config file options
 533 int fgOPTIONS::parse_config_file( const string& path ) {
 534     fg_gzifstream in( path );
 535     if ( !in )
 536         return(FG_OPTIONS_ERROR);
 537
 538     FG_LOG( FG_GENERAL, FG_INFO, "Processing config file: " << path );
 539
 540     in >> skipcomment;
 541     while ( !in.eof() )
 542     {
 543         string line;
 544         getline( in, line );
 545
 546         if ( parse_option( line ) == FG_OPTIONS_ERROR ) {
 547             FG_LOG( FG_GENERAL, FG_ALERT,
 548                     "Config file parse error: " << path << " '"
 549                     << line << "'" );
 550             exit(-1);
 551         }
 552         in >> skipcomment;
 553     }
 554
 555     return FG_OPTIONS_OK;
 556 }
 557
 558
 559 // Print usage message
 560 void fgOPTIONS::usage ( void ) {
 561     printf("Usage: fg [ options ... ]\n");
 562     printf("\n");
 563
 564     printf("General Options:\n");
 565     printf("\t--help -h:  print usage\n");
 566     printf("\t--fg-root=path:  specify the root path for all the data files\n");
 567     printf("\t--disable-game-mode:  disable full-screen game mode\n");
 568     printf("\t--enable-game-mode:  enable full-screen game mode\n");
 569     printf("\t--disable-splash-screen:  disable splash screen\n");
 570     printf("\t--enable-splash-screen:  enable splash screen\n");
 571     printf("\t--disable-intro-music:  disable introduction music\n");
 572     printf("\t--enable-intro-music:  enable introduction music\n");
 573     printf("\t--disable-mouse-pointer:  disable extra mouse pointer\n");
 574     printf("\t--enable-mouse-pointer:  enable extra mouse pointer (i.e. for\n");
 575     printf("\t\tfull screen voodoo/voodoo-II based cards.)\n");
 576     printf("\t--disable-pause:  start out in an active state\n");
 577     printf("\t--enable-pause:  start out in a paused state\n");
 578     printf("\n");
 579
 580     printf("Features:\n");
 581     printf("\t--disable-hud:  disable heads up display\n");
 582     printf("\t--enable-hud:  enable heads up display\n");
 583     printf("\t--disable-panel:  disable instrument panel\n");
 584     printf("\t--enable-panel:  enable instrumetn panel\n");
 585     printf("\t--disable-sound:  disable sound effects\n");
 586     printf("\t--enable-sound:  enable sound effects\n");
 587     printf("\n");
 588
 589     printf("Flight Model:\n");
 590     printf("\t--fdm=abcd:  one of slew, jsb, larcsim, or external\n");
 591     printf("\n");
 592
 593     printf("Initial Position and Orientation:\n");
 594     printf("\t--airport-id=ABCD:  specify starting postion by airport id\n");
 595     printf("\t--lon=degrees:  starting longitude in degrees (west = -)\n");
 596     printf("\t--lat=degrees:  starting latitude in degrees (south = -)\n");
 597     printf("\t--altitude=feet:  starting altitude in feet\n");
 598     printf("\t\t(unless --units-meters specified\n");
 599     printf("\t--heading=degrees:  heading (yaw) angle in degress (Psi)\n");
 600     printf("\t--roll=degrees:  roll angle in degrees (Phi)\n");
 601     printf("\t--pitch=degrees:  pitch angle in degrees (Theta)\n");
 602     printf("\n");
 603
 604     printf("Rendering Options:\n");
 605     printf("\t--fog-disable:  disable fog/haze\n");
 606     printf("\t--fog-fastest:  enable fastest fog/haze\n");
 607     printf("\t--fog-nicest:  enable nicest fog/haze\n");
 608     printf("\t--fov=xx.x:  specify initial field of view angle in degrees\n");
 609     printf("\t--disable-fullscreen:  disable fullscreen mode\n");
 610     printf("\t--enable-fullscreen:  enable fullscreen mode\n");
 611     printf("\t--shading-flat:  enable flat shading\n");
 612     printf("\t--shading-smooth:  enable smooth shading\n");
 613     printf("\t--disable-skyblend:  disable sky blending\n");
 614     printf("\t--enable-skyblend:  enable sky blending\n");
 615     printf("\t--disable-textures:  disable textures\n");
 616     printf("\t--enable-textures:  enable textures\n");
 617     printf("\t--disable-wireframe:  disable wireframe drawing mode\n");
 618     printf("\t--enable-wireframe:  enable wireframe drawing mode\n");
 619     printf("\t--geometry=WWWxHHH:  window geometry: 640x480, 800x600, etc.\n");
 620     printf("\n");
 621
 622     printf("Scenery Options:\n");
 623     printf("\t--tile-radius=n:  specify tile radius, must be 1 - 4\n");
 624     printf("\n");
 625
 626     printf("Hud Options:\n");
 627     printf("\t--units-feet:  Hud displays units in feet\n");
 628     printf("\t--units-meters:  Hud displays units in meters\n");
 629     printf("\t--hud-tris:  Hud displays number of triangles rendered\n");
 630     printf("\t--hud-culled:  Hud displays percentage of triangles culled\n");
 631     printf("\n");
 632
 633     printf("Time Options:\n");
 634     printf("\t--time-offset=[+-]hh:mm:ss:  offset local time by this amount\n");
 635 }
 636
 637
 638 // Destructor
 639 fgOPTIONS::~fgOPTIONS( void ) {
 640 }
 641
 642
 643 // $Log$
 644 // Revision 1.42  1999/03/11 23:09:50  curt
 645 // When "Help" is selected from the menu check to see if netscape is running.
 646 // If so, command it to go to the flight gear user guide url.  Otherwise
 647 // start a new version of netscape with this url.
 648 //
 649 // Revision 1.41  1999/03/02 01:03:17  curt
 650 // Tweaks for building with native SGI compilers.
 651 //
 652 // Revision 1.40  1999/02/26 22:09:51  curt
 653 // Added initial support for native SGI compilers.
 654 //
 655 // Revision 1.39  1999/02/05 21:29:12  curt
 656 // Modifications to incorporate Jon S. Berndts flight model code.
 657 //
 658 // Revision 1.38  1999/02/01 21:33:35  curt
 659 // Renamed FlightGear/Simulator/Flight to FlightGear/Simulator/FDM since
 660 // Jon accepted my offer to do this and thought it was a good idea.
 661 //
 662 // Revision 1.37  1999/01/19 20:57:05  curt
 663 // MacOS portability changes contributed by "Robert Puyol" <puyol@abvent.fr>
 664 //
 665 // Revision 1.36  1999/01/07 20:25:10  curt
 666 // Updated struct fgGENERAL to class FGGeneral.
 667 //
 668 // Revision 1.35  1998/12/06 14:52:57  curt
 669 // Fixed a problem with the initial starting altitude.  "v->abs_view_pos" wasn't
 670 // being calculated correctly at the beginning causing the first terrain
 671 // intersection to fail, returning a ground altitude of zero, causing the plane
 672 // to free fall for one frame, until the ground altitude was corrected, but now
 673 // being under the ground we got a big bounce and the plane always ended up
 674 // upside down.
 675 //
 676 // Revision 1.34  1998/12/05 15:54:22  curt
 677 // Renamed class fgFLIGHT to class FGState as per request by JSB.
 678 //
 679 // Revision 1.33  1998/12/04 01:30:44  curt
 680 // Added support for the External flight model.
 681 //
 682 // Revision 1.32  1998/11/25 01:34:00  curt
 683 // Support for an arbitrary number of serial ports.
 684 //
 685 // Revision 1.31  1998/11/23 21:49:04  curt
 686 // Borland portability tweaks.
 687 //
 688 // Revision 1.30  1998/11/16 14:00:02  curt
 689 // Added pow() macro bug work around.
 690 // Added support for starting FGFS at various resolutions.
 691 // Added some initial serial port support.
 692 // Specify default log levels in main().
 693 //
 694 // Revision 1.29  1998/11/06 21:18:12  curt
 695 // Converted to new logstream debugging facility.  This allows release
 696 // builds with no messages at all (and no performance impact) by using
 697 // the -DFG_NDEBUG flag.
 698 //
 699 // Revision 1.28  1998/11/06 14:47:03  curt
 700 // Changes to track Bernie's updates to fgstream.
 701 //
 702 // Revision 1.27  1998/11/02 23:04:04  curt
 703 // HUD units now display in feet by default with meters being a command line
 704 // option.
 705 //
 706 // Revision 1.26  1998/10/17 01:34:24  curt
 707 // C++ ifying ...
 708 //
 709 // Revision 1.25  1998/09/15 02:09:27  curt
 710 // Include/fg_callback.hxx
 711 //   Moved code inline to stop g++ 2.7 from complaining.
 712 //
 713 // Simulator/Time/event.[ch]xx
 714 //   Changed return type of fgEVENT::printStat().  void caused g++ 2.7 to
 715 //   complain bitterly.
 716 //
 717 // Minor bugfix and changes.
 718 //
 719 // Simulator/Main/GLUTmain.cxx
 720 //   Added missing type to idle_state definition - eliminates a warning.
 721 //
 722 // Simulator/Main/fg_init.cxx
 723 //   Changes to airport lookup.
 724 //
 725 // Simulator/Main/options.cxx
 726 //   Uses fg_gzifstream when loading config file.
 727 //
 728 // Revision 1.24  1998/09/08 15:04:33  curt
 729 // Optimizations by Norman Vine.
 730 //
 731 // Revision 1.23  1998/08/27 17:02:07  curt
 732 // Contributions from Bernie Bright <bbright@c031.aone.net.au>
 733 // - use strings for fg_root and airport_id and added methods to return
 734 //   them as strings,
 735 // - inlined all access methods,
 736 // - made the parsing functions private methods,
 737 // - deleted some unused functions.
 738 // - propogated some of these changes out a bit further.
 739 //
 740 // Revision 1.22  1998/08/24 20:11:13  curt
 741 // Added i/I to toggle full vs. minimal HUD.
 742 // Added a --hud-tris vs --hud-culled option.
 743 // Moved options accessor funtions to options.hxx.
 744 //
 745 // Revision 1.21  1998/08/20 15:10:34  curt
 746 // Added GameGLUT support.
 747 //
 748 // Revision 1.20  1998/07/30 23:48:28  curt
 749 // Output position & orientation when pausing.
 750 // Eliminated libtool use.
 751 // Added options to specify initial position and orientation.
 752 // Changed default fov to 55 degrees.
 753 // Added command line option to start in paused or unpaused state.
 754 //
 755 // Revision 1.19  1998/07/27 18:41:25  curt
 756 // Added a pause command "p"
 757 // Fixed some initialization order problems between pui and glut.
 758 // Added an --enable/disable-sound option.
 759 //
 760 // Revision 1.18  1998/07/22 01:27:03  curt
 761 // Strip out \r when parsing config file in case we are on a windoze system.
 762 //
 763 // Revision 1.17  1998/07/16 17:33:38  curt
 764 // "H" / "h" now control hud brightness as well with off being one of the
 765 //   states.
 766 // Better checking for xmesa/fx 3dfx fullscreen/window support for deciding
 767 //   whether or not to build in the feature.
 768 // Translucent menu support.
 769 // HAVE_AUDIO_SUPPORT -> ENABLE_AUDIO_SUPPORT
 770 // Use fork() / wait() for playing mp3 init music in background under unix.
 771 // Changed default tile diameter to 5.
 772 //
 773 // Revision 1.16  1998/07/13 21:01:39  curt
 774 // Wrote access functions for current fgOPTIONS.
 775 //
 776 // Revision 1.15  1998/07/06 21:34:19  curt
 777 // Added an enable/disable splash screen option.
 778 // Added an enable/disable intro music option.
 779 // Added an enable/disable instrument panel option.
 780 // Added an enable/disable mouse pointer option.
 781 // Added using namespace std for compilers that support this.
 782 //
 783 // Revision 1.14  1998/07/04 00:52:26  curt
 784 // Add my own version of gluLookAt() (which is nearly identical to the
 785 // Mesa/glu version.)  But, by calculating the Model View matrix our selves
 786 // we can save this matrix without having to read it back in from the video
 787 // card.  This hopefully allows us to save a few cpu cycles when rendering
 788 // out the fragments because we can just use glLoadMatrixd() with the
 789 // precalculated matrix for each tile rather than doing a push(), translate(),
 790 // pop() for every fragment.
 791 //
 792 // Panel status defaults to off for now until it gets a bit more developed.
 793 //
 794 // Extract OpenGL driver info on initialization.
 795 //
 796 // Revision 1.13  1998/06/27 16:54:34  curt
 797 // Replaced "extern displayInstruments" with a entry in fgOPTIONS.
 798 // Don't change the view port when displaying the panel.
 799 //
 800 // Revision 1.12  1998/06/17 21:35:13  curt
 801 // Refined conditional audio support compilation.
 802 // Moved texture parameter setup calls to ../Scenery/materials.cxx
 803 // #include <string.h> before various STL includes.
 804 // Make HUD default state be enabled.
 805 //
 806 // Revision 1.11  1998/06/13 00:40:33  curt
 807 // Tweaked fog command line options.
 808 //
 809 // Revision 1.10  1998/05/16 13:08:36  curt
 810 // C++ - ified views.[ch]xx
 811 // Shuffled some additional view parameters into the fgVIEW class.
 812 // Changed tile-radius to tile-diameter because it is a much better
 813 //   name.
 814 // Added a WORLD_TO_EYE transformation to views.cxx.  This allows us
 815 //  to transform world space to eye space for view frustum culling.
 816 //
 817 // Revision 1.9  1998/05/13 18:29:59  curt
 818 // Added a keyboard binding to dynamically adjust field of view.
 819 // Added a command line option to specify fov.
 820 // Adjusted terrain color.
 821 // Root path info moved to fgOPTIONS.
 822 // Added ability to parse options out of a config file.
 823 //
 824 // Revision 1.8  1998/05/07 23:14:16  curt
 825 // Added "D" key binding to set autopilot heading.
 826 // Made frame rate calculation average out over last 10 frames.
 827 // Borland C++ floating point exception workaround.
 828 // Added a --tile-radius=n option.
 829 //
 830 // Revision 1.7  1998/05/06 03:16:25  curt
 831 // Added an averaged global frame rate counter.
 832 // Added an option to control tile radius.
 833 //
 834 // Revision 1.6  1998/05/03 00:47:32  curt
 835 // Added an option to enable/disable full-screen mode.
 836 //
 837 // Revision 1.5  1998/04/30 12:34:19  curt
 838 // Added command line rendering options:
 839 //   enable/disable fog/haze
 840 //   specify smooth/flat shading
 841 //   disable sky blending and just use a solid color
 842 //   enable wireframe drawing mode
 843 //
 844 // Revision 1.4  1998/04/28 01:20:22  curt
 845 // Type-ified fgTIME and fgVIEW.
 846 // Added a command line option to disable textures.
 847 //
 848 // Revision 1.3  1998/04/26 05:01:19  curt
 849 // Added an rint() / HAVE_RINT check.
 850 //
 851 // Revision 1.2  1998/04/25 15:11:12  curt
 852 // Added an command line option to set starting position based on airport ID.
 853 //
 854 // Revision 1.1  1998/04/24 00:49:21  curt
 855 // Wrapped "#include <config.h>" in "#ifdef HAVE_CONFIG_H"
 856 // Trying out some different option parsing code.
 857 // Some code reorganization.
 858 //
 859 //