Vision Sequence Properties and Results
Vision sequences, like vision objects, have properties and results. The primary difference is that the properties and results for Vision Sequences apply to the entire Vision Sequence, while vision object property settings apply to only one vision object.
Vision Sequence Properties
Vision sequence properties are normally used for setting up the execution of the Vision Sequence and to set the proper values for the acquisition of an image for which all the vision objects within the vision sequence will then work from.
All vision sequence properties apply to the entire vision sequence. For example, the Calibration property is set at the vision sequence level rather than the vision object Level.
In this way, all vision objects within a vision sequence will use the Calibration specified by the Calibration property and all the results are guaranteed to be with respect to the same calibration.
The following list is a summary of properties for vision sequences. For details on each property, refer to the following.
"Vision Guide 8.0 Properties & Result Reference"
Property | Description |
---|---|
Calibration | Specifies the camera calibration to use for the vision sequence. This must be specified in order to return Robot or Camera coordinate results. Default: none |
Camera | Specifies which camera to use for the vision sequence. Default: 1 |
CameraBrightness | Specifies the brightness value. Default: 128 |
CameraContrast | Specifies the contrast value. Default: 128 |
Description | Sets a user description Default: Blank |
ExposureDelay | Specifies the delay before the exposure is started. (Unit : microsecond) Default: 0 |
ExposureTime | Specifies the exposure time when used in asynchronous reset mode. (Unit : microsecond) Default: 0 |
ImageBuffer | Specifies which buffer to store the grabbed image in. Default: 0 |
ImageColor | Specifies how color images should be acquired. Default: 1 - All |
ImageFile | Specifies the name of the file that contains the image on disk that you want to work from. Default: None (no image file) |
ImageFileScale | Specifies the scale factor for an image file. Default: 0 (fit to ImageSize) |
ImageSize | Specifies the resolution of the grabbed image. Default: Maximum resolution of the current camera. |
ImageSource | Specifies the source for the image. Default: 1 - Camera |
Index | Displays the index of the sequence. |
HDRMode | Displays the captured image as the HDR image. Default: False |
Name | The name of the vision sequence. |
RuntimeAcquire | Defines which method to use to acquire an image for use with the vision sequence. Default: 1 - Stationary |
RuntimeFreeze | Tells the vision sequence to freeze the image for display. Default: True |
SaveImage | Displays a dialog box for saving the current image to disk. |
ShowProcessing | Specifies whether image processing will be displayed. Default: True |
StrobeBlackVideo | Specifies whether to clear the image to black after the sequence starts and before the image is grabbed after the trigger is received. Default: True |
StrobeDelay | Specifies the delay before the strobe output is turned on. (Unit: microsecond) Default: 0 |
StrobeTime | Specifies the time that the strobe output is on. (Unit : microsecond) Default: 0 |
TriggerMode | Specifies the electronic shutter trigger mode. Default: Leading Edge |
GridColor | Specifies the name of grid’s color displayed in the image display. |
GridPitchX | Specifies the X pitch of the grids displayed in the image display. |
GridPitchY | Specifies the Y pitch of the grids displayed in the image display. |
GridShow | Specifies whether to display the grids in the image display. Default: False |
GridType | Specify the type of the grids displayed in the image display. 1 - Cross Hair 2 - Rectangle |
GridUnits | Specifies the unit of pitches for the grids displayed in the image display. 1 - Pixel 2 - MM When “2 - MM” is selected, the grids are not displayed if calibration is not performed. |
Vision Sequence Results
Vision sequence results apply to the entire vision sequence.
They are useful because they tell you information about the vision sequence as a whole. For example, the AllPassed result returns whether all vision objects within the vision sequence were found.
The following list is a summary of vision sequence results with brief descriptions. For details on each result, refer to the following.
"Vision Guide 8.0 Properties & Result Reference"
Result | Description |
---|---|
AllPassed | Returns whether all vision objects within the sequence were accepted. |
Time | Returns the total execution time for the vision sequence. This includes the cumulative time for all vision objects as well as the time required to acquire an image. |