info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber (Operator)

Name

info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber — Ausgabe von Informationen zur angegebenen Bildeinzugsschnittstelle.

Signatur

info_framegrabber( : : Name, Query : Information, ValueList)

Beschreibung

info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber liefert Informationen zur angegebenen Bildeinzugsschnittstelle NameNameNameNamenamename. Über den Parameter QueryQueryQueryQueryqueryquery wird die gewünschte Information ausgewählt. In InformationInformationInformationInformationinformationinformation wird dann eine textuelle Beschreibung, in ValueListValueListValueListValueListvalueListvalue_list gegebenenfalls eine Liste von zulässigen Werten zurückgegeben. Derzeit werden folgende Abfragen unterstützt:

'bits_per_channel'"bits_per_channel""bits_per_channel""bits_per_channel""bits_per_channel""bits_per_channel":: Auflistung aller unterstützten Werte für den Parameter BitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'camera_type'"camera_type""camera_type""camera_type""camera_type""camera_type":: Beschreibung und Auflistung aller unterstützten Werte für den Parameter CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'color_space'"color_space""color_space""color_space""color_space""color_space":: Auflistung aller unterstützten Werte für den Parameter ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'defaults'"defaults""defaults""defaults""defaults""defaults":: Schnittstellen-spezifische Defaultwerte in ValueListValueListValueListValueListvalueListvalue_list, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'device'"device""device""device""device""device":: Auflistung aller unterstützten Werte für den Parameter DeviceDeviceDeviceDevicedevicedevice, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'external_trigger'"external_trigger""external_trigger""external_trigger""external_trigger""external_trigger":: Auflistung aller unterstützten Werte für den Parameter ExternalTriggerExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'field'"field""field""field""field""field":: Auflistung aller unterstützten Werte für den Parameter FieldFieldFieldFieldfieldfield, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'general'"general""general""general""general""general":: Allgemeine Angaben in InformationInformationInformationInformationinformationinformation.
'generic'"generic""generic""generic""generic""generic":: Generischer Wert mit gerätespezifischer Bedeutung, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'horizontal_resolution'"horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution":: Auflistung aller unterstützten Werte für den Parameter HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'image_height'"image_height""image_height""image_height""image_height""image_height":: Auflistung aller unterstützten Werte für den Parameter ImageHeightImageHeightImageHeightImageHeightimageHeightimage_height, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'image_width'"image_width""image_width""image_width""image_width""image_width":: Auflistung aller unterstützten Werte für den Parameter ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'info_boards'"info_boards""info_boards""info_boards""info_boards""info_boards":: Informationen über die tatsächlich im Rechner installierten Bildeinzugsgeräte. Diese Daten werden z.B für den Auto-detect-Mechanismus des Image Acquisition Assistenten in HDevelop verwendet.
'line_in'"line_in""line_in""line_in""line_in""line_in":: Auflistung aller unterstützten Werte für den Parameter LineInLineInLineInLineInlineInline_in, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'parameters'"parameters""parameters""parameters""parameters""parameters":: Auflistung aller Schnittstellen-spezifischen Parameter, die über set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param bzw. get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param zugänglich sind.
'parameters_readonly'"parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly":: Auflistung aller Schnittstellen-spezifischen Parameter, die nur über get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param zugänglich sind.
'parameters_writeonly'"parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly":: Auflistung aller Schnittstellen-spezifischen Parameter, die nur über set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param zugänglich sind.
'port'"port""port""port""port""port":: Auflistung aller unterstützten Werte für den Parameter PortPortPortPortportport, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'revision'"revision""revision""revision""revision""revision":: Aktuelle Versionsnummer der Bildeinzugsschnittstelle.
'start_column'"start_column""start_column""start_column""start_column""start_column":: Auflistung aller unterstützten Werte für den Parameter StartColumnStartColumnStartColumnStartColumnstartColumnstart_column, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'start_row'"start_row""start_row""start_row""start_row""start_row":: Auflistung aller unterstützten Werte für den Parameter StartRowStartRowStartRowStartRowstartRowstart_row, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
'vertical_resolution'"vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution":: Auflistung aller unterstützten Werte für den Parameter VerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionverticalResolutionvertical_resolution, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

Weitere Informationen zu spezifischen Bildeinzugsschnittstellen findet sich in der Dokumentation aller Bildeinzugsschnittstellen im Verzeichnis doc/html/reference/acquisition.

Achtung

Aus Sicht einer Anwendung mit mehreren Threads werden info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber und close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber exklusiv ausgeführt. D.h., info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber und close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber verhindern die gleichzeitige Ausführung untereinander, laufen aber mit allen nicht exklusiven Operatoren außerhalb der Gruppe parallel.

Auf Windows Systemen können Fehler-Dialogboxen vom Betriebssystems erscheinen, wenn abhängende Module des Interfaces nicht gefunden werden können. Dies ist beispielsweise der Fall, wenn das entsprechende SDK nicht installiert wurde. Das Erscheinen der Dialogboxen kann über Windows Error Mode kontrolliert werden. Informationen dazu finden sich in der Beschreibung von SetErrorMode in der MSDN Dokumentation.

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

NameNameNameNamenamename (input_control) string → (string)

Name der HALCON Bildeinzugsschnittstelle, d.h. Name der zugehörigen DLL (Windows) bzw. 'shared library' (Linux/macOS).

Defaultwert: 'File' "File" "File" "File" "File" "File"

