iohandler.hh
Go to the documentation of this file.
1 /* -*- mia-c++ -*-
2  *
3  * This file is part of MIA - a toolbox for medical image analysis
4  * Copyright (c) Leipzig, Madrid 1999-2017 Gert Wollny
5  *
6  * MIA is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with MIA; if not, see <http://www.gnu.org/licenses/>.
18  *
19  */
20 
21 #ifndef ph_IOhandler_hh
22 #define ph_IOhandler_hh
23 #include <set>
24 
25 #include <mia/core/handler.hh>
26 #include <mia/core/ioplugin.hh>
28 
30 
43 template <class I>
45 public:
46 
48  typedef typename I::Data Data;
49 
51  typedef typename std::shared_ptr<Data > PData;
52 
55 
58 
60  typedef std::multimap<std::string, std::string> CSuffixmap;
61 
64 
72  PData load(const std::string& fname) const;
73 
82  DataKey load_to_pool(const std::string& fname) const;
83 
92  bool save(const std::string& fname, const Data& data) const;
93 
99  const Interface *preferred_plugin_ptr(const std::string& fname) const;
100 
108  const Interface& preferred_plugin(const std::string& fname) const;
109 
111  const CSuffixmap& get_supported_filetype_map() const;
112 
114  const std::string get_supported_suffixes() const;
115 
117  const std::set<std::string> get_supported_suffix_set() const;
118 
125  std::string get_preferred_suffix(const std::string& type) const;
126 
127 protected:
131  TIOPluginHandler();
132 
133 private:
134 
135  void do_initialise();
136  // a map of plugins
137 
138  CSuffixmap m_suffixmap;
139 
140  // list of supported compressd file suffixes
141  std::set<std::string> m_compress_sfx;
142 
143 
144  // print out info about the available plug-ins
145  void do_print_help(std::ostream& os) const;
146 
147  std::string get_handler_type_string_and_help(std::ostream& os) const;
148  std::string do_get_handler_type_string() const;
149  bool do_validate_parameter_string(const std::string& s) const;
150 
151  virtual void check_file_exists(const std::string& fname) const;
152 
156  class EXPORT_HANDLER CDatapoolPlugin : public Interface {
157  public:
158  CDatapoolPlugin();
159  private:
160  PData do_load(const std::string& fname) const;
161  bool do_save(const std::string& fname,
162  const typename Interface::Data& data) const;
163  const std::string do_get_descr() const;
164  const std::string do_get_preferred_suffix() const;
165 
166  };
167  std::shared_ptr<Interface> m_pool_plugin;
168 };
169 
174 #define EXPLICITE_INSTANCEIATE_IO_HANDLER(IOTYPE) \
175  template class TIOPlugin<IOTYPE>; \
176  template class THandlerSingleton<TIOPluginHandler<TIOPlugin<IOTYPE>>>; \
177  template class TIOPluginHandler<TIOPlugin<IOTYPE>>; \
178  template class TPluginHandler<TIOPlugin<IOTYPE>> \
179 
180 
181 
182 template <typename Data>
183 struct IOHandler_of {
185 };
186 
191 template <typename T>
192 T load_image(const std::string& MIA_PARAM_UNUSED(filename))
193 {
194  static_assert(sizeof(T) == 0, "The call to load_image must be resolved to a template specialization");
195 
196 }
197 
199 #endif
I Interface
typedef for the plug-in interface provided by the class
Definition: handler.hh:59
the singleton that a plug-in handler really is
Definition: handler.hh:157
TDelayedParameter< PData > DataKey
The type of the key used for the CDatapool access.
Definition: iohandler.hh:63
#define NS_MIA_BEGIN
conveniance define to start the mia namespace
Definition: defines.hh:33
#define EXPORT_HANDLER
Definition: core/cost.hh:32
std::shared_ptr< Data > PData
Shared pointer to the data hadnled by this plug-in.
Definition: iohandler.hh:51
TPluginHandler< I >::const_iterator const_iterator
an iterator over the available plug-ins
Definition: iohandler.hh:57
I::Data Data
Data type handled by this plug-in.
Definition: iohandler.hh:48
THandlerSingleton< TIOPluginHandler< TIOPlugin< Data > > > type
Definition: iohandler.hh:184
CPluginMap::const_iterator const_iterator
the iterator to walk over the available plug-ins
Definition: handler.hh:67
std::multimap< std::string, std::string > CSuffixmap
The map that maps file name suffixes to IO plug-ins.
Definition: iohandler.hh:60
T load_image(const std::string &filename)
Definition: iohandler.hh:192
Template for all plug-in handlers that are responsible for data IO.
Definition: iohandler.hh:44
TPluginHandler< I >::Interface Interface
the IO interface provided by this handler
Definition: iohandler.hh:54
A parameter proxy object with a key to identify it.
The basic template of all plugin handlers.
Definition: handler.hh:56
#define NS_MIA_END
conveniance define to end the mia namespace
Definition: defines.hh:36