spatmod/imagesourcetileset.h

Go to the documentation of this file.

#ifndef  INC_SPATMOD_IMAGESOURCETILESET_H
#define  INC_SPATMOD_IMAGESOURCETILESET_H

#ifndef  INC_SPATMOD_IMAGESOURCE_H
#include <spatmod/imagesource.h>
#endif

#ifndef INC_SPATMOD_IMAGESAMPLEITERATOR_H
#include <spatmod/imagesampleiterator.h>
#endif

#ifndef INC_SPATMOD_IMAGESTAGEAUTOPTR_H
#include <spatmod/imagestageautoptr.h>
#endif

#ifndef INC_SPATMOD_IMAGETILESET_H
#include <spatmod/imagetileset.h>
#endif

#ifndef INC_MI32_RECT_H
#include <mi32/rect.h>
#endif

#ifndef INC_MI32_DATETIME_H
#include <mi32/datetime.h>
#endif

#ifndef INC_MI32_CRITSEC_H
#include <mi32/critsec.h>
#endif

#ifndef INC_MI32_ZIPFILE_H
#include <mi32/zipfile.h>
#endif

#ifndef INC_RVC_OBJITEM_H
#include <rvc/objitem.h>
#endif


#ifndef GENERATING_DOXYGEN_OUTPUT
// Forward declarations.
class HTTPMESSAGE;
namespace GRE {
   class LAYERDC;
   }
#endif


namespace SPATMOD {
namespace IMAGE {

//=====================================================================================================================

class SOURCE_TILESET : public SOURCE {
   public:

      static void CacheClear ();

      enum DATATIPFLAG {
         DATATIPFLAG_None =         0x0000,
         DATATIPFLAG_TileInfo =     0x0001,     
         DATATIPFLAG_ImageValue =   0x0002,     
         DATATIPFLAG_Date =         0x0008,     
         };

      SOURCE_TILESET (
         const RVC::OBJITEM& objitem
         );

      SOURCE_TILESET (
         );

      // Destructor.
      virtual ~SOURCE_TILESET ();

      ERRVALUE AddTileLabels (
         INT32 ZoomLevelToUse,      
         const LRECT2D& ObjRect,    
         const GRE::LAYERDC& layerdc   
         );
      ERRVALUE FindTileFile (
         INT32 ZoomLevelToUse,      
         const LPOINT2D& TileIdx,   
         FILEPATH& PathTileFile     
         );
      ERRVALUE GetDatatip (
         const DPOINT2D& point,     
         MISTRING& string,       
         INT32 ZoomLevelToUse,      
         DATATIPFLAG flags       
         ) { return (v_GetDatatip(point, string, ZoomLevelToUse, flags)); }
      ERRVALUE GetDatatipObjectNames (
         const DPOINT2D& point,     
         MISTRING& string,       
         INT32 ZoomLevelToUse,      
         int indent = 0          
         ) { return (v_GetDatatipObjectNames(point, string, ZoomLevelToUse, indent)); }
      const MISTRING& GetDateString () const
         { return (m_DateString); }
      INT32 GetMaxLevel () const
         { return (m_TileSet.GetMaxLevel()); }
      INT32 GetMinLevel () const
         { return (m_TileSet.GetMinLevel()); }
      double GetMaxLevelCellSize () const;
      double GetMinLevelCellSize () const;
      double GetMaxScaleVisible (
         double PixelSizeMM
         ) const;
      ERRVALUE GetTileIdx (
         LPOINT2D& TileIdx,         
         const DPOINT2D& point,     
         INT32 ZoomLevel            
         );
      ERRVALUE GetTileIdx (
         LPOINT2D& TileIdx,         
         LPOINT2D& PixelInTile,     
         const DPOINT2D& point,     
         INT32 ZoomLevel            
         );
      SPATMOD::IMAGE::TILESET& GetTileSet ()
         { return (m_TileSet); }
      bool HasTileMap ();
      FORMAT::SPEC FindTileInTileMap (
         const SPATMOD::IMAGE::BUFFER& Buffer,
         INT32 ZoomLevel,
         const LPOINT2D& TopLeftTileIdx,
         const LPOINT2D& TileIdx
         );
      ERRVALUE ReadTileMap (
         SPATMOD::IMAGE::BUFFER& Buffer,
         INT32 level,
         const LPOINT2D& TopLeftTileIdx,
         const LPOINT2D& BottomRightTileIdx,
         bool bIsMaxRangeTileMap = false
         );
      ERRVALUE MakeGeoreference (
         STAGE_AUTOPTR& StagePtr,
         double ZoomUsed
         );
      void SetDateString (const MISTRING& DateString)
         { m_DateString = DateString; }
      ERRVALUE SetMaxLevelToUse (INT32 MaxLevel);
      void SetUseMultithreaded (bool bUseMultithreaded) {m_bUseMultithreaded = bUseMultithreaded;}
      
