ome-files  0.3.1
TileCache.h
1 /*
2  * #%L
3  * OME-FILES C++ library for image IO.
4  * Copyright © 2006 - 2015 Open Microscopy Environment:
5  * - Massachusetts Institute of Technology
6  * - National Institutes of Health
7  * - University of Dundee
8  * - Board of Regents of the University of Wisconsin-Madison
9  * - Glencoe Software, Inc.
10  * %%
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions are met:
13  *
14  * 1. Redistributions of source code must retain the above copyright notice,
15  * this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright notice,
17  * this list of conditions and the following disclaimer in the documentation
18  * and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
24  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  *
32  * The views and conclusions contained in the software and documentation are
33  * those of the authors and should not be interpreted as representing official
34  * policies, either expressed or implied, of any organization.
35  * #L%
36  */
37 
38 #ifndef OME_FILES_TILECACHE_H
39 #define OME_FILES_TILECACHE_H
40 
41 #include <ome/files/Types.h>
42 #include <ome/files/TileBuffer.h>
43 
44 #include <map>
45 #include <memory>
46 
47 namespace ome
48 {
49  namespace files
50  {
51 
58  class TileCache
59  {
60  public:
64  typedef std::shared_ptr<TileBuffer> value_type;
65 
67  TileCache();
68 
70  virtual ~TileCache();
71 
72  private:
73  // To avoid unintentional and expensive copies, copying and
74  // assignment of caches is prevented.
75 
77  TileCache (const TileCache&);
78 
80  TileCache&
81  operator= (const TileCache&);
82 
83  public:
97  bool
98  insert(key_type tileindex,
99  value_type tilebuffer);
100 
106  void
107  erase(key_type tileindex);
108 
116  value_type
117  find(key_type tileindex);
118 
127  const value_type
128  find(key_type tileindex) const;
129 
136  size() const;
137 
141  void
142  clear();
143 
156  value_type&
157  operator[](key_type tileindex);
158 
159  private:
161  std::map<key_type, value_type> cache;
162  };
163 
164  }
165 }
166 
167 #endif // OME_FILES_TILECACHE_H
168 
169 /*
170  * Local Variables:
171  * mode:C++
172  * End:
173  */
void clear()
Clear the tile cache.
Definition: TileCache.cpp:96
Tile cache.
Definition: TileCache.h:58
std::size_t dimension_size_type
Size type for image dimensions.
Definition: Types.h:58
value_type find(key_type tileindex)
Find a tile in the tile cache.
Definition: TileCache.cpp:70
virtual ~TileCache()
Destructor.
Definition: TileCache.cpp:50
std::map< key_type, value_type > cache
Mapping of tile number to tile buffer.
Definition: TileCache.h:161
Open Microscopy Environment C++.
std::shared_ptr< TileBuffer > value_type
Tile buffer type.
Definition: TileCache.h:64
dimension_size_type size() const
Get the tile cache size.
Definition: TileCache.cpp:90
dimension_size_type key_type
Tile index type.
Definition: TileCache.h:62
void erase(key_type tileindex)
Remove a tile from the tile cache.
Definition: TileCache.cpp:64
TileCache & operator=(const TileCache &)
Assignment operator (deleted).
TileCache()
Constructor.
Definition: TileCache.cpp:45
bool insert(key_type tileindex, value_type tilebuffer)
Insert a tile into the tile cache.
Definition: TileCache.cpp:55
value_type & operator[](key_type tileindex)
Get a tile from the tile cache.
Definition: TileCache.cpp:102