imaqWatershedTransform
Usage
int imaqWatershedTransform(Image* dest, const Image* source, int connectivity8, int* zoneCount);
Purpose
Computes the watershed transform on an image. Refer to the NI Vision Concepts Manual for more information about watershed transform.
Image Types Supported
IMAQ_IMAGE_U8, IMAQ_IMAGE_I16
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| dest | Image* | The destination image. |
| source | const Image* | The source image. |
| connectivity8 | int | Specifies how the watershed transform algorithm determines whether an adjacent pixel belongs to the same or different catchment or watershed line. |
| zoneCount | int* | On return, specifies the number of zones detected in the image. A zone is a region of the image in which all of the pixels belong to the same catchment basin. Set this parameter to NULL if you do not need this information. |
Return Value
| Type |
Description |
|---|---|
| int | On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError(). |
Parameter Discussion
dest—If dest is of type IMAQ_IMAGE_U8, the function can store up to 255 unique labels not including the watershed line value of 0. If dest is of type IMAQ_IMAGE_I16, the function can store up to 32,767 unique labels not including the watershed line value of 0.