info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber (Operator)
Name
info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber — Ausgabe von Informationen zur angegebenen Bildeinzugsschnittstelle.
Signatur
def info_framegrabber(name: str, query: str) -> Tuple[str, Sequence[Union[str, int, float]]]
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':
Auflistung aller unterstützten Werte für den
Parameter BitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'camera_type':
Beschreibung und Auflistung aller unterstützten
Werte für den Parameter CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'color_space':
Auflistung aller unterstützten Werte für den Parameter
ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'defaults':
Schnittstellen-spezifische Defaultwerte in
ValueListValueListValueListValueListvalueListvalue_list, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'device':
Auflistung aller unterstützten Werte für den Parameter
DeviceDeviceDeviceDevicedevicedevice, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'external_trigger':
Auflistung aller unterstützten Werte für den
Parameter ExternalTriggerExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'field':
Auflistung aller unterstützten Werte für den Parameter
FieldFieldFieldFieldfieldfield, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'general':
Allgemeine Angaben in InformationInformationInformationInformationinformationinformation.
- 'generic':
Generischer Wert mit gerätespezifischer Bedeutung,
vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'horizontal_resolution':
Auflistung aller unterstützten Werte für den
Parameter HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'image_height':
Auflistung aller unterstützten Werte für den Parameter
ImageHeightImageHeightImageHeightImageHeightimageHeightimage_height, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'image_width':
Auflistung aller unterstützten Werte für den Parameter
ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- '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 Assistant in HDevelop
verwendet.
- 'line_in':
Auflistung aller unterstützten Werte für den Parameter
LineInLineInLineInLineInlineInline_in, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- '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':
Auflistung aller Schnittstellen-spezifischen
Parameter, die nur über
get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param zugänglich sind.
- 'parameters_writeonly':
Auflistung aller Schnittstellen-spezifischen
Parameter, die nur über
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param zugänglich sind.
- 'port':
Auflistung aller unterstützten Werte für den Parameter
PortPortPortPortportport, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'revision':
Aktuelle Versionsnummer der Bildeinzugsschnittstelle.
- 'start_column':
Auflistung aller unterstützten Werte für den Parameter
StartColumnStartColumnStartColumnStartColumnstartColumnstart_column, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'start_row':
Auflistung aller unterstützten Werte für den Parameter
StartRowStartRowStartRowStartRowstartRowstart_row, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- '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'"doc/html/reference/acquisition""doc/html/reference/acquisition""doc/html/reference/acquisition""doc/html/reference/acquisition""doc/html/reference/acquisition".
Achtung
Aus Sicht einer Anwendung mit mehreren Threads bilden alle
Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber aufgelistet)
eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber,
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber und
close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers exklusiv ausgeführt werden.
D.h., info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber,
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers verhindern die
gleichzeitige Ausführung anderer Operatoren innerhalb der Gruppe, 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 → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
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", '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 → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
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 → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Textuelle Information (abhängig von
QueryQueryQueryQueryqueryquery).
ValueListValueListValueListValueListvalueListvalue_list (output_control) string-array → HTupleSequence[Union[str, int, float]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
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 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