ClassifierSearchAll Method

public SearchResult[] SearchAll(
	ImagePlane plane,
	Rect aoi,
	PrecisionMode precision,
	double relativeThreshold,
	int minimumThreshold,
	int coarseLocality
)

Public Function SearchAll ( 
	plane As ImagePlane,
	aoi As Rect,
	precision As PrecisionMode,
	relativeThreshold As Double,
	minimumThreshold As Integer,
	coarseLocality As Integer
) As SearchResult()

public:
array<SearchResult>^ SearchAll(
	ImagePlane plane, 
	Rect aoi, 
	PrecisionMode precision, 
	double relativeThreshold, 
	int minimumThreshold, 
	int coarseLocality
)

member SearchAll : 
        plane : ImagePlane * 
        aoi : Rect * 
        precision : PrecisionMode * 
        relativeThreshold : float * 
        minimumThreshold : int * 
        coarseLocality : int -> SearchResult[] 

Parameters

plane

Type: Stemmer.CvbImagePlane
the image plane to search in; must have 8 bits per pixel in the plane in which the ShapeFinder2 classifier should search

aoi

Type: Stemmer.CvbRect
The area of interest in the plane to search in; reducing the area of interest will decrease search time but not necessarily linearly (i.e. a reduction to half the image will not necessarily reduce the processing time by a factor of 2). Note that strictly speaking the area parameter applies only to the ShapeFinder2 edge model search; if you use one of the correlation modes (precision set to either CorrelationCoarse or CorrelationFine) it is possible for reported results to actually lie outside the area if hill climbing did lead them out of the area.

precision

Type: Stemmer.Cvb.ShapeFinder2PrecisionMode
search mode to use (see description of PrecisionMode for a description of the different search modes

relativeThreshold

Type: SystemDouble
Threshold used for eliminating less promising candidates in the edge model search step of ShapeFinder2. During the edge model search phase, ShapeFinder2 gathers a list of candidates for possible object sites, and each candidate is assigned a quality derived from the number of features present at its site. The relative threshold is applied when deciding whether or not a new candidate may enter the list: If its quality is less than relativeThreshold percent of the so far best candidate, it may not enter the candidate list. Eliminating less promising candidates in this way has the advantage that the time needed for calculating their correlation in the (optional) correlation search step of ShapeFinder2 may be drastically reduced. Relative threshold must be given as a per cent value in in the range [0...1]

minimumThreshold

Type: SystemInt32
minimum gray value different that must be visible in the image before an edge location may be considered a feature; minimumThreshold must be given a value great than 0

coarseLocality

Type: SystemInt32
Minimum distance between two results in the coarse layer during the ShapeFinder2 edge model search. If two of the candidates are closer than coarseLocality pixels in the coarse layer, the one with the lower quality will be eliminated. Keep in mind that this locality operates on the coarse layer: Setting it to a value of 10 will effectively lead to a minimum distance of 40 if the size factor (2^Scale) between the coarse and the fine layer is 4. Also note that if you perform a correlation step (precision set to either CorrelationCoarse or CorrelationFine) the actually reported results can (and are indeed not unlikely to) be less than coarseLocality * 2^Scale if the hill climbing algorithm brings them closer together.

Return Value

Reference