ScoreMode Property

Applies To
Vision Objects: Correlation, Geometric, Polar

Description
Sets the accept threshold for scores during search.

Usage

VGet  Sequence.Object.ScoreMode, var
VSet  Sequence.Object.ScoreMode, 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 - Accept100
  • Vision constant: VISION_SCOREMODE_ACCEPT100
• 1 - Accept90
  • Vision constant: VISION_SCOREMODE_ACCEPT90
• 2 - Accept70
  • Vision constant: VISION_SCOREMODE_ACCEPT70

Default: 0 - Accept100

Remarks
ScoreMode sets the accept threshold for scores during search. This is useful for when you want to know the score of features that were not found, but close to being found. The XX suffix of the AcceptXX property value represents the percentage (%) of the Accept value for which a score is obtained.

For example, if the Accept value is set to 700 and ScoreMode is set to Accept70, then the accept threshold for scores is 700 * 0.70 = 490, and the scores for results >= 490 will be displayed and can be retrieved even if the search failed. With the default setting of Accept100, the score threshold and the accept threshold values are the same, so the scores for failed results are set to zero and are not displayed.

Note that when ScoreMode is not Accept100, the search time will take longer.

See Also
Correlation Object, Geometric Object, Polar Object, Accept Property