HALCON Reference Manual 10.0.2
Table of Contents / Matching / Gray-Value-Based ClassesClassesClasses | | | Operators

best_match_pre_mgbest_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMg (Operator)

Name

best_match_pre_mgbest_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMg — Searching the best grayvalue matches in a pre generated pyramid.

Signature

best_match_pre_mg(ImagePyramid : : TemplateID, MaxError, SubPixel, NumLevels, WhichLevels : Row, Column, Error)

Herror best_match_pre_mg(const Hobject ImagePyramid, const Hlong TemplateID, double MaxError, const char* SubPixel, const Hlong NumLevels, const Hlong WhichLevels, double* Row, double* Column, double* Error)

Herror T_best_match_pre_mg(const Hobject ImagePyramid, const Htuple TemplateID, const Htuple MaxError, const Htuple SubPixel, const Htuple NumLevels, const Htuple WhichLevels, Htuple* Row, Htuple* Column, Htuple* Error)

Herror best_match_pre_mg(Hobject ImagePyramid, const HTuple& TemplateID, const HTuple& MaxError, const HTuple& SubPixel, const HTuple& NumLevels, const HTuple& WhichLevels, double* Row, double* Column, double* Error)

double HImageArray::BestMatchPreMg(const HTemplate& TemplateID, const HTuple& MaxError, const HTuple& SubPixel, const HTuple& NumLevels, const HTuple& WhichLevels, HTuple* Column, HTuple* Error) const

double HTemplate::BestMatchPreMg(const HImageArray& ImagePyramid, const HTuple& MaxError, const HTuple& SubPixel, const HTuple& NumLevels, const HTuple& WhichLevels, HTuple* Column, HTuple* Error) const

void HOperatorSetX.BestMatchPreMg(
[in] IHUntypedObjectX* ImagePyramid, [in] VARIANT TemplateID, [in] VARIANT MaxError, [in] VARIANT SubPixel, [in] VARIANT NumLevels, [in] VARIANT WhichLevels, [out] VARIANT* Row, [out] VARIANT* Column, [out] VARIANT* Error)

double HTemplateX.BestMatchPreMg(
[in] IHImageX* ImagePyramid, [in] double MaxError, [in] BSTR SubPixel, [in] Hlong NumLevels, [in] VARIANT WhichLevels, [out] double* Column, [out] double* Error)

double HImageX.BestMatchPreMg(
[in] IHTemplateX* TemplateID, [in] double MaxError, [in] BSTR SubPixel, [in] Hlong NumLevels, [in] VARIANT WhichLevels, [out] double* Column, [out] double* Error)

static void HOperatorSet.BestMatchPreMg(HObject imagePyramid, HTuple templateID, HTuple maxError, HTuple subPixel, HTuple numLevels, HTuple whichLevels, out HTuple row, out HTuple column, out HTuple error)

void HTemplate.BestMatchPreMg(HImage imagePyramid, double maxError, string subPixel, int numLevels, HTuple whichLevels, out double row, out double column, out double error)

void HTemplate.BestMatchPreMg(HImage imagePyramid, double maxError, string subPixel, int numLevels, int whichLevels, out double row, out double column, out double error)

void HImage.BestMatchPreMg(HTemplate templateID, double maxError, string subPixel, int numLevels, HTuple whichLevels, out double row, out double column, out double error)

void HImage.BestMatchPreMg(HTemplate templateID, double maxError, string subPixel, int numLevels, int whichLevels, out double row, out double column, out double error)

Description

best_match_pre_mgbest_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMg applies gray value matching using an image pyramid. best_match_pre_mgbest_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMg works analogously to best_match_mgbest_match_mgbest_match_mgBestMatchMgBestMatchMg, but it makes use of pre calculated pyramid which has to be generated beforehand using gen_gauss_pyramidgen_gauss_pyramidgen_gauss_pyramidGenGaussPyramidGenGaussPyramid. This reduces runtime if more than one match has to be done or the pyramid has be used otherwise. The pyramid has to be generated using the zooming factor 0.5 and the mode 'constant'"constant""constant""constant""constant".

Parallelization

Parameters

ImagePyramidImagePyramidImagePyramidImagePyramidimagePyramid (input_object)  image-array → objectHImageHImageArrayHImageXHobject (byte)

Image pyramid inside of which the pattern has to be found.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control)  template → HTemplate, HTupleHTemplate, HTupleHTemplateX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Template number.

MaxErrorMaxErrorMaxErrorMaxErrormaxError (input_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Maximal average difference of the grayvalues.

Default value: 30.0

Suggested values: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 9.0, 11.0, 15.0, 17.0, 20.0, 30.0, 40.0, 50.0, 60.0, 70.0

Typical range of values: 0 ≤ MaxError MaxError MaxError MaxError maxError ≤ 255

Minimum increment: 1

Recommended increment: 3

SubPixelSubPixelSubPixelSubPixelsubPixel (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Exactness in subpixels in case of 'true'"true""true""true""true".

Default value: 'false' "false" "false" "false" "false"

List of values: 'true'"true""true""true""true", 'false'"false""false""false""false"

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

Number of the used resolution levels.

Default value: 3

List of values: 1, 2, 3, 4, 5, 6

WhichLevelsWhichLevelsWhichLevelsWhichLevelswhichLevels (input_control)  integer → HTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Resolution level up to which the method “best match” is used.

Default value: 'original' "original" "original" "original" "original"

Suggested values: 'all'"all""all""all""all", 'original'"original""original""original""original", 0, 1, 2, 3, 4, 5, 6

RowRowRowRowrow (output_control)  point.y → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row position of the best match.

ColumnColumnColumnColumncolumn (output_control)  point.x → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column position of the best match.

ErrorErrorErrorErrorerror (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Average divergence of the grayvalues in the best match.

Result

If the parameter values are correct, the operator best_match_pre_mgbest_match_pre_mgbest_match_pre_mgBestMatchPreMgBestMatchPreMg returns the value 2 (H_MSG_TRUE). If the input is empty (no input images are available) the behaviour can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

gen_gauss_pyramidgen_gauss_pyramidgen_gauss_pyramidGenGaussPyramidGenGaussPyramid, create_templatecreate_templatecreate_templateCreateTemplateCreateTemplate, read_templateread_templateread_templateReadTemplateReadTemplate, adapt_templateadapt_templateadapt_templateAdaptTemplateAdaptTemplate, draw_regiondraw_regiondraw_regionDrawRegionDrawRegion, draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, set_reference_templateset_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplate

Alternatives

fast_matchfast_matchfast_matchFastMatchFastMatch, fast_match_mgfast_match_mgfast_match_mgFastMatchMgFastMatchMg, exhaustive_matchexhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatch, exhaustive_match_mgexhaustive_match_mgexhaustive_match_mgExhaustiveMatchMgExhaustiveMatchMg

Module

Matching

Table of Contents / Matching / Gray-Value-Based ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH