Aim: A utility class for constructing different shapes (balls, diamonds, and others). More...

#include <DGtal/shapes/Shapes.h>

Public Types
typedef TDomain	Domain
typedef Domain::Space	Space
typedef Domain::Space::RealPoint	RealPoint
typedef Domain::Point	Point
typedef Domain::Vector	Vector
typedef Domain::Predicate	Predicate
typedef Domain::ConstIterator	ConstIterator
typedef Space::Integer	Integer
typedef Space::UnsignedInteger	UnsignedInteger

Public Member Functions
	~Shapes ()
void	selfDisplay (std::ostream &out) const
bool	isValid () const

Static Public Member Functions
template<typename TDigitalSet, typename TShapeFunctor>
static void	digitalShaper (TDigitalSet &aSet, const TShapeFunctor &aFunctor)
template<typename TDigitalSet, typename TShapeFunctor>
static void	euclideanShaper (TDigitalSet &aSet, const TShapeFunctor &aFunctor, const double h=1.0)
template<typename DigitalSet, typename PointPredicate>
static void	makeSetFromPointPredicate (DigitalSet &aSet, const PointPredicate &aPP)
template<typename TDigitalSet>
static void	addNorm1Ball (TDigitalSet &aSet, const Point &aCenter, UnsignedInteger aRadius)
template<typename TDigitalSet>
static void	addNorm2Ball (TDigitalSet &aSet, const Point &aCenter, UnsignedInteger aRadius)
template<typename TDigitalSet>
static void	removeNorm1Ball (TDigitalSet &aSet, const Point &aCenter, UnsignedInteger aRadius)
template<typename TDigitalSet>
static void	removeNorm2Ball (TDigitalSet &aSet, const Point &aCenter, UnsignedInteger aRadius)

Protected Member Functions
	Shapes ()

Private Member Functions
	BOOST_CONCEPT_ASSERT ((concepts::CDomain< TDomain >))
	Shapes (const Shapes &other)
Shapes &	operator= (const Shapes &other)

Detailed Description

template<typename TDomain>
class DGtal::Shapes< TDomain >

Aim: A utility class for constructing different shapes (balls, diamonds, and others).

Description of template class 'Shapes'

Template Parameters

TDomain the type of the domain in which shapes are created.

Definition at line 71 of file DGtal/shapes/Shapes.h.

Member Typedef Documentation

◆ ConstIterator

template<typename TDomain>

typedef Domain::ConstIterator DGtal::Shapes< TDomain >::ConstIterator

Definition at line 84 of file DGtal/shapes/Shapes.h.

◆ Domain

template<typename TDomain>

typedef TDomain DGtal::Shapes< TDomain >::Domain

Definition at line 78 of file DGtal/shapes/Shapes.h.

◆ Integer

template<typename TDomain>

typedef Space::Integer DGtal::Shapes< TDomain >::Integer

Definition at line 86 of file DGtal/shapes/Shapes.h.

◆ Point

template<typename TDomain>

typedef Domain::Point DGtal::Shapes< TDomain >::Point

Definition at line 81 of file DGtal/shapes/Shapes.h.

◆ Predicate

template<typename TDomain>

typedef Domain::Predicate DGtal::Shapes< TDomain >::Predicate

Definition at line 83 of file DGtal/shapes/Shapes.h.

◆ RealPoint

template<typename TDomain>

typedef Domain::Space::RealPoint DGtal::Shapes< TDomain >::RealPoint

Definition at line 80 of file DGtal/shapes/Shapes.h.

◆ Space

template<typename TDomain>

typedef Domain::Space DGtal::Shapes< TDomain >::Space

Definition at line 79 of file DGtal/shapes/Shapes.h.

◆ UnsignedInteger

template<typename TDomain>

typedef Space::UnsignedInteger DGtal::Shapes< TDomain >::UnsignedInteger

Definition at line 87 of file DGtal/shapes/Shapes.h.

◆ Vector

template<typename TDomain>

typedef Domain::Vector DGtal::Shapes< TDomain >::Vector

Definition at line 82 of file DGtal/shapes/Shapes.h.

Constructor & Destructor Documentation

◆ ~Shapes()

template<typename TDomain>

DGtal::Shapes< TDomain >::~Shapes ( )

Destructor.

◆ Shapes() [1/2]

template<typename TDomain>

DGtal::Shapes< TDomain >::Shapes ( )

