set_reference_template
— Referenzposition für ein Matching-Template setzen.
set_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.
set_reference_template( : : TemplateID, Row, Column : )
set_reference_template
definiert die Referenzposition eines Templates neu.
Als Default nach create_template
oder
create_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_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.
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.
TemplateID
(input_control, Zustand wird modifiziert) template →
(handle)
Nummer des Templates.
Row
(input_control) point.y →
(real)
Referenzposition des Templates (Zeile).
Column
(input_control) point.x →
(real)
Referenzposition des Templates (Spalte).
Sind die Parameterwerte korrekt, dann liefert
set_reference_template
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_template
,
create_template_rot
,
read_template
,
adapt_template
best_match
,
best_match_mg
,
best_match_rot
,
fast_match
,
fast_match_mg
Matching