local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXld (Operator)
Name
local_max_contours_xldlocal_max_contours_xldLocalMaxContoursXldLocalMaxContoursXld — Select XLD contours with a local maximum of gray values.
Signature
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)
void LocalMaxContoursXld(const HObject& Contours, const HObject& Image, HObject* LocalMaxContours, const HTuple& MinPercent, const HTuple& MinDiff, const HTuple& Distance)
HXLDCont HXLDCont::LocalMaxContoursXld(const HImage& Image, const HTuple& MinPercent, Hlong MinDiff, Hlong Distance) const
HXLDCont HXLDCont::LocalMaxContoursXld(const HImage& Image, Hlong MinPercent, Hlong MinDiff, Hlong Distance) const
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_xldLocalMaxContoursXldLocalMaxContoursXldLocalMaxContoursXld 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.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ContoursContoursContoursContourscontours (input_object) xld_cont-array → objectHXLDContHXLDContHobject
XLD contours to be examined.
ImageImageImageImageimage (input_object) singlechannelimage → objectHImageHImageHobject (byte)
Corresponding gray value image.
LocalMaxContoursLocalMaxContoursLocalMaxContoursLocalMaxContourslocalMaxContours (output_object) xld_cont-array → objectHXLDContHXLDContHobject *
Selected contours.
MinPercentMinPercentMinPercentMinPercentminPercent (input_control) number → HTupleHTupleHtuple (integer / real) (int / long / 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 → HTupleHTupleHtuple (integer) (int / long) (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 → HTupleHTupleHtuple (integer) (int / long) (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_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld,
lines_gausslines_gaussLinesGaussLinesGaussLinesGauss,
lines_facetlines_facetLinesFacetLinesFacetLinesFacet,
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix
Possible Successors
gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXld
See also
smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldSmoothContoursXld
Module
Foundation