info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabber (Operator)
Name
info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabber — Ausgabe von Informationen zur angegebenen Bildeinzugsschnittstelle.
Signatur
Beschreibung
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber 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 ValueListValueListValueListValueListvalueList
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 'BitsPerChannel', vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'camera_type':
Beschreibung und Auflistung aller unterstützten
Werte für den Parameter 'CameraType', vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'color_space':
Auflistung aller unterstützten Werte für den
Parameter 'ColorSpace', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'defaults':
Schnittstellen-spezifische Defaultwerte
in ValueListValueListValueListValueListvalueList, vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'device':
Auflistung aller unterstützten Werte für den
Parameter 'Device', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'external_trigger':
Auflistung aller unterstützten Werte für den
Parameter 'ExternalTrigger', vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'field':
Auflistung aller unterstützten Werte für den
Parameter 'Field', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'general':
Allgemeine Angaben in InformationInformationInformationInformationinformation.
- 'generic':
Generischer Wert mit gerätespezifischer Bedeutung,
vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'horizontal_resolution':
Auflistung aller unterstützten Werte für den
Parameter 'HorizontalResolution', vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'image_height':
Auflistung aller unterstützten Werte für den
Parameter 'ImageHeight', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'image_width':
Auflistung aller unterstützten Werte für den
Parameter 'ImageWidth', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- '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 'LineIn', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'parameters':
Auflistung aller Schnittstellen-spezifischen
Parameter, die über set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam
bzw. get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParam zugänglich sind.
- 'parameters_readonly':
Auflistung aller Schnittstellen-spezifischen
Parameter, die nur über
get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParam zugänglich sind.
- 'parameters_writeonly':
Auflistung aller Schnittstellen-spezifischen
Parameter, die nur über
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam zugänglich sind.
- 'port':
Auflistung aller unterstützten Werte für den
Parameter 'Port', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'revision':
Aktuelle Versionsnummer der Bildeinzugsschnittstelle.
- 'start_column':
Auflistung aller unterstützten Werte für den
Parameter 'StartColumn', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'start_row':
Auflistung aller unterstützten Werte für den
Parameter 'StartRow', vgl. open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
- 'vertical_resolution':
Auflistung aller unterstützten Werte für den
Parameter 'VerticalResolution', vgl.
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber.
Weitere Infomationen 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 bilden alle
Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber aufgelistet)
eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber,
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und
close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.
D.h., info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber,
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers 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 Betriebsystems
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 → HTupleHTupleHtuple (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"
Wertevorschläge: 'ABS'"ABS""ABS""ABS""ABS", 'ADLINK'"ADLINK""ADLINK""ADLINK""ADLINK", '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", 'FocalSpecCLI'"FocalSpecCLI""FocalSpecCLI""FocalSpecCLI""FocalSpecCLI", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision2'"GigEVision2""GigEVision2""GigEVision2""GigEVision2", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG", 'heliCamC3'"heliCamC3""heliCamC3""heliCamC3""heliCamC3", 'LinX'"LinX""LinX""LinX""LinX", 'LPS36'"LPS36""LPS36""LPS36""LPS36", 'LuCam'"LuCam""LuCam""LuCam""LuCam", 'MatrixVisionAcquire'"MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire", '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", 'pylon'"pylon""pylon""pylon""pylon", '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", '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 → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der gewählten Anfrage.
Defaultwert:
'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 → HTupleHTupleHtuple (string) (string) (HString) (char*)
Textuelle Information (abhängig von
QueryQueryQueryQueryquery).
ValueListValueListValueListValueListvalueList (output_control) string-array → HTupleHTupleHtuple (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_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber
den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber
Nachfolger
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber
Siehe auch
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber
Modul
Foundation