set_offset_templateT_set_offset_templateSetOffsetTemplateSetOffsetTemplateset_offset_template (Operator)

Name

set_offset_templateT_set_offset_templateSetOffsetTemplateSetOffsetTemplateset_offset_template — Grauwertoffset für Template.

Warnung

set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateset_offset_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

set_offset_template( : : TemplateID, GrayOffset : )

Beschreibung

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

TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id

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

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

Nummer des Templates.

GrayOffsetGrayOffsetGrayOffsetgrayOffsetgray_offset (input_control) number → (integer)

Offset der Grauwert.

Default: 0

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

Wertebereich: -255 ≤ GrayOffset GrayOffset GrayOffset grayOffset gray_offset ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Ergebnis

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

Vorgänger

create_templatecreate_templateCreateTemplateCreateTemplatecreate_template, adapt_templateadapt_templateAdaptTemplateAdaptTemplateadapt_template, read_templateread_templateReadTemplateReadTemplateread_template

Nachfolger

best_matchbest_matchBestMatchBestMatchbest_match, best_match_mgbest_match_mgBestMatchMgBestMatchMgbest_match_mg, best_match_rotbest_match_rotBestMatchRotBestMatchRotbest_match_rot, fast_matchfast_matchFastMatchFastMatchfast_match, fast_match_mgfast_match_mgFastMatchMgFastMatchMgfast_match_mg

Modul

Matching

Operatoren