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

create_template_rotT_create_template_rotCreateTemplateRotCreateTemplateRot (Operator)

Name

create_template_rotT_create_template_rotCreateTemplateRotCreateTemplateRot — Aufbereiten eines Musters für Template Matching mit Rotation.

Warnung

create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot 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

create_template_rot(Template : : NumLevel, AngleStart, AngleExtend, AngleStep, Optimize, GrayValues : TemplateID)

Herror T_create_template_rot(const Hobject Template, const Htuple NumLevel, const Htuple AngleStart, const Htuple AngleExtend, const Htuple AngleStep, const Htuple Optimize, const Htuple GrayValues, Htuple* TemplateID)

void CreateTemplateRot(const HObject& Template, const HTuple& NumLevel, const HTuple& AngleStart, const HTuple& AngleExtend, const HTuple& AngleStep, const HTuple& Optimize, const HTuple& GrayValues, HTuple* TemplateID)

void HTemplate::HTemplate(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const HString& Optimize, const HString& GrayValues)

void HTemplate::HTemplate(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const char* Optimize, const char* GrayValues)

void HTemplate::CreateTemplateRot(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const HString& Optimize, const HString& GrayValues)

void HTemplate::CreateTemplateRot(const HImage& Template, Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const char* Optimize, const char* GrayValues)

HTemplate HImage::CreateTemplateRot(Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const HString& Optimize, const HString& GrayValues) const

HTemplate HImage::CreateTemplateRot(Hlong NumLevel, double AngleStart, double AngleExtend, double AngleStep, const char* Optimize, const char* GrayValues) const

static void HOperatorSet.CreateTemplateRot(HObject template, HTuple numLevel, HTuple angleStart, HTuple angleExtend, HTuple angleStep, HTuple optimize, HTuple grayValues, out HTuple templateID)

public HTemplate(HImage template, int numLevel, double angleStart, double angleExtend, double angleStep, string optimize, string grayValues)

void HTemplate.CreateTemplateRot(HImage template, int numLevel, double angleStart, double angleExtend, double angleStep, string optimize, string grayValues)

HTemplate HImage.CreateTemplateRot(int numLevel, double angleStart, double angleExtend, double angleStep, string optimize, string grayValues)

Beschreibung

create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot bereitet ein Muster, das als Bild übergeben wird, für das Template Matching vor. Als Erweiterung gegenüber create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate kann das Matching später mit rotierten Mustern ausgeführt werden. Die Parameter AngleStartAngleStartAngleStartAngleStartangleStart und AngleExtendAngleExtendAngleExtendAngleExtendangleExtend legen die maximale Rotation des Musters fest: AngleStartAngleStartAngleStartAngleStartangleStart gibt die größte Rotation gegen den Uhrzeiger an und AngleExtendAngleExtendAngleExtendAngleExtendangleExtend die größte Rotation im Uhrzeigersinn relativ zu diesem Winkel. AngleExtendAngleExtendAngleExtendAngleExtendangleExtend muss folglich immer kleiner als sein. Mit dem Parameter AngleStepAngleStepAngleStepAngleStepangleStep wird die maximale Winkelauflösung (auf der untersten Pyramidenebene) festgelegt.

Es ist zu beachten, dass alle möglichen Rotationen bei der Erzeugung des Templates berechnet werden um Laufzeit bei Matching zu sparen. Dies führt zu einer entsprechend hohen Laufzeit von create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot und einem hohen Speicherbedarf des erzeugten Templates. Der Speichebedarf hängt von AngleExtendAngleExtendAngleExtendAngleExtendangleExtend und AngleStepAngleStepAngleStepAngleStepangleStep ab. Die Anzahl der Pyramidenstufen kann dagegen vernachlässigt werden. Falls A die Fläche von TemplateTemplateTemplateTemplatetemplate ist, dann ist der Speicherbedarf M in Byte etwa:

Dem Template wird nach der Transformation eine Nummer zugewiesen (TemplateIDTemplateIDTemplateIDTemplateIDtemplateID), die bei der weiteren Verarbeitung verwendet wird.

Die Beschreibung der weiteren Parameter ist bei create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate zu finden.

Achtung

Es ist zu beachten, dass für jede Rotation Muster angelegt werden. Dies erhöht bei einer feinen Auflösung den Speicherbedarf entsprechend.

Ausführungsinformationen

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

TemplateTemplateTemplateTemplatetemplate (input_object)  singlechannelimage → objectHImageHImageHobject (byte)

Eingabebild, dessen Definitionsbereich für das Pattern Matching aufbereitet wird.

NumLevelNumLevelNumLevelNumLevelnumLevel (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximale Anzahl von Pyramidenebenen.

Defaultwert: 4

Werteliste: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

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

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

Schrittweite (Winkelgenauigkeit) des Matchings.

Defaultwert: 0.0982

Wertevorschläge: 0.3927, 0.1963, 0.0982, 0.0491, 0.0245

Restriktion: AngleStep > 0

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

Art der Optimierung.

Defaultwert: 'sort' "sort" "sort" "sort" "sort"

Werteliste: 'none'"none""none""none""none", 'sort'"sort""sort""sort""sort"

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

Art der Grauwerte.

Defaultwert: 'original' "original" "original" "original" "original"

Werteliste: 'gradient'"gradient""gradient""gradient""gradient", 'normalized'"normalized""normalized""normalized""normalized", 'original'"original""original""original""original", 'sobel'"sobel""sobel""sobel""sobel"

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (output_control)  template → HTemplate, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Nummer des Templates.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRot den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

draw_regiondraw_regionDrawRegionDrawRegionDrawRegion, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, thresholdthresholdThresholdThresholdThreshold

Nachfolger

best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot, best_match_rot_mgbest_match_rot_mgBestMatchRotMgBestMatchRotMgBestMatchRotMg, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate, set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate, clear_templateclear_templateClearTemplateClearTemplateClearTemplate, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate, write_templatewrite_templateWriteTemplateWriteTemplateWriteTemplate

Alternativen

create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelCreateNccModel, create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate

Modul

Matching

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 18.05 Copyright © 1996-2018 MVTec Software GmbH