E:/Projetos_Primeiro_Semestre_2012/TerraView/terralib/src/terralib/kernel/TeRasterMemManager.h

Go to the documentation of this file.

/************************************************************************************
TerraLib - a library for developing GIS applications.
Copyright � 2001-2007 INPE and Tecgraf/PUC-Rio.

This code is part of the TerraLib library.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

You should have received a copy of the GNU Lesser General Public
License along with this library.

The authors reassure the license terms regarding the warranties.
They specifically disclaim any warranties, including, but not limited to,
the implied warranties of merchantability and fitness for a particular purpose.
The library provided hereunder is on an "as is" basis, and the authors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.
In no event shall INPE and Tecgraf / PUC-Rio be held liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use
of this library and its documentation.
*************************************************************************************/
#ifndef TERASTERMEMMANAGER_H
  #define TERASTERMEMMANAGER_H

  #include "TeSharedPtr.h"
  
  #include <vector>
  
  class TL_DLL TeRasterMemManager {
  
    public :
    
      enum MemoryPolicy {
        AutoMemPol = 1,
        RAMMemPol = 2,
        DiskMemPol = 3
      };    
    
      TeRasterMemManager();    

      ~TeRasterMemManager();
      
      void clear();
      
      bool reset( unsigned int bands, unsigned int tilesPerBand,
        const std::vector< unsigned int >& tilesSizesVec,
        MemoryPolicy memoryPolicy, unsigned char maxMemPercentUsage,
        unsigned long int maxTempFileSize );

      void* getTilePointer( const unsigned int& band, 
        const unsigned int& tile );    
      
    protected :
    
      class DiskTileData
      {
        public :
          FILE* filePtr_;
          unsigned long int fileOff_;
          unsigned int size_;
          
          DiskTileData() : filePtr_( 0 ), fileOff_( 0 ), size_( 0 ) {};
          
          ~DiskTileData() {};
      };      

      typedef unsigned char TileDataT;    
    
      typedef TileDataT* TilePtrT;
      
      typedef std::vector< TilePtrT > TilesPtrsVecT;   
      
      typedef std::vector< DiskTileData > 
        DiskTileDataVecT;   
        
      typedef std::vector< std::pair< FILE*, std::string > > 
        OpenDiskFilesVecT;   
             
      unsigned char maxMemPercentUsage_;
      
      unsigned long int maxTempFileSize_;      
      
      // Temp variables used by the getTilePointer method.
      TilePtrT getTilePointer_tilePtr_;
      unsigned int getTilePointer_reqTileIdx_;
      unsigned int getTilePointer_swapTileIdx_;
      
      unsigned int tilesPerBand_;
      
      unsigned int bandsNmb_;
      
      std::vector< unsigned int > bandsTileSizes_;
    
      TilesPtrsVecT allTilesPtrsVec_;
      
      OpenDiskFilesVecT openDiskFilesVec_;   
      
      DiskTileDataVecT diskTilesDataVec_;
      
      std::vector< unsigned int > ramTilesIndexesVec_;
      
      unsigned int nextSwapTileRamTilesIndexesVecIdx_;
      
      TilePtrT swapTilePtr_;
      
      bool allocateDiskFiles( unsigned int tileSize,
        unsigned int tilesNmb, OpenDiskFilesVecT& openDiskFilesVec, 
        DiskTileDataVecT& diskTilesData );
        
      bool createNewDiskFile( unsigned long int size,
        std::string& filename, FILE** fileptr );
      
    private :
    
      TeRasterMemManager( const TeRasterMemManager& ) {};
       
      const TeRasterMemManager& operator=( const TeRasterMemManager& )
        { return *this; };
      
  };
  
#endif