CogAcqSettlingTime SettlingTime Property Cognex VisionPro
Reads or sets the settling time in milliseconds.

Namespace: Cognex.VisionPro.Implementation.Internal
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 65.1.0.0
Syntax

public virtual double SettlingTime { get; set; }

Property Value

Type: Double

Implements

ICogAcqSettlingTime SettlingTime
Events

Event TypeReason
ICogChangedEvent Changed

Fires when the settling time is changed.

The following state flag may be affected:

  • SfTime
Exceptions

ExceptionCondition
ArgumentException

val is < 0.

CogAcqWrongTriggerModelException

The acquisition trigger model is Slave.

Remarks

Sets or gets the settling time in milliseconds.

In general, you should not need to use this interface, and you should select a video format that supports your application.

This interface allows you to specify the settling time, the time to wait after a trigger before starting an acquisition. Typically, you would specify a settling time when using a free-running camera with automatic triggering and ambient illumination to allow a part to stop moving once it is in position. The settling time should be long enough to ensure that no portion of the image is in motion during image integration.

To choose an appropriate settling time, you need to consider the characteristics of the part as well as the latencies of integrating the image. A conservative settling time depends on whether the camera is a rapid-reset camera or free-running and whether a strobe is used.

The following examples illustrate appropriate choices for settling time so that the image is not blurred. In each example, the grey bars denote frames that were integrated while the part was still in motion; the solid green bars denote frames that were integrated after the part stopped moving.

The following figure shows a free-running camera with no strobe in frame integration mode.

The following figure shows a free-running camera with no strobe in field integration mode.

The following figure shows a rapid-reset camera with no strobe.

For a strobed acquisition, the settling time should be zero.

Default Value: 0

See Also