imaqLightMeterPoint

NI Vision for LabWindows/CVI Function

imaqLightMeterPoint

Usage

int imaqLightMeterPoint(Image* image, Point point, int showMeasurement, float* intensity, const CoordinateTransform2* transform);

Purpose

Measures the pixel intensities in a 3 x 3 pixel neighborhood centered on a point of an image.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name

Type

Description

image Image* The image that the function uses for intensity measurement.
point Point The coordinate location of the intensity measurement. The intensity measurement is made in a 3 x 3 block centered on the point.
showMeasurement int Set this parameter to TRUE to overlay the location of the intensity measurement on the image. Set this parameter to FALSE to leave the image unmodified.
intensity float* On return, the average intensity of the pixels in a 3 x 3 neighborhood centered on the point. This parameter is required and cannot be NULL.
transform const CoordinateTransform2* An optional specification of the coordinate transform for point. This parameter specifies how to transform the location of the intensity measurement based on the difference between the reference coordinate system and the measurement coordinate system. Set this parameter to NULL if you do not need to transform point.

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