imaqGetPixel

NI Vision for LabWindows/CVI Function

imaqGetPixel

Usage

int imaqGetPixel(const Image* image, Point pixel, PixelValue* value);

Purpose

Returns the value of a pixel within an image.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_U16, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL, IMAQ_IMAGE_COMPLEX, IMAQ_IMAGE_RGB, IMAQ_IMAGE_HSL, IMAQ_IMAGE_RGB_U64

Parameters

Name

Type

Description

image const Image* The image whose pixel value the function queries.
pixel Point The coordinates of the pixel that the function queries.
value PixelValue* On return, the value of the image pixel. This parameter is required and cannot be NULL.

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