grab_image¶
Captures and returns an image of the camera associated with the given handle .
Parameters¶
grab_image (Image, AcqHandle)
Parameter |
Description |
Image |
Variable where the retrieved image will be stored. |
AcqHandle |
An acquisition handle obtained via ‘ open_framegrabber ‘. Note: The handle must be of type ‘Stereo’ or ‘Monocular’. |
Dependencies¶
Parameter |
Description |
color_space |
Depending on its setting, ‘grab_image ‘ will either retrieve the raw or rectified image from the sensor. Note: This parameter can be only set at the creation of the acquisition handle. Refer to ‘ open_framegrabber’. |
Additional Infos¶
On a stereo camera this function always returns an image from the left sensor.
This operator will automatically turn the Front-LED on and the Projector-LED off during its execution.
This operator is not influenced by ‘auto_grab_data’. It always executes a capture (and rectifiy) command on the referred camera and thus will override the raw (and rectified) image binary node(s).
Note
All automatically executed commands will be run without parameters.
Example¶
* Open default stereo camera
open_framegrabber('Ensenso-NxLib', 0, 0, 0, 0, 0, 0, 'default', 0, 'Raw', -1, 'false', 'Stereo', '', 0, 0, AcqHandle)
* Grab Image
grab_image(Image, AcqHandle)