set_offset_templateT_set_offset_templateSetOffsetTemplateSetOffsetTemplate (Operator)

Name

set_offset_templateT_set_offset_templateSetOffsetTemplateSetOffsetTemplate — Grauwertoffset für Template.

Warnung

set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate 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

set_offset_template( : : TemplateID, GrayOffset : )

Beschreibung

set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate addiert einen Offset zu den Grauwerten des Templates um eine Grauwertänderung im Bild auszugleichen. Der Parameter GrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset gibt die Änderung gegenüber den Grauwerten des ursprünglichen Pattern an, wie sie bei dem Aufruf von create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate gesetzt waren. Der Wert von GrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset bezieht sich auf das Bild in dem das Matching ausgeführt wird: Bei einem helleren Bild ist ein positiver Wert, bei einem dunkleren Bild ein negativer Wert zu übergeben. set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate ist bei jeder Grauwertänderung aufzurufen. Die Grauwerte können z.B. in einem Referenzbereich des Bildes mit intensityintensityIntensityIntensityIntensity oder min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray bestimmt werden.

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:

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID

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

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control, Zustand wird modifiziert) template → (handle)

Nummer des Templates.

GrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset (input_control) number → (integer)

Offset der Grauwert.

Defaultwert: 0

Wertevorschläge: -10, -5, -2, -1, 0, 1, 2, 5, 10

Typischer Wertebereich: -255 ≤ GrayOffset GrayOffset GrayOffset GrayOffset grayOffset ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Ergebnis

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

Vorgänger

create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplate, adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate, read_templateread_templateReadTemplateReadTemplateReadTemplate

Nachfolger

best_matchbest_matchBestMatchBestMatchBestMatch, best_match_mgbest_match_mgBestMatchMgBestMatchMgBestMatchMg, best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot, fast_matchfast_matchFastMatchFastMatchFastMatch, fast_match_mgfast_match_mgFastMatchMgFastMatchMgFastMatchMg

Modul

Matching

Operatoren