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:
'camera_types' Description of the frame grabber specific
parameter 'CameraType',
see open_framegrabber.
'defaults' Frame grabber specific default values
in ValueList, see
open_framegrabber.
'general' General information (in Information).
'info_boards' Information about currently installed boards,
connected ports, etc. This data is especially
useful for the auto-detect functionality of
ActivVisionTools.
'parameters' List of all frame grabber specific parameters which
are accessible via set_framegrabber_param
and get_framegrabber_param.
'ports' Description of the ports (signal, connectors, etc.)
in Information and the port numbers
in ValueList.
'revision' Version number of the frame grabber interface.
Please check also the directory doc/html/manuals for files
describing selected frame grabbers.
|
Name (input_control) |
string -> string |
| Frame grabber of interest. | |
| Default value: 'File' | |
| Suggested values: 'Barracuda', 'Bcam1394', 'BitFlow', 'CCi4', 'DFG-BW', 'DFG-LC', 'DirectShow', 'DqVll', 'DT315x', 'DT3162', 'File', 'Fire-i', 'FirePackage', 'FlashBus', 'FlashBusMX', 'Ginga', 'Ginga++', 'IDS', 'Inspecta', 'MatrixVision', 'MultiCam', 'Opteon', 'p3i2', 'p3i4', 'PCEye', 'PicPort', 'PicPortPro', 'PicProdigy', 'PX', 'PXC', 'PXD', 'PXR', 'Ramses1', 'TWAIN', 'uEye' | |
|
Query (input_control) |
string -> string |
| Name of the chosen query. | |
| Default value: 'info_boards' | |
| List of values: 'camera_types', 'defaults', 'general', 'info_boards', 'parameters', 'ports', '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). | |
// Select a suitable frame grabber FgName
info_framegrabber(FgName,'ports',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)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.
info_framegrabber is local and processed completely exclusively without parallelization.
Image / region / XLD management
