query_image_sources — Gibt Handles zurück, die Bildquellen entsprechen.
query_image_sources( : : PluginName, GenParamName, GenParamValue : ImageSourceHandles)
Entsprechend der Abfrage die durch den Plugin-Namen und den generischen
Eingabeparametern spezifiziert wird gibt query_image_sources die
entsprechenden Handles in ImageSourceHandles zurück.
Die abgefragten Handles sind in einem unverbundenen Zustand.
Es können Bildquellen-Handles der verschiedenen Bildquellenmodule abgefragt werden:
Plugins,
Interfaces,
Geräte und
Streams.
Diese Module sind in einer hierarchischen Eltern-Kind-Konfiguration strukturiert, wobei jedes Modul als übergeordnetes Modul für das nachfolgende fungiert.
Für weitere Informationen zum Bildquellenkonzept siehe Bildquelle. Siehe die MVTec Interfaces Reference Documentation für die Dokumentation der einzelnen MVTec Bildquellen-Plugins.
Um die Abfrage auf ein spezifisches Plugin zu beschränken kann dessen Name in
PluginName gesetzt werden. Um alle verfügbaren Plugins gleichzeitig
abzufragen kann PluginName auf 'all' gesetzt werden.
PluginName muss auf 'ignore' gesetzt werden, wenn
Informationen zu einem speziellen Plugin- oder Interface-Handle abgefragt
werden.
Werteliste: 'all', 'ignore', '<plugin_name>'.
Default: 'all'.
Die generischen Parameter GenParamName und GenParamValue
werden verwendet, um den Umfang der Abfrage festzulegen. Die
unterstützten GenParamName sind:
Abfrage von Handles verfügbarer Bildquellen.
Die Optionen für GenParamValue sind:
Für jedes verfügbare Plugin wird ein Handle zurückgegeben.
Für jedes verfügbare Interface wird ein Handle zurückgegeben, welches dem Interface- und dem übergeordneten Plugin-Modul entspricht.
Für jedes verfügbare Gerät wird ein Handle zurückgegeben, welches dem Geräte-, sowie dem übergeordneten Interface- und Plugin-Modul entspricht.
Für jeden verfügbaren Stream wird ein Handle
zurückgegeben, welches dem Stream-, sowie dem übergeordneten Geräte-,
Interface- und Plugin-Modul entspricht.
PluginName muss auf 'ignore' gesetzt sein.
Zu beachten: Zusammen mit den generischen Parametern 'query' und 'streams', muss auch der Parameter 'device_handle' und ein Geräte-Handle übergeben werden:
query_image_sources('ignore', ['query', 'device_handle'] , ['streams', DeviceHandle], QueriedStreams)
Spezifiziert ein verbundenes Plugin-Handle in GenParamValue, von
dem aus alle Interface- oder Geräte-Handles abgefragt werden.
Siehe connect_image_source für Informationen über das verbinden
mit Bildquellen.
PluginName muss auf 'ignore' gesetzt werden.
Spezifiziert ein verbundenes Interface-Handle in GenParamValue, von
dem aus Geräte-Handles abgefragt werden.
Siehe connect_image_source für Informationen über das verbinden
mit Bildquellen.
PluginName muss auf 'ignore' gesetzt werden.
Spezifiziert ein verbundenes Geräte-Handle in GenParamValue, von
dem aus Stream-Handles abgefragt werden (siehe die Option 'query'
oben).
Siehe connect_image_source für Informationen über das verbinden
mit Bildquellen.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
PluginName (input_control) string → (string)
Name des Bildquellen-Plugins.
Default: 'all'
Wertevorschläge: 'all', 'ignore', 'mvtec_gigevision', 'mvtec_usb3vision', 'mvtec_realsense', 'mvtec_gstreamer', 'mvtec_mediafoundation', '<plugin_name>'
GenParamName (input_control) attribute.name-array → (string)
Generischer Parametername.
Default: []
Wertevorschläge: 'query', 'image_source_handle', 'plugin_handle', 'interface_handle', 'device_handle'
GenParamValue (input_control) attribute.value-array → (string / handle)
Generischer Parameterwert.
Default: []
Wertevorschläge: 'plugins', 'interfaces', 'devices', 'streams'
ImageSourceHandles (output_control) image_source-array → (handle)
Bildquellen-Handles, die den im System verfügbaren Modulen entsprechen.
* Query different modules.
query_image_sources ('all', 'query', 'plugins', Plugins)
query_image_sources ('all', 'query', 'interfaces', Interfaces)
query_image_sources ('all', 'query', 'devices', Devices)
* Connect to an available plugin and interface.
connect_image_source (Plugins[0], [], [])
connect_image_source (Interfaces[0], [], [])
* Restrict query to all device modules of one connected plugin.
query_image_sources ('ignore', 'plugin_handle', Plugins[0], PluginSubHandles)
* Restrict query to all sub-modules down to the interface level of one connected plugin.
query_image_sources ('ignore', ['query', 'plugin_handle'], ['interfaces', Plugins[0]], InterfaceHandlesPluginZero)
Sind die Parameterwerte korrekt, dann liefert query_image_sources
den Wert 2 (
H_MSG_TRUE)
.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
connect_image_source,
get_image_source_param,
set_image_source_param
Foundation