   protected:
      // SOURCE_TILESET - protected (used by derived SOURCE_BINGMAPS)

      void ComputePosition (INT32 TileSize, INT32 RowsToAdd, INT32 ColsToAdd, const LPOINT2D& BaseTopLeftTileIdx, LPOINT2D& TileIdx, LPOINT2D& PixelInTile);
      ERRVALUE FindSource (const MISTRING& RemotePathString, INT32 TileMapLevel, INT32 ZoomLevelToUse, const LPOINT2D& TileIdx, SPATMOD::IMAGE::STAGE*& source, bool bDownloadIfNeeded = false, MISTRING* PathString = 0, bool bReturnOnlyString = false);
      ERRVALUE FindSource (INT32 ZoomLevelToUse, const LPOINT2D& TileIdx, SPATMOD::IMAGE::STAGE*& source, bool bDownloadIfNeeded = false, MISTRING* PathString = 0, bool bReturnOnlyString = false);
      ERRVALUE FinishInitialize ();
      void SetUseTileMap (bool bUseTileMap) {m_bUseTilemap = bUseTileMap;}
      virtual ERRVALUE v_GetDatatip (const DPOINT2D& point, MISTRING& string, INT32 ZoomLevelToUse, DATATIPFLAG flags);

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT
      // SOURCE_TILESET private methods

      static void CheckContentType (SPATMOD::IMAGE::FORMAT& ImgFormat, FILEPATH& PathTileFile, const HTTPMESSAGE& reply, const SPATMOD::IMAGE::TILESET& TileSet);
      ERRVALUE AddSectionToDownload(const SPATMOD::IMAGE::SECTION& section);
      void CheckCache ();
      ERRVALUE CheckDownloadTile (const LPOINT3D& TileIdx);
      bool FilterDelegate (
         const SPATMOD::IMAGE::SAMPLEITERATOR *ittgt,
         const SPATMOD::IMAGE::SAMPLEITERATOR *itsrc,
         bool valid
         );
      const FILEPATH& GetCacheBasePath () const
         { return (m_TempCacheBasePath); }
      MISTRING GetCacheFileName (const LPOINT2D& TileIdx, INT32 ZoomLevel, INT32 TileMapLevel = -1);
      INT32 GetZoomLevel (INT32 MaxLevel, double zoom) const;
      void OnJobDone (MITHREAD::ID id);
      void QueueNextTileJob (int ServerPos);

