Deprecated functions
VISP_EXPORT void	vp::unsharpMask (vpImage< unsigned char > &I, float sigma, double weight=0.6)

VISP_EXPORT void	vp::unsharpMask (const vpImage< unsigned char > &I, vpImage< unsigned char > &Ires, float sigma, double weight=0.6)

VISP_EXPORT void	vp::unsharpMask (vpImage< vpRGBa > &I, float sigma, double weight=0.6)

VISP_EXPORT void	vp::unsharpMask (const vpImage< vpRGBa > &I, vpImage< vpRGBa > &Ires, float sigma, double weight=0.6)

vp_deprecated VISP_EXPORT void	vp::unsharpMask (vpImage< unsigned char > &I, unsigned int size=7, double weight=0.6)

vp_deprecated VISP_EXPORT void	vp::unsharpMask (const vpImage< unsigned char > &I, vpImage< unsigned char > &Ires, unsigned int size=7, double weight=0.6)

vp_deprecated VISP_EXPORT void	vp::unsharpMask (vpImage< vpRGBa > &I, unsigned int size=7, double weight=0.6)

vp_deprecated VISP_EXPORT void	vp::unsharpMask (const vpImage< vpRGBa > &I, vpImage< vpRGBa > &Ires, unsigned int size=7, double weight=0.6)

VISP_EXPORT void	vp::connectedComponents (const vpImage< unsigned char > &I, vpImage< int > &labels, int &nbComponents, const vpImageMorphology::vpConnexityType &connexity=vpImageMorphology::CONNEXITY_4)

VISP_EXPORT void	vp::fillHoles (vpImage< unsigned char > &I)

VISP_EXPORT void	vp::floodFill (vpImage< unsigned char > &I, const vpImagePoint &seedPoint, const unsigned char oldValue, const unsigned char newValue, const vpImageMorphology::vpConnexityType &connexity=vpImageMorphology::CONNEXITY_4)

VISP_EXPORT void	vp::reconstruct (const vpImage< unsigned char > &marker, const vpImage< unsigned char > &mask, vpImage< unsigned char > &h_kp1, const vpImageMorphology::vpConnexityType &connexity=vpImageMorphology::CONNEXITY_4)

VISP_EXPORT unsigned char	vp::autoThreshold (vpImage< unsigned char > &I, const vp::vpAutoThresholdMethod &method, const unsigned char backgroundValue=0, const unsigned char foregroundValue=255)

Detailed Description

Image sharpening.

Function Documentation

◆ autoThreshold()

unsigned char vp::autoThreshold	(	vpImage< unsigned char > &	I,
		const vp::vpAutoThresholdMethod &	method,
		const unsigned char	backgroundValue = `0`,
		const unsigned char	foregroundValue = `255`
	)

Automatic thresholding.

Parameters

I	: Input grayscale image.
method	: Automatic thresholding method.
backgroundValue	: Value to set to the background.
foregroundValue	: Value to set to the foreground.

Examples: testAutoThreshold.cpp, tutorial-autothreshold.cpp, tutorial-contour.cpp, and tutorial-count-coins.cpp.

Definition at line 361 of file vpThreshold.cpp.

References vp::AUTO_THRESHOLD_HUANG, vp::AUTO_THRESHOLD_INTERMODES, vp::AUTO_THRESHOLD_ISODATA, vp::AUTO_THRESHOLD_MEAN, vp::AUTO_THRESHOLD_OTSU, vp::AUTO_THRESHOLD_TRIANGLE, vpImageTools::binarise(), and vpImage< Type >::getSize().

◆ connectedComponents()

void vp::connectedComponents	(	const vpImage< unsigned char > &	I,
		vpImage< int > &	labels,
		int &	nbComponents,
		const vpImageMorphology::vpConnexityType &	connexity = `vpImageMorphology::CONNEXITY_4`
	)

Perform connected components detection.

Parameters

I	: Input image (0 means background).
labels	: Label image that contain for each position the component label.
nbComponents	: Number of connected components.
connexity	: Type of connexity.

Examples: testConnectedComponents.cpp, and tutorial-connected-components.cpp.

Definition at line 107 of file vpConnectedComponents.cpp.

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

