/usr/include/mia-2.0/mia/2d/imageio.hh is in libmia-2.0-dev 2.0.13-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 | /* -*- mia-c++ -*-
*
* This file is part of MIA - a toolbox for medical image analysis
* Copyright (c) Leipzig, Madrid 1999-2013 Gert Wollny
*
* MIA is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with MIA; if not, see <http://www.gnu.org/licenses/>.
*
*/
#ifndef mia_2d_2dimageui_hh
#define mia_2d_2dimageui_hh
#include <set>
#include <vector>
#include <mia/core/ioplugin.hh>
#include <mia/core/iohandler.hh>
#include <mia/core/callback.hh>
#include <mia/2d/image.hh>
NS_MIA_BEGIN
/**
\ingroup Infrastructure
\brief Vector of 2D images to load and store series of images to one file
*/
class EXPORT_2D C2DImageVector: public C2DImageSeries,
public CIOData {
public:
/// \returns a newly created copy of the image vector
C2DImageVector *clone() const __attribute__((warn_unused_result));
};
/// @cond INTERNAL
class EXPORT_2D io_2dimage_type {
public:
typedef C2DImageVector type;
static const char *data_descr;
};
/// @endcond
/// Base type for 2D image IO plugins
typedef TIOPlugin<io_2dimage_type> C2DImageIOPlugin;
/// @cond INTERNAL
/**
\ingroup io
\brief Handler class for the image IO
*/
class EXPORT_2D C2DImageIOPPH: public TIOPluginHandler<C2DImageIOPlugin> {
public:
typedef TIOPluginHandler<C2DImageIOPlugin>::CSuffixmap CSuffixmap;
typedef TIOPluginHandler<C2DImageIOPlugin>::PData PData;
protected:
C2DImageIOPPH();
};
/// @endcond
/**
\ingroup io
The 2D image IO plugin handler that also provides the interface to
load and store 2D images.
*/
typedef THandlerSingleton< C2DImageIOPPH > C2DImageIOPluginHandler;
/** The type for virtual storage access for images
\sa CDatapool
*/
typedef C2DImageIOPluginHandler::Instance::DataKey C2DImageDataKey;
/**
Data type of what is actually loaded by the image plugins handler
*/
typedef C2DImageIOPluginHandler::Instance::PData P2DImageVector;
/**
@cond INTERNAL
\ingroup test
\brief Class to initialiaze the plug-in search path fot testing without installing the plug-ins
*/
struct EXPORT_2D C2DImageIOPluginHandlerTestPath {
C2DImageIOPluginHandlerTestPath();
};
/// @endcond
/**
\ingroup convenience
Convenience function to create a vector of images wrapping one image
\param image
\returns the vector containing the image
\todo the interface that requires a vector to be passes may not be the best approach
in ensures that we can also load all images from a multi-record image file type
but other then that it is very inconvenient
*/
P2DImageVector EXPORT_2D create_image2d_vector(P2DImage image);
/**
\ingroup io
Convenience function to load one 2D image from a file
@param filename
@returns image
*/
P2DImage EXPORT_2D load_image2d(const std::string& filename);
/**
\ingroup io
Convenience function to load one 2D image from a file
@param filename
@returns image
*/
template <>
inline P2DImage load_image<P2DImage>(const std::string& filename)
{
return load_image2d(filename);
}
/**
\ingroup io
Convenience function to save one 2D image to a file
@param filename
@param image
@returns true if saving was successfull
*/
bool EXPORT_2D save_image(const std::string& filename, P2DImage image);
/**
\ingroup io
Convenience function to save one 2D image to a file
@param filename
@param image
@returns true if saving was successfull
*/
bool EXPORT_2D save_image(const std::string& filename, C2DImage& image);
/**
\ingroup io
Convenience function to load a series of images and group them into sets based
on the acquisition parameters if available.
If these parameters are not available, then the order of the input files is used
to sort the files but no grouping takes place.
\param filenames list of file names
\param cb optionally provide a call back function that shows loading progress
\returns grouped set of files.
*/
C2DImageGroupedSeries EXPORT_2D load_image_series(const std::vector<std::string>& filenames,
CProgressCallback *cb = NULL);
/**
some DICOM tags that may be used
\cond DICOM_TAGS
*/
extern EXPORT_2D const char * IDModality;
extern EXPORT_2D const char * IDPatientOrientation;
extern EXPORT_2D const char * IDPatientPosition;
extern EXPORT_2D const char * IDAcquisitionDate;
extern EXPORT_2D const char * IDAcquisitionNumber;
extern EXPORT_2D const char * IDImageType;
extern EXPORT_2D const char * IDInstanceNumber;
extern EXPORT_2D const char * IDSeriesNumber;
extern EXPORT_2D const char * IDSliceLocation;
extern EXPORT_2D const char * IDStudyID;
extern EXPORT_2D const char * IDSmallestImagePixelValue;
extern EXPORT_2D const char * IDLargestImagePixelValue;
extern EXPORT_2D const char * IDProtocolName;
/// @endcond
NS_MIA_END
#endif
|