ossimTileCache Class Reference

#include <ossimTileCache.h>

Classes
struct	ossimTileInformation

Public Member Functions
	ossimTileCache (long numberOfBuckets=10)
virtual	~ossimTileCache ()
virtual ossimDataObject *	get (const ossimDpt3d &origin, unsigned long resLevel=0)
virtual ossimDataObject *	remove (const ossimDpt3d &origin, unsigned long resLevel=0)
virtual ossimDataObject *	insert (const ossimDpt3d &origin, ossimDataObject *data, unsigned long resLevel=0)
void	invalidate ()
virtual void	invalidate (const ossimDpt3d &origin, ossim_uint32 resLevel)
virtual long	numberOfItems () const
virtual void	display () const
virtual ossim_uint32	sizeInBytes ()

Protected Types
typedef multimap< ossim_uint32, ossimTileInformation * >::iterator	Iterator
typedef ossimTileInformation *	CacheDataPtr
typedef ossimTileInformation	CacheData

Protected Member Functions
void	deleteAll ()
virtual ossim_uint32	bucketHash (const ossimDpt3d &aPt)
virtual ossim_uint32	tileId (const ossimDpt3d &aPt)

Protected Attributes
multimap< ossim_uint32, ossimTileInformation * > *	theCache
long	theNumberOfBuckets
ossim_uint32	theSizeInBytes

Detailed Description

Definition at line 25 of file ossimTileCache.h.

Member Typedef Documentation

CacheData

typedef ossimTileInformation ossimTileCache::CacheData

protected

Definition at line 94 of file ossimTileCache.h.

CacheDataPtr

typedef ossimTileInformation* ossimTileCache::CacheDataPtr

protected

Definition at line 93 of file ossimTileCache.h.

Iterator

typedef multimap<ossim_uint32, ossimTileInformation*>::iterator ossimTileCache::Iterator

protected

Definition at line 92 of file ossimTileCache.h.

Constructor & Destructor Documentation

ossimTileCache()

ossimTileCache::ossimTileCache

(

long

numberOfBuckets = 10

)

Definition at line 29 of file ossimTileCache.cpp.

References theCache, and theNumberOfBuckets.

   : theCache(NULL),
     theNumberOfBuckets(numberOfBuckets>0?numberOfBuckets:255),
     theSizeInBytes(0)
{
   theCache = new multimap<ossim_uint32, ossimTileInformation*>[theNumberOfBuckets];
}

~ossimTileCache()

ossimTileCache::~ossimTileCache ( )

virtual

Definition at line 37 of file ossimTileCache.cpp.

References deleteAll().

{
   deleteAll();
}

Member Function Documentation

bucketHash()

ossim_uint32 ossimTileCache::bucketHash ( const ossimDpt3d &  aPt )

protectedvirtual

Definition at line 152 of file ossimTileCache.cpp.

References theNumberOfBuckets, and tileId().

Referenced by get(), insert(), and remove().

{   
   return tileId(aPt)%theNumberOfBuckets;
}

deleteAll()

void ossimTileCache::deleteAll ( )

protected

Definition at line 157 of file ossimTileCache.cpp.

References theCache, and theNumberOfBuckets.

Referenced by ~ossimTileCache().

{
   Iterator anIterator;

   for(long bucket = 0; bucket < theNumberOfBuckets; bucket++)
   {
      anIterator = theCache[bucket].begin();
      while(anIterator != theCache[bucket].end())
      {
         CacheDataPtr info = (*anIterator).second;
         delete info;
         
         ++anIterator;
      }
      theCache[bucket].clear();
   }
   delete [] theCache;
}

display()

void ossimTileCache::display ( ) const

virtual

Definition at line 14 of file ossimTileCache.cpp.

References theCache, and theNumberOfBuckets.

{
   ossimTileCache::Iterator tiles;

   for(long buckets = 0; buckets < theNumberOfBuckets; buckets++)
   {
      tiles = theCache[buckets].begin();
      while(tiles != theCache[buckets].end())
      {
         cout << ((*tiles).second) << endl;
         ++tiles;
      }
   }
}

get()

ossimDataObject * ossimTileCache::get ( const ossimDpt3d &  origin, unsigned long  resLevel = 0  )

virtual

This will return a tile if found. Note this tile is still owned by the cache.

Definition at line 42 of file ossimTileCache.cpp.

References bucketHash(), ossimRefPtr< T >::get(), theCache, ossimTileCache::ossimTileInformation::theCachedTile, ossimTileCache::ossimTileInformation::theOrigin, ossimTileCache::ossimTileInformation::theResLevel, and tileId().

Referenced by ossimAppTileCache::get().

{
   ossimDataObject* result = NULL;
   Iterator anIterator;

   ossim_uint32 bucket = bucketHash(origin);
   
   anIterator = theCache[bucket].find(tileId(origin));
   while(anIterator != theCache[bucket].end())
   {
      CacheDataPtr info = (*anIterator).second;
      if(info)
      {
         if(info->theOrigin   == origin &&
            info->theResLevel == resLevel)
         {
            return info->theCachedTile.get();
         }
      }

      ++anIterator;
   }
   return result;
}

insert()

