set_image_source_paramT_set_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param (Operator)

Name

set_image_source_paramT_set_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param — Setzen eines Bildquellenparameters.

Signatur

set_image_source_param( : : ImageSourceHandle, Param, GenParamName, GenParamValue, Value : )

Beschreibung

Der Operator set_image_source_paramset_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param setzt die Parameterwerte oder Parametereigenschaften für ein Bildquellen-Handle ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle in ValueValueValuevaluevalue.

Der Parameter wird in ParamParamParamparamparam festgelegt. Die Parametergruppe kann mit generischen Parametern bestimmt werden. Es bestehen die folgenden Optionen für GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name:

'group'"group""group""group""group"

Die Parametergruppe, der der Parameter zugeordnet ist, wird in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value festgelegt, indem eine dieser Optionen gesetzt wird:

'image_source'"image_source""image_source""image_source""image_source",
'plugin'"plugin""plugin""plugin""plugin",
'interface'"interface""interface""interface""interface",
'local_device'"local_device""local_device""local_device""local_device",
'device'"device""device""device""device",
'stream'"stream""stream""stream""stream".

Werden keine generischen Parameter gesetzt, werden GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name = 'group'"group""group""group""group" und GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value = 'device'"device""device""device""device" standardmäßig angenommen.

'command_wait'"command_wait""command_wait""command_wait""command_wait"

Die Beendigung der Kommandoausführung (blockierende Operation) soll abgewartet werden.

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

Default: 'true'"true""true""true""true"

Restriktion: Nur für ParamParamParamparamparam des Typs 'command'"command""command""command""command" möglich.

'command_wait_interval'"command_wait_interval""command_wait_interval""command_wait_interval""command_wait_interval"

Abfrageintervall in [ms] zur Überprüfung, ob die Kommandoausführung abgeschlossen wurde.

Default: 100

Restriktion: Nur für ParamParamParamparamparam des Typs 'command'"command""command""command""command" möglich.

'command_wait_timeout'"command_wait_timeout""command_wait_timeout""command_wait_timeout""command_wait_timeout"

Zeit in [ms], die auf das Ende der Kommandoausführung gewartet werden soll.

Default: 5000

Restriktion: Nur für ParamParamParamparamparam des Typs 'command'"command""command""command""command" möglich.

Es ist von der Bildquelle und ihrem Zustand abhängig, welche Parameter ParamParamParamparamparam gesetzt werden können. Während manche Parameter spezifisch für den Software- oder Hardwarehersteller sind und manche davon abhängig sind ob das Gerät verbunden ist, sind die Parameter der Gruppe 'image_source'"image_source""image_source""image_source""image_source" immer verfügbar. Die folgende Liste gibt einen Überblick , welche Parameter mit set_image_source_paramset_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param gesetzt werden können. Eine Beschreibung der Parameter ist in get_image_source_paramget_image_source_paramGetImageSourceParamGetImageSourceParamget_image_source_param gegeben.

'device_access_flags'"device_access_flags""device_access_flags""device_access_flags""device_access_flags"
'device_id'"device_id""device_id""device_id""device_id"
'device_query_timeout'"device_query_timeout""device_query_timeout""device_query_timeout""device_query_timeout"
'device_user_name'"device_user_name""device_user_name""device_user_name""device_user_name"
'device_serial_number'"device_serial_number""device_serial_number""device_serial_number""device_serial_number"
'fetch_timeout'"fetch_timeout""fetch_timeout""fetch_timeout""fetch_timeout"
'interface_id'"interface_id""interface_id""interface_id""interface_id"
'interface_query_timeout'"interface_query_timeout""interface_query_timeout""interface_query_timeout""interface_query_timeout"
'num_buffers'"num_buffers""num_buffers""num_buffers""num_buffers"
'plugin_name'"plugin_name""plugin_name""plugin_name""plugin_name"
'plugin_path'"plugin_path""plugin_path""plugin_path""plugin_path"
'stream_id'"stream_id""stream_id""stream_id""stream_id"

Für Plugins, die von MVTec zur Verfügung gestellt werden, beschreibt die MVTec Interfaces Reference Documentation alle Plugin-spezifischen Parameter.

ParamParamParamparamparam wird verwendet um den gewünschten Parameter zu bestimmen. Der Wert, den der Parameter annehmen soll, wird in ValueValueValuevaluevalue übergeben. Parameter vom Typ 'command'"command""command""command""command" können ausgeführt werden indem ValueValueValuevaluevalue auf 'execute'"execute""execute""execute""execute" gesetzt wird.

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.

Parameter

ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle (input_control) image_source → (handle)

Bildquellen-Handle.

ParamParamParamparamparam (input_control) string → (string)

Parameter, dessen Wert gesetzt werden soll.

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

Generischer Parametername.

Default: []

Wertevorschläge: 'group'"group""group""group""group", 'command_wait'"command_wait""command_wait""command_wait""command_wait", 'command_wait_timeout'"command_wait_timeout""command_wait_timeout""command_wait_timeout""command_wait_timeout", 'command_wait_interval'"command_wait_interval""command_wait_interval""command_wait_interval""command_wait_interval"

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

Generischer Parameterwert.

Default: []

Wertevorschläge: 'image_source'"image_source""image_source""image_source""image_source", 'plugin'"plugin""plugin""plugin""plugin", 'interface'"interface""interface""interface""interface", 'local_device'"local_device""local_device""local_device""local_device", 'device'"device""device""device""device", 'stream'"stream""stream""stream""stream", 1, 5000, 100

ValueValueValuevaluevalue (input_control) string-array → (string / real / integer)

Zu setzender Wert.

Beispiel (HDevelop)

* Configure or change the 'device_id' of the ImageSource (before the connect).
set_image_source_param (ImageSourceHandle,'device_id', 'group', 'image_source', '<desired_device_id>')
* Configure the ExposureTime of the connected camera (notice per default 'group'='device').
set_image_source_param (ImageSourceHandle, 'ExposureTime', [], [], 50000)
* Execute a software trigger (notice per default 'group'='device') without waiting for the end of the execution.
set_image_source_param (ImageSourceHandle, 'TriggerSoftware', 'command_wait', 0,'execute')
* Configure the handling of image buffers in the stream module.
set_image_source_param (ImageSourceHandle, 'StreamBufferHandlingMode', 'group', 'stream', 'NewestOnly')

Ergebnis

Sind die Parameterwerte korrekt, gibt set_image_source_paramset_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param den Wert 2 ( H_MSG_TRUE) zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources, create_image_sourcecreate_image_sourceCreateImageSourceCreateImageSourcecreate_image_source, connect_image_sourceconnect_image_sourceConnectImageSourceConnectImageSourceconnect_image_source

Nachfolger

get_image_source_paramget_image_source_paramGetImageSourceParamGetImageSourceParamget_image_source_param, disconnect_image_sourcedisconnect_image_sourceDisconnectImageSourceDisconnectImageSourcedisconnect_image_source

Siehe auch

get_image_source_paramget_image_source_paramGetImageSourceParamGetImageSourceParamget_image_source_param

Modul

Foundation

Operatoren