imaqSizeFilter

Usage

int imaqSizeFilter(Image* dest, Image* source, int connectivity8, int erosions, SizeType keepSize, const StructuringElement* structuringElement);

Purpose

Filters particles based on their size. The algorithm erodes the image a specified number of times and either keeps or discards the particles from the original image that remain in the eroded image.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name	Type	Description
dest	Image*	The destination image.
source	Image*	The image on which the function applies the filter. The calculation modifies the border of the source image. The border must be at least half as large as the larger of the structuring element dimensions.
connectivity8	int	Set this parameter to TRUE to use connectivity-8 to determine whether particles are touching. Set this parameter to FALSE to use connectivity-4 to determine whether particles are touching. For more information about connectivity, see Chapter 9, Binary Morphology, in the NI Vision Concepts Manual.
erosions	int	The number of erosions to perform.
keepSize	SizeType	Determines the size of the particles the function keeps after the erosion.
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.