RuntimeAcquire Property

Applies To
Vision Sequence

Description
The RuntimeAcquire property tells the vision sequence which method to use to acquire an image for use with that sequence.

Usage

VGet  Sequence.Object.RuntimeAcquire, var
VSet  Sequence.Object.RuntimeAcquire, value

Sequence

Name of a sequence or string variable containing a sequence name.

Object

Name of an object or string variable containing an object name. The object must exist in the specified sequence.

var

Integer variable that will contain the value of the property.

value

Integer value or expression for the new value of the property.

Values

• 0 - None
  • Vision constant: VISION_ACQUIRE_NONE
  • This tells the vision system not to acquire an image before processing the sequence. Simply use the image which is already in the frame buffer specified by the ImageBuffer property. This is useful when a series of vision sequences need to work from the same image. For example, you could acquire an image in sequence#1. During this sequence you could also execute some vision objects. Next, assume that you want to use another vision sequence on the same image. Simply set the RuntimeAcquire property to None for the 2nd vision sequence and the same image will be used for both sequences.
• 1 - Stationary
  • Vision constant: VISION_ACQUIRE_STATIONARY
  • The camera is stationary (not moving). A new image is acquired at the start of the vision sequence. This is the normal method for running a vision sequence. Each time a new vision sequence is executed, a new image is acquired at the start of the sequence. Also the strobe output is output. The ExposureTime property affects how stationary images are acquired. See ExposureTime for details.
    ExposureTime Property
• 2 - Strobed
  • Vision constant: VISION_ACQUIRE_STROBED
  • The image acquisition starts by the trigger input. Also the strobe output is output. This is the mechanism for setting up strobed lighting for capturing moving images within the image buffer. See the remarks section below for more details.

Default: 1 -Stationary

Remarks
The RuntimeAcquire property is very important to understand. There are 3 setting for the RuntimeAcquire property as explained in the Values section. The most common of the 3 is the 1-Stationary setting since in most cases you will want to acquire a new image at the beginning of each vision sequence.

However, you may also use the same image for more than 1 sequence. Simply acquire an image for the 1st sequence and then use the same image in the 2nd sequence making sure to set the RuntimeAcquire property to 0-None for the 2nd sequence.

The 3rd Acquisition method is called 2-Strobed. This acquiers an image as follows.

When the vision sequence is run, the sequence will wait for an input trigger. At the instance the trigger input goes active, the vision sequence will initiate an acquisition, thus capturing the image at the same time as the strobe of the light source. Please see Image Acquisition in the Vision Guide 6.0 manual for more details.

See Also
RuntimeFreeze Property, Vision Sequences