Up | Grab | Inspect | GetImageProp | GetImagePropRange | SetImageProp | Image | Camera

 

  

 
Grab

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
    • Grab;imageNo=1
  • OnImage1Complete
    • Grab;imageno=2
  • OnImage2Complete
    • <empty>
  • AfterGrab
    • InspectExecute
  • InspectExecute
    • Inspect

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
  • InspectExecute
    • Inspect

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]  
 

Scorpion Vision Version XV  : Build 764 - Date: 20200529
Scorpion Vision Software® is a registered trademark of Tordivel AS.
Copyright © 2000 - 2020 Tordivel AS.