Numbertofind property – Epson 5 User Manual

Page 105

NumberToFind Property

Applies To

Vision Objects: Blob, Correlation, Edge, Geometric

Description

Defines the number of features to search for within a single Search Window for a Blob, Correlation, Edge,
or Geometric object.

Usage

VGet Sequence.Object.NumberToFind, var

VSet Sequence.Object.NumberToFind, 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 expression for the new value of the property.

Values

Valid entries are 0 - 100.

Default: 1

Remarks

The Blob, Correlation, Edge, and Geometric objects support finding multiple features within a single
Search Window. The NumberToFind property defines how many.

Since many applications require that only 1 feature be found within a Search Window, the default value of
the NumberToFind property is set to 1.

When working in the Vision Guide Development Environment, you will notice that the Results List on the
Object tab will display a heading like "Result (1 of 15)". This means that the system tried to find 15
features (as defined by the NumberToFind property) and the Result List will display the results for item 1.

If you want to see the results for one of the other results, just change the CurrentResult property value to
indicate which result you want to examine.

Blob results are ordered according to the SizeToFind and Sort properties.

If NumberToFind is set to 0, then all possible results are found, up to the maximum allowed. One use is
when the Blob object is used as a pixel counter. With NumberToFind set to 0, then the TotalArea result
will equal the total number of pixels found in the search window.

Correlation and Geometric results are ordered by highest Score result to lowest Score result when Sort is
None. (i.e. result Record 1 (CurrentResult =1) contains the results for the feature with the highest score.)