Wertevorschläge: 'ABS'"ABS""ABS""ABS""ABS""ABS", 'ADLINK'"ADLINK""ADLINK""ADLINK""ADLINK""ADLINK", 'AlkUSB3'"AlkUSB3""AlkUSB3""AlkUSB3""AlkUSB3""AlkUSB3", 'Andor'"Andor""Andor""Andor""Andor""Andor", 'BitFlow'"BitFlow""BitFlow""BitFlow""BitFlow""BitFlow", 'Crevis'"Crevis""Crevis""Crevis""Crevis""Crevis", 'DahengCAM'"DahengCAM""DahengCAM""DahengCAM""DahengCAM""DahengCAM", 'DirectFile'"DirectFile""DirectFile""DirectFile""DirectFile""DirectFile", 'DirectShow'"DirectShow""DirectShow""DirectShow""DirectShow""DirectShow", 'Ensenso-NxLib'"Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib", 'File'"File""File""File""File""File", 'FocalSpecLCI'"FocalSpecLCI""FocalSpecLCI""FocalSpecLCI""FocalSpecLCI""FocalSpecLCI", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision2'"GigEVision2""GigEVision2""GigEVision2""GigEVision2""GigEVision2", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG""GingaDG", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++""Ginga++", 'GStreamer'"GStreamer""GStreamer""GStreamer""GStreamer""GStreamer", 'heliCamC3'"heliCamC3""heliCamC3""heliCamC3""heliCamC3""heliCamC3", 'KeyenceVJ'"KeyenceVJ""KeyenceVJ""KeyenceVJ""KeyenceVJ""KeyenceVJ", 'LinX'"LinX""LinX""LinX""LinX""LinX", 'LPS36'"LPS36""LPS36""LPS36""LPS36""LPS36", 'LuCam'"LuCam""LuCam""LuCam""LuCam""LuCam", 'MatrixVisionAcquire'"MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire", 'MILLite'"MILLite""MILLite""MILLite""MILLite""MILLite", 'MultiCam'"MultiCam""MultiCam""MultiCam""MultiCam""MultiCam", 'O3D3xx'"O3D3xx""O3D3xx""O3D3xx""O3D3xx""O3D3xx", 'Opteon'"Opteon""Opteon""Opteon""Opteon""Opteon", 'PhoXi'"PhoXi""PhoXi""PhoXi""PhoXi""PhoXi", 'PixeLINK'"PixeLINK""PixeLINK""PixeLINK""PixeLINK""PixeLINK", 'pylon'"pylon""pylon""pylon""pylon""pylon", 'RealSense'"RealSense""RealSense""RealSense""RealSense""RealSense", 'SaperaLT'"SaperaLT""SaperaLT""SaperaLT""SaperaLT""SaperaLT", 'Sentech'"Sentech""Sentech""Sentech""Sentech""Sentech", 'SICK-3DCamera'"SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera", 'SICK-ScanningRuler'"SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler", 'SiliconSoftware'"SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware", 'Slink'"Slink""Slink""Slink""Slink""Slink", 'TWAIN'"TWAIN""TWAIN""TWAIN""TWAIN""TWAIN", 'uEye'"uEye""uEye""uEye""uEye""uEye", 'USB3Vision'"USB3Vision""USB3Vision""USB3Vision""USB3Vision""USB3Vision", 'Video4Linux2'"Video4Linux2""Video4Linux2""Video4Linux2""Video4Linux2""Video4Linux2", 'VRmUsbCam'"VRmUsbCam""VRmUsbCam""VRmUsbCam""VRmUsbCam""VRmUsbCam"

QueryQueryQueryQueryqueryquery (input_control) string → (string)

Name der gewählten Anfrage.

Defaultwert: 'info_boards' "info_boards" "info_boards" "info_boards" "info_boards" "info_boards"

Werteliste: 'bits_per_channel'"bits_per_channel""bits_per_channel""bits_per_channel""bits_per_channel""bits_per_channel", 'camera_type'"camera_type""camera_type""camera_type""camera_type""camera_type", 'color_space'"color_space""color_space""color_space""color_space""color_space", 'defaults'"defaults""defaults""defaults""defaults""defaults", 'device'"device""device""device""device""device", 'external_trigger'"external_trigger""external_trigger""external_trigger""external_trigger""external_trigger", 'field'"field""field""field""field""field", 'general'"general""general""general""general""general", 'generic'"generic""generic""generic""generic""generic", 'horizontal_resolution'"horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution", 'image_height'"image_height""image_height""image_height""image_height""image_height", 'image_width'"image_width""image_width""image_width""image_width""image_width", 'info_boards'"info_boards""info_boards""info_boards""info_boards""info_boards", 'parameters'"parameters""parameters""parameters""parameters""parameters", 'parameters_readonly'"parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly", 'parameters_writeonly'"parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly", 'port'"port""port""port""port""port", 'revision'"revision""revision""revision""revision""revision", 'start_column'"start_column""start_column""start_column""start_column""start_column", 'start_row'"start_row""start_row""start_row""start_row""start_row", 'vertical_resolution'"vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution"

InformationInformationInformationInformationinformationinformation (output_control) string → (string)

Textuelle Information (abhängig von QueryQueryQueryQueryqueryquery).

ValueListValueListValueListValueListvalueListvalue_list (output_control) string-array → (string / integer / real)

Werteliste (abhängig von QueryQueryQueryQueryqueryquery).

Beispiel (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Open image acquisition device using the default settings, see
* documentation of the actually used interface for more details
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',-1,-1,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

Ergebnis

Sind die Parameterwerte korrekt und ist die angegebene Bildeinzugsschnittstelle verfügbar, liefert info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

Nachfolger

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

Siehe auch

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

Modul

Foundation

Operatoren