imaqReadMeter

Usage

int imaqReadMeter(const Image* image, const MeterArc* arcInfo, double* percentage, PointFloat* endOfNeedle);

Purpose

Reads a meter. You must have already determined the arc information with imaqGetMeterArc().

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name	Type	Description
image	const Image*	The image of the meter to read.
arcInfo	const MeterArc*	Information about the meter's arc. This information is returned by imaqGetMeterArc()
percentage	double*	Returns the current sweep position of the needle in comparison to the maximum sweep position, expressed as a percentage. For example, a value of 100 indicates the needle is at the maximum sweep position. Set this parameter to NULL if you do not need this information.
endOfNeedle	PointFloat*	Returns the location of the endpoint of the needle. Set this parameter to NULL if you do not need this information.

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().