HALCON Reference Manual 10.0.2
Table of Contents / Filters / Match ClassesClassesClasses | | | Operators

monotonymonotonymonotonyMonotonyMonotony (Operator)

Name

monotonymonotonymonotonyMonotonyMonotony — Calculating the monotony operation.

Signature

monotony(Image : ImageMonotony : : )

Herror monotony(const Hobject Image, Hobject* ImageMonotony)

Herror T_monotony(const Hobject Image, Hobject* ImageMonotony)

Herror monotony(Hobject Image, Hobject* ImageMonotony)

HImage HImage::Monotony() const

HImageArray HImageArray::Monotony() const

void HOperatorSetX.Monotony(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImageMonotony)

IHImageX* HImageX.Monotony()

static void HOperatorSet.Monotony(HObject image, out HObject imageMonotony)

HImage HImage.Monotony()

Description

The operator monotonymonotonymonotonyMonotonyMonotony calculates the monotony operator. Thereby the points which are strictly smaller than the current grayvalue will be counted in the 8 neighborhood. This number will be entered into the output imaged.

If there is a strict maximum, the value 8 is returned; in case of a minimum or a plateau, the value 0 will be returned. A ridge or a slope will return the corresponding intermediate values.

The monotony operator is often used to prepare matching operations as it is invariant with regard to lightness modifications.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageXHobject (byte / int2 / uint2)

Input image.

ImageMonotonyImageMonotonyImageMonotonyImageMonotonyimageMonotony (output_object)  (multichannel-)image(-array) objectHImageHImageHImageXHobject * (byte / int2 / uint2)

Result of the monotony operator.

Number of elements: ImageMonotony == Image

Example (C)

/* searching the strict maximums */
gauss_image(Image,&Gauss,5);
monotony(Gauss,&Monotony);
threshold(Monotony,Maxima,8.0,8.0);

Possible Predecessors

binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, median_imagemedian_imagemedian_imageMedianImageMedianImage, mean_imagemean_imagemean_imageMeanImageMeanImage, smooth_imagesmooth_imagesmooth_imageSmoothImageSmoothImage, invert_imageinvert_imageinvert_imageInvertImageInvertImage

Possible Successors

thresholdthresholdthresholdThresholdThreshold, exhaustive_matchexhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatch, disp_imagedisp_imagedisp_imageDispImageDispImage

Alternatives

local_maxlocal_maxlocal_maxLocalMaxLocalMax, topographic_sketchtopographic_sketchtopographic_sketchTopographicSketchTopographicSketch, corner_responsecorner_responsecorner_responseCornerResponseCornerResponse

Module

Foundation


Table of Contents / Filters / Match ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH