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 accurately perform correlation searching with angle, follow the procedure below.
The Correlation Model must be taught after the AngleEnable property is set to "True". You must also make sure that the AngleMaxIncrement and AngleRange properties are set correctly prior to teaching the Correlation Model again. If you teach a Correlation Model, then set the AngleEnable property to "True", and then try to detect that Correlation object, it will not perform searching with angle.
To perform geometric searching with angle, follow the procedure below.
The Correlation Model must be taught after the AngleEnable property is set to "True". You must also make sure that the AngleStart and AngleRange properties are set correctly prior to teaching the Geometric again.
See Also
AngleMaxIncrement Property, AngleRange Property, Angle Result, Correlation Object, Geometric Object