DGtal::GenericReader< TContainer, Tdim, TValue > Struct Template Reference

#include <DGtal/io/readers/GenericReader.h>

Public Member Functions
	BOOST_CONCEPT_ASSERT ((concepts::CImage< TContainer >))

Static Public Member Functions
static TContainer	import (const std::string &filename, std::vector< unsigned int > dimSpace=std::vector< unsigned int >()) throw (DGtal::IOException)

Detailed Description

template<typename TContainer, int Tdim = TContainer::Point::dimension, typename TValue = typename TContainer::Value>
struct DGtal::GenericReader< TContainer, Tdim, TValue >

Aim: Provide a mechanism to load with the bestloader according to an image (2D or 3D) filename (by parsing the extension).

Description of template class 'GenericReader'

The typical use is very simple:

• First include the header of the generic reader (and StdDefs) and define image type:

  #include "DGTal/io/readers/GenericReader.h"
  #include "DGtal/helpers/StdDefs.h"
  typedef DGtal::ImageContainerBySTLMap<DGtal::Z3i::Domain, unsigned int> Image3D;
  typedef DGtal::ImageContainerBySTLMap<DGtal::Z2i::Domain, unsigned int> Image2D;

• Use the same import function for both 2D or 3D images:

  Image3D an3Dimage= DGtal::GenericReader<Image3D>::import("example.vol");
  Image2D an2Dimage= DGtal::GenericReader<Image2D>::import("example.pgm");

Advanced:

the file format value type will be cast to TContainer::Value. For instance, VOL file format deals with "unsigned char" and if the TContainer::Value type is different, you could have type conversion issues.

Template Parameters

TContainer	the container (mainly an ImageContainer like ImageContainerBySTLVector or ImageContainerBySTLMap).
Tdim	the dimension of the container (by default given by the container).

Examples:

geometry/surfaces/dvcm-3d.cpp, images/imageBasicSubsampling.cpp, io/viewers/viewer3D-9-3Dimages.cpp, and tutorial-examples/2DSliceImageFromVol.cpp.

Definition at line 101 of file GenericReader.h.

Member Function Documentation

template<typename TContainer , int Tdim = TContainer::Point::dimension, typename TValue = typename TContainer::Value>

DGtal::GenericReader< TContainer, Tdim, TValue >::BOOST_CONCEPT_ASSERT

(

(concepts::CImage< TContainer >)

)

Referenced by DGtal::GenericReader< TContainer, 2, TValue >::importWithColorFunctor(), DGtal::GenericReader< TContainer, 2, DGtal::uint32_t >::importWithColorFunctor(), DGtal::GenericReader< TContainer, 3, TValue >::importWithValueFunctor(), DGtal::GenericReader< TContainer, 3, DGtal::uint32_t >::importWithValueFunctor(), DGtal::GenericReader< TContainer, 2, TValue >::importWithValueFunctor(), and DGtal::GenericReader< TContainer, 2, DGtal::uint32_t >::importWithValueFunctor().

template<typename TContainer , int Tdim = TContainer::Point::dimension, typename TValue = typename TContainer::Value>

static TContainer DGtal::GenericReader< TContainer, Tdim, TValue >::import ( const std::string &  filename, std::vector< unsigned int >  dimSpace = std::vector< unsigned int >()  ) throw ( DGtal::IOException )

static

Import a volume nd image file. For the special format of raw image, the default parameter of the image size must be given in the optional function vector parameter (dimSpace) .

Parameters

filename	the image filename to imported.
dimSpace	a vector containing the n dimensional image size.

---

The documentation for this struct was generated from the following file:

• GenericReader.h