imaqParticleFilter2
Usage
int imaqParticleFilter2(Image* dest, Image* source, const ParticleFilterCriteria2* criteria, int criteriaCount, int rejectMatches, int connectivity8, int* numParticles);
Purpose
Filters particles based on their morphological measurements.
 |
Note This function is obsolete. The replacement function is imaqParticleFilter3(). |
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. |
| rejectMatches | int | Set this parameter to TRUE to transfer only those particles that do not meet all the criteria. Set this parameter to FALSE to transfer only those particles that meet all the criteria to the destination. |
| 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, refer to Chapter 9, Binary Morphology, in the NI Vision Concepts Manual. |
| 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.