imaqFindEdge2
Usage
FindEdgeReport* imaqFindEdge2(Image* image, const ROI* roi, const CoordinateSystem* baseSystem, const CoordinateSystem* newSystem, const FindEdgeOptions2* findEdgeOptions, const StraightEdgeOptions* straightEdgeOptions);
Purpose
Detects straight edges inside an ROI, and optionally overlays the information used to search for the edges.
Image Types Supported
IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | Image* | The image in which to find edges. |
| roi | const ROI* | The rectangular region the function looks in for the edges. The first contour of roi must be a rectangle or a rotated rectangle. |
| baseSystem | const CoordinateSystem* | Describes the base coordinate system. |
| newSystem | const CoordinateSystem* | Describes the new coordinate system. |
| findEdgeOptions | const FindEdgeOptions2* | Describes how you want the function to search for edges and the information the function overlays to the image. |
| straightEdgeOptions | const StraightEdgeOptions* | Specifies the options used to fit a line in the roi. |
Return Value
| Type |
Description |
|---|---|
| FindEdgeReport* | On success, this function returns information describing the calculated edges. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the information, dispose of it by calling imaqDispose(). |
Parameter Discussion
findEdgeOptions—Set findEdgeOptions to NULL to use the default options, as follows:
| direction | IMAQ_LEFT_TO_RIGHT |
| showSearchArea | FALSE |
| showSearchLines | FALSE |
| showEdgesFound | FALSE |
| showResult | TRUE |
| searchAreaColor | IMAQ_RGB_GREEN |
| searchLinesColor | IMAQ_RGB_BLUE |
| searchEdgesColor | IMAQ_RGB_YELLOW |
| resultColor | IMAQ_RGB_RED |
| overlayGroupName | "" (default group) |
| edgeOptions.polarity | IMAQ_SEARCH_FOR_ALL_EDGES |
| edgeOptions.kernelSize | 3 |
| edgeOptions.numSearchLines | 3 |
| edgeOptions.minThreshold | 10.0 |
| edgeOptions.interpolationType | IMAQ_BILINEAR_FIXED |
| edgeOptions.columnProcessingMode | IMAQ_MEDIAN_COLUMNS |
straightEdgeOptions—Set straightEdgeOptions to NULL to use the following default values:
| numLines | 1 |
| searchMode | IMAQ_USE_BEST_PROJECTION_EDGE |
| minScore | 10.0 |
| maxSize | 1000.0 |
| orientation | 0.0 |
| angleRange | 10.0 |
| angleTolerance | 1.0 |
| stepSize | 3 |
| minSignalToNoiseRatio | 0.0 |
| minCoverage | 25.0 |
| houghIterations | 5 |