imaqFindCircles
Usage
CircleReport* imaqFindCircles(Image* dest, 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.
Image Types Supported
IMAQ_IMAGE_U8
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| dest | Image* | On return, an image containing circles that the function located. |
| source | 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 or the returned report array. |
| maxRadius | float | The largest radius (in pixels) to be detected. Circles with radii larger than this value do not appear in the destination image or the returned report array. |
| numCircles | int* | On return, the number of circles that the function detected in the 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(). |
Parameter Discussion
source—This function modifies the source image. If you need the original image, create a copy of the image using imaqDuplicate() before using this function.