imaqMeasureParticle

Usage

int imaqMeasureParticle(Image* image, int particleNumber, int calibrated, MeasurementType measurement, double* value);

Purpose

Returns a measurement associated with a particle. Call imaqCountParticles() before calling imaqMeasureParticle().

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name	Type	Description
image	Image*	The image containing the particle to get information about.
particleNumber	int	The number of the particle to get information about.
calibrated	int	Specifies whether to return the measurement as a real-world value.
measurement	MeasurementType	The measurement to make on the particle.
value	double*	On return, the value of the requested measurement. This parameter can not be NULL.

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.