Visual Servoing Platform  version 3.5.1 under development (2023-06-04)

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 > &I, 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 374 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 119 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 54 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 85 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 145 of file vpMorph.cpp.

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

Referenced by vp::fillHoles().

◆ unsharpMask() [1/8]

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

Sharpen a grayscale image using the unsharp mask technique.

Parameters
I1: The first input grayscale image.
I2: The second output grayscale image.
sigma: Standard deviation for Gaussian kernel.
weight: Weight (between [0 - 1[) for the sharpening process.

Definition at line 651 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 = 7,
double  weight = 0.6 
)
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 746 of file vpImgproc.cpp.

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

◆ unsharpMask() [3/8]

void vp::unsharpMask ( const vpImage< vpRGBa > &  I1,
vpImage< vpRGBa > &  I2,
float  sigma,
double  weight = 0.6 
)

Sharpen a color image using the unsharp mask technique.

Parameters
I1: The first input color image.
I2: The second output color image.
sigma: Standard deviation for Gaussian kernel.
weight: Weight (between [0 - 1[) for the sharpening process.

Definition at line 698 of file vpImgproc.cpp.

References vp::unsharpMask().

◆ unsharpMask() [4/8]

void vp::unsharpMask ( const vpImage< vpRGBa > &  I1,
vpImage< vpRGBa > &  I2,
unsigned int  size = 7,
double  weight = 0.6 
)
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 820 of file vpImgproc.cpp.

References vpRGBa::B, vpImage< Type >::bitmap, vpRGBa::G, vpImageFilter::gaussianBlur(), vpImage< Type >::getSize(), vpRGBa::R, 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 625 of file vpImgproc.cpp.

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

◆ unsharpMask() [6/8]

void vp::unsharpMask ( vpImage< unsigned char > &  I,
unsigned int  size = 7,
double  weight = 0.6 
)
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 718 of file vpImgproc.cpp.

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

Referenced by 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 667 of file vpImgproc.cpp.

References vpGaussianFilter::apply(), vpRGBa::B, vpImage< Type >::bitmap, vpRGBa::G, vpImage< Type >::getHeight(), vpImage< Type >::getSize(), vpImage< Type >::getWidth(), and vpRGBa::R.

◆ unsharpMask() [8/8]

void vp::unsharpMask ( vpImage< vpRGBa > &  I,
unsigned int  size = 7,
double  weight = 0.6 
)
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 782 of file vpImgproc.cpp.

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