simgear/scene/tsync/terrasync.hxx

   1 // terrasync.hxx -- scenery fetcher
   2 //
   3 // Copyright (C) 2011  Thorsten Brehm <brehmt@gmail.com>
   4 //
   5 // This program is free software; you can redistribute it and/or
   6 // modify it under the terms of the GNU General Public License as
   7 // published by the Free Software Foundation; either version 2 of the
   8 // License, or (at your option) any later version.
   9 //
  10 // This program is distributed in the hope that it will be useful, but
  11 // WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13 // General Public License for more details.
  14 //
  15 // You should have received a copy of the GNU General Public License
  16 // along with this program; if not, write to the Free Software
  17 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18 //
  19 // $Id$
  20
  21 #ifndef TERRASYNC_HXX_
  22 #define TERRASYNC_HXX_
  23
  24 #include <set>
  25
  26 #include <simgear/props/props.hxx>
  27 #include <simgear/structure/subsystem_mgr.hxx>
  28 #include <simgear/props/tiedpropertylist.hxx>
  29
  30 class SGPath;
  31 class SGBucket;
  32
  33 namespace simgear
  34 {
  35 const int NOWHERE = -9999;
  36
  37 class BufferedLogCallback;
  38
  39 class SGTerraSync : public SGSubsystem
  40 {
  41 public:
  42
  43     SGTerraSync();
  44     virtual ~SGTerraSync();
  45
  46     virtual void init();
  47     virtual void shutdown();
  48     virtual void reinit();
  49     virtual void bind();
  50     virtual void unbind();
  51     virtual void update(double);
  52
  53     /// notify terrasync that the sim was repositioned, as opposed to
  54     /// us travelling in a direction. Avoid last_lat / last_lon blocking
  55     /// certain tiles when we reposition.
  56     void reposition();
  57
  58     bool isIdle();
  59     bool schedulePosition(int lat, int lon);
  60
  61     bool scheduleTile(const SGBucket& bucket);
  62
  63     void setRoot(SGPropertyNode_ptr root);
  64
  65     /// retrive the associated log object, for displaying log
  66     /// output somewhere (a UI, presumably)
  67     BufferedLogCallback* log() const
  68         { return _log; }
  69
  70     /**
  71      * Test if a scenery directory is queued or actively syncing.
  72      * File path is the tile name, eg 'e001n52' or 'w003n56'. Will return true
  73      * if either the Terrain or Objects variant is being synced.
  74      *
  75      */
  76     bool isTileDirPending(const std::string& sceneryDir) const;
  77
  78
  79     void scheduleDataDir(const std::string& dataDir);
  80
  81     bool isDataDirPending(const std::string& dataDir) const;
  82 protected:
  83     void syncAirportsModels();
  84     void syncArea(int lat, int lon);
  85     void syncAreas(int lat, int lon, int lat_dir, int lon_dir);
  86
  87     void syncAreaByPath(const std::string& aPath);
  88
  89     class SvnThread;
  90
  91 private:
  92     SvnThread* _svnThread;
  93     int last_lat;
  94     int last_lon;
  95     SGPropertyNode_ptr _terraRoot;
  96     SGPropertyNode_ptr _stalledNode;
  97     SGPropertyNode_ptr _cacheHits;
  98
  99     // we manually bind+init TerraSync during early startup
 100     // to get better overlap of slow operations (Shared Models sync
 101     // and nav-cache rebuild). As a result we need to track the bind/init
 102     // state explicitly to avoid duplicate calls.
 103     bool _bound, _inited;
 104
 105     simgear::TiedPropertyList _tiedProperties;
 106     BufferedLogCallback* _log;
 107
 108     typedef std::set<std::string> string_set;
 109     string_set _activeTileDirs;
 110 };
 111
 112 }
 113
 114 #endif /* TERRASYNC_HXX_ */