AngleEnable Property

Applies To
Vision Object: Correlation, Geometric

Description
Specifies whether a correlation or geometric object will search for rotation of a feature.

Usage

VGet  Sequence.Object.AngleEnable, var
VSet  Sequence.Object.AngleEnable, 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

Boolean variable that will contain the value of the property

value

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

Value

• 0 - False: Do not search for rotation.
• -1 - True: Search for rotation.

Default

• Correlation: False
• Geometric: True

Remarks
The AngleRange and AngleMaxIncrement properties will not be used with the correlation or geometric search object if the AngleEnable property is set "False".

It should be noted that while correlation with angle is normally able to find rotated parts, the correlation search time usually increase significantly. This is why correlation with angle is most useful for finding parts which rotate slightly. On the other hand, Geometric search is suitable for a pattern search which includes large rotation detection. If it is predictable that the parts have a large rotation angle, consider to use Geometric search.

Also, the Polar object is normally very fast and can be used in conjunction with the Correlation object for a powerful and fast combination. (See the sections on Correlation or Polar Searching for more information.)

To search with angle using Correlation search, follow the procedures below. Set the AngleEnable property to "True". You must also have the proper settings for the AngleMaxIncrement and AngleRange Properties prior to teaching the new Correlation Model as well.

If you teach a Correlation Model, then later set the AngleEnable property to “True”, and then try to search that Correlation object, it will not search with angle.

To search with angle using Geometric search, follow the procedures below.

The Correlation Model must be taught after the AngleEnable property is set to "True". You must also have the proper settings for the AngleStart and AngleRange Properties prior to teaching the new Model as well.

See Also
AngleMaxIncrement Property, AngleRange Property, Angle ResultCorrelation Object, Geometric Object