HALCON Reference Manual 10.0.2
Table of Contents / XLD / Features ClassesClassesClasses | | | Operators

local_max_contours_xldlocal_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXld (Operator)

Name

local_max_contours_xldlocal_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXld — Select XLD contours with a local maximum of gray values.

Signature

local_max_contours_xld(Contours, Image : LocalMaxContours : MinPercent, MinDiff, Distance : )

Herror local_max_contours_xld(const Hobject Contours, const Hobject Image, Hobject* LocalMaxContours, const Hlong MinPercent, const Hlong MinDiff, const Hlong Distance)

Herror T_local_max_contours_xld(const Hobject Contours, const Hobject Image, Hobject* LocalMaxContours, const Htuple MinPercent, const Htuple MinDiff, const Htuple Distance)

Herror local_max_contours_xld(Hobject Contours, Hobject Image, Hobject* LocalMaxContours, const HTuple& MinPercent, const HTuple& MinDiff, const HTuple& Distance)

HXLDContArray HXLDContArray::LocalMaxContoursXld(const HImage& Image, const HTuple& MinPercent, const HTuple& MinDiff, const HTuple& Distance) const

void HOperatorSetX.LocalMaxContoursXld(
[in] IHUntypedObjectX* Contours, [in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** LocalMaxContours, [in] VARIANT MinPercent, [in] VARIANT MinDiff, [in] VARIANT Distance)

IHXLDContX* HXLDContX.LocalMaxContoursXld(
[in] IHImageX* Image, [in] VARIANT MinPercent, [in] Hlong MinDiff, [in] Hlong Distance)

static void HOperatorSet.LocalMaxContoursXld(HObject contours, HObject image, out HObject localMaxContours, HTuple minPercent, HTuple minDiff, HTuple distance)

HXLDCont HXLDCont.LocalMaxContoursXld(HImage image, HTuple minPercent, int minDiff, int distance)

HXLDCont HXLDCont.LocalMaxContoursXld(HImage image, int minPercent, int minDiff, int distance)

Description

local_max_contours_xldlocal_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXld selects XLD contours from the contours passed in ContoursContoursContoursContourscontours, which have a local maximum in gray values across the direction of the contour. In order to be selected, at least MinPercentMinPercentMinPercentMinPercentminPercent of the contour points must have a local maximum perpendicular to the direction of the contour. The contours' direction is determined by fitting a regression line through five neighboring points of the contour. In order to decide whether there is a local maximum for a contour point, a gray value profile that is DistanceDistanceDistanceDistancedistance points wide and perpendicular to the contour is computed on both sides of the contour. If the gray value at the contour point is at least MinDiffMinDiffMinDiffMinDiffminDiff larger than the gray value at at least one point on each side of the profile, the contour point is labeled as a local maximum. The selected contours are returned in LocalMaxContoursLocalMaxContoursLocalMaxContoursLocalMaxContourslocalMaxContours.

Parallelization

Parameters

ContoursContoursContoursContourscontours (input_object)  xld_cont-array → objectHXLDContHXLDContArrayHXLDContXHobject

XLD contours to be examined.

ImageImageImageImageimage (input_object)  image → objectHImageHImageHImageXHobject (byte)

Corresponding gray value image.

LocalMaxContoursLocalMaxContoursLocalMaxContoursLocalMaxContourslocalMaxContours (output_object)  xld_cont-array → objectHXLDContHXLDContArrayHXLDContXHobject *

Selected contours.

MinPercentMinPercentMinPercentMinPercentminPercent (input_control)  number → HTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double)

Minimum percentage of maximum points.

Default value: 70

Suggested values: 60, 70, 75, 80, 85, 90, 95

Restriction: (0.0 <= MinPercent) && (MinPercent <= 100.0)

MinDiffMinDiffMinDiffMinDiffminDiff (input_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Minimum amount by which the gray value at the maximum must be larger than in the profile.

Default value: 15

Suggested values: 5, 8, 10, 12, 15, 20

Restriction: (0 <= MinDiff) && (MinDiff <= 255)

DistanceDistanceDistanceDistancedistance (input_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Maximum width of profile used to check for maxima.

Default value: 4

Suggested values: 2, 3, 4, 5, 6

Restriction: Distance >= 1

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, lines_gausslines_gausslines_gaussLinesGaussLinesGauss, lines_facetlines_facetlines_facetLinesFacetLinesFacet, edges_sub_pixedges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPix

Possible Successors

gen_polygons_xldgen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXld

See also

smooth_contours_xldsmooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXld

Module

Foundation

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