imaqSeparation

NI Vision for LabWindows/CVI Function

imaqSeparation

Usage

int imaqSeparation(Image* dest, Image* source, int erosions, const StructuringElement* structuringElement);

Purpose

Separates touching particles by eroding the image to remove small isthmuses between the particles. After performing the erosion, the algorithm reconstructs the image.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name

Type

Description

dest Image* The destination image.
source Image* The image containing particles to separate. The separation modifies the border of the source image. The border must be at least half as large as the larger dimension of the structuring element.
erosions int The number of erosions to perform.
structuringElement const StructuringElement* The structuring element used in the operation. Set this parameter to NULL if you do not want a custom structuring element.

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

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.