◆ fillHoles()

void vp::fillHoles ( vpImage< unsigned char > & I )

Fill the holes in a binary image.

Parameters

I	: Input binary image (0 means background, 255 means foreground).

Examples: testContours.cpp, and tutorial-count-coins.cpp.

Definition at line 45 of file vpMorph.cpp.

References vp::floodFill(), vpImage< Type >::getHeight(), vpImage< Type >::getSize(), vpImage< Type >::getWidth(), vpImageTools::imageAdd(), vpImageTools::imageSubtract(), and vp::reconstruct().

◆ floodFill()

void vp::floodFill	(	vpImage< unsigned char > &	I,
		const vpImagePoint &	seedPoint,
		const unsigned char	oldValue,
		const unsigned char	newValue,
		const vpImageMorphology::vpConnexityType &	connexity = `vpImageMorphology::CONNEXITY_4`
	)

Perform the flood fill algorithm.

Parameters

I	: Input image to flood fill.
seedPoint	: Seed position in the image.
oldValue	: Old value to replace.
newValue	: New value to flood fill.
connexity	: Type of connexity.

Examples: testFloodFill.cpp, and tutorial-flood-fill.cpp.

Definition at line 71 of file vpFloodFill.cpp.

References vpImageMorphology::CONNEXITY_4, vpImagePoint::get_i(), vpImagePoint::get_j(), vpImage< Type >::getHeight(), vpImage< Type >::getSize(), and vpImage< Type >::getWidth().

Referenced by vp::fillHoles().

◆ reconstruct()

void vp::reconstruct	(	const vpImage< unsigned char > &	marker,
		const vpImage< unsigned char > &	mask,
		vpImage< unsigned char > &	h_kp1,
		const vpImageMorphology::vpConnexityType &	connexity = `vpImageMorphology::CONNEXITY_4`
	)

Perform morphological reconstruction of the image marker under the image mask. Definition from Gleb V. Tcheslavsk: > The morphological reconstruction by dilation of a grayscale image $ g $ by a grayscale marker image $ f $ > is defined as the geodesic dilation of $ f $ with respect to $ g $ repeated (iterated) until stability is reached:

$R_{g}^{D} \left ( f \right ) = D_{g}^{\left ( k \right )} \left ( f \right )$

with $ k $ such that: $D_{g}^{\left ( k \right )} \left ( f \right ) = D_{g}^{\left ( k+1 \right )} \left ( f \right )$

Parameters

marker	: Grayscale image marker.
mask	: Grayscale image mask.
h_kp1	: Image morphologically reconstructed.
connexity	: Type of connexity.

Definition at line 119 of file vpMorph.cpp.

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

Referenced by vp::fillHoles().

◆ unsharpMask() [1/8]

void vp::unsharpMask	(	const vpImage< unsigned char > &	I,
		vpImage< unsigned char > &	Ires,
		float	sigma,
		double	weight = `0.6`
	)

Sharpen a grayscale image using the unsharp mask technique.

Parameters

I	: The input grayscale image.
Ires	: The output grayscale image.
sigma	: Standard deviation for Gaussian kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 468 of file vpImgproc.cpp.

References vp::unsharpMask().

◆ unsharpMask() [2/8]

void vp::unsharpMask	(	const vpImage< unsigned char > &	I1,
		vpImage< unsigned char > &	I2,
		unsigned int	size,
		double	weight
	)

Deprecated:: This function is deprecated. You should rather use unsharpMask() with sigma Gaussian parameter. You can use sigma = 1.0f to have similar results.

Sharpen a grayscale image using the unsharp mask technique.

Parameters

I1	: The first input grayscale image.
I2	: The second output grayscale image.
size	: Size (must be odd) of the Gaussian blur kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 544 of file vpImgproc.cpp.

References vpImage< Type >::bitmap, vpImageFilter::gaussianBlur(), vpImage< Type >::getSize(), vpMath::saturate(), and vp::unsharpMask().

◆ unsharpMask() [3/8]

void vp::unsharpMask	(	const vpImage< vpRGBa > &	I,
		vpImage< vpRGBa > &	Ires,
		float	sigma,
		double	weight = `0.6`
	)