      ERRVALUE PullTiles (
         const SECTION& SubSection,                
         BUFFER& buffer,                           
         const SPATMOD::IMAGE::PIXEL& PixelProperties,   
         bool &bFoundTiles                      
         );
      ERRVALUE PullTiles (
         const MISTRING& RemotePathString,            
         INT32 TileMapLevel,                       
         INT32 ZoomLevelToUse,                     
         const SECTION& SubSection,                
         BUFFER& buffer,                           
         const SPATMOD::IMAGE::PIXEL& PixelProperties,   
         bool &bFoundTiles                      
         );
      void GetMinimumPixelInMap (
         const SPATMOD::IMAGE::BUFFER& Buffer,
         INT32 ZoomLevel,
         const LPOINT2D& TopLeftTileIdx,
         const LPOINT2D& TileIdx,
         double& MinValue
         );
      void GetMaximumPixelInMap (
         const SPATMOD::IMAGE::BUFFER& Buffer,
         INT32 ZoomLevel,
         const LPOINT2D& TopLeftTileIdx,
         const LPOINT2D& TileIdx,
         double& MaxValue
         );
      // Read pixel range for tile
      ERRVALUE ReadPixelRange (
         INT32 level, 
         const LPOINT2D& TileIdx,
         double& MinValue,
         double& MaxValue
         );

      // SOURCE_TILESET overridables.
      virtual void v_GetCacheName (MISTRING& CacheName);
      virtual ERRVALUE v_GetDatatipObjectNames (const DPOINT2D& point, MISTRING& string, INT32 ZoomLevelToUse, int indent);
      virtual ERRVALUE v_ProcessBottomTile (SPATMOD::IMAGE::STAGE*& source, INT32 ZoomLevelToUse, const LPOINT2D& TileIdx);

      // BASE overrides.
      virtual ERRVALUE v_GetDimensions (DIMENSIONS& dimensions, double zoom) const;
      virtual ERRVALUE v_GetGeoreference (GEOREFERENCE& georeference, double zoom) const;
      virtual const char* v_GetTypeName () const;
      virtual ZOOMABILITY v_GetZoomAbility (SIMPLE_ARRAY<double>& ZoomsAllowed) const;

      // STAGE overrides.
      virtual ERRVALUE v_ComputePixelRange (
         const SECTION& section,                
         PIXEL& PixelValueMin,                  
         PIXEL& PixelValueMax,                  
         RANGETYPE accuracy                     
         );
      virtual ERRVALUE v_Initialize ();
      virtual ERRVALUE v_PullBegin (const SECTION_ITERATOR& iterator);
      virtual ERRVALUE v_PullEnd ();
      virtual ERRVALUE v_PullSubSection (const SECTION& SubSection, BUFFER& buffer);
      virtual float v_QueryIterator (const SECTION_ITERATOR& iterator) const;

      // Unimplemented
      SOURCE_TILESET (const SOURCE_TILESET&);
      SOURCE_TILESET& operator= (const SOURCE_TILESET&);

      // SOURCE_TILESET private members
      class TILEJOB;
      class TILETODOWNLOAD;

      bool m_bUseTilemap;
      INT32 m_NumTiles;
      MISTRING m_DateString;
      MISTRING m_TempCacheName;
      FILEPATH m_TempCacheBasePath;
      FILEPATH m_LastZipFilePath;
      ZIPFILE m_LastZipFile;
      RVC::OBJITEM m_objitem;
      SPATMOD::IMAGE::TILESET m_TileSet;
      SPATMOD::IMAGE::TILESET m_TileMapTileset;
      SPATMOD::IMAGE::TILESET::IMGFORMAT m_ImgFormat;
      SPATMOD::IMAGE::PIXEL::TYPE m_SrcPixelType;
      MILIST<TILEJOB*> m_TileJobPtrs;
      MILIST<TILETODOWNLOAD> m_TilesToDownload;
      MITHREAD::QUEUE m_Queue;
      MITHREAD::POOL* m_Pool;
      MITHREAD::CRITICALSECTION m_TileListSync;
      bool m_bUseMultithreaded;

      #endif // GENERATING_DOXYGEN_OUTPUT

   };

#ifndef  GENERATING_DOXYGEN_OUTPUT
DEFINE_ENUM_OP_BITWISE(SOURCE_TILESET::DATATIPFLAG)
#endif

//=====================================================================================================================

}  // End namespace IMAGE
}  // End namespace SPATMOD

#endif   // INC_SPATMOD_IMAGESOURCEGOOGLEMAPS_H

---