Herror ::grab_image (
    Hobject *Image,
    const HTuple &FGHandle
)
HImage HImage::GrabImage (
    const HTuple &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 -> Hobject * : HImage
Grabbed image.

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


Example
/* 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) ;

Result

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


Possible Predecessors

::open_framegrabber, ::grab_image_start


Possible Successors

::grab_image, ::grab_image_start, ::grab_image_async, ::close_framegrabber


See also

::open_framegrabber, ::info_framegrabber, ::set_framegrabber_param


Module

Image / region / XLD management



Copyright © 1996-2002 MVTec Software GmbH