imaqLightMeterLine

Usage

LineProfile* imaqLightMeterLine(Image* image, Point start, Point end, int showMeasurement, const CoordinateTransform2* transform);

Purpose

Measures the pixel intensities on a line 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.
start	Point	The coordinate location of the start of the line.
end	Point	The coordinate location of the end of the line.
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 the line. 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 the line.

Return Value

Type	Description
LineProfile*	On success, this function returns a report containing information about the line. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the line profile, dispose of it by calling imaqDispose().