imaqLightMeterRect

Usage

HistogramReport* imaqLightMeterRect(Image* image, RotatedRect rect, int showMeasurement, const CoordinateTransform2* transform);

Purpose

Measures the pixel intensities in a rectangle 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.
rect	RotatedRect	The coordinate location of the rectangular area of the intensity measurement.
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.
transform	const CoordinateTransform2*	An optional specification of the coordinate transform for rect. 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 rect.

Return Value

Type	Description
HistogramReport*	On success, this function returns a report describing the pixel value classification. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the report, dispose of it by calling imaqDispose().