src/Scenery/tilemgr.hxx

   1 // tilemgr.hxx -- 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  - http://www.flightgear.org/~curt
   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
  23
  24 #ifndef _TILEMGR_HXX
  25 #define _TILEMGR_HXX
  26
  27
  28 #ifndef __cplusplus
  29 # error This library requires C++
  30 #endif
  31
  32 #include <simgear/compiler.h>
  33 #include <simgear/math/point3d.hxx>
  34 #include <simgear/scene/model/location.hxx>
  35
  36 #include <queue>
  37
  38 #include <simgear/bucket/newbucket.hxx>
  39 #if defined(ENABLE_THREADS) && ENABLE_THREADS
  40 #  include <simgear/threads/SGQueue.hxx>
  41 #endif // ENABLE_THREADS
  42
  43 #include "FGTileLoader.hxx"
  44 #include "hitlist.hxx"
  45 #include "newcache.hxx"
  46
  47 #if defined(USE_MEM) || defined(WIN32)
  48 #  define FG_MEM_COPY(to,from,n)        memcpy(to, from, n)
  49 #else
  50 #  define FG_MEM_COPY(to,from,n)        bcopy(from, to, n)
  51 #endif
  52
  53 SG_USING_STD( queue );
  54
  55
  56 // forward declaration
  57 class ssgBranch;
  58 class ssgEntity;
  59 class FGTileEntry;
  60 class FGDeferredModel;
  61
  62
  63 class FGTileMgr {
  64
  65 private:
  66
  67     // Tile loading state
  68     enum load_state {
  69         Start = 0,
  70         Inited = 1,
  71         Running = 2
  72     };
  73
  74     load_state state;
  75
  76     // initialize the cache
  77     void initialize_queue();
  78
  79     // schedule a tile for loading
  80     void sched_tile( const SGBucket& b, const bool is_inner_ring );
  81
  82     // schedule a needed buckets for loading
  83     void schedule_needed(double visibility_meters, SGBucket curr_bucket);
  84
  85     FGHitList hit_list;
  86
  87     SGBucket previous_bucket;
  88     SGBucket current_bucket;
  89     SGBucket pending;
  90
  91     FGTileEntry *current_tile;
  92
  93     // x and y distance of tiles to load/draw
  94     float vis;
  95     int xrange, yrange;
  96
  97     // current longitude latitude
  98     double longitude;
  99     double latitude;
 100     double altitude_m;
 101
 102     /**
 103      * tile cache
 104      */
 105     FGNewCache tile_cache;
 106     /**
 107      * and its center
 108      */
 109     Point3D current_center;
 110
 111     /**
 112      * Queue tiles for loading.
 113      */
 114     FGTileLoader loader;
 115
 116     /**
 117      * Work queues.
 118      *
 119      * attach_queue is the tiles that have been loaded [by the pager]
 120      * that can be attached to the scene graph by the render thread.
 121      *
 122      * model_queue is the set of models that need to be loaded by the
 123      * primary render thread.
 124      */
 125 #if defined(ENABLE_THREADS) && ENABLE_THREADS
 126     static SGLockedQueue<FGTileEntry *> attach_queue;
 127     static SGLockedQueue<FGDeferredModel *> model_queue;
 128 #else
 129     static queue<FGTileEntry *> attach_queue;
 130     static queue<FGDeferredModel *> model_queue;
 131 #endif // ENABLE_THREADS
 132     static queue<FGTileEntry *> delete_queue;
 133
 134     /**
 135      * Tile filter indicator, to implement multipass rendering
 136      */
 137     static bool tile_filter;
 138
 139 public:
 140
 141     /**
 142      * Add a loaded tile to the 'attach to the scene graph' queue.
 143      */
 144     static void ready_to_attach( FGTileEntry *t ) { attach_queue.push( t ); }
 145
 146     /**
 147      * Add a pending model to the 'deferred model load' queue
 148      */
 149     static void model_ready( FGDeferredModel *dm ) { model_queue.push( dm ); }
 150
 151 public:
 152
 153     // Constructor
 154     FGTileMgr();
 155
 156     // Destructor
 157     ~FGTileMgr();
 158
 159     // Initialize the Tile Manager subsystem
 160     int init();
 161
 162     // Update the various queues maintained by the tilemagr (private
 163     // internal function, do not call directly.)
 164     void update_queues();
 165
 166     // get state of all the scenery loading queues
 167     bool all_queues_empty();
 168
 169     // given the current lon/lat (in degrees), fill in the array of
 170     // local chunks.  If the chunk isn't already in the cache, then
 171     // read it from disk.
 172     int update( double visibility_meters );
 173     int update( SGLocation *location, double visibility_meters,
 174                 sgdVec3 abs_pos_vector );
 175
 176     int updateCurrentElevAtPos( sgdVec3 abs_pos_vector, double altitude_m,
 177                                 Point3D center );
 178
 179     // Determine scenery altitude.  Normally this just happens when we
 180     // render the scene, but we'd also like to be able to do this
 181     // explicitely.  lat & lon are in radians.  abs_view_pos in
 182     // meters.  Returns result in meters.
 183     void my_ssg_los( string s, ssgBranch *branch, sgdMat4 m,
 184                      const sgdVec3 p, const sgdVec3 dir, sgdVec3 normal );
 185
 186     void my_ssg_los( ssgBranch *branch, sgdMat4 m,
 187                      const sgdVec3 p, const sgdVec3 dir,
 188                      FGHitList *list );
 189
 190     // Prepare the ssg nodes corresponding to each tile.  For each
 191     // tile, set the ssg transform and update it's range selector
 192     // based on current visibilty void prep_ssg_nodes( float
 193     // visibility_meters );
 194     void prep_ssg_nodes( SGLocation *location, float visibility_meters );
 195     const Point3D get_current_center(void) const { return current_center; }
 196
 197     // Set flag with event manager so that non-moving view refreshes
 198     // tiles...
 199     void refresh_view_timestamps();
 200
 201     inline SGBucket get_current_bucket () { return current_bucket; }
 202     inline SGBucket get_previous_bucket () { return previous_bucket; }
 203
 204     static bool set_tile_filter( bool f );
 205     static int tile_filter_cb( ssgEntity *, int );
 206 };
 207
 208
 209 #endif // _TILEMGR_HXX