set_shape_model_paramT_set_shape_model_paramSetShapeModelParamSetShapeModelParam (Operator)

Name

set_shape_model_paramT_set_shape_model_paramSetShapeModelParamSetShapeModelParam — Setzen ausgewählter Formmodellparameter.

Signatur

set_shape_model_param( : : ModelID, GenParamName, GenParamValue : )

Beschreibung

Der Operator set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParamSetShapeModelParam setzt ausgewählte Parameter im Formmodell ModelIDModelIDModelIDModelIDmodelID. Die folgenden Parameter können modifiziert werden:

'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast"

Setzt im Formmodell ModelIDModelIDModelIDModelIDmodelID den minimalen Kontrast des Objekts in den Suchbildern. Damit wird der Wert 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast", der ursprünglich z.B. mit create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel gesetzt wurde, überschrieben. Falls das Formmodell ModelIDModelIDModelIDModelIDmodelID aus einer Datei eingelesen wurde und diese Datei geändert werden soll, muss das Formmodell ModelIDModelIDModelIDModelIDmodelID nochmals in die Datei geschrieben werden, nachdem der Operator set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParamSetShapeModelParam ausgeführt wurde.

'timeout'"timeout""timeout""timeout""timeout"

Setzt die maximale Laufzeit der Operatoren die verwendet werden um das Formmodell ModelIDModelIDModelIDModelIDmodelID zu finden (z.B. find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel). Dies ist dann besonders nützlich, wenn eine maximale Zykluszeit sichergestellt werden muss. Der 'timeout'"timeout""timeout""timeout""timeout" muss in Millisekunden angegeben werden. Die zeitliche Genauigkeit des Timeouts hängt von vielen Faktoren ab, darunter ist die Größe des Modells, die Geschwindigkeit des Rechners und der 'timer_mode'"timer_mode""timer_mode""timer_mode""timer_mode" der über set_systemset_systemSetSystemSetSystemSetSystem gesetzt wurde. Beachten Sie, dass sich die Laufzeit der Modellsuche bei aktiviertem Timeout um bis zu 10 Prozent erhöht. Um den Timeout zu deaktivieren, können Sie entweder einen negativen Wert oder 'false'"false""false""false""false" angeben.

'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models"

Legt für die Operatoren, die verwendet werden um das Formmodell ModelIDModelIDModelIDModelIDmodelID zu finden (z.B. find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel), fest, ob die gesuchten Modelle teilweise außerhalb des Bildes liegen dürfen (also den Bildrand überschreiten dürfen). Der Wert von 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models" ist entweder 'true'"true""true""true""true", 'false'"false""false""false""false" oder 'system'"system""system""system""system". Wenn der Wert auf den Standardwert 'system'"system""system""system""system" gesetzt ist, wird der systemweite Wert verwendet, der zuletzt mit set_systemset_systemSetSystemSetSystemSetSystem für 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models" gesetzt wurde.

'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter"

Deaktiviert oder aktiviert die Nutzung von Störparametern für das Formmodell ModelIDModelIDModelIDModelIDmodelID, welche zuvor mit set_shape_model_clutterset_shape_model_clutterSetShapeModelClutterSetShapeModelClutterSetShapeModelClutter gesetzt wurden. Der Wert von 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter" kann 'true'"true""true""true""true" oder 'false'"false""false""false""false" sein. Es ist zu beachten, dass der Wert von 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter" die Anzahl erwarteter Einträge für den Parameter MinScoreMinScoreMinScoreMinScoreminScore beeinflusst. Für weitere Informationen, siehe die Referenz der entsprechenden Operatoren, wie beispielsweise find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel.

Für neu generierte Formmodelle ist die Nutzung von Störparametern deaktiviert. Nach dem Aufruf von set_shape_model_clutterset_shape_model_clutterSetShapeModelClutterSetShapeModelClutterSetShapeModelClutter ist die Nutzung von Störparametern aktiviert. Störparameter sowie der Wert von 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter" können mit get_shape_model_clutterget_shape_model_clutterGetShapeModelClutterGetShapeModelClutterGetShapeModelClutter abgefragt 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:

ModelIDModelIDModelIDModelIDmodelID

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

ModelIDModelIDModelIDModelIDmodelID (input_control, Zustand wird modifiziert) shape_model → (handle)

Handle des Modells.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name-array → (string)

Parameternamen.

Werteliste: 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models", 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast", 'timeout'"timeout""timeout""timeout""timeout", 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value-array → (real / integer / string)

Parameterwerte.

Werteliste: 'false'"false""false""false""false", 'system'"system""system""system""system", 'true'"true""true""true""true"

Ergebnis

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

Vorgänger

Nachfolger

find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel, find_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModelFindScaledShapeModel, find_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModelFindAnisoShapeModel

Siehe auch

create_shape_model_xldcreate_shape_model_xldCreateShapeModelXldCreateShapeModelXldCreateShapeModelXld, create_scaled_shape_model_xldcreate_scaled_shape_model_xldCreateScaledShapeModelXldCreateScaledShapeModelXldCreateScaledShapeModelXld, create_aniso_shape_model_xldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldCreateAnisoShapeModelXldCreateAnisoShapeModelXld, set_shape_model_clutterset_shape_model_clutterSetShapeModelClutterSetShapeModelClutterSetShapeModelClutter, get_shape_model_clutterget_shape_model_clutterGetShapeModelClutterGetShapeModelClutterGetShapeModelClutter

Modul

Matching

Operatoren