Sharpen a color image using the unsharp mask technique.

Parameters

I	: The input color image.
Ires	: The output color image.
sigma	: Standard deviation for Gaussian kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 496 of file vpImgproc.cpp.

References vp::unsharpMask().

◆ unsharpMask() [4/8]

void vp::unsharpMask	(	const vpImage< vpRGBa > &	I1,
		vpImage< vpRGBa > &	I2,
		unsigned int	size,
		double	weight
	)

Deprecated:: This function is deprecated. You should rather use unsharpMask() with sigma Gaussian parameter. You can use sigma = 1.0f to have similar results.

Sharpen a color image using the unsharp mask technique.

Parameters

I1	: The first input color image.
I2	: The second output color image.
size	: Size (must be odd) of the Gaussian blur kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 618 of file vpImgproc.cpp.

References vpImage< Type >::bitmap, vpImageFilter::gaussianBlur(), vpImage< Type >::getSize(), vpMath::saturate(), vpImageConvert::split(), and vp::unsharpMask().

◆ unsharpMask() [5/8]

void vp::unsharpMask	(	vpImage< unsigned char > &	I,
		float	sigma,
		double	weight = `0.6`
	)

Sharpen a grayscale image using the unsharp mask technique.

Parameters

I	: The grayscale image to sharpen.
sigma	: Standard deviation for Gaussian kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 452 of file vpImgproc.cpp.

References vpGaussianFilter::apply(), vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getSize(), vpImage< Type >::getWidth(), and vpMath::saturate().

◆ unsharpMask() [6/8]

void vp::unsharpMask	(	vpImage< unsigned char > &	I,
		unsigned int	size,
		double	weight
	)

Deprecated:: This function is deprecated. You should rather use unsharpMask() with sigma Gaussian parameter. You can use sigma = 1.0f to have similar results.

Sharpen a grayscale image using the unsharp mask technique.

Parameters

I	: The grayscale image to sharpen.
size	: Size (must be odd) of the Gaussian blur kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Examples: testImgproc.cpp, and tutorial-contrast-sharpening.cpp.

Definition at line 516 of file vpImgproc.cpp.

References vpImage< Type >::bitmap, vpImageFilter::gaussianBlur(), vpImage< Type >::getSize(), and vpMath::saturate().

Referenced by vp::unsharpMask(), vp::unsharpMask(), vp::unsharpMask(), and vp::unsharpMask().

◆ unsharpMask() [7/8]

void vp::unsharpMask	(	vpImage< vpRGBa > &	I,
		float	sigma,
		double	weight = `0.6`
	)

Sharpen a color image using the unsharp mask technique.

Parameters

I	: The color image to sharpen.
sigma	: Standard deviation for Gaussian kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 475 of file vpImgproc.cpp.

References vpGaussianFilter::apply(), vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getSize(), vpImage< Type >::getWidth(), and vpMath::saturate().

◆ unsharpMask() [8/8]

void vp::unsharpMask	(	vpImage< vpRGBa > &	I,
		unsigned int	size,
		double	weight
	)

Deprecated:: This function is deprecated. You should rather use unsharpMask() with sigma Gaussian parameter. You can use sigma = 1.0f to have similar results.

Sharpen a color image using the unsharp mask technique.

Parameters

I	: The color image to sharpen.
size	: Size (must be odd) of the Gaussian blur kernel.
weight	: Weight (between [0 - 1[) for the sharpening process.

Definition at line 580 of file vpImgproc.cpp.

References vpImage< Type >::bitmap, vpImageFilter::gaussianBlur(), vpImage< Type >::getSize(), vpMath::saturate(), and vpImageConvert::split().

Deprecated functions

Detailed Description

Function Documentation

◆ autoThreshold()

◆ connectedComponents()

◆ fillHoles()

◆ floodFill()

◆ reconstruct()

◆ unsharpMask() [1/8]

◆ unsharpMask() [2/8]

◆ unsharpMask() [3/8]

◆ unsharpMask() [4/8]

◆ unsharpMask() [5/8]

◆ unsharpMask() [6/8]

◆ unsharpMask() [7/8]

◆ unsharpMask() [8/8]