imaqReadMeter

NI Vision for LabWindows/CVI Function

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