#include <vpImageMorphology.h>

Public Types
enum	vpConnexityType { CONNEXITY_4 , CONNEXITY_8 }

Static Public Member Functions
template<class Type >
static void	erosion (vpImage< Type > &I, Type value, Type value_out, vpConnexityType connexity=CONNEXITY_4)

template<class Type >
static void	dilatation (vpImage< Type > &I, Type value, Type value_out, vpConnexityType connexity=CONNEXITY_4)

template<typename T >
static void	erosion (vpImage< T > &I, const vpConnexityType &connexity=CONNEXITY_4)

template<typename T >
static void	dilatation (vpImage< T > &I, const vpConnexityType &connexity=CONNEXITY_4)

Deprecated functions
static vp_deprecated void	erosion (vpImage< unsigned char > &I, const vpConnexityType &connexity=CONNEXITY_4)

static vp_deprecated void	dilatation (vpImage< unsigned char > &I, const vpConnexityType &connexity=CONNEXITY_4)

Detailed Description

Various mathematical morphology tools, erosion, dilatation...

Author: Fabien Spindler (Fabie.nosp@m.n.Sp.nosp@m.indle.nosp@m.r@ir.nosp@m.isa.f.nosp@m.r) Irisa / Inria Rennes

Definition at line 62 of file vpImageMorphology.h.

Member Enumeration Documentation

◆ vpConnexityType

enum vpImageMorphology::vpConnexityType

Type of connexity 4, or 8.

Enumerator
CONNEXITY_4	For a given pixel 4 neighbors are considered (left, right, up, down)
CONNEXITY_8	For a given pixel 8 neighbors are considered (left, right, up, down, and the 4 pixels located on the diagonal)

Examples: tutorial-connected-components.cpp.

Definition at line 68 of file vpImageMorphology.h.

Member Function Documentation

◆ dilatation() [1/3]

template<typename T >

void vpImageMorphology::dilatation	(	vpImage< T > &	I,
		const vpConnexityType &	connexity = `CONNEXITY_4`
	)

static

Dilate an image using the given structuring element.

The dilatation of $A \left( x, y \right)$ by $B \left (x, y \right)$ is defined as:

$\left ( A \oplus B \right ) \left( x,y \right) = \textbf{max} \left \{ A \left ( x-x', y-y' \right ) + B \left ( x', y'\right ) | \left ( x', y'\right ) \subseteq D_B \right \}$

where $ D_B $ is the domain of the structuring element $ B $ and $A \left( x,y \right)$ is assumed to be $- \infty$ outside the domain of the image.

In our case, the dilatation is performed with a flat structuring element $\left( B \left( x,y \right) = 0 \right)$ . The dilatation using such a structuring element is equivalent to a local-maximum operator:

$\left ( A \oplus B \right ) \left( x,y \right) = \textbf{max} \left \{ A \left ( x-x', y-y' \right ) | \left ( x', y'\right ) \subseteq D_B \right \}$

Parameters

I	: Image to process.
connexity	: Type of connexity: 4 or 8.

See also: erosion(vpImage<unsigned char> &, const vpConnexityType &)

Definition at line 387 of file vpImageMorphology.h.

◆ dilatation() [2/3]

template<class Type >

void vpImageMorphology::dilatation	(	vpImage< Type > &	I,
		Type	value,
		Type	value_out,
		vpConnexityType	connexity = `CONNEXITY_4`
	)

static

Dilate a binary image using a structuring element of size one.

Parameters

I	: Image to process.
value	: Values of the pixels to dilate.
value_out	: Value to set if dilatation is done.
connexity	: Type of connexity: 4 or 8.

To dilate a black area in an unsigned char image with one element mask, set value to 0 and value_out to 255.

To dilate a white area in an unsigned char image with one element mask, set value to 255 and value_out to 0.

See also: erosion()

Examples: testImageMorphology.cpp.

Definition at line 234 of file vpImageMorphology.h.

References CONNEXITY_4, vpImage< Type >::getHeight(), vpImage< Type >::getSize(), and vpImage< Type >::getWidth().

◆ dilatation() [3/3]

