imaqSetLine

NI Vision for LabWindows/CVI Function

imaqSetLine

Usage

int imaqSetLine(Image* image, const void* array, int arraySize, Point start, Point end);

Purpose

Sets the pixel values along a line in an image.

Image Types Supported

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

Parameters

Name

Type

Description

image Image* The image whose line pixel values the function modifies.
array const void*

The one-dimensional array of pixel values that the function uses to replace the values in the line. The type of array you provide depends on the image type, as follows:

Image Type Array Type
IMAQ_IMAGE_U8 unsigned char
IMAQ_IMAGE_U16 unsigned short
IMAQ_IMAGE_I16 short
IMAQ_IMAGE_SGL float
IMAQ_IMAGE_RGB RGBValue structures
IMAQ_IMAGE_HSL HSLValue structures
IMAQ_IMAGE_RGB_U64 RGBU64Value structures
arraySize int The number of pixels in the array.
start Point The coordinate location of the starting point of the line.
end Point The coordinate location of the ending point of the line.

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