Aim: implements association bewteen points lying in a digital domain and values. More...

#include <DGtal/images/Image.h>

Collaboration diagram for DGtal::Image< TImageContainer >:

Public Types
typedef TImageContainer	ImageContainer
	Types copied from the container. More...

typedef TImageContainer::Domain	Domain

typedef TImageContainer::Point	Point

typedef TImageContainer::Value	Value

typedef TImageContainer::ConstRange	ConstRange

typedef TImageContainer::Range	Range

typedef TImageContainer::OutputIterator	OutputIterator

typedef CowPtr< TImageContainer >	ImagePointer
	Pointer to the image container data. More...

Public Member Functions
	BOOST_CONCEPT_ASSERT ((concepts::CImage< TImageContainer >))
	Checking concepts. More...

	BOOST_CONCEPT_ASSERT ((concepts::CVertexMap< TImageContainer >))

	Image ()

	Image (ImageContainer *anImageContainer)

	Image (const CowPtr< ImageContainer > &anImageContainerCowPointer)

	Image (const ImageContainer &other)

	Image (const Image &other)

Image &	operator= (const Image &other)

	~Image ()

const Domain &	domain () const

ConstRange	constRange () const

Range	range ()

Value	operator() (const Point &aPoint) const

void	setValue (const Point &aPoint, const Value &aValue)

void	selfDisplay (std::ostream &out) const

bool	isValid () const

const ImagePointer	getPointer () const

Protected Attributes
ImagePointer	myImagePointer
	Owning smart pointer on the image container. More...

Detailed Description

template<typename TImageContainer>
class DGtal::Image< TImageContainer >

Aim: implements association bewteen points lying in a digital domain and values.

Description of template class 'Image'

This class is a lightweight proxy on ImageContainers (models of CImage). Image class is also a model of CImage.

Template Parameters

TImageContainer an image container type (model of CImage).

Examples: examples/tutorial-examples/polyhedralizer.cpp, geometry/curves/exampleGridCurve3d-2.cpp, geometry/surfaces/dvcm-3d.cpp, geometry/surfaces/greedy-plane-segmentation-ex2.cpp, geometry/surfaces/greedy-plane-segmentation.cpp, geometry/volumes/distance/distancetransform2D.cpp, geometry/volumes/distance/distancetransform3D.cpp, geometry/volumes/distance/toricdomainvolumetric.cpp, graph/volDistanceTraversal.cpp, images/exampleConstImageAdapter.cpp, images/exampleRigidtransformation2d.cpp, images/exampleRigidtransformation3d.cpp, io/digitalSetFromVol.cpp, io/display3DToOFF.cpp, shapes/viewMarchingCubes.cpp, shapes/viewPolygonalMarchingCubes.cpp, topology/3dBorderExtractionImg.cpp, topology/ctopo-2-3d.cpp, topology/ctopo-2.cpp, topology/digitalSurfaceSlice.cpp, topology/frontierAndBoundary.cpp, topology/volBreadthFirstTraversal.cpp, topology/volMarchingCubes.cpp, topology/volScanBoundary.cpp, topology/volToOFF.cpp, topology/volTrackBoundary.cpp, tutorial-examples/freemanChainFromImage.cpp, tutorial-examples/polyhedralizer.cpp, and tutorial-examples/volDTGranulo.cpp.

Definition at line 69 of file Image.h.

Member Typedef Documentation

◆ ConstRange

template<typename TImageContainer >

typedef TImageContainer::ConstRange DGtal::Image< TImageContainer >::ConstRange

Definition at line 85 of file Image.h.

◆ Domain

template<typename TImageContainer >

typedef TImageContainer::Domain DGtal::Image< TImageContainer >::Domain

Definition at line 82 of file Image.h.

◆ ImageContainer

template<typename TImageContainer >

typedef TImageContainer DGtal::Image< TImageContainer >::ImageContainer

Types copied from the container.

Definition at line 81 of file Image.h.

◆ ImagePointer

template<typename TImageContainer >

typedef CowPtr<TImageContainer> DGtal::Image< TImageContainer >::ImagePointer

Pointer to the image container data.

Definition at line 90 of file Image.h.

◆ OutputIterator

template<typename TImageContainer >

typedef TImageContainer::OutputIterator DGtal::Image< TImageContainer >::OutputIterator

Definition at line 87 of file Image.h.

◆ Point

template<typename TImageContainer >

typedef TImageContainer::Point DGtal::Image< TImageContainer >::Point

Definition at line 83 of file Image.h.

◆ Range

template<typename TImageContainer >

typedef TImageContainer::Range DGtal::Image< TImageContainer >::Range

Definition at line 86 of file Image.h.

◆ Value

template<typename TImageContainer >

