Chapter
4
Reference Manual
IVC-2D
50
©
SICK AG • Advanced Industrial Sensors • www.sick.com • All rights reserved
Image
Grab
Grab is the most common tool for image acquisition and has different functions depending
on how it is used, and depending on if the Emulator or a hardware camera is the selected
device. It can be used alone or in combination with the ‘Start Snapshot’ tool.
Using the Grab tool only
When used alone Grab acquires an image from the device and places it in the image bank
indicated by the parameter
Destination bank
. The step following Grab does not start
executing until this is completed.
Using Grab in combination with Start Snapshot
When used in combination with ‘Start snapshot’, the function instead is this: ‘Start Snap-
shot’ starts an image acquisition in parallel with the execution of steps following ‘Start
Snapshot’. When all the steps between ‘Start Snapshot’ and Grab has been executed,
Grab waits for the image acquisition to complete if not already completed before the step
following Grab can start executing. When using Grab in combination with ‘Start Snapshot’,
the
Destination bank
parameter is set in the ‘Start Snapshot’ tool and the parameter in the
Grab tool is simply ignored.
When the combination of ‘Start Snapshot’ and Grab is used the execution time of Grab in
run mode is longer than what is indicated in step mode for the case where intermediate
steps have shorter execution time than the time of an image acquisition.
Using the Emulator
When the Emulator is the selected device, images are captured from a predefined set of
image files. Executing a ‘Grab’ tool means that the next image in the dedicated image
folder is captured. For more information regarding the Emulator, see section Handling the
Emulator.
Input Parameters
01 = Destination bank
When the Grab tool is used alone this parameter indicates in
which image bank the acquired image is placed.
Returned Values
01 = File Name
The file name of the acquired image file.
Error Messages
Err. = 8605
A 3D image cannot be loaded into a 2D camera.
Err. = 8606
The image size is not correct.