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_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber liefert Informationen zur angegebenen
Bildeinzugsschnittstelle NameNameNamenamename. Über den Parameter QueryQueryQueryqueryquery
wird die gewünschte Information ausgewählt. In InformationInformationInformationinformationinformation
wird dann eine textuelle Beschreibung, in ValueListValueListValueListvalueListvalue_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 BitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'camera_type':
Beschreibung und Auflistung aller unterstützten
Werte für den Parameter CameraTypeCameraTypeCameraTypecameraTypecamera_type, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'color_space':
Auflistung aller unterstützten Werte für den Parameter
ColorSpaceColorSpaceColorSpacecolorSpacecolor_space, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'defaults':
Schnittstellen-spezifische Defaultwerte in
ValueListValueListValueListvalueListvalue_list, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'device':
Auflistung aller unterstützten Werte für den Parameter
DeviceDeviceDevicedevicedevice, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'external_trigger':
Auflistung aller unterstützten Werte für den
Parameter ExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'field':
Auflistung aller unterstützten Werte für den Parameter
FieldFieldFieldfieldfield, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'general':
Allgemeine Angaben in InformationInformationInformationinformationinformation.
- 'generic':
Generischer Wert mit gerätespezifischer Bedeutung,
vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'horizontal_resolution':
Auflistung aller unterstützten Werte für den
Parameter HorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'image_height':
Auflistung aller unterstützten Werte für den Parameter
ImageHeightImageHeightImageHeightimageHeightimage_height, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'image_width':
Auflistung aller unterstützten Werte für den Parameter
ImageWidthImageWidthImageWidthimageWidthimage_width, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_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 Assistenten in HDevelop
verwendet.
- 'line_in':
Auflistung aller unterstützten Werte für den Parameter
LineInLineInLineInlineInline_in, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'parameters':
Auflistung aller Schnittstellen-spezifischen Parameter,
die über set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param
bzw. get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamget_framegrabber_param zugänglich sind.
- 'parameters_readonly':
Auflistung aller Schnittstellen-spezifischen
Parameter, die nur über
get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamget_framegrabber_param zugänglich sind.
- 'parameters_writeonly':
Auflistung aller Schnittstellen-spezifischen
Parameter, die nur über
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param zugänglich sind.
- 'port':
Auflistung aller unterstützten Werte für den Parameter
PortPortPortportport, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'revision':
Aktuelle Versionsnummer der Bildeinzugsschnittstelle.
- 'start_column':
Auflistung aller unterstützten Werte für den Parameter
StartColumnStartColumnStartColumnstartColumnstart_column, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'start_row':
Auflistung aller unterstützten Werte für den Parameter
StartRowStartRowStartRowstartRowstart_row, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.
- 'vertical_resolution':
Auflistung aller unterstützten Werte für den
Parameter VerticalResolutionVerticalResolutionVerticalResolutionverticalResolutionvertical_resolution, vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_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".
Achtung
Aus Sicht einer Anwendung mit mehreren Threads werden info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber,
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber und close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber exklusiv ausgeführt.
D.h., info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber und
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberclose_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
NameNameNamenamename (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der HALCON Bildeinzugsschnittstelle,
d.h. Name der zugehörigen DLL (Windows)
bzw. 'shared library' (Linux).
Default:
'File'
"File"
"File"
"File"
"File"
Wertevorschläge:
'ABS'"ABS""ABS""ABS""ABS", 'ADLINK'"ADLINK""ADLINK""ADLINK""ADLINK", 'AlkUSB3'"AlkUSB3""AlkUSB3""AlkUSB3""AlkUSB3", 'Andor'"Andor""Andor""Andor""Andor", 'BitFlow'"BitFlow""BitFlow""BitFlow""BitFlow", 'Crevis'"Crevis""Crevis""Crevis""Crevis", 'DahengCAM'"DahengCAM""DahengCAM""DahengCAM""DahengCAM", 'DirectFile'"DirectFile""DirectFile""DirectFile""DirectFile", 'DirectShow'"DirectShow""DirectShow""DirectShow""DirectShow", 'Ensenso-NxLib'"Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib", 'File'"File""File""File""File", 'FocalSpecLCI'"FocalSpecLCI""FocalSpecLCI""FocalSpecLCI""FocalSpecLCI", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision2'"GigEVision2""GigEVision2""GigEVision2""GigEVision2", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++", 'GStreamer'"GStreamer""GStreamer""GStreamer""GStreamer", 'heliCamC3'"heliCamC3""heliCamC3""heliCamC3""heliCamC3", 'KeyenceVJ'"KeyenceVJ""KeyenceVJ""KeyenceVJ""KeyenceVJ", 'LinX'"LinX""LinX""LinX""LinX", 'LPS36'"LPS36""LPS36""LPS36""LPS36", 'LuCam'"LuCam""LuCam""LuCam""LuCam", 'MatrixVisionAcquire'"MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire", 'MediaFoundation'"MediaFoundation""MediaFoundation""MediaFoundation""MediaFoundation", 'MILLite'"MILLite""MILLite""MILLite""MILLite", 'MultiCam'"MultiCam""MultiCam""MultiCam""MultiCam", 'O3D3xx'"O3D3xx""O3D3xx""O3D3xx""O3D3xx", 'Opteon'"Opteon""Opteon""Opteon""Opteon", 'PhoXi'"PhoXi""PhoXi""PhoXi""PhoXi", 'PixeLINK'"PixeLINK""PixeLINK""PixeLINK""PixeLINK", 'pylon'"pylon""pylon""pylon""pylon", 'RealSense'"RealSense""RealSense""RealSense""RealSense", 'SaperaLT'"SaperaLT""SaperaLT""SaperaLT""SaperaLT", 'Sentech'"Sentech""Sentech""Sentech""Sentech", 'SICK-3DCamera'"SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera", 'SICK-ScanningRuler'"SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler", 'SiliconSoftware'"SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware", 'Slink'"Slink""Slink""Slink""Slink", 'TWAIN'"TWAIN""TWAIN""TWAIN""TWAIN", 'uEye'"uEye""uEye""uEye""uEye", 'USB3Vision'"USB3Vision""USB3Vision""USB3Vision""USB3Vision", 'Video4Linux2'"Video4Linux2""Video4Linux2""Video4Linux2""Video4Linux2", 'VRmUsbCam'"VRmUsbCam""VRmUsbCam""VRmUsbCam""VRmUsbCam"
QueryQueryQueryqueryquery (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der gewählten Anfrage.
Default:
'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", 'camera_type'"camera_type""camera_type""camera_type""camera_type", 'color_space'"color_space""color_space""color_space""color_space", 'defaults'"defaults""defaults""defaults""defaults", 'device'"device""device""device""device", 'external_trigger'"external_trigger""external_trigger""external_trigger""external_trigger", 'field'"field""field""field""field", 'general'"general""general""general""general", 'generic'"generic""generic""generic""generic", 'horizontal_resolution'"horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution", 'image_height'"image_height""image_height""image_height""image_height", 'image_width'"image_width""image_width""image_width""image_width", 'info_boards'"info_boards""info_boards""info_boards""info_boards", 'parameters'"parameters""parameters""parameters""parameters", 'parameters_readonly'"parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly", 'parameters_writeonly'"parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly", 'port'"port""port""port""port", 'revision'"revision""revision""revision""revision", 'start_column'"start_column""start_column""start_column""start_column", 'start_row'"start_row""start_row""start_row""start_row", 'vertical_resolution'"vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution"
InformationInformationInformationinformationinformation (output_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Textuelle Information (abhängig von
QueryQueryQueryqueryquery).
ValueListValueListValueListvalueListvalue_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 QueryQueryQueryqueryquery).
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_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
den Wert 2 (
H_MSG_TRUE)
. Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
Nachfolger
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
Siehe auch
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
Modul
Foundation