Epson 5 NumberToFind Property

NumberToFind Property

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.)