imaqMeasureParticle

NI Vision for LabWindows/CVI Function

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.