static vp_deprecated void vpImageMorphology::dilatation	(	vpImage< unsigned char > &	I,
		const vpConnexityType &	connexity = `CONNEXITY_4`
	)

inlinestatic

A dilatation is performed with a flat structuring element $\left( B \left( x,y \right) = 0 \right)$ . The erosion using such a structuring element is equivalent to a local-maximum operator:

$\left ( A \ominus B \right ) \left( x,y \right) = \textbf{max} \left \{ A \left ( x+x', y+y' \right ) | \left ( x', y'\right ) \subseteq D_B \right \}$

Deprecated:: Provided only for compat with previous releases. Use rather the template function dilatation(vpImage<T> &, const vpConnexityType &)

Parameters

I	: Gray-scale image to process.
connexity	: Type of connexity: 4 or 8.

Definition at line 138 of file vpImageMorphology.h.

◆ erosion() [1/3]

template<typename T >

void vpImageMorphology::erosion	(	vpImage< T > &	I,
		const vpConnexityType &	connexity = `CONNEXITY_4`
	)

static

Erode an image using the given structuring element.

The erosion of $A \left( x, y \right)$ by $B \left (x, y \right)$ is defined as:

$\left ( A \ominus B \right ) \left( x,y \right) = \textbf{min} \left \{ A \left ( x+x', y+y' \right ) - B \left ( x', y'\right ) | \left ( x', y'\right ) \subseteq D_B \right \}$

where $ D_B $ is the domain of the structuring element $ B $ and $A \left( x,y \right)$ is assumed to be $+ \infty$ outside the domain of the image.

In our case, the erosion is performed with a flat structuring element $\left( B \left( x,y \right) = 0 \right)$ . The erosion using such a structuring element is equivalent to a local-minimum operator:

$\left ( A \ominus B \right ) \left( x,y \right) = \textbf{min} \left \{ A \left ( x+x', y+y' \right ) | \left ( x', y'\right ) \subseteq D_B \right \}$

Parameters

I	: Image to process.
connexity	: Type of connexity: 4 or 8.

See also: dilatation(vpImage<unsigned char> &, const vpConnexityType &)

Definition at line 357 of file vpImageMorphology.h.

◆ erosion() [2/3]

template<class Type >

void vpImageMorphology::erosion	(	vpImage< Type > &	I,
		Type	value,
		Type	value_out,
		vpConnexityType	connexity = `CONNEXITY_4`
	)

static

Erode a binary image using a structuring element of size one.

Parameters

I	: Image to process.
value	: Values of the pixels to erode.
value_out	: Value to set if erosion is done.
connexity	: Type of connexity: 4 or 8.

To erode a black area in an unsigned char image, set value to 0 and value_out to 255.

To erode a white area in an unsigned char image with one element mask, set value to 255 and value_out to 0.

See also: dilatation()

Examples: testImageMorphology.cpp.

Definition at line 164 of file vpImageMorphology.h.

References CONNEXITY_4, vpImage< Type >::getHeight(), vpImage< Type >::getSize(), and vpImage< Type >::getWidth().

◆ erosion() [3/3]

static vp_deprecated void vpImageMorphology::erosion	(	vpImage< unsigned char > &	I,
		const vpConnexityType &	connexity = `CONNEXITY_4`
	)

inlinestatic

An erosion is performed with a flat structuring element $\left( B \left( x,y \right) = 0 \right)$ . The erosion using such a structuring element is equivalent to a local-minimum operator:

$\left ( A \ominus B \right ) \left( x,y \right) = \textbf{min} \left \{ A \left ( x+x', y+y' \right ) | \left ( x', y'\right ) \subseteq D_B \right \}$

Deprecated:: Provided only for compat with previous releases. Use rather the template function erosion(vpImage<T> &, const vpConnexityType &)

Parameters

I	: Gray-scale image to process.
connexity	: Type of connexity: 4 or 8.

Definition at line 121 of file vpImageMorphology.h.

Public Types

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ vpConnexityType

Member Function Documentation

◆ dilatation() [1/3]

◆ dilatation() [2/3]

◆ dilatation() [3/3]

◆ erosion() [1/3]

◆ erosion() [2/3]

◆ erosion() [3/3]