create_image_sourceT_create_image_sourceCreateImageSourceCreateImageSourcecreate_image_source (Operator)
Name
create_image_sourceT_create_image_sourceCreateImageSourceCreateImageSourcecreate_image_source — Erzeugen eines Bildquellen-Handles.
Signatur
void CreateImageSource(const HTuple& PluginName, const HTuple& DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ImageSourceHandle)
void HImageSource::HImageSource(const HString& PluginName, const HString& DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue)
void HImageSource::HImageSource(const char* PluginName, const char* DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue)
void HImageSource::HImageSource(const wchar_t* PluginName, const wchar_t* DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue)
(
Nur Windows)
void HImageSource::CreateImageSource(const HString& PluginName, const HString& DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue)
void HImageSource::CreateImageSource(const char* PluginName, const char* DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue)
void HImageSource::CreateImageSource(const wchar_t* PluginName, const wchar_t* DeviceID, const HTuple& GenParamName, const HTuple& GenParamValue)
(
Nur Windows)
static void HOperatorSet.CreateImageSource(HTuple pluginName, HTuple deviceID, HTuple genParamName, HTuple genParamValue, out HTuple imageSourceHandle)
public HImageSource(string pluginName, string deviceID, HTuple genParamName, HTuple genParamValue)
void HImageSource.CreateImageSource(string pluginName, string deviceID, HTuple genParamName, HTuple genParamValue)
Beschreibung
create_image_sourcecreate_image_sourceCreateImageSourceCreateImageSourcecreate_image_source erzeugt ein Bildquellen-Handle und gibt es in
ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle zurück. Das erzeugte Handle ist in einem
unverbundenen Zustand. Die Parameter PluginNamePluginNamePluginNamepluginNameplugin_name und DeviceIDDeviceIDDeviceIDdeviceIDdevice_id
können verwendet werden um die Plugin- und Geräte-Module der
Bildquellen-Handles zu spezifizieren.
Alternativ können die generischen Parameter GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value verwendet werden um Module mittels anderer Kennungen
als Plugin-Namen oder Geräte-ID zu spezifizieren.
Für weitere Informationen zum Bildquellenkonzept siehe
Bildquelle. Siehe die
MVTec Interfaces Reference Documentation
für die Dokumentation der einzelnen MVTec Bildquellen-Plugins.
Folgende Optionen bestehen für PluginNamePluginNamePluginNamepluginNameplugin_name.
- <Plugin-Name>
In PluginNamePluginNamePluginNamepluginNameplugin_name kann ein Bildquellen-Plugin
festgelegt werden, indem der Plugin-Name gesetzt wird.
query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources kann verwendet werden um den Plugin-Namen
('plugin_name'"plugin_name""plugin_name""plugin_name""plugin_name") aller verfügbaren Plugins abzufragen.
- 'none'"none""none""none""none"
Kein Plugin wird in ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle
festgelegt.
- 'ignore'"ignore""ignore""ignore""ignore"
Wird ein Plugin über die generischen Parameter
gesetzt (siehe unten), muss PluginNamePluginNamePluginNamepluginNameplugin_name auf 'ignore'"ignore""ignore""ignore""ignore"
gesetzt werden.
Folgende Optionen bestehen für DeviceIDDeviceIDDeviceIDdeviceIDdevice_id.
- <Geräte- ID>
In DeviceIDDeviceIDDeviceIDdeviceIDdevice_id kann ein Bildquellen-Gerät
festgelegt werden, indem die Geräte-ID gesetzt wird.
query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources kann verwendet werden um die Device-ID
'device_id'"device_id""device_id""device_id""device_id" aller verfügbaren Geräte abzufragen.
- 'none'"none""none""none""none"
Kein Gerät wird in ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle
festgelegt.
- 'ignore'"ignore""ignore""ignore""ignore"
Wird ein Gerät über die generischen Parameter
gesetzt (siehe unten), muss DeviceIDDeviceIDDeviceIDdeviceIDdevice_id auf 'ignore'"ignore""ignore""ignore""ignore"
gesetzt werden.
Module des Bildquellen-Handles ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle können auch gesetzt
werden indem eine der folgenden Optionen für GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name übergeben
werden:
- 'plugin_path'"plugin_path""plugin_path""plugin_path""plugin_path":
-
Erzeugen eines Handles, das ein Plugin
spezifiziert, indem der Pfad zur .cti Plugin-Datei als der
entsprechende Parameter GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt wird.
PluginNamePluginNamePluginNamepluginNameplugin_name muss auf 'ignore'"ignore""ignore""ignore""ignore" gesetzt werden.
Für DeviceIDDeviceIDDeviceIDdeviceIDdevice_id muss 'none'"none""none""none""none" oder eine Device-ID gesetzt
werden.
- 'interface_id'"interface_id""interface_id""interface_id""interface_id":
-
Erzeugen eines Handles, das ein Interface
spezifiziert, indem die Interface-ID als der
entsprechende Parameter GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt wird.
Für PluginNamePluginNamePluginNamepluginNameplugin_name muss ein Plugin-Name gesetzt werden.
DeviceIDDeviceIDDeviceIDdeviceIDdevice_id muss auf 'ignore'"ignore""ignore""ignore""ignore" gesetzt werden.
- 'device_user_name'"device_user_name""device_user_name""device_user_name""device_user_name":
-
Erzeugen eines Handles, das ein Gerät
spezifiziert, indem der Benutzername des Gerätes als der
entsprechende Parameter GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt wird.
Für PluginNamePluginNamePluginNamepluginNameplugin_name muss ein Plugin-Name gesetzt werden.
DeviceIDDeviceIDDeviceIDdeviceIDdevice_id muss auf 'ignore'"ignore""ignore""ignore""ignore" gesetzt werden.
- 'device_serial_number'"device_serial_number""device_serial_number""device_serial_number""device_serial_number":
-
Erzeugen eines Handles, das ein Gerät
spezifiziert, indem die Seriennummer des Gerätes als der
entsprechende Parameter GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt wird.
Für PluginNamePluginNamePluginNamepluginNameplugin_name muss ein Plugin-Name gesetzt werden.
DeviceIDDeviceIDDeviceIDdeviceIDdevice_id muss auf 'ignore'"ignore""ignore""ignore""ignore" gesetzt werden.
- 'stream_id'"stream_id""stream_id""stream_id""stream_id":
-
Erzeugen eines Handles, das einen Stream
spezifiziert, indem die Stream-ID als der entsprechende Parameter
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt wird.
Für PluginNamePluginNamePluginNamepluginNameplugin_name muss ein Plugin-Name gesetzt werden.
Für DeviceIDDeviceIDDeviceIDdeviceIDdevice_id muss eine Device-ID gesetzt werden.
Mit query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources können die Werte aller verfügbaren Bildquellen
abgefragt werden.
Ein leeres Bildquellen-Handle kann erzeugt werden indem sowohl
PluginNamePluginNamePluginNamepluginNameplugin_name als auch DeviceIDDeviceIDDeviceIDdeviceIDdevice_id auf 'none'"none""none""none""none" gesetzt
werden und keine generischen Parameter gesetzt werden. Das leere
Bildquellen-Handle kann mit set_image_source_paramset_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param erweitert 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 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.
Parameter
PluginNamePluginNamePluginNamepluginNameplugin_name (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name des Bildquellen-Plugins.
Default:
'none'
"none"
"none"
"none"
"none"
Wertevorschläge:
'none'"none""none""none""none", 'ignore'"ignore""ignore""ignore""ignore", 'mvtec_gigevision'"mvtec_gigevision""mvtec_gigevision""mvtec_gigevision""mvtec_gigevision", 'mvtec_usb3vision'"mvtec_usb3vision""mvtec_usb3vision""mvtec_usb3vision""mvtec_usb3vision", 'mvtec_realsense'"mvtec_realsense""mvtec_realsense""mvtec_realsense""mvtec_realsense", 'mvtec_gstreamer'"mvtec_gstreamer""mvtec_gstreamer""mvtec_gstreamer""mvtec_gstreamer", 'mvtec_mediafoundation'"mvtec_mediafoundation""mvtec_mediafoundation""mvtec_mediafoundation""mvtec_mediafoundation", '<plugin_name>'"<plugin_name>""<plugin_name>""<plugin_name>""<plugin_name>"
DeviceIDDeviceIDDeviceIDdeviceIDdevice_id (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
ID des Bildquellengeräts.
Default:
'none'
"none"
"none"
"none"
"none"
Wertevorschläge:
'none'"none""none""none""none", 'ignore'"ignore""ignore""ignore""ignore"
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Generischer Parametername.
Default:
[]
Wertevorschläge:
'plugin_path'"plugin_path""plugin_path""plugin_path""plugin_path", 'interface_id'"interface_id""interface_id""interface_id""interface_id", '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", 'stream_id'"stream_id""stream_id""stream_id""stream_id"
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Generischer Parameterwert.
Default:
[]
ImageSourceHandleImageSourceHandleImageSourceHandleimageSourceHandleimage_source_handle (output_control) image_source → HImageSource, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Erzeugtes Bildquellen-Handle, das Kennungen von
Modulen enthält.
Beispiel (HDevelop)
* Specify the plugin for GigE Vision devices via its name.
create_image_source ('mvtec_gigevision', 'none', [], [], ImageSourceHandle)
* Specify a plugin by providing its path.
create_image_source ('ignore', 'none', 'plugin_path', 'path/to/plugin.cti', ImageSourceHandle)
*
* Specify a GigE Vision device by providing its unique ID.
create_image_source ('mvtec_gigevision', '00305324c805_Basler_acA244020gc', [], [], ImageSourceHandle)
* Specify a GigE Vision camera by providing its user name.
create_image_source ('mvtec_gigevision', 'ignore', 'device_user_name', 'MyDevice', ImageSourceHandle)
Ergebnis
Sind die Parameterwerte korrekt, dann liefert create_image_sourcecreate_image_sourceCreateImageSourceCreateImageSourcecreate_image_source
den Wert 2 (
H_MSG_TRUE)
.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
connect_image_sourceconnect_image_sourceConnectImageSourceConnectImageSourceconnect_image_source,
get_image_source_paramget_image_source_paramGetImageSourceParamGetImageSourceParamget_image_source_param,
set_image_source_paramset_image_source_paramSetImageSourceParamSetImageSourceParamset_image_source_param
Alternativen
query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources
Siehe auch
query_image_sourcesquery_image_sourcesQueryImageSourcesQueryImageSourcesquery_image_sources
Modul
Foundation