HALCON Reference Manual 10.0.2
Table of Contents / Image / Acquisition ClassesClassesClasses | | | Operators

info_framegrabberT_info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber (Operator)

Name

info_framegrabberT_info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber — Query information about the specified image acquisition interface.

Signature

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 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)

Description

The operator info_framegrabberinfo_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber returns information about the image acquisition device NameNameNameNamename. The desired information is specified via QueryQueryQueryQueryquery. A textual description according to the selected topic is returned in InformationInformationInformationInformationinformation. If applicable, ValueListValueListValueListValueListvalueList contains a list of supported values. Up to now, the following queries are possible:

'bits_per_channel':

List of all supported values for the parameter 'BitsPerChannel', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'camera_type':

Description and list of all supported values for the parameter 'CameraType', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'color_space':

List of all supported values for the parameter 'ColorSpace', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'defaults':

Interface-specific default values in ValueListValueListValueListValueListvalueList, see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'device':

List of all supported values for the parameter 'Device', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'external_trigger':

List of all supported values for the parameter 'ExternalTrigger', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'field':

List of all supported values for the parameter 'Field', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'general':

General information (in InformationInformationInformationInformationinformation).

'generic':

Generic value with device-specific meaning, see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'horizontal_resolution':

List of all supported values for the parameter 'HorizontalResolution', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'image_height':

List of all supported values for the parameter 'ImageHeight', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'image_width':

List of all supported values for the parameter 'ImageWidth', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'info_boards':

Information about actually installed boards or cameras. This data is especially useful for the auto-detect mechansim of ActivVisionTools and for the Image Acquisition Assistant in HDevelop.

'line_in':

List of all supported values for the parameter 'LineIn', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'parameters':

List of all interface-specific parameters which are accessible via set_framegrabber_paramset_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam or get_framegrabber_paramget_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParam.

'parameters_readonly':

List of all interface-specific parameters which are only accessible via get_framegrabber_paramget_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParam.

'parameters_writeonly':

List of all interface-specific parameters which are only accessible via set_framegrabber_paramset_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam.

'port':

List of all supported values for the parameter 'Port', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'revision':

Version number of the image acquisition interface.

'start_column':

List of all supported values for the parameter 'StartColumn', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'start_row':

List of all supported values for the parameter 'StartRow', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

'vertical_resolution':

List of all supported values for the parameter 'VerticalResolution', see open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber.

Please check also the directory 'doc/html/manuals'"doc/html/manuals""doc/html/manuals""doc/html/manuals""doc/html/manuals" for documentation about specific image grabber interfaces.

Parallelization

Parameters

NameNameNameNamename (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

HALCON image acquisition interface name, i.e., name of the corresponding DLL (Windows) or shared library (Linux/UNIX).

Default value: 'File' "File" "File" "File" "File"

Suggested values: '1394IIDC'"1394IIDC""1394IIDC""1394IIDC""1394IIDC", '1394IIDC-2'"1394IIDC-2""1394IIDC-2""1394IIDC-2""1394IIDC-2", '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", 'eneo'"eneo""eneo""eneo""eneo", 'File'"File""File""File""File", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision'"GigEVision""GigEVision""GigEVision""GigEVision", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG", 'INSPECTA'"INSPECTA""INSPECTA""INSPECTA""INSPECTA", 'INSPECTA5'"INSPECTA5""INSPECTA5""INSPECTA5""INSPECTA5", '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", 'Opteon'"Opteon""Opteon""Opteon""Opteon", 'p3i2'"p3i2""p3i2""p3i2""p3i2", 'PcEyeCL'"PcEyeCL""PcEyeCL""PcEyeCL""PcEyeCL", 'PixeLINK'"PixeLINK""PixeLINK""PixeLINK""PixeLINK", '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", 'SiliconSoftware'"SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware", 'SonyXCI-2'"SonyXCI-2""SonyXCI-2""SonyXCI-2""SonyXCI-2", 'SVCam-GigE'"SVCam-GigE""SVCam-GigE""SVCam-GigE""SVCam-GigE", 'TWAIN'"TWAIN""TWAIN""TWAIN""TWAIN", 'uEye'"uEye""uEye""uEye""uEye", 'VRmAreaScan3D'"VRmAreaScan3D""VRmAreaScan3D""VRmAreaScan3D""VRmAreaScan3D", 'VRmUsbCam'"VRmUsbCam""VRmUsbCam""VRmUsbCam""VRmUsbCam"

QueryQueryQueryQueryquery (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name of the chosen query.

Default value: 'info_boards' "info_boards" "info_boards" "info_boards" "info_boards"

List of values: 'defaults'"defaults""defaults""defaults""defaults", 'general'"general""general""general""general", '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", 'revision'"revision""revision""revision""revision", '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", 'device'"device""device""device""device", 'external_trigger'"external_trigger""external_trigger""external_trigger""external_trigger", 'field'"field""field""field""field", '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", 'port'"port""port""port""port", '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 → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Textual information (according to QueryQueryQueryQueryquery).

ValueListValueListValueListValueListvalueList (output_control)  string-array → HTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

List of values (according to QueryQueryQueryQueryquery).

Example (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Choose the port P and the input line L your camera is connected to
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',P,L,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

Example (C)

/* Select a suitable image acquisition interface name AcqName*/
info_framegrabber(AcqName,"port",&Information,&Values) ;
/* Choose the port P and the input line L your camera is connected to */
open_framegrabber(AcqName,1,1,0,0,0,0,"default",-1,"default",-1.0,
                  "default","default","default",P,L,&AcqHandle) ;
grab_image(Image,AcqHandle) ;
close_framegrabber(AcqHandle) ;

Example (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Choose the port P and the input line L your camera is connected to
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',P,L,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

Example (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Choose the port P and the input line L your camera is connected to
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',P,L,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

Example (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Choose the port P and the input line L your camera is connected to
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',P,L,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

Result

If the parameter values are correct and the specified image acquistion interface is available, info_framegrabberinfo_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber

Possible Successors

open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber

See also

open_framegrabberopen_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber

Module

Foundation

Table of Contents / Image / Acquisition ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH