imaqSelectParticles
Usage
ParticleReport* imaqSelectParticles(const Image* image, const ParticleReport* reports, int reportCount, int rejectBorder, const SelectParticleCriteria* criteria, int criteriaCount, int* selectedCount);
Purpose
Filters an array of particle reports based on criteria ranges. Call imaqGetParticleInfo() before calling imaqSelectParticle().
 |
Note This function is obsolete. Use imaqCountParticles(), imaqParticleFilter2(), and imaqMeasureParticle() to measure particles that fit a certain criteria. |
Image Types Supported
IMAQ_IMAGE_U8
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | const Image* | The image from which imaqGetParticleInfo() generated the particle reports. |
| reports | const ParticleReport* | The array of reports that imaqGetParticleInfo() returned. The function makes a copy of the reports that match the criteria. |
| reportCount | int | The number of reports in the input reports array. |
| rejectBorder | int | Set this parameter to TRUE to filter out particles touching the border of the image. Set this parameter to FALSE to process all particles. |
| criteria | const SelectParticleCriteria* | The array of criteria for the filter. This parameter is required and cannot be NULL. |
| criteriaCount | int | The number of criteria in the criteria array. |
| selectedCount | int* | On return, the number of reports that matched the criteria. Set this parameter to NULL if you do not need this information. |
Return Value
| Type |
Description |
|---|---|
| ParticleReport* | On success, this function returns an array of the input reports that match the filtration criteria. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the return value, dispose of it by calling imaqDispose(). |