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