Get specific parameters for a frame grabber.
The operator ::get_framegrabber_param returns specific parameter values for the frame grabber specified by FGHandle. The standard parameters listed below are available for all frame grabbers. Additional parameters may be supported by specific frame grabbers. A list of those can be obtained with the query 'parameter' via ::info_framegrabber.
Standard values for Param, see ::open_framegrabber:
'name' Name of the frame grabber.
'fgwidth' Horizontal resolution of the frame grabber.
'fgheight' Vertical resolution of the frame grabber.
'width' Width of the image area.
'height' Height of the image area.
'start_row' Line number of upper left corner of the image area.
'start_column' Column number of upper left corner of the image area.
'field' Selected half image or for full image.
'bits' Number of bits per pixel.
'color_space' Color images: color space.
'gain' Amplification factor for video amplifier.
'external_trigger'
External triggering ('true' / 'false').
'generic' Generic parameter (frame grabber specific).
'device' Device the frame grabber is linked to.
'port' Port of the frame grabber the video signal is linked to.
'line_in' Camera input line of multiplexer.
|
FGHandle (input_control) |
framegrabber -> HTuple.long |
| Handle of the frame grabber to be used. | |
|
Param (input_control) |
string(-array) -> HTuple.char * |
| Parameter of interest. | |
| Default value: 'name' | |
| Suggested values: 'name', 'fgwidth', 'fgheight', 'width', 'height', 'start_row', 'start_column', 'field', 'bits', 'color_space', 'gain', 'external_trigger', 'generic', 'device', 'port', 'line_in' | |
|
Value (output_control) |
string(-array) -> (HTuple.) char * / double * / long * |
| Parameter value. | |
If the frame grabber is open and the specified parameter is supported by the frame grabber, the operator ::get_framegrabber_param returns the value H_MSG_TRUE. Otherwise an exception handling is raised.
::grab_image, ::grab_region, ::grab_image_start, ::grab_image_async, ::grab_region_async, ::close_framegrabber
::open_framegrabber, ::info_framegrabber, ::set_framegrabber_param
Image / region / XLD management
