imaqCircles
Usage
CircleReport* imaqCircles(Image* dest, const Image* source, float minRadius, float maxRadius, int* numCircles);
Purpose
Separates overlapping circular objects and classifies them depending on their radii. This function also draws the detected circles into the destination image.
 |
Note This function is obsolete. The replacement function is imaqFindCircles(), which returns only circles that meet the minimum and maximum radius requirements. |
Image Types Supported
IMAQ_IMAGE_U8
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| dest | Image* | On return, an image containing circles that the function located. |
| source | const Image* | The image in which the function finds circles. |
| minRadius | float | The smallest radius (in pixels) to be detected. Circles with radii smaller than this value do not appear in the destination image. These circles are in the returned report array, but the function reports their radii as negative. |
| maxRadius | float | The largest radius (in pixels) to be detected. Circles with radii larger than this value do not appear in the destination image. These circles are in the returned report array, but the function reports their radii as negative. |
| numCircles | int* | On return, the number of circles that the function detected in the image. If any circles fall outside the radius range, numCircles is greater than the number of circles that the function draws in the destination image. Set this parameter to NULL if you do not need this information. |
Return Value
| Type |
Description |
|---|---|
| CircleReport* | On success, this function returns an array of structures containing information about each of the found circles. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the array, dispose of it by calling imaqDispose(). |