HALCON Website / HALCON Operator-Referenz / Bild / Bildeinzug
KlassenKlassenKlassenKlassen | | | | Operatoren

info_framegrabberT_info_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber (Operator)

Name

info_framegrabberT_info_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber — Ausgabe von Informationen zur angegebenen Bildeinzugsschnittstelle.

Signatur

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

Herror T_info_framegrabber(const Htuple Name, const Htuple Query, Htuple* Information, Htuple* ValueList)

Herror info_framegrabber(const HTuple& Name, const HTuple& Query, HTuple* Information, HTuple* ValueList)

void InfoFramegrabber(const HTuple& Name, const HTuple& Query, HTuple* Information, HTuple* ValueList)

static HString HInfo::InfoFramegrabber(const HString& Name, const HString& Query, HTuple* ValueList)

static HString HInfo::InfoFramegrabber(const char* Name, const char* Query, HTuple* ValueList)

void HOperatorSetX.InfoFramegrabber(
[in] VARIANT Name, [in] VARIANT Query, [out] VARIANT* Information, [out] VARIANT* ValueList)

BSTR HInfoX.InfoFramegrabber(
[in] BSTR Name, [in] BSTR Query, [out] VARIANT* ValueList)

static void HOperatorSet.InfoFramegrabber(HTuple name, HTuple query, out HTuple information, out HTuple valueList)

static string HInfo.InfoFramegrabber(string name, string query, out HTuple valueList)

Beschreibung

info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber 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 ValueListValueListValueListValueListValueListvalueList 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_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'camera_type':

Beschreibung und Auflistung aller unterstützten Werte für den Parameter 'CameraType', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'color_space':

Auflistung aller unterstützten Werte für den Parameter 'ColorSpace', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'defaults':

Schnittstellen-spezifische Defaultwerte in ValueListValueListValueListValueListValueListvalueList, vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'device':

Auflistung aller unterstützten Werte für den Parameter 'Device', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'external_trigger':

Auflistung aller unterstützten Werte für den Parameter 'ExternalTrigger', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'field':

Auflistung aller unterstützten Werte für den Parameter 'Field', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'general':

Allgemeine Angaben in InformationInformationInformationInformationInformationinformation.

'generic':

Generischer Wert mit gerätespezifischer Bedeutung, vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'horizontal_resolution':

Auflistung aller unterstützten Werte für den Parameter 'HorizontalResolution', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'image_height':

Auflistung aller unterstützten Werte für den Parameter 'ImageHeight', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'image_width':

Auflistung aller unterstützten Werte für den Parameter 'ImageWidth', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'info_boards':

Informationen über die tatsächlich im Rechner installierten Bildeinzugsgeräte. Diese Daten werden vor allem für den Auto-detect-Mechanismus von ActivVisionTools sowie dem Image Acquisition Assistant in HDevelop verwendet.

'line_in':

Auflistung aller unterstützten Werte für den Parameter 'LineIn', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'parameters':

Auflistung aller Schnittstellen-spezifischen Parameter, die über set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam bzw. get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamget_framegrabber_paramGetFramegrabberParamGetFramegrabberParam zugänglich sind.

'parameters_readonly':

Auflistung aller Schnittstellen-spezifischen Parameter, die nur über get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamget_framegrabber_paramGetFramegrabberParamGetFramegrabberParam zugänglich sind.

'parameters_writeonly':

Auflistung aller Schnittstellen-spezifischen Parameter, die nur über set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam zugänglich sind.

'port':

Auflistung aller unterstützten Werte für den Parameter 'Port', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'revision':

Aktuelle Versionsnummer der Bildeinzugsschnittstelle.

'start_column':

Auflistung aller unterstützten Werte für den Parameter 'StartColumn', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'start_row':

Auflistung aller unterstützten Werte für den Parameter 'StartRow', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'vertical_resolution':

Auflistung aller unterstützten Werte für den Parameter 'VerticalResolution', vgl. open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

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""doc/html/reference/acquisition".

Achtung

Aus Sicht einer Anwendung mit mehreren Threads bilden alle Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber aufgelistet) eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.

D.h., info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers verhindern die gleichzeitige Ausführung anderer Operatoren innerhalb der Gruppe, laufen aber mit allen nicht exklusiven Operatoren außerhalb der Gruppe parallel.

Parallelisierung

Parameter

NameNameNameNameNamename (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

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

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

Wertevorschläge: '1394IIDC'"1394IIDC""1394IIDC""1394IIDC""1394IIDC""1394IIDC", '1394IIDC-2'"1394IIDC-2""1394IIDC-2""1394IIDC-2""1394IIDC-2""1394IIDC-2", 'ABS'"ABS""ABS""ABS""ABS""ABS", 'ADLINK'"ADLINK""ADLINK""ADLINK""ADLINK""ADLINK", '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", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision'"GigEVision""GigEVision""GigEVision""GigEVision""GigEVision", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++""Ginga++", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG""GingaDG", 'INSPECTA'"INSPECTA""INSPECTA""INSPECTA""INSPECTA""INSPECTA", 'INSPECTA5'"INSPECTA5""INSPECTA5""INSPECTA5""INSPECTA5""INSPECTA5", '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", 'OpenNI'"OpenNI""OpenNI""OpenNI""OpenNI""OpenNI", 'Opteon'"Opteon""Opteon""Opteon""Opteon""Opteon", 'p3i2'"p3i2""p3i2""p3i2""p3i2""p3i2", 'PcEyeCL'"PcEyeCL""PcEyeCL""PcEyeCL""PcEyeCL""PcEyeCL", 'PixeLINK'"PixeLINK""PixeLINK""PixeLINK""PixeLINK""PixeLINK", 'pylon'"pylon""pylon""pylon""pylon""pylon", 'SaperaLT'"SaperaLT""SaperaLT""SaperaLT""SaperaLT""SaperaLT", 'Sentech'"Sentech""Sentech""Sentech""Sentech""Sentech", 'ShapeDrive'"ShapeDrive""ShapeDrive""ShapeDrive""ShapeDrive""ShapeDrive", 'SICK-3DCamera'"SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera", 'SiliconSoftware'"SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware", 'SonyXCI-2'"SonyXCI-2""SonyXCI-2""SonyXCI-2""SonyXCI-2""SonyXCI-2", 'SwissRanger'"SwissRanger""SwissRanger""SwissRanger""SwissRanger""SwissRanger", '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 → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (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 → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Textuelle Information (abhängig von QueryQueryQueryQueryQueryquery).

ValueListValueListValueListValueListValueListvalueList (output_control)  string-array → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / 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)

Beispiel (C)

/* 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) ;

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)

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)

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)

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_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber

Nachfolger

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber

Siehe auch

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH