]> git.mxchange.org Git - flightgear.git/blob - Scenery/tilemgr.cxx
material.cxx: whups, double method declaration with no definition.
[flightgear.git] / Scenery / tilemgr.cxx
1 // tilemgr.cxx -- routines to handle dynamic management of scenery tiles
2 //
3 // Written by Curtis Olson, started January 1998.
4 //
5 // Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.com
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 #ifdef HAVE_WINDOWS_H
30 #  include <windows.h>
31 #endif
32
33 #include <GL/glut.h>
34 #include <XGL/xgl.h>
35
36 #include <Aircraft/aircraft.h>
37
38 #include <Bucket/bucketutils.h>
39 #include <Debug/fg_debug.h>
40 #include <Include/fg_constants.h>
41 #include <Include/fg_types.h>
42 #include <Main/options.hxx>
43 #include <Main/views.hxx>
44 #include <Math/fg_geodesy.h>
45 #include <Math/mat3.h>
46 #include <Math/polar3d.hxx>
47 #include <Math/vector.hxx>
48 #include <Weather/weather.h>
49
50 #include "material.hxx"
51 #include "obj.hxx"
52 #include "scenery.hxx"
53 #include "tilecache.hxx"
54
55
56 #define FG_LOCAL_X_Y         81  // max(o->tile_diameter) ** 2
57
58 #define FG_SQUARE(X) ((X) * (X))
59
60
61 // closest (potentially viewable) tiles, centered on current tile.
62 // This is an array of pointers to cache indexes.
63 int tiles[FG_LOCAL_X_Y];
64
65
66 // Initialize the Tile Manager subsystem
67 int fgTileMgrInit( void ) {
68     fgPrintf( FG_TERRAIN, FG_INFO, "Initializing Tile Manager subsystem.\n");
69
70     // load default material library
71     material_mgr.load_lib();
72
73     return 1;
74 }
75
76
77 // load a tile
78 void fgTileMgrLoadTile( fgBUCKET *p, int *index) {
79     fgTILECACHE *c;
80
81     c = &global_tile_cache;
82
83     fgPrintf( FG_TERRAIN, FG_DEBUG, "Updating for bucket %d %d %d %d\n", 
84            p->lon, p->lat, p->x, p->y);
85     
86     // if not in cache, load tile into the next available slot
87     if ( (*index = c->Exists(p)) < 0 ) {
88         *index = c->NextAvail();
89         c->EntryFillIn(*index, p);
90     }
91
92     fgPrintf( FG_TERRAIN, FG_DEBUG, "Selected cache index of %d\n", *index);
93 }
94
95
96 // given the current lon/lat, fill in the array of local chunks.  If
97 // the chunk isn't already in the cache, then read it from disk.
98 int fgTileMgrUpdate( void ) {
99     fgTILECACHE *c;
100     fgFLIGHT *f;
101     fgBUCKET p1, p2;
102     static fgBUCKET p_last = {-1000, 0, 0, 0};
103     int tile_diameter;
104     int i, j, dw, dh;
105
106     c = &global_tile_cache;
107     f = current_aircraft.flight;
108
109     tile_diameter = current_options.get_tile_diameter();
110
111     fgBucketFind(FG_Longitude * RAD_TO_DEG, FG_Latitude * RAD_TO_DEG, &p1);
112     dw = tile_diameter / 2;
113     dh = tile_diameter / 2;
114
115     if ( (p1.lon == p_last.lon) && (p1.lat == p_last.lat) &&
116          (p1.x == p_last.x) && (p1.y == p_last.y) ) {
117         // same bucket as last time
118         fgPrintf( FG_TERRAIN, FG_DEBUG, "Same bucket as last time\n");
119     } else if ( p_last.lon == -1000 ) {
120         // First time through, initialize the system and load all
121         // relavant tiles
122
123         fgPrintf( FG_TERRAIN, FG_INFO, "  First time through ... ");
124         fgPrintf( FG_TERRAIN, FG_INFO, "  Updating Tile list for %d,%d %d,%d\n",
125                   p1.lon, p1.lat, p1.x, p1.y);
126         fgPrintf( FG_TERRAIN, FG_INFO, "  Loading %d tiles\n", 
127                   tile_diameter * tile_diameter);
128
129         // wipe/initialize tile cache
130         c->Init();
131
132         // build the local area list and update cache
133         for ( j = 0; j < tile_diameter; j++ ) {
134             for ( i = 0; i < tile_diameter; i++ ) {
135                 fgBucketOffset(&p1, &p2, i - dw, j - dh);
136                 fgTileMgrLoadTile(&p2, &tiles[(j*tile_diameter) + i]);
137             }
138         }
139     } else {
140         // We've moved to a new bucket, we need to scroll our
141         // structures, and load in the new tiles
142
143         // CURRENTLY THIS ASSUMES WE CAN ONLY MOVE TO ADJACENT TILES.
144         // AT ULTRA HIGH SPEEDS THIS ASSUMPTION MAY NOT BE VALID IF
145         // THE AIRCRAFT CAN SKIP A TILE IN A SINGLE ITERATION.
146
147         fgPrintf( FG_TERRAIN, FG_INFO, "Updating Tile list for %d,%d %d,%d\n",
148                   p1.lon, p1.lat, p1.x, p1.y);
149
150         if ( (p1.lon > p_last.lon) ||
151              ( (p1.lon == p_last.lon) && (p1.x > p_last.x) ) ) {
152             fgPrintf( FG_TERRAIN, FG_INFO, "  Loading %d tiles\n", 
153                       tile_diameter);
154             for ( j = 0; j < tile_diameter; j++ ) {
155                 // scrolling East
156                 for ( i = 0; i < tile_diameter - 1; i++ ) {
157                     tiles[(j*tile_diameter) + i] = 
158                         tiles[(j*tile_diameter) + i + 1];
159                 }
160                 // load in new column
161                 fgBucketOffset(&p_last, &p2, dw + 1, j - dh);
162                 fgTileMgrLoadTile(&p2, &tiles[(j*tile_diameter) + 
163                                              tile_diameter - 1]);
164             }
165         } else if ( (p1.lon < p_last.lon) ||
166                     ( (p1.lon == p_last.lon) && (p1.x < p_last.x) ) ) {
167             fgPrintf( FG_TERRAIN, FG_INFO, "  Loading %d tiles\n", 
168                       tile_diameter);
169             for ( j = 0; j < tile_diameter; j++ ) {
170                 // scrolling West
171                 for ( i = tile_diameter - 1; i > 0; i-- ) {
172                     tiles[(j*tile_diameter) + i] = 
173                         tiles[(j*tile_diameter) + i - 1];
174                 }
175                 // load in new column
176                 fgBucketOffset(&p_last, &p2, -dw - 1, j - dh);
177                 fgTileMgrLoadTile(&p2, &tiles[(j*tile_diameter) + 0]);
178             }
179         }
180
181         if ( (p1.lat > p_last.lat) ||
182              ( (p1.lat == p_last.lat) && (p1.y > p_last.y) ) ) {
183             fgPrintf( FG_TERRAIN, FG_INFO, "  Loading %d tiles\n", 
184                       tile_diameter);
185             for ( i = 0; i < tile_diameter; i++ ) {
186                 // scrolling North
187                 for ( j = 0; j < tile_diameter - 1; j++ ) {
188                     tiles[(j * tile_diameter) + i] =
189                         tiles[((j+1) * tile_diameter) + i];
190                 }
191                 // load in new column
192                 fgBucketOffset(&p_last, &p2, i - dw, dh + 1);
193                 fgTileMgrLoadTile(&p2, &tiles[((tile_diameter-1) * 
194                                                tile_diameter) + i]);
195             }
196         } else if ( (p1.lat < p_last.lat) ||
197                     ( (p1.lat == p_last.lat) && (p1.y < p_last.y) ) ) {
198             fgPrintf( FG_TERRAIN, FG_INFO, "  Loading %d tiles\n", 
199                       tile_diameter);
200             for ( i = 0; i < tile_diameter; i++ ) {
201                 // scrolling South
202                 for ( j = tile_diameter - 1; j > 0; j-- ) {
203                     tiles[(j * tile_diameter) + i] = 
204                         tiles[((j-1) * tile_diameter) + i];
205                 }
206                 // load in new column
207                 fgBucketOffset(&p_last, &p2, i - dw, -dh - 1);
208                 fgTileMgrLoadTile(&p2, &tiles[0 + i]);
209             }
210         }
211     }
212     p_last.lon = p1.lon;
213     p_last.lat = p1.lat;
214     p_last.x = p1.x;
215     p_last.y = p1.y;
216     return 1;
217 }
218
219
220 // Calculate shortest distance from point to line
221 static double point_line_dist_squared( fgPoint3d *tc, fgPoint3d *vp, 
222                                        MAT3vec d )
223 {
224     MAT3vec p, p0;
225     double dist;
226
227     p[0] = tc->x; p[1] = tc->y; p[2] = tc->z;
228     p0[0] = vp->x; p0[1] = vp->y; p0[2] = vp->z;
229
230     dist = fgPointLineSquared(p, p0, d);
231
232     // printf("dist = %.2f\n", dist);
233
234     return(dist);
235 }
236
237
238 // Calculate if point/radius is inside view frustum
239 static int viewable( fgPoint3d *cp, double radius ) {
240     fgVIEW *v;
241     MAT3hvec world, eye;
242     int viewable = 1; // start by assuming it's viewable
243     double x0, x1, y1, slope;
244
245     v = &current_view;
246
247     MAT3_SET_HVEC(world, cp->x, cp->y, cp->z, 1.0);
248     MAT3mult_vec(eye, world, v->WORLD_TO_EYE);
249     // printf( "\nworld -> eye = %.2f %.2f %.2f  radius = %.2f\n", 
250     //         eye[0], eye[1], eye[2], radius);
251
252     // Check near clip plane
253     if ( eye[2] - radius > 0.0 ) {
254         return(0);
255     }
256
257     // Check far clip plane
258     if ( eye[2] + radius < -current_weather.visibility ) {
259         return(0);
260     }
261
262     // check right clip plane (from eye perspective)
263     // y = m * (x - x0) = equation of a line intercepting X axis at x0
264     x1 = v->cos_fov_x * radius;
265     y1 = v->sin_fov_x * radius;
266     slope = v->slope_x;
267     x0 = x1 - y1 / slope;
268
269     // printf("(r) x1 = %.2f  y1 = %.2f\n", x1, y1);
270     // printf("eye[0] = %.2f  eye[2] = %.2f\n", eye[0], eye[2]);
271     // printf("(r) x0 = %.2f  slope_x = %.2f  radius = %.2f\n", 
272     //        x0, slope, radius);
273
274     if ( eye[2] > slope * (eye[0] - x0) ) {
275         return(0);
276     }
277
278     // check left clip plane (from eye perspective)
279     x1 = -x1;
280     slope = -slope;
281     x0 = x1 - y1 / slope;
282
283     // printf("(r) x1 = %.2f  y1 = %.2f\n", x1, y1);
284     // printf("eye[0] = %.2f  eye[2] = %.2f\n", eye[0], eye[2]);
285     // printf("(r) x0 = %.2f  slope_x = %.2f  radius = %.2f\n", 
286     //        x0, slope, radius);
287
288     if ( eye[2] > slope * (eye[0] - x0) ) {
289         return(0);
290     }
291
292     // check bottom clip plane (from eye perspective)
293     x1 = -(v->cos_fov_y) * radius;
294     y1 = v->sin_fov_y * radius;
295     slope = v->slope_y;
296     x0 = x1 - y1 / slope;
297
298     // printf("(r) x1 = %.2f  y1 = %.2f\n", x1, y1);
299     // printf("eye[1] = %.2f  eye[2] = %.2f\n", eye[1], eye[2]);
300     // printf("(r) x0 = %.2f  slope_y = %.2f  radius = %.2f\n", 
301     //       x0, slope, radius);
302
303     if ( eye[2] > slope * (eye[1] - x0) ) {
304         return(0);
305     }
306
307     // check top clip plane (from eye perspective)
308     x1 = -x1;
309     slope = -slope;
310     x0 = x1 - y1 / slope;
311
312     // printf("(r) x1 = %.2f  y1 = %.2f\n", x1, y1);
313     // printf("eye[1] = %.2f  eye[2] = %.2f\n", eye[1], eye[2]);
314     // printf("(r) x0 = %.2f  slope_y = %.2f  radius = %.2f\n", 
315     //        x0, slope, radius);
316
317     if ( eye[2] > slope * (eye[1] - x0) ) {
318         return(0);
319     }
320
321     return(viewable);
322 }
323
324
325 // Render the local tiles
326 void fgTileMgrRender( void ) {
327     fgTILECACHE *c;
328     fgFLIGHT *f;
329     fgTILE *t, *last_tile_ptr;
330     fgVIEW *v;
331     fgBUCKET p;
332     fgPoint3d frag_offset, pp;
333     fgPoint3d earth_center, result;
334     fgFRAGMENT *frag_ptr;
335     fgMATERIAL *mtl_ptr;
336     GLdouble *m;
337     double dist, min_dist, lat_geod, alt, sea_level_r;
338     double x, y, z;
339     list < fgFRAGMENT > :: iterator current;
340     list < fgFRAGMENT > :: iterator last;
341     int i, j, size;
342     int tile_diameter, textures;
343     int index;
344     int culled = 0;
345     int drawn = 0;
346
347     c = &global_tile_cache;
348     f = current_aircraft.flight;
349     v = &current_view;
350
351     tile_diameter = current_options.get_tile_diameter();
352     textures = current_options.get_textures();
353
354     // Find current translation offset
355     fgBucketFind(FG_Longitude * RAD_TO_DEG, FG_Latitude * RAD_TO_DEG, &p);
356     index = c->Exists(&p);
357     t = c->GetTile(index);
358
359     scenery.next_center.x = t->center.x;
360     scenery.next_center.y = t->center.y;
361     scenery.next_center.z = t->center.z;
362
363     earth_center.x = 0.0;
364     earth_center.y = 0.0;
365     earth_center.z = 0.0;
366
367     fgPrintf( FG_TERRAIN, FG_DEBUG, 
368               "Pos = (%.2f, %.2f) Current bucket = %d %d %d %d  Index = %ld\n", 
369               FG_Longitude * RAD_TO_DEG, FG_Latitude * RAD_TO_DEG,
370               p.lon, p.lat, p.x, p.y, fgBucketGenIndex(&p) );
371
372     // initialize the transient per-material fragment lists
373     material_mgr.init_transient_material_lists();
374     min_dist = 100000.0;
375
376     // Pass 1
377     // traverse the potentially viewable tile list
378     for ( i = 0; i < (tile_diameter * tile_diameter); i++ ) {
379         index = tiles[i];
380         // fgPrintf( FG_TERRAIN, FG_DEBUG, "Index = %d\n", index);
381         t = c->GetTile(index);
382
383         // calculate tile offset
384         x = (t->offset.x = t->center.x - scenery.center.x);
385         y = (t->offset.y = t->center.y - scenery.center.y);
386         z = (t->offset.z = t->center.z - scenery.center.z);
387
388         m = t->model_view;
389         for ( j = 0; j < 16; j++ ) {
390             m[j] = v->MODEL_VIEW[j];
391         }
392
393         // Calculate the model_view transformation matrix for this tile
394         // This is equivalent to doing a glTranslatef(x, y, z);
395         m[12] = m[0] * x + m[4] * y + m[8]  * z + m[12];
396         m[13] = m[1] * x + m[5] * y + m[9]  * z + m[13];
397         m[14] = m[2] * x + m[6] * y + m[10] * z + m[14];
398         m[15] = m[3] * x + m[7] * y + m[11] * z + m[15];
399
400         // temp ... calc current terrain elevation
401         // calculate distance from vertical tangent line at
402         // current position to center of tile.
403         
404         /* printf("distance squared = %.2f, bounding radius = %.2f\n", 
405                point_line_dist_squared(&(t->offset), &(v->view_pos), 
406                v->local_up), t->bounding_radius); */
407
408         dist = point_line_dist_squared( &(t->center), &(v->abs_view_pos), 
409                                         v->local_up );
410         if ( dist < FG_SQUARE(t->bounding_radius) ) {
411
412             // traverse fragment list for tile
413             current = t->fragment_list.begin();
414             last = t->fragment_list.end();
415
416             while ( current != last ) {
417                 frag_ptr = &(*current);
418                 current++;
419                 /* printf("distance squared = %.2f, bounding radius = %.2f\n", 
420                        point_line_dist_squared( &(frag_ptr->center), 
421                                         &(v->abs_view_pos), v->local_up),
422                        frag_ptr->bounding_radius); */
423
424                 dist = point_line_dist_squared( &(frag_ptr->center), 
425                                         &(v->abs_view_pos), v->local_up);
426                 if ( dist <= FG_SQUARE(frag_ptr->bounding_radius) ) {
427                     if ( frag_ptr->intersect( &(v->abs_view_pos), 
428                                               &earth_center, 0, &result ) ) {
429                         // compute geocentric coordinates of tile center
430                         pp = fgCartToPolar3d(result);
431                         // convert to geodetic coordinates
432                         fgGeocToGeod(pp.lat, pp.radius, &lat_geod, 
433                                      &alt, &sea_level_r);
434                         // printf("alt = %.2f\n", alt);
435                         scenery.cur_elev = alt;
436                         // exit this loop since we found an intersection
437                         break;
438                     }
439                 }
440             }
441         }
442
443         // Course (tile based) culling
444         if ( viewable(&(t->offset), t->bounding_radius) ) {
445             // at least a portion of this tile could be viewable
446             
447             // xglPushMatrix();
448             // xglTranslatef(t->offset.x, t->offset.y, t->offset.z);
449
450             // traverse fragment list for tile
451             current = t->fragment_list.begin();
452             last = t->fragment_list.end();
453
454             while ( current != last ) {
455                 frag_ptr = &(*current);
456                 current++;
457                 
458                 if ( frag_ptr->display_list >= 0 ) {
459                     // Fine (fragment based) culling
460                     frag_offset.x = frag_ptr->center.x - scenery.center.x;
461                     frag_offset.y = frag_ptr->center.y - scenery.center.y;
462                     frag_offset.z = frag_ptr->center.z - scenery.center.z;
463
464                     if ( viewable(&frag_offset, frag_ptr->bounding_radius*2) ) {
465                         // add to transient per-material property fragment list
466                         // frag_ptr->tile_offset.x = t->offset.x;
467                         // frag_ptr->tile_offset.y = t->offset.y;
468                         // frag_ptr->tile_offset.z = t->offset.z;
469
470                         mtl_ptr = (fgMATERIAL *)(frag_ptr->material_ptr);
471                         // printf(" lookup = %s\n", mtl_ptr->texture_name);
472                         if ( mtl_ptr->list_size < FG_MAX_MATERIAL_FRAGS ) {
473                             mtl_ptr->list[mtl_ptr->list_size] = frag_ptr;
474                             (mtl_ptr->list_size)++;
475                         } else {
476                             fgPrintf( FG_TERRAIN, FG_ALERT,
477                                       "Overran material sorting array\n" );
478                         }
479
480                         // xglCallList(frag_ptr->display_list);
481                         drawn++;
482                     } else {
483                         // printf("Culled a fragment %.2f %.2f %.2f %.2f\n",
484                         //        frag_ptr->center.x, frag_ptr->center.y,
485                         //        frag_ptr->center.z, frag_ptr->bounding_radius);
486                         culled++;
487                     }
488                 }
489             }
490
491             // xglPopMatrix();
492         } else {
493             culled += t->fragment_list.size();
494         }
495     }
496
497     if ( (drawn + culled) > 0 ) {
498         v->vfc_ratio = (double)culled / (double)(drawn + culled);
499     } else {
500         v->vfc_ratio = 0.0;
501     }
502     // printf("drawn = %d  culled = %d  saved = %.2f\n", drawn, culled, 
503     //        v->vfc_ratio);
504
505     // Pass 2
506     // traverse the transient per-material fragment lists and render
507     // out all fragments for each material property.
508     map < string, fgMATERIAL, less<string> > :: iterator mapcurrent = 
509         material_mgr.material_map.begin();
510     map < string, fgMATERIAL, less<string> > :: iterator maplast = 
511         material_mgr.material_map.end();
512
513     xglPushMatrix();
514
515     while ( mapcurrent != maplast ) {
516         // (char *)key = (*mapcurrent).first;
517         // (fgMATERIAL)value = (*mapcurrent).second;
518         mtl_ptr = &(*mapcurrent).second;
519
520         last_tile_ptr = NULL;
521
522         size = mtl_ptr->list_size;
523         if ( size > 0 ) {
524             if ( textures ) {
525 #ifdef GL_VERSION_1_1
526                 xglBindTexture(GL_TEXTURE_2D, mtl_ptr->texture_id);
527 #elif GL_EXT_texture_object
528                 xglBindTextureEXT(GL_TEXTURE_2D, mtl_ptr->texture_id);
529 #else
530 #  error port me
531 #endif
532             } else {
533                 xglMaterialfv (GL_FRONT, GL_AMBIENT, mtl_ptr->ambient);
534                 xglMaterialfv (GL_FRONT, GL_DIFFUSE, mtl_ptr->diffuse);
535             }
536
537             // printf("traversing = %s, size = %d\n", 
538             //       mtl_ptr->texture_name, size);
539             for ( i = 0; i < size; i++ ) {
540                 frag_ptr = mtl_ptr->list[i];
541                 
542                 if ( frag_ptr->tile_ptr == last_tile_ptr ) {
543                     // same tile as last time, no transform necessary
544                 } else {
545                     // new tile, new translate
546                     // xglLoadMatrixf( frag_ptr->matrix );
547                     t = (fgTILE *)(frag_ptr->tile_ptr);
548                     xglLoadMatrixd(t->model_view );
549                 }
550             
551                 // Woohoo!!!  We finally get to draw something!
552                 // printf("  display_list = %d\n", frag_ptr->display_list);
553                 xglCallList(frag_ptr->display_list);
554
555                 last_tile_ptr = (fgTILE *)(frag_ptr->tile_ptr);
556             }
557         }
558
559         *mapcurrent++;
560     }
561
562     xglPopMatrix();
563 }
564
565
566 // $Log$
567 // Revision 1.27  1998/07/24 21:42:09  curt
568 // material.cxx: whups, double method declaration with no definition.
569 // obj.cxx: tweaks to avoid errors in SGI's CC.
570 // tile.cxx: optimizations by Norman Vine.
571 // tilemgr.cxx: optimizations by Norman Vine.
572 //
573 // Revision 1.26  1998/07/20 12:51:26  curt
574 // Added far clip plane to fragment clipping calculations and tie this to
575 // weather->visibility.  This way you can increase framerates by increasing
576 // for and lowering visibility.
577 //
578 // Revision 1.25  1998/07/13 21:02:01  curt
579 // Wrote access functions for current fgOPTIONS.
580 //
581 // Revision 1.24  1998/07/12 03:18:29  curt
582 // Added ground collision detection.  This involved:
583 // - saving the entire vertex list for each tile with the tile records.
584 // - saving the face list for each fragment with the fragment records.
585 // - code to intersect the current vertical line with the proper face in
586 //   an efficient manner as possible.
587 // Fixed a bug where the tiles weren't being shifted to "near" (0,0,0)
588 //
589 // Revision 1.23  1998/07/08 14:47:23  curt
590 // Fix GL_MODULATE vs. GL_DECAL problem introduced by splash screen.
591 // polare3d.h renamed to polar3d.hxx
592 // fg{Cartesian,Polar}Point3d consolodated.
593 // Added some initial support for calculating local current ground elevation.
594 //
595 // Revision 1.22  1998/07/04 00:54:31  curt
596 // Added automatic mipmap generation.
597 //
598 // When rendering fragments, use saved model view matrix from associated tile
599 // rather than recalculating it with push() translate() pop().
600 //
601 // Revision 1.21  1998/06/27 16:54:59  curt
602 // Check for GL_VERSION_1_1 or GL_EXT_texture_object to decide whether to use
603 //   "EXT" versions of texture management routines.
604 //
605 // Revision 1.20  1998/06/17 21:36:42  curt
606 // Load and manage multiple textures defined in the Materials library.
607 // Boost max material fagments for each material property to 800.
608 // Multiple texture support when rendering.
609 //
610 // Revision 1.19  1998/06/08 17:57:54  curt
611 // Working first pass at material proporty sorting.
612 //
613 // Revision 1.18  1998/06/06 01:09:32  curt
614 // I goofed on the log message in the last commit ... now fixed.
615 //
616 // Revision 1.17  1998/06/06 01:07:18  curt
617 // Increased per material fragment list size from 100 to 400.
618 // Now correctly draw viewable fragments in per material order.
619 //
620 // Revision 1.16  1998/06/05 22:39:55  curt
621 // Working on sorting by, and rendering by material properties.
622 //
623 // Revision 1.15  1998/06/03 00:47:51  curt
624 // No .h for STL includes.
625 // Minor view culling optimizations.
626 //
627 // Revision 1.14  1998/06/01 17:56:20  curt
628 // Incremental additions to material.cxx (not fully functional)
629 // Tweaked vfc_ratio math to avoid divide by zero.
630 //
631 // Revision 1.13  1998/05/24 02:49:10  curt
632 // Implimented fragment level view frustum culling.
633 //
634 // Revision 1.12  1998/05/23 14:09:23  curt
635 // Added tile.cxx and tile.hxx.
636 // Working on rewriting the tile management system so a tile is just a list
637 // fragments, and the fragment record contains the display list for that fragment.
638 //
639 // Revision 1.11  1998/05/20 20:53:55  curt
640 // Moved global ref point and radius (bounding sphere info, and offset) to
641 // data file rather than calculating it on the fly.
642 // Fixed polygon winding problem in scenery generation stage rather than
643 // compensating for it on the fly.
644 // Made a fgTILECACHE class.
645 //
646 // Revision 1.10  1998/05/17 16:59:34  curt
647 // Frist pass at view frustum culling now operational.
648 //
649 // Revision 1.9  1998/05/16 13:09:58  curt
650 // Beginning to add support for view frustum culling.
651 // Added some temporary code to calculate bouding radius, until the
652 //   scenery generation tools and scenery can be updated.
653 //
654 // Revision 1.8  1998/05/07 23:15:21  curt
655 // Fixed a glTexImage2D() usage bug where width and height were mis-swapped.
656 // Added support for --tile-radius=n option.
657 //
658 // Revision 1.7  1998/05/06 03:16:42  curt
659 // Added an option to control square tile radius.
660 //
661 // Revision 1.6  1998/05/02 01:52:18  curt
662 // Playing around with texture coordinates.
663 //
664 // Revision 1.5  1998/04/30 12:35:32  curt
665 // Added a command line rendering option specify smooth/flat shading.
666 //
667 // Revision 1.4  1998/04/27 03:30:14  curt
668 // Minor transformation adjustments to try to keep scenery tiles closer to
669 // (0, 0, 0)  GLfloats run out of precision at the distances we need to model
670 // the earth, but we can do a bunch of pre-transformations using double math
671 // and then cast to GLfloat once everything is close in where we have less
672 // precision problems.
673 //
674 // Revision 1.3  1998/04/25 22:06:32  curt
675 // Edited cvs log messages in source files ... bad bad bad!
676 //
677 // Revision 1.2  1998/04/24 00:51:09  curt
678 // Wrapped "#include <config.h>" in "#ifdef HAVE_CONFIG_H"
679 // Tweaked the scenery file extentions to be "file.obj" (uncompressed)
680 // or "file.obz" (compressed.)
681 //
682 // Revision 1.1  1998/04/22 13:22:48  curt
683 // C++ - ifing the code a bit.
684 //
685 // Revision 1.25  1998/04/18 04:14:07  curt
686 // Moved fg_debug.c to it's own library.
687 //
688 // Revision 1.24  1998/04/14 02:23:18  curt
689 // Code reorganizations.  Added a Lib/ directory for more general libraries.
690 //
691 // Revision 1.23  1998/04/08 23:30:08  curt
692 // Adopted Gnu automake/autoconf system.
693 //
694 // Revision 1.22  1998/04/03 22:11:38  curt
695 // Converting to Gnu autoconf system.
696 //
697 // Revision 1.21  1998/03/23 21:23:05  curt
698 // Debugging output tweaks.
699 //
700 // Revision 1.20  1998/03/14 00:30:51  curt
701 // Beginning initial terrain texturing experiments.
702 //
703 // Revision 1.19  1998/02/20 00:16:25  curt
704 // Thursday's tweaks.
705 //
706 // Revision 1.18  1998/02/19 13:05:54  curt
707 // Incorporated some HUD tweaks from Michelle America.
708 // Tweaked the sky's sunset/rise colors.
709 // Other misc. tweaks.
710 //
711 // Revision 1.17  1998/02/16 13:39:46  curt
712 // Miscellaneous weekend tweaks.  Fixed? a cache problem that caused whole
713 // tiles to occasionally be missing.
714 //
715 // Revision 1.16  1998/02/12 21:59:53  curt
716 // Incorporated code changes contributed by Charlie Hotchkiss
717 // <chotchkiss@namg.us.anritsu.com>
718 //
719 // Revision 1.14  1998/02/09 21:30:19  curt
720 // Fixed a nagging problem with terrain tiles not "quite" matching up perfectly.
721 //
722 // Revision 1.13  1998/02/07 15:29:46  curt
723 // Incorporated HUD changes and struct/typedef changes from Charlie Hotchkiss
724 // <chotchkiss@namg.us.anritsu.com>
725 //
726 // Revision 1.12  1998/02/01 03:39:55  curt
727 // Minor tweaks.
728 //
729 // Revision 1.11  1998/01/31 00:43:27  curt
730 // Added MetroWorks patches from Carmen Volpe.
731 //
732 // Revision 1.10  1998/01/29 00:51:40  curt
733 // First pass at tile cache, dynamic tile loading and tile unloading now works.
734 //
735 // Revision 1.9  1998/01/27 03:26:44  curt
736 // Playing with new fgPrintf command.
737 //
738 // Revision 1.8  1998/01/27 00:48:04  curt
739 // Incorporated Paul Bleisch's <pbleisch@acm.org> new debug message
740 // system and commandline/config file processing code.
741 //
742 // Revision 1.7  1998/01/26 15:55:25  curt
743 // Progressing on building dynamic scenery system.
744 //
745 // Revision 1.6  1998/01/24 00:03:30  curt
746 // Initial revision.
747 //
748 // Revision 1.5  1998/01/19 19:27:18  curt
749 // Merged in make system changes from Bob Kuehne <rpk@sgi.com>
750 // This should simplify things tremendously.
751 //
752 // Revision 1.4  1998/01/19 18:40:38  curt
753 // Tons of little changes to clean up the code and to remove fatal errors
754 // when building with the c++ compiler.
755 //
756 // Revision 1.3  1998/01/13 00:23:11  curt
757 // Initial changes to support loading and management of scenery tiles.  Note,
758 // there's still a fair amount of work left to be done.
759 //
760 // Revision 1.2  1998/01/08 02:22:27  curt
761 // Continue working on basic features.
762 //
763 // Revision 1.1  1998/01/07 23:50:51  curt
764 // "area" renamed to "tile"
765 //
766 // Revision 1.2  1998/01/07 03:29:29  curt
767 // Given an arbitrary lat/lon, we can now:
768 //   generate a unique index for the chunk containing the lat/lon
769 //   generate a path name to the chunk file
770 //   build a list of the indexes of all the nearby areas.
771 //
772 // Revision 1.1  1998/01/07 02:05:48  curt
773 // Initial revision.