Grab images and preprocessed image data from the specified image acquisition device.
The operator grab_data grabs images and preprocessed image data via the image acquisition device specified by AcqHandle. The desired operational mode of the image acquisition device as well as a suitable image part can be adjusted via the operator open_framegrabber. Additional interface-specific settings can be specified via set_framegrabber_param. Depending on the current configuration of the image acquisition device, the preprocessed image data can be returned in terms of images (Image), regions (Region), XLD contours (Contours), and control data (Data).
|
Image (output_object) |
image(-array) -> object |
| Grabbed image data. | |
|
Region (output_object) |
region(-array) -> object |
| Preprocessed image regions. | |
|
Contours (output_object) |
xld_cont(-array) -> object |
| Preprocessed XLD contours. | |
|
AcqHandle (input_control) |
framegrabber -> integer |
| Handle of the acquisition device to be used. | |
|
Data (output_control) |
string(-array) -> string / real / integer |
| Preprocessed control data. | |
// Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
// Choose the port P and the input line L your camera is connected to
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0,
'default','default','default',P,L,AcqHandle)
// Grab and segment image
grab_data(Region,AcqHandle)
// Process Region...
close_framegrabber(AcqHandle)If the image acquisition device is open and supports the image acquisition via grab_data, the operator grab_data returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised.
grab_data is reentrant and processed without parallelization.
open_framegrabber, grab_image_start, set_framegrabber_param
grab_data, grab_data_async, grab_image_start, grab_image, grab_image_async, set_framegrabber_param, close_framegrabber
open_framegrabber, info_framegrabber, set_framegrabber_param
Foundation