set_shape_model_paramT_set_shape_model_paramSetShapeModelParamSetShapeModelParamset_shape_model_param (Operator)
Name
set_shape_model_paramT_set_shape_model_paramSetShapeModelParamSetShapeModelParamset_shape_model_param — Setzen ausgewählter Formmodellparameter.
Signatur
Beschreibung
Der Operator set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParamSetShapeModelParamset_shape_model_param setzt ausgewählte Parameter im
Formmodell ModelIDModelIDModelIDModelIDmodelIDmodel_id. Die folgenden Parameter können modifiziert
werden:
'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast"
Setzt im Formmodell ModelIDModelIDModelIDModelIDmodelIDmodel_id den minimalen Kontrast des Objekts in
den Suchbildern. Damit wird der Wert 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast",
der ursprünglich z.B. mit create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModelcreate_shape_model
gesetzt wurde, überschrieben. Falls das Formmodell ModelIDModelIDModelIDModelIDmodelIDmodel_id aus einer
Datei eingelesen wurde und diese Datei geändert werden soll, muss das
Formmodell ModelIDModelIDModelIDModelIDmodelIDmodel_id nochmals in die Datei geschrieben werden, nachdem
der Operator set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParamSetShapeModelParamset_shape_model_param ausgeführt wurde.
'timeout'"timeout""timeout""timeout""timeout""timeout"
Setzt die maximale Laufzeit der Operatoren die verwendet werden um das
Formmodell ModelIDModelIDModelIDModelIDmodelIDmodel_id zu finden (z.B. find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model).
Dies ist dann besonders nützlich, wenn eine maximale Zykluszeit
sichergestellt werden muss. Der 'timeout'"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""timer_mode" der über set_systemset_systemSetSystemSetSystemSetSystemset_system
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""false" angeben.
'border_shape_models'"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 ModelIDModelIDModelIDModelIDmodelIDmodel_id zu finden (z.B. find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model),
fest, ob die gesuchten Modelle teilweise außerhalb des Bildes liegen
dürfen (also den Bildrand überschreiten dürfen).
Teilweise bedeutet, dass der Ursprung des Modells noch innerhalb
des Bildes liegen muss. Ein eventuell mit set_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOriginSetShapeModelOriginset_shape_model_origin
anders gesetzter Ursprung wird nicht berücksichtigt.
Der Wert von 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models""border_shape_models" ist entweder 'true'"true""true""true""true""true",
'false'"false""false""false""false""false" oder 'system'"system""system""system""system""system". Wenn der Wert auf den Standardwert
'system'"system""system""system""system""system" gesetzt ist, wird der systemweite Wert verwendet,
der zuletzt mit set_systemset_systemSetSystemSetSystemSetSystemset_system für 'border_shape_models'"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""use_clutter"
Deaktiviert oder aktiviert die Nutzung von Störparametern für das
Formmodell ModelIDModelIDModelIDModelIDmodelIDmodel_id, welche zuvor mit
set_shape_model_clutterset_shape_model_clutterSetShapeModelClutterSetShapeModelClutterSetShapeModelClutterset_shape_model_clutter gesetzt wurden.
Der Wert von 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter""use_clutter" kann 'true'"true""true""true""true""true" oder
'false'"false""false""false""false""false" sein. Es ist zu beachten, dass der Wert von
'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter""use_clutter" die Anzahl erwarteter Einträge für den Parameter
MinScoreMinScoreMinScoreMinScoreminScoremin_score beeinflusst. Für weitere Informationen, siehe die
Referenz der entsprechenden Operatoren, wie beispielsweise
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model.
Für neu generierte Formmodelle ist die Nutzung von Störparametern
deaktiviert. Nach dem Aufruf von set_shape_model_clutterset_shape_model_clutterSetShapeModelClutterSetShapeModelClutterSetShapeModelClutterset_shape_model_clutter ist die
Nutzung von Störparametern aktiviert. Störparameter sowie der
Wert von 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter""use_clutter" können mit get_shape_model_clutterget_shape_model_clutterGetShapeModelClutterGetShapeModelClutterGetShapeModelClutterget_shape_model_clutter
abgefragt werden.
'model_cache'"model_cache""model_cache""model_cache""model_cache""model_cache"
Schaltet einen internen Cache, der auf temporärem Speicher basiert und der
von dem Formmodell bei z.B. find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model verwendet wird, ein oder aus.
Die Größe des Caches hängt davon ab, wie groß der Suchraum ist und wie viele
Diskretisierungsschritte der Suchoperator benötigt.
Das bedeutet, dass der Speicherverbrauch sowohl durch kleine Schrittweiten in
AngleStepAngleStepAngleStepAngleStepangleStepangle_step und ScaleStepScaleStepScaleStepScaleStepscaleStepscale_step als auch durch die Festlegung eines
großen Suchraums mittels AngleExtentAngleExtentAngleExtentAngleExtentangleExtentangle_extent sowie ScaleMinScaleMinScaleMinScaleMinscaleMinscale_min und
ScaleMaxScaleMaxScaleMaxScaleMaxscaleMaxscale_max erhöht wird. Wenn man 'model_cache' ausschaltet
(durch Setzen auf 'false'"false""false""false""false""false"), führt das manchmal zu einer leicht längerer
Laufzeit, aber konstant kleinem Speicherverbrauch, was besonders für Anwendungen auf
Embedded-Systemen wichtig ist. Standardmäßig ist der Cache eingeschaltet
('true'"true""true""true""true""true").
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:
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
ModelIDModelIDModelIDModelIDmodelIDmodel_id (input_control, Zustand wird modifiziert) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Modells.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Parameternamen.
Werteliste: 'border_shape_models'"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""min_contrast", 'model_cache'"model_cache""model_cache""model_cache""model_cache""model_cache", 'timeout'"timeout""timeout""timeout""timeout""timeout", 'use_clutter'"use_clutter""use_clutter""use_clutter""use_clutter""use_clutter"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Parameterwerte.
Werteliste: 'false'"false""false""false""false""false", 'system'"system""system""system""system""system", 'true'"true""true""true""true""true"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
set_shape_model_paramset_shape_model_paramSetShapeModelParamSetShapeModelParamSetShapeModelParamset_shape_model_param den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Vorgänger
create_shape_model_xldcreate_shape_model_xldCreateShapeModelXldCreateShapeModelXldCreateShapeModelXldcreate_shape_model_xld,
create_scaled_shape_model_xldcreate_scaled_shape_model_xldCreateScaledShapeModelXldCreateScaledShapeModelXldCreateScaledShapeModelXldcreate_scaled_shape_model_xld,
create_aniso_shape_model_xldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldCreateAnisoShapeModelXldCreateAnisoShapeModelXldcreate_aniso_shape_model_xld
Nachfolger
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModelfind_shape_model,
find_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModelFindScaledShapeModelfind_scaled_shape_model,
find_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModelFindAnisoShapeModelfind_aniso_shape_model
Alternativen
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param
Siehe auch
create_shape_model_xldcreate_shape_model_xldCreateShapeModelXldCreateShapeModelXldCreateShapeModelXldcreate_shape_model_xld,
create_scaled_shape_model_xldcreate_scaled_shape_model_xldCreateScaledShapeModelXldCreateScaledShapeModelXldCreateScaledShapeModelXldcreate_scaled_shape_model_xld,
create_aniso_shape_model_xldcreate_aniso_shape_model_xldCreateAnisoShapeModelXldCreateAnisoShapeModelXldCreateAnisoShapeModelXldcreate_aniso_shape_model_xld,
set_shape_model_clutterset_shape_model_clutterSetShapeModelClutterSetShapeModelClutterSetShapeModelClutterset_shape_model_clutter,
get_shape_model_clutterget_shape_model_clutterGetShapeModelClutterGetShapeModelClutterGetShapeModelClutterget_shape_model_clutter
Modul
Matching