imaqParticleFilter4

Usage

int imaqParticleFilter4(Image* dest, Image* source, const ParticleFilterCriteria2* criteria, int criteriaCount, const ParticleFilterOptions2* options, const ROI* roi, int* numParticles);

Purpose

Filters particles based on their morphological measurements.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name	Type	Description
dest	Image*	The destination image that will contain only the filtered particles.
source	Image*	The image containing the particles to filter.
criteria	const ParticleFilterCriteria2*	An array of criteria to apply to the particles in the source image. This array cannot be NULL.
criteriaCount	int	The number of elements in the criteria array.
options	const ParticleFilterOptions2*	The options used by the function to filter binary particles.
roi	const ROI*	The ROI whose contours a particle must be contained in to avoid being filtered out. If rejectBorder is true in options, any particle touching the border of a contour in roi will also be filtered out. Set this parameter to NULL to filter particles in the entire image based on the criteria array.
numParticles	int*	On return, the number of particles left in the image.

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.

options—Set options to NULL to use the following default values:

rejectMatches	FALSE
rejectBorder	FALSE
fillHoles	FALSE
connectivity8	TRUE