adapt_template
— Anpassen eines Templates an die Größe eines Bildes.
adapt_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.
adapt_template(Image : : TemplateID : )
adapt_template
dient zur Anpassung eines
Templates, das mit create_template
erzeugt
wurde, an die Größe eines Bildes.
Vor der ersten Verwendung eines Templates
mit Bildern einer anderen Größe kann adapt_template
aufgerufen werden um Laufzeit beim ersten Aufruf des
Matching Operators zu sparen. Wird adapt_template
nicht explizit verwendet, erfolgt der Aufruf implizit beim
ersten Matching mit einer anderen Bildgröße.
Der Inhalt des Bildes ist irrelevant. Es wird nur
die Breite von Image
verwendet.
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.
Image
(input_object) singlechannelimage(-array) →
object (byte)
Bild, das die Größe des späteren Matching vorgibt.
TemplateID
(input_control, Zustand wird modifiziert) template →
(handle)
Nummer des Templates.
Sind die Parameterwerte korrekt, dann liefert adapt_template
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_template
,
create_template_rot
,
read_template
set_reference_template
,
best_match
,
fast_match
,
fast_match_mg
,
set_offset_template
,
best_match_mg
,
best_match_pre_mg
,
best_match_rot
,
best_match_rot_mg
Matching