ossimDataObject * ossimTileCache::insert ( const ossimDpt3d &  origin, ossimDataObject *  data, unsigned long  resLevel = 0  )

virtual

This will not duplicate the tile. Note the tile is owned by the cache.

Definition at line 100 of file ossimTileCache.cpp.

References bucketHash(), ossimDataObject::getDataSizeInBytes(), theCache, theSizeInBytes, and tileId().

Referenced by ossimAppTileCache::insert().

{   
   ossim_uint32 bucket = bucketHash(origin);

   // make sure we keep up with the current size of the
   // cache in bytes.  This is only the count of the data
   // and not any overhead required by the cache.
   theSizeInBytes += data->getDataSizeInBytes();
   theCache[bucket].insert(make_pair(tileId(origin),
                                     new CacheData(data,
                                                   origin,
                                                   resLevel)));
   
   return data;
}

invalidate() [1/2]

void ossimTileCache::invalidate

(

)

Not implemented

Definition at line 118 of file ossimTileCache.cpp.

{
   
}

invalidate() [2/2]

void ossimTileCache::invalidate ( const ossimDpt3d &  origin, ossim_uint32  resLevel  )

virtual

Not implemented

Definition at line 123 of file ossimTileCache.cpp.

{
}

numberOfItems()

virtual long ossimTileCache::numberOfItems ( ) const

inlinevirtual

Definition at line 64 of file ossimTileCache.h.

{return theCache?(long)theCache->size():(long)0;}

remove()

ossimDataObject * ossimTileCache::remove ( const ossimDpt3d &  origin, unsigned long  resLevel = 0  )

virtual

Will remove the tile from the cache and will not delete. Note: the cache no longer owns the tile.

Definition at line 68 of file ossimTileCache.cpp.

References bucketHash(), ossimRefPtr< T >::get(), ossimDataObject::getDataSizeInBytes(), theCache, ossimTileCache::ossimTileInformation::theCachedTile, ossimTileCache::ossimTileInformation::theOrigin, ossimTileCache::ossimTileInformation::theResLevel, theSizeInBytes, and tileId().

Referenced by ossimAppTileCache::removeTile().

{
   Iterator anIterator;
   ossimDataObject *result;
   ossim_uint32 bucket = bucketHash(origin);
   
   anIterator = theCache[bucket].find(tileId(origin));
   while(anIterator != theCache[bucket].end())
   {
      CacheDataPtr info = (*anIterator).second;
      if(info)
      {
         if(info->theOrigin   == origin &&
            info->theResLevel == resLevel)
         {
            theCache[bucket].erase(anIterator);
            theSizeInBytes -= info->theCachedTile->getDataSizeInBytes();

            result = info->theCachedTile.get();

            delete info;
            return result;
         }
      }

      ++anIterator;
   }
   
   return NULL;   
}

sizeInBytes()

virtual ossim_uint32 ossimTileCache::sizeInBytes ( )

inlinevirtual

Definition at line 67 of file ossimTileCache.h.

Referenced by ossimAppTileCache::deleteCache().

{return theSizeInBytes;}

tileId()

ossim_uint32 ossimTileCache::tileId ( const ossimDpt3d &  aPt )

protectedvirtual

Definition at line 130 of file ossimTileCache.cpp.

References ossimDpt3d::x, ossimDpt3d::y, and ossimDpt3d::z.

Referenced by bucketHash(), get(), insert(), and remove().

{
   const unsigned char *bufx = (unsigned char*)(&aPt.x);
   const unsigned char *bufy = (unsigned char*)(&aPt.y);
   const unsigned char *bufz = (unsigned char*)(&aPt.z);

   // this just multiplies each byte by some prime number
   // and add together.
   return (ossim_uint32)(bufx[0]*101 + bufx[1]*103 +
                    bufx[2]*107 + bufx[3]*109 +
                    bufx[4]*113 + bufx[5]*127 +
                    bufx[6]*131 + bufx[7]*137 +
                    bufy[0]*139 + bufy[1]*149 +
                    bufy[2]*151 + bufy[3]*157 +
                    bufy[4]*163 + bufy[5]*167 +
                    bufy[6]*173 + bufy[7]*179 +
                    bufz[0]*181 + bufz[1]*191 +
                    bufz[2]*193 + bufz[3]*197 +
                    bufz[4]*199 + bufz[5]*211 +
                    bufz[6]*223 + bufz[6]*227);       
}

Member Data Documentation

theCache

multimap<ossim_uint32, ossimTileInformation*>* ossimTileCache::theCache

protected

Definition at line 100 of file ossimTileCache.h.

Referenced by deleteAll(), display(), get(), insert(), ossimTileCache(), and remove().

theNumberOfBuckets

long ossimTileCache::theNumberOfBuckets

protected

Definition at line 101 of file ossimTileCache.h.

Referenced by bucketHash(), deleteAll(), display(), and ossimTileCache().

theSizeInBytes

ossim_uint32 ossimTileCache::theSizeInBytes

protected

Definition at line 102 of file ossimTileCache.h.

Referenced by insert(), and remove().

---

The documentation for this class was generated from the following files:

• ossimTileCache.h
• ossimTileCache.cpp