set_offset_templateset_offset_templateSetOffsetTemplateset_offset_templateSetOffsetTemplateSetOffsetTemplate (Operator)

Name

set_offset_templateset_offset_templateSetOffsetTemplateset_offset_templateSetOffsetTemplateSetOffsetTemplate — Grauwertoffset für Template.

Warnung

set_offset_templateset_offset_templateSetOffsetTemplateset_offset_templateSetOffsetTemplateSetOffsetTemplate 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_templateSetOffsetTemplateset_offset_templateSetOffsetTemplateSetOffsetTemplate addiert einen Offset zu den Grauwerten des Templates um eine Grauwertänderung im Bild auszugleichen. Der Parameter GrayOffsetGrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset gibt die Änderung gegenüber den Grauwerten des ursprünglichen Pattern an, wie sie bei dem Aufruf von create_templatecreate_templateCreateTemplatecreate_templateCreateTemplateCreateTemplate gesetzt waren. Der Wert von GrayOffsetGrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset 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_templateSetOffsetTemplateset_offset_templateSetOffsetTemplateSetOffsetTemplate ist bei jeder Grauwertänderung aufzurufen. Die Grauwerte können z.B. in einem Referenzbereich des Bildes mit intensityintensityIntensityintensityIntensityIntensity oder min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray bestimmt werden.

Parallelisierung

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:

TemplateIDTemplateIDTemplateIDTemplateIDTemplateIDtemplateID

Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.

Parameter

TemplateIDTemplateIDTemplateIDTemplateIDTemplateIDtemplateID (input_control, Zustand wird modifiziert) template → (integer)

Nummer des Templates.

GrayOffsetGrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffset (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 grayOffset ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Ergebnis

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

Vorgänger

create_templatecreate_templateCreateTemplatecreate_templateCreateTemplateCreateTemplate, adapt_templateadapt_templateAdaptTemplateadapt_templateAdaptTemplateAdaptTemplate, read_templateread_templateReadTemplateread_templateReadTemplateReadTemplate

Nachfolger

best_matchbest_matchBestMatchbest_matchBestMatchBestMatch, best_match_mgbest_match_mgBestMatchMgbest_match_mgBestMatchMgBestMatchMg, best_match_rotbest_match_rotBestMatchRotbest_match_rotBestMatchRotBestMatchRot, fast_matchfast_matchFastMatchfast_matchFastMatchFastMatch, fast_match_mgfast_match_mgFastMatchMgfast_match_mgFastMatchMgFastMatchMg

Modul

Matching

Operatoren