set_reference_templateT_set_reference_templateSetReferenceTemplateSetReferenceTemplateset_reference_template (Operator)
Name
set_reference_templateT_set_reference_templateSetReferenceTemplateSetReferenceTemplateset_reference_template — Referenzposition für ein Matching-Template setzen.
Warnung
set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplateset_reference_template 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
Herror T_set_reference_template(const Htuple TemplateID, const Htuple Row, const Htuple Column)
Beschreibung
set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplateset_reference_template
definiert die Referenzposition eines Templates neu.
Als Default nach create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template oder
create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRotcreate_template_rot wird der Ursprung
des Bild (0,0) als Referenz verwendet, d.h. bei einer
Verschiebung von Null wird der Schwerpunkt des Templates
als Ergebnis geliefert. Mit set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplateset_reference_template
kann nun ein beliebiger Referenzpunkt definiert werden.
Verwendet man z.B. den Schwerpunkt als Referenz, dann wird
bei einer Verschiebung von Null der Vektor (0,0)
geliefert.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Parameter
TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (input_control, Zustand wird modifiziert) template → HTemplate, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Nummer des Templates.
RowRowRowRowrowrow (input_control) point.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Referenzposition des Templates (Zeile).
ColumnColumnColumnColumncolumncolumn (input_control) point.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Referenzposition des Templates (Spalte).
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplateset_reference_template
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template,
create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRotcreate_template_rot,
read_templateread_templateReadTemplateReadTemplateReadTemplateread_template,
adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplateadapt_template
Nachfolger
best_matchbest_matchBestMatchBestMatchBestMatchbest_match,
best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMgbest_match_mg,
best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRotbest_match_rot,
fast_matchfast_matchFastMatchFastMatchFastMatchfast_match,
fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMgfast_match_mg
Modul
Matching