grab_image

Navigation:  Halcon Interface > Operators >

grab_image

Previous pageReturn to chapter overviewNext page

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 automaticallly 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)