typedef TImageContainer::Value DGtal::Image< TImageContainer >::Value

Definition at line 84 of file Image.h.

Constructor & Destructor Documentation

◆ Image() [1/5]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::Image ( )

inline

Default constructor.

Definition at line 99 of file Image.h.

             {
 #ifdef DEBUG_VERBOSE
 trace.warning() << "Image Ctor default "<<std::endl;
 #endif
  
     };

References DGtal::trace, and DGtal::Trace::warning().

◆ Image() [2/5]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::Image ( ImageContainer * anImageContainer )

inline

Constructor from a pointer on the underlying image container. (data pointer is acquired, ownership transfer)

Definition at line 110 of file Image.h.

                                            :
       myImagePointer(anImageContainer)
     {
 #ifdef DEBUG_VERBOSE
     trace.warning() << "Image Ctor fromPointer "<<std::endl;
 #endif
     }

References DGtal::trace, and DGtal::Trace::warning().

◆ Image() [3/5]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::Image ( const CowPtr< ImageContainer > & anImageContainerCowPointer )

inline

Constructor from Copy on write pointer. (data is not copied if read-only)

Parameters

anImageContainerCowPointer a COW-pointer on the underlying container.

Definition at line 123 of file Image.h.

                                                                    :
       myImagePointer(anImageContainerCowPointer)
     {
       #ifdef DEBUG_VERBOSE
 trace.warning() << "Image Ctor fromCow  "<<std::endl;
 #endif
     }

References DGtal::trace, and DGtal::Trace::warning().

◆ Image() [4/5]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::Image ( const ImageContainer & other )

inline

Constructor from ImageContainer const reference (data is duplicated).

Parameters

other an object of same type to copy.

Definition at line 136 of file Image.h.

                                      :
       myImagePointer(new ImageContainer(other) )
       {
 #ifdef DEBUG_VERBOSE
 trace.warning() << "Image Ctor fromConstRef "<<std::endl;
 #endif
       }

References DGtal::trace, and DGtal::Trace::warning().

◆ Image() [5/5]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::Image ( const Image< TImageContainer > & other )

inline

Copy Constructor (data is not copied here).

Parameters

other an object of same type to copy.

Definition at line 150 of file Image.h.

                             :
       myImagePointer(other.myImagePointer )
       {
           #ifdef DEBUG_VERBOSE
 trace.warning() << "Image copy Ctor  "<<std::endl;
 #endif
       }

References DGtal::trace, and DGtal::Trace::warning().

◆ ~Image()

template<typename TImageContainer >

DGtal::Image< TImageContainer >::~Image ( )

inline

Destructor. Does nothing, the cow pointer takes care of everything

Definition at line 180 of file Image.h.

180 {}

Member Function Documentation

◆ BOOST_CONCEPT_ASSERT() [1/2]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::BOOST_CONCEPT_ASSERT ( (concepts::CImage< TImageContainer >) )

Checking concepts.

◆ BOOST_CONCEPT_ASSERT() [2/2]

template<typename TImageContainer >

DGtal::Image< TImageContainer >::BOOST_CONCEPT_ASSERT ( (concepts::CVertexMap< TImageContainer >) )

◆ constRange()

template<typename TImageContainer >

ConstRange DGtal::Image< TImageContainer >::constRange ( ) const

inline

Returns the range of the underlying image to iterate over its values

Returns: a range.

Examples: tutorial-examples/volDTGranulo.cpp.

Definition at line 203 of file Image.h.

     {
       return myImagePointer->constRange();
     }

References DGtal::Image< TImageContainer >::myImagePointer.

Referenced by test_image(), testImage(), and testImageFromSet().

◆ domain()

template<typename TImageContainer >

const Domain& DGtal::Image< TImageContainer >::domain ( ) const

inline

Returns a reference to the underlying image domain.

Returns: a reference to the domain.

Examples: tutorial-examples/volDTGranulo.cpp.

Definition at line 192 of file Image.h.

     {
       return myImagePointer->domain();
     }

References DGtal::Image< TImageContainer >::myImagePointer.

Referenced by DGtal::SetFromImage< TSet >::append(), generateRefImage(), main(), DGtal::ImageToConstantFunctor< Image, PointPredicate, TValue >::operator()(), test_image(), testConsistence(), testImage(), testImageOnRef(), testITKImageWithShiftDomain(), and testPNMReader().

◆ getPointer()

template<typename TImageContainer >

const ImagePointer DGtal::Image< TImageContainer >::getPointer ( ) const

inline

Returns the smart pointer on the Image container data.

Returns: a const ImagePointer.

Definition at line 276 of file Image.h.

     {
       return myImagePointer;
     }

References DGtal::Image< TImageContainer >::myImagePointer.

◆ isValid()

