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.)
The Correlation Model must be taught after the AngleEnable property is set to "True". If you teach a Correlation Model, then set the AngleEnable property to “True”, and then try to run that Correlation object, it will not search with angle. You must re-teach the Correlation Model with the AngleEnable property set to “True” in order for Correlation search with angle to work properly. You must also have the proper settings for the AngleMaxIncrement and AngleRange Properties prior to teaching the new Model as well.
See Also
AngleMaxIncrement Property, AngleRange Property, Angle Result, Correlation Object, Geometric Object