http://www.emgu.com
Finds rectangular regions in the given image that are likely to contain objects the cascade has been trained for and returns those regions as a sequence of rectangles. The function scans the image several times at different scales (see cvSetImagesForHaarClassifierCascade). Each time it considers overlapping regions in the image and applies the classifiers to the regions using cvRunHaarClassifierCascade. It may also apply some heuristics to reduce number of analyzed regions, such as Canny prunning. After it has proceeded and collected the candidate rectangles (regions that passed the classifier cascade), it groups them and returns a sequence of average rectangles for each large enough group. The default parameters (scale_factor=1.1, min_neighbors=3, flags=0) are tuned for accurate yet slow object detection. For a faster operation on real video images the settings are: scale_factor=1.2, min_neighbors=2, flags=CV_HAAR_DO_CANNY_PRUNING, min_size=<minimum possible face size> (for example, ~1/4 to 1/16 of the image area in case of video conferencing).

Namespace: Emgu.CV
Assembly: Emgu.CV (in Emgu.CV.dll) Version: 2.4.0.1717 (2.4.0.1717)

Syntax

C#
[ObsoleteAttribute("Use HaarCascade.Detect function instead. This function will be removed in the next release")]
public MCvAvgComp[][] DetectHaarCascade(
	HaarCascade haarObj,
	double scaleFactor,
	int minNeighbors,
	HAAR_DETECTION_TYPE flag,
	Size minSize
)
Visual Basic
<ObsoleteAttribute("Use HaarCascade.Detect function instead. This function will be removed in the next release")> _
Public Function DetectHaarCascade ( _
	haarObj As HaarCascade, _
	scaleFactor As Double, _
	minNeighbors As Integer, _
	flag As HAAR_DETECTION_TYPE, _
	minSize As Size _
) As MCvAvgComp()()
Visual C++
[ObsoleteAttribute(L"Use HaarCascade.Detect function instead. This function will be removed in the next release")]
public:
array<array<MCvAvgComp>^>^ DetectHaarCascade(
	HaarCascade^ haarObj, 
	double scaleFactor, 
	int minNeighbors, 
	HAAR_DETECTION_TYPE flag, 
	Size minSize
)

Parameters

haarObj
Type: Emgu.CV..::..HaarCascade
Haar classifier cascade in internal representation
scaleFactor
Type: System..::..Double
The factor by which the search window is scaled between the subsequent scans, for example, 1.1 means increasing window by 10%
minNeighbors
Type: System..::..Int32
Minimum number (minus 1) of neighbor rectangles that makes up an object. All the groups of a smaller number of rectangles than min_neighbors-1 are rejected. If min_neighbors is 0, the function does not any grouping at all and returns all the detected candidate rectangles, which may be useful if the user wants to apply a customized grouping procedure
flag
Type: Emgu.CV.CvEnum..::..HAAR_DETECTION_TYPE
Mode of operation. Currently the only flag that may be specified is CV_HAAR_DO_CANNY_PRUNING. If it is set, the function uses Canny edge detector to reject some image regions that contain too few or too much edges and thus can not contain the searched object. The particular threshold values are tuned for face detection and in this case the pruning speeds up the processing.
minSize
Type: System.Drawing..::..Size
Minimum window size. By default, it is set to the size of samples the classifier has been trained on (~20x20 for face detection)

Return Value

The objects detected, one array per channel

See Also