imaqCreateImage

NI Vision for LabWindows/CVI Function

imaqCreateImage

Usage

Image* imaqCreateImage(ImageType type, int borderSize);

Purpose

Creates an image. The created image will be 0 x 0 pixels in size. To change the image size, use imaqSetImageSize().

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

type ImageType The type of image to create.
borderSize int The size of the image border. For more information about borders, refer to Chapter 1, Digital Images, of the NI Vision Concepts Manual.

Return Value

Type

Description

Image* On success, this function returns the created image. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the created image, dispose of it by calling imaqDispose().