Finds circles in grayscale image using some modification of Hough transform

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

Syntax

         
 C#  Visual Basic  Visual C++ 
public static IntPtr cvHoughCircles(
	IntPtr image,
	IntPtr circleStorage,
	HOUGH_TYPE method,
	double dp,
	double minDist,
	double param1,
	double param2,
	int minRadius,
	int maxRadius
)
Public Shared Function cvHoughCircles ( _
	image As IntPtr, _
	circleStorage As IntPtr, _
	method As HOUGH_TYPE, _
	dp As Double, _
	minDist As Double, _
	param1 As Double, _
	param2 As Double, _
	minRadius As Integer, _
	maxRadius As Integer _
) As IntPtr
public:
static IntPtr cvHoughCircles(
	IntPtr image, 
	IntPtr circleStorage, 
	HOUGH_TYPE method, 
	double dp, 
	double minDist, 
	double param1, 
	double param2, 
	int minRadius, 
	int maxRadius
)

Parameters

image
IntPtr
The input 8-bit single-channel grayscale image
circleStorage
IntPtr
The storage for the circles detected. It can be a memory storage (in this case a sequence of circles is created in the storage and returned by the function) or single row/single column matrix (CvMat*) of type CV_32FC3, to which the circles' parameters are written. The matrix header is modified by the function so its cols or rows will contain a number of lines detected. If circle_storage is a matrix and the actual number of lines exceeds the matrix size, the maximum possible number of circles is returned. Every circle is encoded as 3 floating-point numbers: center coordinates (x,y) and the radius
method
HOUGH_TYPE
Currently, the only implemented method is CV_HOUGH_GRADIENT
dp
Double
Resolution of the accumulator used to detect centers of the circles. For example, if it is 1, the accumulator will have the same resolution as the input image, if it is 2 - accumulator will have twice smaller width and height, etc
minDist
Double
Minimum distance between centers of the detected circles. If the parameter is too small, multiple neighbor circles may be falsely detected in addition to a true one. If it is too large, some circles may be missed
param1
Double
The first method-specific parameter. In case of CV_HOUGH_GRADIENT it is the higher threshold of the two passed to Canny edge detector (the lower one will be twice smaller).
param2
Double
The second method-specific parameter. In case of CV_HOUGH_GRADIENT it is accumulator threshold at the center detection stage. The smaller it is, the more false circles may be detected. Circles, corresponding to the larger accumulator values, will be returned first
minRadius
Int32
Minimal radius of the circles to search for
maxRadius
Int32
Maximal radius of the circles to search for. By default the maximal radius is set to max(image_width, image_height).

Return Value

Pointer to the sequence of circles

See Also