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  - 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
  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
  34 #include <queue>
  35
  36 #include <plib/ssg.h>
  37
  38 #include <simgear/bucket/newbucket.hxx>
  39 #ifdef 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
  54 // forward declaration
  55 class FGTileEntry;
  56 class FGDeferredModel;
  57
  58
  59 class FGTileMgr {
  60
  61 private:
  62
  63     // Tile loading state
  64     enum load_state {
  65         Start = 0,
  66         Inited = 1,
  67         Running = 2
  68     };
  69
  70     load_state state;
  71
  72     // initialize the cache
  73     void initialize_queue();
  74
  75     // schedule a tile for loading
  76     void sched_tile( const SGBucket& b );
  77
  78     // schedule a needed buckets for loading
  79     void schedule_needed();
  80
  81     // see comment at prep_ssg_nodes()
  82     void prep_ssg_node( int idx );
  83
  84     FGHitList hit_list;
  85
  86     SGBucket previous_bucket;
  87     SGBucket current_bucket;
  88     SGBucket pending;
  89
  90     FGTileEntry *current_tile;
  91
  92     // x and y distance of tiles to load/draw
  93     float vis;
  94     int xrange, yrange;
  95
  96     // current longitude latitude
  97     double longitude;
  98     double latitude;
  99     double last_longitude;
 100     double last_latitude;
 101
 102     /**
 103      * tile cache
 104      */
 105     FGNewCache tile_cache;
 106
 107     /**
 108      * Queue tiles for loading.
 109      */
 110     FGTileLoader loader;
 111     int counter_hack;
 112
 113     /**
 114      * Work queues.
 115      *
 116      * attach_queue is the tiles that have been loaded [by the pager]
 117      * that can be attached to the scene graph by the render thread.
 118      *
 119      * model_queue is the set of models that need to be loaded by the
 120      * primary render thread.
 121      */
 122 #ifdef ENABLE_THREADS
 123     static SGLockedQueue<FGTileEntry *> attach_queue;
 124     static SGLockedQueue<FGDeferredModel *> model_queue;
 125 #else
 126     static queue<FGTileEntry *> attach_queue;
 127     static queue<FGDeferredModel *> model_queue;
 128 #endif // ENABLE_THREADS
 129
 130 public:
 131
 132     /**
 133      * Add a loaded tile to the 'attach to the scene graph' queue.
 134      */
 135     static void ready_to_attach( FGTileEntry *t ) { attach_queue.push( t ); }
 136
 137 #ifdef WISH_PLIB_WAS_THREADED // but it isn't
 138     /**
 139      * Tile is detatched from scene graph and is ready to delete
 140      */
 141     inline void ready_to_delete( FGTileEntry *t ) { loader.remove( t ); }
 142 #endif
 143
 144     /**
 145      * Add a pending model to the 'deferred model load' queue
 146      */
 147     static void model_ready( FGDeferredModel *dm ) { model_queue.push( dm ); }
 148
 149 public:
 150
 151     // Constructor
 152     FGTileMgr();
 153
 154     // Destructor
 155     ~FGTileMgr();
 156
 157     // Initialize the Tile Manager subsystem
 158     int init();
 159
 160     // given the current lon/lat (in degrees), fill in the array of
 161     // local chunks.  If the chunk isn't already in the cache, then
 162     // read it from disk.
 163     int update( double lon, double lat );
 164
 165     // Determine scenery altitude.  Normally this just happens when we
 166     // render the scene, but we'd also like to be able to do this
 167     // explicitely.  lat & lon are in radians.  abs_view_pos in
 168     // meters.  Returns result in meters.
 169     void my_ssg_los( string s, ssgBranch *branch, sgdMat4 m,
 170                      const sgdVec3 p, const sgdVec3 dir, sgdVec3 normal );
 171
 172     void my_ssg_los( ssgBranch *branch, sgdMat4 m,
 173                      const sgdVec3 p, const sgdVec3 dir,
 174                      FGHitList *list );
 175
 176
 177     // Prepare the ssg nodes ... for each tile, set it's proper
 178     // transform and update it's range selector based on current
 179     // visibilty
 180     void prep_ssg_nodes();
 181 };
 182
 183
 184 // the tile manager
 185 extern FGTileMgr global_tile_mgr;
 186
 187
 188 #endif // _TILEMGR_HXX