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