DGtal  1.4.2
DGtal::GenericReader< TContainer, 2, 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, unsigned int x=0, unsigned int y=0)
 
template<typename TFunctor >
static TContainer importWithColorFunctor (const std::string &filename, const TFunctor &aFunctor, unsigned int x=0, unsigned int y=0)
 
template<typename TFunctor >
static TContainer importWithValueFunctor (const std::string &filename, const TFunctor &aFunctor, unsigned int x=0, unsigned int y=0)
 

Detailed Description

template<typename TContainer, typename TValue>
struct DGtal::GenericReader< TContainer, 2, TValue >

GenericReader Template partial specialisation for volume images of dimension 2

Definition at line 398 of file GenericReader.h.

Member Function Documentation

◆ BOOST_CONCEPT_ASSERT()

template<typename TContainer , typename TValue >
DGtal::GenericReader< TContainer, 2, TValue >::BOOST_CONCEPT_ASSERT ( (concepts::CImage< TContainer >)  )

◆ import()

template<typename TContainer , typename TValue >
static TContainer DGtal::GenericReader< TContainer, 2, TValue >::import ( const std::string &  filename,
unsigned int  x = 0,
unsigned int  y = 0 
)
static

Import a volume image file. For the special format h5 (you need to set WITH_HDF5 of cmake build), the default parameter datasetName needs to be updated according to the dimension if the image.

Parameters
filenamethe image filename to be imported.
xspecify the x image size to be used with raw format.
yspecify the y image size to be used with raw format.

◆ importWithColorFunctor()

template<typename TContainer , typename TValue >
template<typename TFunctor >
static TContainer DGtal::GenericReader< TContainer, 2, TValue >::importWithColorFunctor ( const std::string &  filename,
const TFunctor &  aFunctor,
unsigned int  x = 0,
unsigned int  y = 0 
)
inlinestatic

Import an image file by specifying a color encoder functor (used only for color image format ppm, png, tga, bmp,jpeg) .

Template Parameters
TFunctorThe type of the functor (should verify the concept CUnaryFunctor<TFunctor, TContainer::Value, DGtal::Color > ).
Parameters
filenamethe image filename to be imported.
aFunctoran ColorRGBEncoder. The type of the functor (should verify the concept CUnaryFunctor<TFunctor, TContainer::Value, DGtal::Color > ).
xspecify the x image size to be used with raw format.
yspecify the y image size to be used with raw format.

Definition at line 429 of file GenericReader.h.

433  {
434  BOOST_CONCEPT_ASSERT(( concepts::CUnaryFunctor<TFunctor, DGtal::Color, typename TContainer::Value> )) ;
435  DGtal::IOException dgtalio;
436  //Getting image extension
437  const std::string extension = filename.substr( filename.find_last_of(".") + 1 );
438 
439  if ( extension == "ppm" )
440  {
441  return PPMReader<TContainer, TFunctor>::importPPM(filename, aFunctor);
442  }
443  else if ( extension == "raw" )
444  {
445  ASSERT( x != 0 && y != 0 );
446  typename TContainer::Point const pt (x,y);
447  return RawReader< TContainer, TFunctor >::template importRaw<DGtal::Color>( filename, pt, aFunctor);
448  }
449  else if ( extension == "gif" || extension == "jpg" || extension == "png" || extension == "jpeg" || extension == "bmp" || extension == "tga" )
450  {
451  STBReader<TContainer, TFunctor> reader;
452  return reader.import( filename, aFunctor );
453  }
454 
455  trace.error() << "Extension " << extension<< " in 2D, not yet implemented in DGtal GenericReader." << std::endl;
456  throw dgtalio;
457  }
std::ostream & error()
Trace trace
Definition: Common.h:153
BOOST_CONCEPT_ASSERT((concepts::CImage< TContainer >))
static ImageContainer importPPM(const std::string &aFilename, const Functor &aFunctor=functors::ColorRGBEncoder< Value >(), bool topbotomOrder=true)
MyPointD Point
Definition: testClone2.cpp:383

References DGtal::GenericReader< TContainer, Tdim, TValue >::BOOST_CONCEPT_ASSERT(), DGtal::Trace::error(), DGtal::STBReader< TImageContainer, TFunctor >::import(), DGtal::PPMReader< TImageContainer, TFunctor >::importPPM(), and DGtal::trace.

◆ importWithValueFunctor()

template<typename TContainer , typename TValue >
template<typename TFunctor >
static TContainer DGtal::GenericReader< TContainer, 2, TValue >::importWithValueFunctor ( const std::string &  filename,
const TFunctor &  aFunctor,
unsigned int  x = 0,
unsigned int  y = 0 
)
inlinestatic

Import an image file by specifying a value functor used for grayscale image.

Template Parameters
TFunctorThe type of the functor (should verify the concept CUnaryFunctor<TFunctor, unsigned char, TContainer::Value > ).
Parameters
filenamethe image filename to be imported.
aFunctorto transform input unsigned char of image value into the given image type. image.
xspecify the x image size to be used with raw format.
yspecify the y image size to be used with raw format.

Definition at line 472 of file GenericReader.h.

475  {
476  BOOST_CONCEPT_ASSERT(( concepts::CUnaryFunctor<TFunctor, unsigned char, typename TContainer::Value > )) ;
477 
478  DGtal::IOException dgtalio;
479  //Getting image extension
480  const std::string extension = filename.substr( filename.find_last_of(".") + 1 );
481 
482  if ( extension == "raw" )
483  {
484  ASSERT( x!= 0 && y != 0);
485  typename TContainer::Point const pt (x,y);
486  return RawReader< TContainer, TFunctor >::importRaw8( filename, pt, aFunctor );
487  }
488  else if ( extension == "pgm" )
489  {
490  return PGMReader<TContainer, TFunctor>::importPGM(filename, aFunctor);
491  }
492 
493 #ifdef WITH_HDF5
494  if (extension=="h5")
495  return HDF5Reader<TContainer, TFunctor>::importHDF5(filename, "image8bit", aFunctor);
496 #endif
497 
498  trace.error() << "Extension " << extension<< " not yet implemented in DGtal GenericReader." << std::endl;
499  throw dgtalio;
500 
501  }
static ImageContainer importHDF5(const std::string &aFilename, const std::string &aDataset, const Functor &aFunctor=Functor(), bool topbotomOrder=true)
static ImageContainer importPGM(const std::string &aFilename, const Functor &aFunctor=Functor(), bool topbotomOrder=true)
static ImageContainer importRaw8(const std::string &filename, const Vector &extent, const Functor &aFunctor=Functor())

References DGtal::GenericReader< TContainer, Tdim, TValue >::BOOST_CONCEPT_ASSERT(), DGtal::Trace::error(), DGtal::HDF5Reader< TImageContainer, TFunctor >::importHDF5(), DGtal::PGMReader< TImageContainer, TFunctor >::importPGM(), DGtal::RawReader< TImageContainer, TFunctor >::importRaw8(), and DGtal::trace.


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