HALCON Website / HALCON Operator-Referenz / Legacy / Matching
KlassenKlassen | | Operatoren

best_match_rotbest_match_rotBestMatchRotBestMatchRot (Operator)

Name

best_match_rotbest_match_rotBestMatchRotBestMatchRot — Suche des besten Matching zwischen einem Template und einem Bild mit Rotation.

Warnung

best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt. Neue Applikationen sollten stattdessen die Form-basierten oder NCC-basierten Operatoren verwenden.

Signatur

best_match_rot(Image : : TemplateID, AngleStart, AngleExtend, MaxError, SubPixel : Row, Column, Angle, Error)

Herror best_match_rot(const Hobject Image, const Hlong TemplateID, double AngleStart, double AngleExtend, double MaxError, const char* SubPixel, double* Row, double* Column, double* Angle, double* Error)

Herror T_best_match_rot(const Hobject Image, const Htuple TemplateID, const Htuple AngleStart, const Htuple AngleExtend, const Htuple MaxError, const Htuple SubPixel, Htuple* Row, Htuple* Column, Htuple* Angle, Htuple* Error)

void BestMatchRot(const HObject& Image, const HTuple& TemplateID, const HTuple& AngleStart, const HTuple& AngleExtend, const HTuple& MaxError, const HTuple& SubPixel, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Error)

void HTemplate::BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Error) const

void HTemplate::BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, double* Row, double* Column, double* Angle, double* Error) const

void HTemplate::BestMatchRot(const HImage& Image, double AngleStart, double AngleExtend, double MaxError, const char* SubPixel, double* Row, double* Column, double* Angle, double* Error) const

void HImage::BestMatchRot(const HTemplate& TemplateID, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Error) const

void HImage::BestMatchRot(const HTemplate& TemplateID, double AngleStart, double AngleExtend, double MaxError, const HString& SubPixel, double* Row, double* Column, double* Angle, double* Error) const

void HImage::BestMatchRot(const HTemplate& TemplateID, double AngleStart, double AngleExtend, double MaxError, const char* SubPixel, double* Row, double* Column, double* Angle, double* Error) const

static void HOperatorSet.BestMatchRot(HObject image, HTuple templateID, HTuple angleStart, HTuple angleExtend, HTuple maxError, HTuple subPixel, out HTuple row, out HTuple column, out HTuple angle, out HTuple error)

void HTemplate.BestMatchRot(HImage image, double angleStart, double angleExtend, double maxError, string subPixel, out HTuple row, out HTuple column, out HTuple angle, out HTuple error)

void HTemplate.BestMatchRot(HImage image, double angleStart, double angleExtend, double maxError, string subPixel, out double row, out double column, out double angle, out double error)

void HImage.BestMatchRot(HTemplate templateID, double angleStart, double angleExtend, double maxError, string subPixel, out HTuple row, out HTuple column, out HTuple angle, out HTuple error)

void HImage.BestMatchRot(HTemplate templateID, double angleStart, double angleExtend, double maxError, string subPixel, out double row, out double column, out double angle, out double error)

Beschreibung

best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot führt ein Matching zwischen dem Template von TemplateIDTemplateIDTemplateIDTemplateIDtemplateID und ImageImageImageImageimage durch. Es arbeitet analog zu best_matchbest_matchBestMatchBestMatchBestMatch mit der Erweiterung, dass das Muster gedreht vorliegen kann. Die Parameter AngleStartAngleStartAngleStartAngleStartangleStart und AngleExtendAngleExtendAngleExtendAngleExtendangleExtend legen die maximale Rotation des Musters fest: AngleStartAngleStartAngleStartAngleStartangleStart gibt größte Rotation gegen den Uhrzeiger an und AngleExtendAngleExtendAngleExtendAngleExtendangleExtend die größte Rotation im Uhrzeigersinn relativ zu diesem Winkel. Beide Werte müssen kleiner oder gleich den entsprechenden Werte des Template bei dessen Erzeugung sein (siehe create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot). Als Erweiterung gegenüber best_matchbest_matchBestMatchBestMatchBestMatch liefert best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot zu zusätzlichen Ausgabeparameter AngleAngleAngleAngleangle der die gefundenen Rotationswinkel des Musters angibt. Die Genauigkeit hängt von dem Parameter AngleStep von create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot ab. Im Fall von SubPixelSubPixelSubPixelSubPixelsubPixel = 'true'"true""true""true""true" wird die Position und der Winkel mit „subpixel“ Genauigkeit bestimmt.

Ausführungsinformationen

Parameter

ImageImageImageImageimage (input_object)  singlechannelimage(-array) → objectHImageHImageHobject (byte)

Eingabebild, in dem das Pattern gefunden werden soll.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control)  template → HTemplate, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Nummer des Templates.

AngleStartAngleStartAngleStartAngleStartangleStart (input_control)  angle.rad → HTupleHTupleHtuple (real) (double) (double) (double)

Kleinster auftretende Rotation des Musters.

Defaultwert: -0.39

Wertevorschläge: -3.14, -1.57, -0.79, -0.39, -0.20, 0.0

AngleExtendAngleExtendAngleExtendAngleExtendangleExtend (input_control)  angle.rad → HTupleHTupleHtuple (real) (double) (double) (double)

Maximale posivite Abweichung von AngleStartAngleStartAngleStartAngleStartangleStart.

Defaultwert: 0.79

Wertevorschläge: 6.28, 3.14, 1.57, 0.79, 0.39

Restriktion: AngleExtend > 0

MaxErrorMaxErrorMaxErrorMaxErrormaxError (input_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Maximale mittlere Differenz der Grauwerte.

Defaultwert: 30.0

Wertevorschläge: 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

Typischer Wertebereich: 0 ≤ MaxError MaxError MaxError MaxError maxError ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 3

SubPixelSubPixelSubPixelSubPixelsubPixel (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Subpixel Genauigkeit falls 'true'"true""true""true""true".

Defaultwert: 'false' "false" "false" "false" "false"

Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"

RowRowRowRowrow (output_control)  point.y(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Zeilenposition des Best-Match.

ColumnColumnColumnColumncolumn (output_control)  point.x(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Spaltenposition des Best-Match.

AngleAngleAngleAngleangle (output_control)  angle.rad(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Rotationswinkel des Musters.

ErrorErrorErrorErrorerror (output_control)  real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Mittlere Abweichung der Grauwerte des Best-Match.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot, read_templateread_templateReadTemplateReadTemplateReadTemplate, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate, set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Alternativen

best_match_rot_mgbest_match_rot_mgBestMatchRotMgBestMatchRotMgBestMatchRotMg

Siehe auch

best_matchbest_matchBestMatchBestMatchBestMatch, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMg

Modul

Matching

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH