grab_image

grab_image ( : Image : FGHandle : )

Grab an image from the specified frame grabber.

The operator grab_image grabs an image via the frame grabber specified by FGHandle. The desired operational mode of the frame grabber as well as a suitable image area can be adjusted via the operator open_framegrabber. Additional (frame grabber specific) settings might be possible via set_framegrabber_param.

Parameters

`Image` (output_object)	image `->` object : byte / int2
Grabbed image.

`FGHandle` (input_control)	framegrabber `->` integer
Handle of the frame grabber to be used.

Example

// Select a suitable frame grabber FgName
info_framegrabber(FgName,'port',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)

Result

If the frame grabber is open the operator grab_image returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised.

Parallelization Information

grab_image is reentrant and processed without parallelization.

Possible Predecessors

open_framegrabber, grab_image_start

Possible Successors

grab_image, grab_image_start, grab_image_async, close_framegrabber

Module

Foundation