info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber (Operator)

Name

info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber — Query information about the specified image acquisition interface.

Signature

Description

The operator info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber 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, ValueListValueListValueListvalueListvalue_list 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 BitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'camera_type':

Description and list of all supported values for the parameter CameraTypeCameraTypeCameraTypecameraTypecamera_type, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'color_space':

List of all supported values for the parameter ColorSpaceColorSpaceColorSpacecolorSpacecolor_space, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'defaults':

Interface-specific default values in ValueListValueListValueListvalueListvalue_list, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'device':

List of all supported values for the parameter DeviceDeviceDevicedevicedevice, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'external_trigger':

List of all supported values for the parameter ExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'field':

List of all supported values for the parameter FieldFieldFieldfieldfield, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'general':

General information (in InformationInformationInformationinformationinformation).

'generic':

Generic value with device-specific meaning, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'horizontal_resolution':

List of all supported values for the parameter HorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'image_height':

List of all supported values for the parameter ImageHeightImageHeightImageHeightimageHeightimage_height, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'image_width':

List of all supported values for the parameter ImageWidthImageWidthImageWidthimageWidthimage_width, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'info_boards':

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

'line_in':

List of all supported values for the parameter LineInLineInLineInlineInline_in, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'parameters':

List of all interface-specific parameters which are accessible via set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param or get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamget_framegrabber_param.

'parameters_readonly':

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

'parameters_writeonly':

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

'port':

List of all supported values for the parameter PortPortPortportport, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'revision':

Version number of the image acquisition interface.

'start_column':

List of all supported values for the parameter StartColumnStartColumnStartColumnstartColumnstart_column, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'start_row':

List of all supported values for the parameter StartRowStartRowStartRowstartRowstart_row, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

'vertical_resolution':

List of all supported values for the parameter VerticalResolutionVerticalResolutionVerticalResolutionverticalResolutionvertical_resolution, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber.

Please check also the directory doc/html/reference/acquisition for documentation about specific image grabber interfaces.

Attention

For a multithreaded application, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, and close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber are executed exclusively. Thus, they block the concurrent execution of each other, but run in parallel with all non-exclusive operators outside of this group.

On Windows Systems, error dialog boxes from the operating system can occur when dependency modules of the interface are not found, e.g., the according SDK was not installed. The occurrence of the error boxes can be controlled by setting Windows' Error Mode. Please refer to the description of SetErrorMode within the Windows MSDN documentation.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

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

Result

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

Possible Predecessors

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

Possible Successors

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

See also

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber

Module

Foundation