protected

Constructor. Forbidden by default (protected to avoid g++ warnings).

Referenced by operator=(), and Shapes().

◆ Shapes() [2/2]

template<typename TDomain>

DGtal::Shapes< TDomain >::Shapes ( const Shapes< TDomain > & other )

private

Copy constructor.

Parameters

other the object to clone. Forbidden by default.

References Shapes().

Member Function Documentation

◆ addNorm1Ball()

template<typename TDomain>

template<typename TDigitalSet>

void DGtal::Shapes< TDomain >::addNorm1Ball	(	TDigitalSet &	aSet,
		const Point &	aCenter,
		UnsignedInteger	aRadius )

static

Adds the discrete ball (norm-1) of center [aCenter] and radius [aRadius] to the (perhaps non empty) set [aSet].

Warning: deprecated Use implicitShaper instead.

Template Parameters

TDigitalSet the type chosen for the digital set.

Parameters

aSet	the set (modified) which will contain the discrete ball.
aCenter	the center of the ball.
aRadius	the radius of the ball.

Examples: graph/graphTraversal.cpp, io/boards/dgtalBoard2D-2-sets.cpp, io/boards/dgtalBoard2D-4-colormaps.cpp, io/viewers/viewer3D-2-sets.cpp, and io/viewers/viewer3D-3-objects.cpp.

Referenced by main(), main(), main(), Objects2D::Objects2D(), testBreadthFirstPropagation(), testDepthFirstPropagation(), testDistancePropagation(), testSetTable(), testSimplePoints2D(), and testSurfelAdjacency().

◆ addNorm2Ball()

template<typename TDomain>

template<typename TDigitalSet>

void DGtal::Shapes< TDomain >::addNorm2Ball	(	TDigitalSet &	aSet,
		const Point &	aCenter,
		UnsignedInteger	aRadius )

static

Adds the discrete ball (norm-2) of center [aCenter] and radius [aRadius] to the (perhaps non empty) set [aSet].

Warning: deprecated Use implicitShaper instead.

Template Parameters

TDigitalSet the type chosen for the digital set.

Parameters

aSet	the set (modified) which will contain the discrete ball.
aCenter	the center of the ball.
aRadius	the radius of the ball.

Examples: graph/graphTraversal.cpp, io/viewers/viewer3D-2-sets.cpp, io/viewers/viewer3D-3-objects.cpp, io/viewers/viewer3D-6-clipping.cpp, topology/area-estimation-with-digital-surface.cpp, and topology/area-estimation-with-indexed-digital-surface.cpp.

Referenced by main(), main(), SCENARIO(), SCENARIO(), SCENARIO(), SCENARIO(), SCENARIO(), SCENARIO(), testBreadthFirstPropagation(), testDepthFirstPropagation(), testDigitalSetBoundary(), testDigitalSurface(), testDistancePropagation(), testFindABel(), and testKanungo2D().

◆ BOOST_CONCEPT_ASSERT()

template<typename TDomain>

DGtal::Shapes< TDomain >::BOOST_CONCEPT_ASSERT ( (concepts::CDomain< TDomain >) )

private

◆ digitalShaper()

template<typename TDomain>

template<typename TDigitalSet, typename TShapeFunctor>

void DGtal::Shapes< TDomain >::digitalShaper	(	TDigitalSet &	aSet,
		const TShapeFunctor &	aFunctor )

static

Adds to the (perhaps non empty) set [aSet] an shape defined by an instance of ShapeFunctor. Add Points where orientation is inside. The shape functor must be a model of CDigitalOrientedShape and CDigitalBoundedShape.

Parameters

aSet	the set (modified) which will contain the shape.
aFunctor	a functor defining the shape.

Template Parameters

TDigitalSet	a model of CDigitalSet.
TShapeFunctor	a model of CDigitalBoundedShape and CDigitalOrientedShape.

Examples: shapes/exampleEuclideanShapesDecorator.cpp, and topology/digitalSetToCubicalComplexes2D.cpp.

Referenced by testDigitalSetToCellularGridConverter::extractCells(), getComplex(), main(), main(), and testDigitization().

◆ euclideanShaper()

template<typename TDomain>

template<typename TDigitalSet, typename TShapeFunctor>

void DGtal::Shapes< TDomain >::euclideanShaper	(	TDigitalSet &	aSet,
		const TShapeFunctor &	aFunctor,
		const double	h = 1.0 )

static

Adds to the (perhaps non empty) set [aSet] an shape defined by an instance of ShapeFunctor. Add Points where orientation is inside. The shape functor must be a model of CEuclideanOrientedShape and CEuclideanBoundedShape. The underlying digitization process is a Gauss Digitizer with grid step h.

Parameters

aSet	the set (modified) which will contain the shape.
aFunctor	a functor defining the shape.
h	grid step for the Gauss digitization.

Template Parameters

TDigitalSet	a model of CDigitalSet.
TShapeFunctor	a model of CEuclideanBoundedShape and CEuclideanOrientedShape.

Examples: geometry/tools/exampleAlphaShape.cpp, and geometry/tools/exampleConvexHull2D.cpp.

Referenced by alphaShape(), convexHull(), main(), testDTFromSet(), testImplicitShape(), and testImplicitShape3D().

◆ isValid()

template<typename TDomain>

bool DGtal::Shapes< TDomain >::isValid ( ) const

Checks the validity/consistency of the object.

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

◆ makeSetFromPointPredicate()

template<typename TDomain>

template<typename DigitalSet, typename PointPredicate>

void DGtal::Shapes< TDomain >::makeSetFromPointPredicate	(	DigitalSet &	aSet,
		const PointPredicate &	aPP )

static

Add to the set aSet the points of the domain that satisfies the predicate aPP.

Parameters

aSet	(modified) the digital set that will contain the points.
aPP	a predicate on point.

Template Parameters

DigitalSet	a model of CDigitalSet such that DigitalSet::Domain is Domain.
PointPredicate	a model of concepts::CPointPredicate such that PointPredicate::Point is Point.

Examples: arithmetic/lower-integer-convex-hull.cpp.

Referenced by checkCut(), checkOutputConvexHullBorder(), main(), specificTestLatticePolytope2D(), and testLatticePolytope2D().

◆ operator=()

template<typename TDomain>

Shapes & DGtal::Shapes< TDomain >::operator= ( const Shapes< TDomain > & other )

private

Assignment.

Parameters

other the object to copy.

Returns: a reference on 'this'. Forbidden by default.

References Shapes().

◆ removeNorm1Ball()

template<typename TDomain>

template<typename TDigitalSet>

void DGtal::Shapes< TDomain >::removeNorm1Ball	(	TDigitalSet &	aSet,
		const Point &	aCenter,
		UnsignedInteger	aRadius )

static

Removes the discrete ball (norm-1) of center [aCenter] and radius [aRadius] to the (perhaps non empty) set [aSet].

Template Parameters

TDigitalSet the type chosen for the digital set.

Parameters

aSet	the set (modified) which will contain the discrete ball.
aCenter	the center of the ball.
aRadius	the radius of the ball.

◆ removeNorm2Ball()

template<typename TDomain>

template<typename TDigitalSet>

void DGtal::Shapes< TDomain >::removeNorm2Ball	(	TDigitalSet &	aSet,
		const Point &	aCenter,
		UnsignedInteger	aRadius )

static

Removes the discrete ball (norm-2) of center [aCenter] and radius [aRadius] to the (perhaps non empty) set [aSet].

Template Parameters

TDigitalSet the type chosen for the digital set.

Parameters

aSet	the set (modified) which will contain the discrete ball.
aCenter	the center of the ball.
aRadius	the radius of the ball.

Referenced by testDigitalSetBoundary(), and testDigitalSurface().

◆ selfDisplay()

template<typename TDomain>

void DGtal::Shapes< TDomain >::selfDisplay ( std::ostream & out ) const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

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

DGtal/shapes/Shapes.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Detailed Description

Member Typedef Documentation

◆ ConstIterator

◆ Domain

◆ Integer

◆ Point

◆ Predicate

◆ RealPoint

◆ Space

◆ UnsignedInteger

◆ Vector

Constructor & Destructor Documentation

◆ ~Shapes()

◆ Shapes() [1/2]

◆ Shapes() [2/2]

Member Function Documentation

◆ addNorm1Ball()

◆ addNorm2Ball()

◆ BOOST_CONCEPT_ASSERT()

◆ digitalShaper()

◆ euclideanShaper()

◆ isValid()

◆ makeSetFromPointPredicate()

◆ operator=()

◆ removeNorm1Ball()

◆ removeNorm2Ball()

◆ selfDisplay()