Command for image capture with Scorpion. The Grab command arms the
system for the specified camera / image. The image arrives with an event
ImageNComplete. More information about Actions.
Syntax:
Grab;<imageNo=n>;<cameraNo=n>
Grab;Name=<imagename>;<cameraNo=n>
Grab;Filename=<name>;convert=<none|hsi|bw>
Parameter |
Value |
Description |
ImageNo |
1..n |
image index - if the parameter is
omitted all images will be taken as fast as possible
note: index start at 1 |
Image |
image name |
image by name is an alternative to imageNo -
avoids dependence to index in the image list |
Images |
n,name,n+1 | All | None |
grabs multiple images from a camera
note: syntax is more powerful than imageNo and Image
note: will save editing under actions
note: can be combined with Flush and ClearAll |
Flush |
0 | 1 | False | True |
Execute Flush when 1 or True
note: added so that one command can grab and resync image capture |
ClearAll |
0 | 1 | False | True |
Execute ClearAll when 1 or True
note: added so that one command can grab and resync image capture |
CameraNo |
1..n |
grab from specified camera.
note 1: setting cameraNo
changes camera for the image configuration.
note 2: used when capture multiple images from a single camera |
Convert |
none/bw/hsi [none] |
conversion
method if the image is a color
image.
HSI requires
that Scorpion is setup with at least 3 images. |
Filename |
<path>name [blank] |
if
filename is given, the image is read from file instead of taken by
the camera. |
Note: Images, Flush and ClearAll require build 744 or higher
Example 1: Two Images with different illumination
Individual
image sequence where two images are captured, no backlight. The backlight is
handled by an io-signal:
Status;0:OSigSBackLight=0
Grab;imageno=1
Status;0:OSigSBackLight=1
Delay;value=100
Grab;imageno=2
Example 2: Initiate remote Inspection over tcp/ip from another
Windows Application
Two color images
are generated by an external application. This task is to:
-
convert the first
image to black and white,
-
the second to hsi - 3 8 bit images images
The command
sequence shown is sent in one message over TdvCmdProtocol. It can be set up as a
command handler in Scorpion.
The message sent over TdvCmdProtocol from an
external application:
Grab;imageno=1;convert=bw;filename=tank1.bmp; imageno=2;convert=hsi;filename=c:\images\tank2.bmp;Inspect;
Example 3: Grab all active images
- Grab
- Grab;Flush=1;ClearAll=1 # will grab all images after
flush and clear
Note: This will start image aquisition in parallell for all cameras
connected to the images. More information about grabbing sequence -
look here.
Example 3: Grab images in a Sequence
The image sequence is asynchrous in scorpion this means that to
define a camera grab sequence normally involves a number of scorpion
events. A typical example is shown below:
- GrabExecute
- OnImage1Complete
- OnImage2Complete
- AfterGrab
- InspectExecute
Note: With this approach the images will be capture one by one.
Inspect will execute the toolbox on all captured images.
Example 4: Single command Grab multiple images optional resync
- Grab;images=1,2
- Grab;images=All;Flush=1;ClearAll=1 # will grab all
images after flush and clear - to resync
Example 5: Flush and ClearAll
- Grab;images=None;Flush=1;ClearAll=1 # will grab NO
image - but flush and clear - note None
Example 6: Grab Images from a specific camera to multiple images
- GrabExecute
- Grab;cameraNo=1;image=Image1
- OnImage1Complete
- Grab;cameraNo=1;image=Image2
- OnImage2Complete
- Grab;cameraNo=1;image=Image3
- AfterGrab
- InspectExecute
Note: Will not run in sequence - must use OnImageNComplete events
Example 7: Grab Images from a specific camera defined by an data
tool
Grab images from camera given by an ExternalData tool, SETUP:
Grab;cameraNo=%SETUP.CameraNo
Note: Using the CameraNo parameter changes the
image configuration, the camera attached to an image. Only one
camera can be attached to an Image at a time, sending multiple grab
commands to different camera
numbers will not work since images will be read from current attached
camera as they arrives from the camera driver.
Legacy Parameters for Cognex Framegrabbers using CVLGrab and
CVLGrab55.dll
Exposure |
0..MaxInt [-1] |
exposure time in ms |
Contrast |
0..1 [-1] |
|
Brightness |
0..1 [-1] |
|
|