ClassesClassesClassesClasses | | | | Operators

nonmax_suppression_ampnonmax_suppression_ampNonmaxSuppressionAmpnonmax_suppression_ampNonmaxSuppressionAmpNonmaxSuppressionAmp (Operator)

Name

nonmax_suppression_ampnonmax_suppression_ampNonmaxSuppressionAmpnonmax_suppression_ampNonmaxSuppressionAmpNonmaxSuppressionAmp — Suppress non-maximum points on an edge.

Signature

nonmax_suppression_amp(ImgAmp : ImageResult : Mode : )

Herror nonmax_suppression_amp(const Hobject ImgAmp, Hobject* ImageResult, const char* Mode)

Herror T_nonmax_suppression_amp(const Hobject ImgAmp, Hobject* ImageResult, const Htuple Mode)

Herror nonmax_suppression_amp(Hobject ImgAmp, Hobject* ImageResult, const HTuple& Mode)

HImage HImage::NonmaxSuppressionAmp(const HTuple& Mode) const

HImageArray HImageArray::NonmaxSuppressionAmp(const HTuple& Mode) const

void NonmaxSuppressionAmp(const HObject& ImgAmp, HObject* ImageResult, const HTuple& Mode)

HImage HImage::NonmaxSuppressionAmp(const HString& Mode) const

HImage HImage::NonmaxSuppressionAmp(const char* Mode) const

void HOperatorSetX.NonmaxSuppressionAmp(
[in] IHUntypedObjectX* ImgAmp, [out] IHUntypedObjectX*ImageResult, [in] VARIANT Mode)

IHImageX* HImageX.NonmaxSuppressionAmp([in] BSTR Mode)

static void HOperatorSet.NonmaxSuppressionAmp(HObject imgAmp, out HObject imageResult, HTuple mode)

HImage HImage.NonmaxSuppressionAmp(string mode)

Description

nonmax_suppression_ampnonmax_suppression_ampNonmaxSuppressionAmpnonmax_suppression_ampNonmaxSuppressionAmpNonmaxSuppressionAmp suppresses all points in the regions of the image ImgAmpImgAmpImgAmpImgAmpImgAmpimgAmp whose gray values are not local (directed) maxima. In contrast to nonmax_suppression_dirnonmax_suppression_dirNonmaxSuppressionDirnonmax_suppression_dirNonmaxSuppressionDirNonmaxSuppressionDir, a direction image is not needed. Two modes of operation can be selected:

'hvnms'

A point is labeled as a local maximum if its gray value is larger than or equal to the gray values within a seach space of pm 5 pixels, either horizontally or vertically. Non-maximum points are removed from the region, gray values remain unchanged.

'loc_max'

A point is labeled as a local maximum if its gray value is larger than or equal to the gray values of its eight neighbors.

Parallelization

Parameters

ImgAmpImgAmpImgAmpImgAmpImgAmpimgAmp (input_object)  singlechannelimage(-array) objectHImageHImageHImageHImageXHobject (byte / uint2 / real)

Amplitude (gradient magnitude) image.

ImageResultImageResultImageResultImageResultImageResultimageResult (output_object)  singlechannelimage(-array) objectHImageHImageHImageHImageXHobject * (byte / uint2 / real)

Image with thinned edge regions.

ModeModeModeModeModemode (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Select horizontal/vertical or undirected NMS.

Default value: 'hvnms' "hvnms" "hvnms" "hvnms" "hvnms" "hvnms"

List of values: 'hvnms'"hvnms""hvnms""hvnms""hvnms""hvnms", 'loc_max'"loc_max""loc_max""loc_max""loc_max""loc_max"

Result

nonmax_suppression_ampnonmax_suppression_ampNonmaxSuppressionAmpnonmax_suppression_ampNonmaxSuppressionAmpNonmaxSuppressionAmp returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior with respect to the input images and output regions can be determined by setting the values of the flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result""no_object_result", 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result""empty_region_result", and 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region""store_empty_region" with set_systemset_systemSetSystemset_systemSetSystemSetSystem. If necessary, an exception is raised.

Possible Predecessors

sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp

Possible Successors

thresholdthresholdThresholdthresholdThresholdThreshold, hysteresis_thresholdhysteresis_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold

Alternatives

local_maxlocal_maxLocalMaxlocal_maxLocalMaxLocalMax, nonmax_suppression_dirnonmax_suppression_dirNonmaxSuppressionDirnonmax_suppression_dirNonmaxSuppressionDirNonmaxSuppressionDir

See also

skeletonskeletonSkeletonskeletonSkeletonSkeleton

References

S.Lanser: “Detektion von Stufenkanten mittels rekursiver Filter nach Deriche”; Diplomarbeit; Technische Universität München, Institut für Informatik, Lehrstuhl Prof. Radig; 1991.
J.Canny: “Finding Edges and Lines in Images”; Report, AI-TR-720; M.I.T. Artificial Intelligence Lab., Cambridge, MA; 1983.

Module

Foundation


ClassesClassesClassesClasses | | | | Operators