imaqOverlayLine

NI Vision for LabWindows/CVI Function

imaqOverlayLine

Usage

int imaqOverlayLine(Image* image, Point start, Point end, const RGBValue* color, const char* group);

Purpose

Overlays a line onto 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 Image* The image on which to overlay the line.
start Point The coordinate location of the start of the line.
end Point The coordinate location of the end of the line.
color const RGBValue* The color of the line. The alpha color channel is not supported. Setting the color to transparent has the same effect as selecting black. This parameter is required and cannot be NULL.
group const char* The group to which you want to add the overlay. Set this parameter to NULL to add the overlay to the default group.

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