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

points_lepetitT_points_lepetitpoints_lepetitPointsLepetitPointsLepetit (Operator)

Name

points_lepetitT_points_lepetitpoints_lepetitPointsLepetitPointsLepetit — Detect points of interest using the Lepetit operator.

Signature

points_lepetit(Image : : Radius, CheckNeighbor, MinCheckNeighborDiff, MinScore, Subpix : Row, Column)

Herror T_points_lepetit(const Hobject Image, const Htuple Radius, const Htuple CheckNeighbor, const Htuple MinCheckNeighborDiff, const Htuple MinScore, const Htuple Subpix, Htuple* Row, Htuple* Column)

Herror points_lepetit(Hobject Image, const HTuple& Radius, const HTuple& CheckNeighbor, const HTuple& MinCheckNeighborDiff, const HTuple& MinScore, const HTuple& Subpix, HTuple* Row, HTuple* Column)

HTuple HImage::PointsLepetit(const HTuple& Radius, const HTuple& CheckNeighbor, const HTuple& MinCheckNeighborDiff, const HTuple& MinScore, const HTuple& Subpix, HTuple* Column) const

void HOperatorSetX.PointsLepetit(
[in] IHUntypedObjectX* Image, [in] VARIANT Radius, [in] VARIANT CheckNeighbor, [in] VARIANT MinCheckNeighborDiff, [in] VARIANT MinScore, [in] VARIANT Subpix, [out] VARIANT* Row, [out] VARIANT* Column)

VARIANT HImageX.PointsLepetit(
[in] Hlong Radius, [in] Hlong CheckNeighbor, [in] Hlong MinCheckNeighborDiff, [in] Hlong MinScore, [in] BSTR Subpix, [out] VARIANT* Column)

static void HOperatorSet.PointsLepetit(HObject image, HTuple radius, HTuple checkNeighbor, HTuple minCheckNeighborDiff, HTuple minScore, HTuple subpix, out HTuple row, out HTuple column)

void HImage.PointsLepetit(int radius, int checkNeighbor, int minCheckNeighborDiff, int minScore, string subpix, out HTuple row, out HTuple column)

Description

points_lepetitpoints_lepetitpoints_lepetitPointsLepetitPointsLepetit extracts points of interest like corners or blob-like structures from ImageImageImageImageimage. The ImageImageImageImageimage is first smoothed with a median of size 3x3. Then, all the gray values on a circle with radius RadiusRadiusRadiusRadiusradius around an interest point candidate (m) are examined. The absolute differences of two diagonally opposed gray values (m1,m2) on the circle to the central pixel m is computed. At least one of these differences has to be larger than MinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffminCheckNeighborDiff. All diagonally opposed pixels on the circle must fulfill that condition. To suppress detection of points at edges that have a small curvature (aliasing), it is possible to compute CheckNeighborCheckNeighborCheckNeighborCheckNeighborcheckNeighbor further differences of circle point neighbors of m1 and m2 to the center, that as well fulfill the above criteria. By computing all gray value differences of the circle points to the center, a mean gray value difference is determined. That value has to be larger than MinScoreMinScoreMinScoreMinScoreminScore and allows to restrict the results to points with high contrast. By computing the score of all eight neighbors of m, it is possible to fit a quadratic equation to that. The maxima of that equation determines a subpixel accurate interest point position. By setting the parameter SubpixSubpixSubpixSubpixsubpix to 'true' or 'false' (default), it is possible to turn that refinement step on or off. The resulting points are returned in RowRowRowRowrow and ColumnColumnColumnColumncolumn. The operator points_lepetitpoints_lepetitpoints_lepetitPointsLepetitPointsLepetit can especially be used for very fast interest point extraction. The results are however less robust than points extracted by points_harrispoints_harrispoints_harrisPointsHarrisPointsHarris for example.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageXHobject (byte / uint2)

Input image.

RadiusRadiusRadiusRadiusradius (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Radius of the circle.

Default value: 3

List of values: 3, 5, 6, 7, 8, 9, 10, 15

CheckNeighborCheckNeighborCheckNeighborCheckNeighborcheckNeighbor (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of checked neighbors on the circle.

Default value: 1

List of values: 1, 2, 3, 5

MinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffMinCheckNeighborDiffminCheckNeighborDiff (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Threshold of grayvalue difference to each circle point.

Default value: 15

List of values: 10, 15, 20, 25, 30, 35, 40, 45, 60, 80

MinScoreMinScoreMinScoreMinScoreminScore (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Threshold of grayvalue difference to all circle points.

Default value: 30

List of values: 5, 10, 15, 20, 25, 30

SubpixSubpixSubpixSubpixsubpix (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Subpixel accuracy of point coordinates.

Default value: 'interpolation' "interpolation" "interpolation" "interpolation" "interpolation"

List of values: 'none'"none""none""none""none", 'interpolation'"interpolation""interpolation""interpolation""interpolation"

RowRowRowRowrow (output_control)  point.y-array HTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double)

Row-coordinates of the detected points.

ColumnColumnColumnColumncolumn (output_control)  point.x-array HTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double)

Column-coordinates of the detected points.

Possible Predecessors

gauss_imagegauss_imagegauss_imageGaussImageGaussImage

Alternatives

points_foerstnerpoints_foerstnerpoints_foerstnerPointsFoerstnerPointsFoerstner, points_harrispoints_harrispoints_harrisPointsHarrisPointsHarris, points_harris_binomialpoints_harris_binomialpoints_harris_binomialPointsHarrisBinomialPointsHarrisBinomial, points_sojkapoints_sojkapoints_sojkaPointsSojkaPointsSojka

Module

Foundation


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