imaqGetParticleInfo

Usage

ParticleReport* imaqGetParticleInfo(Image* image, int connectivity8, ParticleInfoMode mode, int* reportCount);

Purpose

Calculates various measurements of particles in a binary image.

Note  This function is obsolete. Use imaqCountParticles() and imaqMeasureParticle() to get information about particles in your image.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name	Type	Description
image	Image*	The binary image containing particles on which the function gets particle information. The calculation modifies the border of the image.
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.
mode	ParticleInfoMode	Controls the extent of particle information that the function returns.
reportCount	int*	On return, filled with the number of reports in the array returned by the function. Set this parameter to NULL if you do not need this information.

Return Value

Type	Description
ParticleReport*	On success, this function returns a pointer to an array of reports about the particles in the image. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with this data, dispose of the array by calling imaqDispose().

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.