template<typename TImageContainer >

bool DGtal::Image< TImageContainer >::isValid ( ) const

inline

Checks the validity/consistency of the object.

Returns: 'true' if the object is valid, 'false' otherwise.

Definition at line 266 of file Image.h.

     {
       return (myImagePointer->isValid() );
     }

References DGtal::CowPtr< T >::isValid(), and DGtal::Image< TImageContainer >::myImagePointer.

Referenced by testImage().

◆ operator()()

template<typename TImageContainer >

Value DGtal::Image< TImageContainer >::operator() ( const Point & aPoint ) const

inline

Get the value of an image at a given position given by a Point.

Precondition: the point must be in the domain

Parameters

aPoint the point.

Returns: the value at aPoint.

Definition at line 231 of file Image.h.

     {
       return myImagePointer->operator()(aPoint);
     }

References aPoint(), and DGtal::Image< TImageContainer >::myImagePointer.

◆ operator=()

template<typename TImageContainer >

Image& DGtal::Image< TImageContainer >::operator= ( const Image< TImageContainer > & other )

inline

Assignment.

Parameters

other the object to copy.

Returns: a reference on 'this'.

Definition at line 163 of file Image.h.

     {
       #ifdef DEBUG_VERBOSE
  trace.warning() << "Image assignment "<<std::endl;
 #endif
       if (&other != this)
         {
           myImagePointer = other.myImagePointer;
         }
       return *this;
     }

References DGtal::Image< TImageContainer >::myImagePointer, DGtal::trace, and DGtal::Trace::warning().

◆ range()

template<typename TImageContainer >

Range DGtal::Image< TImageContainer >::range ( )

inline

Returns the range of the underlying image to iterate over its values

Returns: a range.

Examples: tutorial-examples/volDTGranulo.cpp.

Definition at line 214 of file Image.h.

     {
       return myImagePointer->range();
     }

References DGtal::Image< TImageContainer >::myImagePointer.

Referenced by testImage().

◆ selfDisplay()

template<typename TImageContainer >

void DGtal::Image< TImageContainer >::selfDisplay ( std::ostream & out ) const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

◆ setValue()

template<typename TImageContainer >

void DGtal::Image< TImageContainer >::setValue	(	const Point &	aPoint,
		const Value &	aValue
	)

inline

Set a value on an Image at a position specified by a Point.

Precondition: it must be a point in the image domain.

Parameters

aPoint	the point.
aValue	the value.

Examples: images/exampleRigidtransformation2d.cpp, images/exampleRigidtransformation3d.cpp, and tutorial-examples/volDTGranulo.cpp.

Definition at line 247 of file Image.h.

     {
       myImagePointer->setValue(aPoint,aValue);
     }

References aPoint(), and DGtal::Image< TImageContainer >::myImagePointer.

Referenced by for(), generateRefImage(), main(), SECTION(), testComparison(), testDisplayDT2d(), testDisplayDT3d(), testGetSetVal(), testITKImage(), testITKImageWithMetadata(), testITKImageWithShiftDomain(), and testITKMethod().

Field Documentation

◆ myImagePointer

template<typename TImageContainer >

ImagePointer DGtal::Image< TImageContainer >::myImagePointer

protected

Owning smart pointer on the image container.

Definition at line 287 of file Image.h.

Referenced by DGtal::Image< TImageContainer >::constRange(), DGtal::Image< TImageContainer >::domain(), DGtal::Image< TImageContainer >::getPointer(), DGtal::Image< TImageContainer >::isValid(), DGtal::Image< TImageContainer >::operator()(), DGtal::Image< TImageContainer >::operator=(), DGtal::Image< TImageContainer >::range(), and DGtal::Image< TImageContainer >::setValue().

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

Image.h

Public Types

Public Member Functions

Protected Attributes

Detailed Description

template<typename TImageContainer> class DGtal::Image< TImageContainer >

Member Typedef Documentation

◆ ConstRange

◆ Domain

◆ ImageContainer

◆ ImagePointer

◆ OutputIterator

◆ Point

◆ Range

◆ Value

Constructor & Destructor Documentation

◆ Image() [1/5]

◆ Image() [2/5]

◆ Image() [3/5]

◆ Image() [4/5]

◆ Image() [5/5]

◆ ~Image()

Member Function Documentation

◆ BOOST_CONCEPT_ASSERT() [1/2]

◆ BOOST_CONCEPT_ASSERT() [2/2]

◆ constRange()

◆ domain()

◆ getPointer()

◆ isValid()

◆ operator()()

◆ operator=()

◆ range()

◆ selfDisplay()

◆ setValue()

Field Documentation

◆ myImagePointer

template<typename TImageContainer>
class DGtal::Image< TImageContainer >