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

Information about the specified frame grabber.

The operator info_framegrabber returns information about the frame grabber Name. The desired information is specified via Query. A textual description according to the selected topic is returned in Information. If applicable, ValueList 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_framegrabber.
    'camera_type'        Description and list of all supported values 
                         for the parameter 'CameraType', see
                         open_framegrabber.
    'color_space'        List of all supported values for the
                         Parameter 'ColorSpace', see
                         open_framegrabber.
    'defaults'           Frame grabber specific default values
                         in ValueList, see 
                         open_framegrabber.
    'device'             List of all supported values for the
                         parameter 'Device', see
                         open_framegrabber.
    'external_trigger'   List of all supported values for the
                         parameter 'ExternalTrigger', see
                         open_framegrabber.
    'field'              List of all supported values for the
                         parameter 'Field', see open_framegrabber.
    'general'            General information (in Information).
    'info_boards'        Information about actually installed boards
                         and cameras. This data is especially
                         useful for the auto-detect mechansim of
                         ActivVisionTools.
    'info_parameters'    Information about type and value ranges
                         of all frame grabber specific parameters.
    'parameters'         List of all frame grabber specific parameters which 
                         are accessible via set_framegrabber_param 
                         or get_framegrabber_param.
    'parameters_readonly'  List of all frame grabber specific parameters
                         which are only accessible via 
                         get_framegrabber_param.
    'parameters_writeonly' List of all frame grabber specific parameters
                         which are only accessible via 
                         set_framegrabber_param.
    'port'               List of all supported values for the
                         parameter 'Port', see open_framegrabber.
    'revision'           Version number of the frame grabber interface.
    
Please check also the directory doc/html/manuals for documentation about specific frame grabber interfaces.


Parameters

Name (input_control)
string -> string
Frame grabber of interest.
Default value: 'File'
Suggested values: '1394IIDC', 'BARRACUDA', 'BaumerFCAM', 'BCAM1394', 'BitFlow', 'DahengCAM', 'DahengFG', 'DFG-BW', 'DFG-LC', 'DirectFile', 'DirectShow', 'dPict', 'DT315x', 'DT3162', 'eneo', 'eXcite', 'File', 'FirePackage', 'FlashBus', 'FlashBusMX', 'Ginga++', 'GingaDG', 'IDS', 'INSPECTA', 'INSPECTA5', 'iPORT', 'Leutron', 'LuCam', 'MatrixVision', 'MatrixVisionAcquire', 'MeteorII', 'MilLite', 'mEnable3', 'MultiCam', 'Opteon', 'p3i2', 'p3i4', 'PX', 'PXC', 'PXD', 'PXR', 'pylon', 'SaperaLT', 'SonyXCI', 'TAG', 'TWAIN', 'uEye'

Query (input_control)
string -> string
Name of the chosen query.
Default value: 'info_boards'
List of values: 'bits_per_channel', 'camera_type', 'color_space', 'defaults', 'device', 'external_trigger', 'field', 'general', 'info_boards', 'info_parameters', 'parameters', 'parameters_readonly', 'parameters_writeonly', 'port', 'revision'

Information (output_control)
string -> string
Textual information (according to Query).

ValueList (output_control)
string-array -> string / integer / real
If applicable, a list of values (according to Query).


Example
// Select a suitable frame grabber FgName
info_framegrabber(FgName,'port',Information,Val)
// Choose the port P and the input line L your camera is connected to
open_framegrabber(FgName,1,1,0,0,0,0,'default',-1,'default',-1.0,
                  'default','default','default',P,L,FgHandle)
grab_image(Img,FgHandle) 
close_framegrabber(FgHandle)

Result

If the parameter values are correct and the desired frame grabber is available at call time, info_framegrabber returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised.


Parallelization Information

info_framegrabber is local and processed completely exclusively without parallelization.


Possible Predecessors

open_framegrabber


Possible Successors

open_framegrabber


See also

open_framegrabber


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH