Main/GLUTmain.c

   1 /**************************************************************************
   2  * GLUTmain.c -- top level sim routines
   3  *
   4  * Written by Curtis Olson for OpenGL, started May 1997.
   5  *
   6  * Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.com
   7  *
   8  * This program is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License as
  10  * published by the Free Software Foundation; either version 2 of the
  11  * License, or (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21  *
  22  * $Id$
  23  * (Log is kept at end of this file)
  24  **************************************************************************/
  25
  26
  27 #ifdef WIN32
  28 #  include <windows.h>
  29 #endif
  30
  31 #include <GL/glut.h>
  32 #include <stdio.h>
  33
  34 #include "GLUTkey.h"
  35 #include "fg_init.h"
  36 #include "views.h"
  37
  38 #include "../constants.h"
  39 #include "../general.h"
  40
  41 #include "../Aircraft/aircraft.h"
  42 #include "../Cockpit/cockpit.h"
  43 #include "../Joystick/joystick.h"
  44 #include "../Math/fg_geodesy.h"
  45 #include "../Math/mat3.h"
  46 #include "../Math/polar.h"
  47 #include "../Scenery/mesh.h"
  48 #include "../Scenery/scenery.h"
  49 #include "../Time/fg_time.h"
  50 #include "../Time/fg_timer.h"
  51 #include "../Time/sunpos.h"
  52 #include "../Weather/weather.h"
  53
  54
  55 /* This is a record containing all the info for the aircraft currently
  56    being operated */
  57 struct AIRCRAFT current_aircraft;
  58
  59 /* This is a record containing global housekeeping information */
  60 struct GENERAL general;
  61
  62 /* This is a record containing current weather info */
  63 struct WEATHER current_weather;
  64
  65 /* This is a record containing current view parameters */
  66 struct VIEW current_view;
  67
  68 /* view parameters */
  69 static GLfloat win_ratio = 1.0;
  70
  71 /* sun direction */
  72 /* static GLfloat sun_vec[4] = {1.0, 0.0, 0.0, 0.0 }; */
  73
  74 /* if the 4th field is 0.0, this specifies a direction ... */
  75 /* clear color (sky) */
  76 static GLfloat fgClearColor[4] = {0.60, 0.60, 0.90, 1.0};
  77 /* fog color */
  78 static GLfloat fgFogColor[4] =   {0.65, 0.65, 0.85, 1.0};
  79
  80 /* temporary hack */
  81 /* extern struct mesh *mesh_ptr; */
  82 /* Function prototypes */
  83 /* GLint fgSceneryCompile_OLD(); */
  84 /* static void fgSceneryDraw_OLD(); */
  85
  86 /* pointer to scenery structure */
  87 /* static GLint scenery, runway; */
  88
  89 double Simtime;
  90
  91 /* Another hack */
  92 int use_signals = 0;
  93
  94 /* Yet another hack. This one used by the HUD code. Michele */
  95 int show_hud;
  96
  97
  98 /**************************************************************************
  99  * fgInitVisuals() -- Initialize various GL/view parameters
 100  **************************************************************************/
 101
 102 static void fgInitVisuals() {
 103     struct fgTIME *t;
 104     struct WEATHER *w;
 105
 106     t = &cur_time_params;
 107     w = &current_weather;
 108
 109     glEnable( GL_DEPTH_TEST );
 110     /* glFrontFace(GL_CW); */
 111     glEnable( GL_CULL_FACE );
 112
 113     /* If enabled, normal vectors specified with glNormal are scaled
 114        to unit length after transformation.  See glNormal. */
 115     glEnable( GL_NORMALIZE );
 116
 117     glLightfv( GL_LIGHT0, GL_POSITION, t->sun_vec );
 118     glEnable( GL_LIGHTING );
 119     glEnable( GL_LIGHT0 );
 120
 121     glShadeModel( GL_FLAT ); /* glShadeModel( GL_SMOOTH ); */
 122
 123     glEnable( GL_FOG );
 124     glFogi (GL_FOG_MODE, GL_LINEAR);
 125     /* glFogf (GL_FOG_START, 1.0); */
 126     glFogf (GL_FOG_END, w->visibility);
 127     glFogfv (GL_FOG_COLOR, fgFogColor);
 128     /* glFogf (GL_FOG_DENSITY, w->visibility); */
 129     /* glHint (GL_FOG_HINT, GL_FASTEST); */
 130
 131     glClearColor(fgClearColor[0], fgClearColor[1], fgClearColor[2],
 132                  fgClearColor[3]);
 133 }
 134
 135
 136 /**************************************************************************
 137  * Update the view volume, position, and orientation
 138  **************************************************************************/
 139
 140 static void fgUpdateViewParams() {
 141     struct FLIGHT *f;
 142     struct fgTIME *t;
 143     struct VIEW *v;
 144     double ambient, diffuse, sky;
 145     GLfloat color[4] = { 1.0, 1.0, 0.50, 1.0 };
 146     GLfloat amb[3], diff[3], fog[4], clear[4];
 147
 148     f = &current_aircraft.flight;
 149     t = &cur_time_params;
 150     v = &current_view;
 151
 152     fgViewUpdate(f, v);
 153
 154     /* Tell GL we are about to modify the projection parameters */
 155     glMatrixMode(GL_PROJECTION);
 156     glLoadIdentity();
 157     gluPerspective(60.0, 1.0/win_ratio, 1.0, 200000.0);
 158
 159     glMatrixMode(GL_MODELVIEW);
 160     glLoadIdentity();
 161
 162     /* set up our view volume */
 163     gluLookAt(v->view_pos.x, v->view_pos.y, v->view_pos.z,
 164               v->view_pos.x + v->view_forward[0],
 165               v->view_pos.y + v->view_forward[1],
 166               v->view_pos.z + v->view_forward[2],
 167               v->view_up[0], v->view_up[1], v->view_up[2]);
 168
 169     /* set the sun position */
 170     glLightfv( GL_LIGHT0, GL_POSITION, t->sun_vec );
 171
 172     /* calculate lighting parameters based on sun's relative angle to
 173      * local up */
 174     /* ya kind'a have to plot this to see the magic */
 175     ambient = 0.4 *
 176         pow(2.4, -t->sun_angle*t->sun_angle*t->sun_angle*t->sun_angle / 3.0);
 177     diffuse = 0.4 * cos(0.6 * t->sun_angle * t->sun_angle);
 178     sky = 0.85 *
 179         pow(1.6, -t->sun_angle*t->sun_angle*t->sun_angle*t->sun_angle/2.0)
 180         + 0.15;
 181
 182     if ( ambient < 0.1 ) { ambient = 0.1; }
 183     if ( diffuse < 0.0 ) { diffuse = 0.0; }
 184
 185     if ( sky < 0.0 ) { sky = 0.0; }
 186
 187     amb[0] = color[0] * ambient;
 188     amb[1] = color[1] * ambient;
 189     amb[2] = color[2] * ambient;
 190
 191     diff[0] = color[0] * diffuse;
 192     diff[1] = color[1] * diffuse;
 193     diff[2] = color[2] * diffuse;
 194
 195     /* set lighting parameters */
 196     glLightfv(GL_LIGHT0, GL_AMBIENT, amb );
 197     glLightfv(GL_LIGHT0, GL_DIFFUSE, diff );
 198
 199     /* set fog color */
 200     fog[0] = fgFogColor[0] * (ambient + diffuse);
 201     fog[1] = fgFogColor[1] * (ambient + diffuse);
 202     fog[2] = fgFogColor[2] * (ambient + diffuse);
 203     fog[3] = fgFogColor[3];
 204     glFogfv (GL_FOG_COLOR, fog);
 205
 206     /* set sky color */
 207     clear[0] = fgClearColor[0] * sky;
 208     clear[1] = fgClearColor[1] * sky;
 209     clear[2] = fgClearColor[2] * sky;
 210     clear[3] = fgClearColor[3];
 211     glClearColor(clear[0], clear[1], clear[2], clear[3]);
 212 }
 213
 214
 215 /**************************************************************************
 216  * Update all Visuals (redraws anything graphics related)
 217  **************************************************************************/
 218
 219 static void fgUpdateVisuals( void ) {
 220     /* update view volume parameters */
 221     fgUpdateViewParams();
 222
 223     glClear( GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT );
 224
 225     /* Tell GL we are switching to model view parameters */
 226     glMatrixMode(GL_MODELVIEW);
 227     /* glLoadIdentity(); */
 228
 229     /* draw scenery */
 230     fgSceneryRender();
 231
 232     /* display HUD */
 233     if( show_hud )
 234         fgCockpitUpdate();
 235
 236     #ifdef GLUT
 237       glutSwapBuffers();
 238     #endif
 239 }
 240
 241
 242 /**************************************************************************
 243  * Update internal time dependent calculations (i.e. flight model)
 244  **************************************************************************/
 245
 246 void fgUpdateTimeDepCalcs(int multi_loop) {
 247     struct FLIGHT *f;
 248     struct fgTIME *t;
 249     struct VIEW *v;
 250     int i;
 251
 252     f = &current_aircraft.flight;
 253     t = &cur_time_params;
 254     v = &current_view;
 255
 256     /* update the flight model */
 257     if ( multi_loop < 0 ) {
 258         multi_loop = DEFAULT_MULTILOOP;
 259     }
 260
 261     /* printf("updating flight model x %d\n", multi_loop); */
 262     fgFlightModelUpdate(FG_LARCSIM, f, multi_loop);
 263
 264     /* refresh shared sun position and sun_vec */
 265     fgUpdateSunPos(scenery.center);
 266
 267     /* update the view angle */
 268     for ( i = 0; i < multi_loop; i++ ) {
 269         if ( fabs(v->goal_view_offset - v->view_offset) < 0.05 ) {
 270             v->view_offset = v->goal_view_offset;
 271             break;
 272         } else {
 273             /* move v->view_offset towards v->goal_view_offset */
 274             if ( v->goal_view_offset > v->view_offset ) {
 275                 if ( v->goal_view_offset - v->view_offset < FG_PI ) {
 276                     v->view_offset += 0.01;
 277                 } else {
 278                     v->view_offset -= 0.01;
 279                 }
 280             } else {
 281                 if ( v->view_offset - v->goal_view_offset < FG_PI ) {
 282                     v->view_offset -= 0.01;
 283                 } else {
 284                     v->view_offset += 0.01;
 285                 }
 286             }
 287             if ( v->view_offset > FG_2PI ) {
 288                 v->view_offset -= FG_2PI;
 289             } else if ( v->view_offset < 0 ) {
 290                 v->view_offset += FG_2PI;
 291             }
 292         }
 293     }
 294 }
 295
 296
 297 void fgInitTimeDepCalcs() {
 298     /* initialize timer */
 299
 300 #ifdef USE_ITIMER
 301     fgTimerInit( 1.0 / DEFAULT_TIMER_HZ, fgUpdateTimeDepCalcs );
 302 #endif USE_ITIMER
 303
 304 }
 305
 306
 307 /**************************************************************************
 308  * Scenery management routines
 309  **************************************************************************/
 310
 311 /* static void fgSceneryInit_OLD() { */
 312     /* make scenery */
 313 /*     scenery = fgSceneryCompile_OLD();
 314     runway = fgRunwayHack_OLD(0.69, 53.07);
 315 } */
 316
 317
 318 /* create the scenery */
 319 /* GLint fgSceneryCompile_OLD() {
 320     GLint scenery;
 321
 322     scenery = mesh2GL(mesh_ptr_OLD);
 323
 324     return(scenery);
 325 }
 326 */
 327
 328 /* hack in a runway */
 329 /* GLint fgRunwayHack_OLD(double width, double length) {
 330     static GLfloat concrete[4] = { 0.5, 0.5, 0.5, 1.0 };
 331     static GLfloat line[4]     = { 0.9, 0.9, 0.9, 1.0 };
 332     int i;
 333     int num_lines = 16;
 334     float line_len, line_width_2, cur_pos;
 335
 336     runway = glGenLists(1);
 337     glNewList(runway, GL_COMPILE);
 338     */
 339     /* draw concrete */
 340 /*    glBegin(GL_POLYGON);
 341     glMaterialfv( GL_FRONT, GL_AMBIENT_AND_DIFFUSE, concrete );
 342     glNormal3f(0.0, 0.0, 1.0);
 343
 344     glVertex3d( 0.0,   -width/2.0, 0.0);
 345     glVertex3d( 0.0,    width/2.0, 0.0);
 346     glVertex3d(length,  width/2.0, 0.0);
 347     glVertex3d(length, -width/2.0, 0.0);
 348     glEnd();
 349     */
 350     /* draw center line */
 351 /*    glMaterialfv( GL_FRONT, GL_AMBIENT_AND_DIFFUSE, line );
 352     line_len = length / ( 2 * num_lines + 1);
 353     printf("line_len = %.3f\n", line_len);
 354     line_width_2 = 0.02;
 355     cur_pos = line_len;
 356     for ( i = 0; i < num_lines; i++ ) {
 357         glBegin(GL_POLYGON);
 358         glVertex3d( cur_pos, -line_width_2, 0.005);
 359         glVertex3d( cur_pos,  line_width_2, 0.005);
 360         cur_pos += line_len;
 361         glVertex3d( cur_pos,  line_width_2, 0.005);
 362         glVertex3d( cur_pos, -line_width_2, 0.005);
 363         cur_pos += line_len;
 364         glEnd();
 365     }
 366
 367     glEndList();
 368
 369     return(runway);
 370 }
 371 */
 372
 373 /* draw the scenery */
 374 /*static void fgSceneryDraw_OLD() {
 375     static float z = 32.35;
 376
 377     glPushMatrix();
 378
 379     glCallList(scenery);
 380
 381     printf("*** Drawing runway at %.2f\n", z);
 382
 383     glTranslatef( -398391.28, 120070.41, 32.35);
 384     glRotatef(170.0, 0.0, 0.0, 1.0);
 385     glCallList(runway);
 386
 387     glPopMatrix();
 388 }
 389 */
 390
 391 /* What should we do when we have nothing else to do?  How about get
 392  * ready for the next move and update the display? */
 393 static void fgMainLoop( void ) {
 394     static int remainder = 0;
 395     int elapsed, multi_loop;
 396     double cur_elev;
 397     double joy_x, joy_y;
 398     int joy_b1, joy_b2;
 399     struct AIRCRAFT *a;
 400     struct FLIGHT *f;
 401     struct fgTIME *t;
 402
 403     a = &current_aircraft;
 404     f = &a->flight;
 405     t = &cur_time_params;
 406
 407     /* update "time" */
 408     fgTimeUpdate(f, t);
 409
 410     /* Read joystick */
 411     /* fgJoystickRead( &joy_x, &joy_y, &joy_b1, &joy_b2 );
 412     printf( "Joystick X %f  Y %f  B1 %d  B2 %d\n",
 413             joy_x, joy_y, joy_b1, joy_b2 );
 414     fgElevSet( -joy_y );
 415     fgAileronSet( joy_x ); */
 416
 417     /* update the weather for our current position */
 418     fgWeatherUpdate(FG_Longitude * RAD_TO_ARCSEC,
 419                     FG_Latitude * RAD_TO_ARCSEC,
 420                     FG_Altitude * FEET_TO_METER);
 421
 422     /* Calculate model iterations needed */
 423     elapsed = fgGetTimeInterval();
 424     printf("Time interval is = %d, previous remainder is = %d\n", elapsed,
 425            remainder);
 426     printf("--> Frame rate is = %.2f\n", 1000.0 / (float)elapsed);
 427     elapsed += remainder;
 428
 429     multi_loop = ((float)elapsed * 0.001) * DEFAULT_MODEL_HZ;
 430     remainder = elapsed - ((multi_loop*1000) / DEFAULT_MODEL_HZ);
 431     printf("Model iterations needed = %d, new remainder = %d\n", multi_loop,
 432            remainder);
 433
 434     if ( ! use_signals ) {
 435         /* flight model */
 436         fgUpdateTimeDepCalcs(multi_loop);
 437     }
 438
 439     /* I'm just sticking this here for now, it should probably move
 440      * eventually */
 441     cur_elev = mesh_altitude(FG_Longitude * RAD_TO_ARCSEC,
 442                                FG_Latitude  * RAD_TO_ARCSEC);
 443     printf("Ground elevation is %.2f meters here.\n", cur_elev);
 444     /* FG_Runway_altitude = cur_elev * METER_TO_FEET; */
 445
 446     if ( FG_Altitude * FEET_TO_METER < cur_elev + 3.758099) {
 447         /* set this here, otherwise if we set runway height above our
 448            current height we get a really nasty bounce. */
 449         FG_Runway_altitude = FG_Altitude - 3.758099;
 450
 451         /* now set aircraft altitude above ground */
 452         FG_Altitude = cur_elev * METER_TO_FEET + 3.758099;
 453         printf("<*> resetting altitude to %.0f meters\n",
 454                FG_Altitude * FEET_TO_METER);
 455     }
 456
 457     fgAircraftOutputCurrent(a);
 458
 459     /* redraw display */
 460     fgUpdateVisuals();
 461 }
 462
 463
 464 /**************************************************************************
 465  * Handle new window size or exposure
 466  **************************************************************************/
 467
 468 static void fgReshape( int width, int height ) {
 469     /* Do this so we can call fgReshape(0,0) ourselves without having to know
 470      * what the values of width & height are. */
 471     if ( (height > 0) && (width > 0) ) {
 472         win_ratio = (GLfloat) height / (GLfloat) width;
 473     }
 474
 475     /* Inform gl of our view window size */
 476     glViewport(0, 0, (GLint)width, (GLint)height);
 477
 478     fgUpdateViewParams();
 479
 480     glClear( GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT );
 481 }
 482
 483
 484 /**************************************************************************
 485  * Main ...
 486  **************************************************************************/
 487
 488 int main( int argc, char *argv[] ) {
 489     struct FLIGHT *f;
 490
 491     f = &current_aircraft.flight;
 492
 493     printf("Flight Gear: prototype version %s\n\n", VERSION);
 494
 495     /**********************************************************************
 496      * Initialize the Window/Graphics environment.
 497      **********************************************************************/
 498
 499     #ifdef GLUT
 500       /* initialize GLUT */
 501       glutInit(&argc, argv);
 502
 503       /* Define Display Parameters */
 504       glutInitDisplayMode( GLUT_RGB | GLUT_DEPTH | GLUT_DOUBLE );
 505
 506       /* Define initial window size */
 507       glutInitWindowSize(640, 480);
 508
 509       /* Initialize windows */
 510       glutCreateWindow("Flight Gear");
 511     #endif
 512
 513     /* This is the general house keeping init routine */
 514     fgInitGeneral();
 515
 516     /* This is the top level init routine which calls all the other
 517      * subsystem initialization routines.  If you are adding a
 518      * subsystem to flight gear, its initialization call should
 519      * located in this routine.*/
 520     fgInitSubsystems();
 521
 522     /* setup view parameters, only makes GL calls */
 523     fgInitVisuals();
 524
 525     if ( use_signals ) {
 526         /* init timer routines, signals, etc.  Arrange for an alarm
 527            signal to be generated, etc. */
 528         fgInitTimeDepCalcs();
 529     }
 530
 531    /**********************************************************************
 532      * Initialize the Event Handlers.
 533      **********************************************************************/
 534
 535     #ifdef GLUT
 536       /* call fgReshape() on window resizes */
 537       glutReshapeFunc( fgReshape );
 538
 539       /* call key() on keyboard event */
 540       glutKeyboardFunc( GLUTkey );
 541       glutSpecialFunc( GLUTspecialkey );
 542
 543       /* call fgMainLoop() whenever there is nothing else to do */
 544       glutIdleFunc( fgMainLoop );
 545
 546       /* draw the scene */
 547       glutDisplayFunc( fgUpdateVisuals );
 548
 549       /* pass control off to the GLUT event handler */
 550       glutMainLoop();
 551     #endif
 552
 553     return(0);
 554 }
 555
 556
 557 #ifdef NO_PRINTF
 558   #include <stdarg.h>
 559   int printf (const char *format, ...) {
 560   }
 561 #endif
 562
 563
 564 /* $Log$
 565 /* Revision 1.16  1997/09/13 02:00:06  curt
 566 /* Mostly working on stars and generating sidereal time for accurate star
 567 /* placement.
 568 /*
 569  * Revision 1.15  1997/09/05 14:17:27  curt
 570  * More tweaking with stars.
 571  *
 572  * Revision 1.14  1997/09/05 01:35:53  curt
 573  * Working on getting stars right.
 574  *
 575  * Revision 1.13  1997/09/04 02:17:34  curt
 576  * Shufflin' stuff.
 577  *
 578  * Revision 1.12  1997/08/27 21:32:24  curt
 579  * Restructured view calculation code.  Added stars.
 580  *
 581  * Revision 1.11  1997/08/27 03:30:16  curt
 582  * Changed naming scheme of basic shared structures.
 583  *
 584  * Revision 1.10  1997/08/25 20:27:22  curt
 585  * Merged in initial HUD and Joystick code.
 586  *
 587  * Revision 1.9  1997/08/22 21:34:39  curt
 588  * Doing a bit of reorganizing and house cleaning.
 589  *
 590  * Revision 1.8  1997/08/19 23:55:03  curt
 591  * Worked on better simulating real lighting.
 592  *
 593  * Revision 1.7  1997/08/16 12:22:38  curt
 594  * Working on improving the lighting/shading.
 595  *
 596  * Revision 1.6  1997/08/13 20:24:56  curt
 597  * Changes due to changing sunpos interface.
 598  *
 599  * Revision 1.5  1997/08/06 21:08:32  curt
 600  * Sun position now *really* works (I think) ... I still have sun time warping
 601  * code in place, probably should remove it soon.
 602  *
 603  * Revision 1.4  1997/08/06 15:41:26  curt
 604  * Working on correct sun position.
 605  *
 606  * Revision 1.3  1997/08/06 00:24:22  curt
 607  * Working on correct real time sun lighting.
 608  *
 609  * Revision 1.2  1997/08/04 20:25:15  curt
 610  * Organizational tweaking.
 611  *
 612  * Revision 1.1  1997/08/02 18:45:00  curt
 613  * Renamed GLmain.c GLUTmain.c
 614  *
 615  * Revision 1.43  1997/08/02 16:23:47  curt
 616  * Misc. tweaks.
 617  *
 618  * Revision 1.42  1997/08/01 19:43:33  curt
 619  * Making progress with coordinate system overhaul.
 620  *
 621  * Revision 1.41  1997/07/31 22:52:37  curt
 622  * Working on redoing internal coordinate systems & scenery transformations.
 623  *
 624  * Revision 1.40  1997/07/30 16:12:42  curt
 625  * Moved fg_random routines from Util/ to Math/
 626  *
 627  * Revision 1.39  1997/07/21 14:45:01  curt
 628  * Minor tweaks.
 629  *
 630  * Revision 1.38  1997/07/19 23:04:47  curt
 631  * Added an initial weather section.
 632  *
 633  * Revision 1.37  1997/07/19 22:34:02  curt
 634  * Moved PI definitions to ../constants.h
 635  * Moved random() stuff to ../Utils/ and renamed fg_random()
 636  *
 637  * Revision 1.36  1997/07/18 23:41:25  curt
 638  * Tweaks for building with Cygnus Win32 compiler.
 639  *
 640  * Revision 1.35  1997/07/18 14:28:34  curt
 641  * Hacked in some support for wind/turbulence.
 642  *
 643  * Revision 1.34  1997/07/16 20:04:48  curt
 644  * Minor tweaks to aid Win32 port.
 645  *
 646  * Revision 1.33  1997/07/12 03:50:20  curt
 647  * Added an #include <Windows32/Base.h> to help compiling for Win32
 648  *
 649  * Revision 1.32  1997/07/11 03:23:18  curt
 650  * Solved some scenery display/orientation problems.  Still have a positioning
 651  * (or transformation?) problem.
 652  *
 653  * Revision 1.31  1997/07/11 01:29:58  curt
 654  * More tweaking of terrian floor.
 655  *
 656  * Revision 1.30  1997/07/10 04:26:37  curt
 657  * We now can interpolated ground elevation for any position in the grid.  We
 658  * can use this to enforce a "hard" ground.  We still need to enforce some
 659  * bounds checking so that we don't try to lookup data points outside the
 660  * grid data set.
 661  *
 662  * Revision 1.29  1997/07/09 21:31:12  curt
 663  * Working on making the ground "hard."
 664  *
 665  * Revision 1.28  1997/07/08 18:20:12  curt
 666  * Working on establishing a hard ground.
 667  *
 668  * Revision 1.27  1997/07/07 20:59:49  curt
 669  * Working on scenery transformations to enable us to fly fluidly over the
 670  * poles with no discontinuity/distortion in scenery.
 671  *
 672  * Revision 1.26  1997/07/05 20:43:34  curt
 673  * renamed mat3 directory to Math so we could add other math related routines.
 674  *
 675  * Revision 1.25  1997/06/29 21:19:17  curt
 676  * Working on scenery management system.
 677  *
 678  * Revision 1.24  1997/06/26 22:14:53  curt
 679  * Beginning work on a scenery management system.
 680  *
 681  * Revision 1.23  1997/06/26 19:08:33  curt
 682  * Restructuring make, adding automatic "make dep" support.
 683  *
 684  * Revision 1.22  1997/06/25 15:39:47  curt
 685  * Minor changes to compile with rsxnt/win32.
 686  *
 687  * Revision 1.21  1997/06/22 21:44:41  curt
 688  * Working on intergrating the VRML (subset) parser.
 689  *
 690  * Revision 1.20  1997/06/21 17:12:53  curt
 691  * Capitalized subdirectory names.
 692  *
 693  * Revision 1.19  1997/06/18 04:10:31  curt
 694  * A couple more runway tweaks ...
 695  *
 696  * Revision 1.18  1997/06/18 02:21:24  curt
 697  * Hacked in a runway
 698  *
 699  * Revision 1.17  1997/06/17 16:51:58  curt
 700  * Timer interval stuff now uses gettimeofday() instead of ftime()
 701  *
 702  * Revision 1.16  1997/06/17 04:19:16  curt
 703  * More timer related tweaks with respect to view direction changes.
 704  *
 705  * Revision 1.15  1997/06/17 03:41:10  curt
 706  * Nonsignal based interval timing is now working.
 707  * This would be a good time to look at cleaning up the code structure a bit.
 708  *
 709  * Revision 1.14  1997/06/16 19:32:51  curt
 710  * Starting to add general timer support.
 711  *
 712  * Revision 1.13  1997/06/02 03:40:06  curt
 713  * A tiny bit more view tweaking.
 714  *
 715  * Revision 1.12  1997/06/02 03:01:38  curt
 716  * Working on views (side, front, back, transitions, etc.)
 717  *
 718  * Revision 1.11  1997/05/31 19:16:25  curt
 719  * Elevator trim added.
 720  *
 721  * Revision 1.10  1997/05/31 04:13:52  curt
 722  * WE CAN NOW FLY!!!
 723  *
 724  * Continuing work on the LaRCsim flight model integration.
 725  * Added some MSFS-like keyboard input handling.
 726  *
 727  * Revision 1.9  1997/05/30 19:27:01  curt
 728  * The LaRCsim flight model is starting to look like it is working.
 729  *
 730  * Revision 1.8  1997/05/30 03:54:10  curt
 731  * Made a bit more progress towards integrating the LaRCsim flight model.
 732  *
 733  * Revision 1.7  1997/05/29 22:39:49  curt
 734  * Working on incorporating the LaRCsim flight model.
 735  *
 736  * Revision 1.6  1997/05/29 12:31:39  curt
 737  * Minor tweaks, moving towards general flight model integration.
 738  *
 739  * Revision 1.5  1997/05/29 02:33:23  curt
 740  * Updated to reflect changing interfaces in other "modules."
 741  *
 742  * Revision 1.4  1997/05/27 17:44:31  curt
 743  * Renamed & rearranged variables and routines.   Added some initial simple
 744  * timer/alarm routines so the flight model can be updated on a regular
 745  * interval.
 746  *
 747  * Revision 1.3  1997/05/23 15:40:25  curt
 748  * Added GNU copyright headers.
 749  * Fog now works!
 750  *
 751  * Revision 1.2  1997/05/23 00:35:12  curt
 752  * Trying to get fog to work ...
 753  *
 754  * Revision 1.1  1997/05/21 15:57:51  curt
 755  * Renamed due to added GLUT support.
 756  *
 757  * Revision 1.3  1997/05/19 18:22:42  curt
 758  * Parameter tweaking ... starting to stub in fog support.
 759  *
 760  * Revision 1.2  1997/05/17 00:17:34  curt
 761  * Trying to stub in support for standard OpenGL.
 762  *
 763  * Revision 1.1  1997/05/16 16:05:52  curt
 764  * Initial revision.
 765  *
 766  */