Filter
Top Products
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.)
See Also
Blob Object, Correlation Object, CurrentResult property, Edge Object, Found Result, Geometric Object,
NumberFound Result, Object Tab
Vision Guide 5.0 Reference (Ver.5.3) Rev.1 91