cvHoughCircles Method (image, circleStorage, method, dp, minDist, param1, param2, minRadius, maxRadius)

www.emgu.com/wiki

Finds circles in grayscale image using some modification of Hough transform

Declaration Syntax

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

Assembly: Emgu.CV (Module: Emgu.CV) Version: 1.3.0.0 (1.3.0.0)