ome-files  0.5.0
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  // To avoid unintentional and expensive copies, copying and
73  // assignment of caches is prevented.
74 
76  TileCache (const TileCache&) = delete;
77 
78  TileCache&
79  operator= (const TileCache&) = delete;
81 
95  bool
96  insert(key_type tileindex,
97  value_type tilebuffer);
98 
104  void
105  erase(key_type tileindex);
106 
114  value_type
115  find(key_type tileindex);
116 
125  const value_type
126  find(key_type tileindex) const;
127 
134  size() const;
135 
139  void
140  clear();
141 
154  value_type&
155  operator[](key_type tileindex);
156 
157  private:
159  std::map<key_type, value_type> cache;
160  };
161 
162  }
163 }
164 
165 #endif // OME_FILES_TILECACHE_H
166 
167 /*
168  * Local Variables:
169  * mode:C++
170  * End:
171  */
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:159
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()
Constructor.
Definition: TileCache.cpp:45
SKIP 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