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:
'ports' Description of the ports (signal, connectors etc.)
in Information and the port numbers
in ValueList.
'generic' Description of the frame grabber specific
parameter 'Generic',
see ::open_framegrabber.
'general' General information (in Information).
'defaults' Frame grabber specific default values
in ValueList, see
::open_framegrabber.
'parameters' Frame grabber specific parameters accessable via
::set_framegrabber_param and
::get_framegrabber_param.
Please check also the directory doc/html/manuals for files
describing selected frame grabbers.
|
Name (input_control) |
string -> HTuple.char * |
| Frame grabber of interest. | |
| Default value: 'VirtualFG' | |
| Suggested values: 'BitFlow', 'DFG-BW1', 'DFG-LC', 'DT315x', 'FlashBus', 'GINGA', 'HTwain', 'IDS', 'Inspecta2', 'MatrixVision', 'Meteor', 'PCEye', 'PicPort', 'PX', 'PXC', 'Ramses1', 'Raven', 'RoadRunner', 'VideoPort', 'VirtualFG' | |
|
Query (input_control) |
string -> HTuple.char * |
| Description of the ports (signal, connectors etc.). | |
| Default value: 'ports' | |
| List of values: 'ports', 'generic', 'general', 'defaults', 'parameters' | |
|
Information (output_control) |
string -> (HTuple.) char * |
| Textual information (according to Query). | |
|
ValueList (output_control) |
string(-array) -> (HTuple.) char * / long * / double * |
| 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 H_MSG_TRUE. Otherwise an exception handling is raised.
Image / region / XLD management
