imaqEasyAcquire

NI Vision for LabWindows/CVI Function

imaqEasyAcquire

Usage

Image* imaqEasyAcquire(const char* interfaceName);

Purpose

Configures the image acquisition device specified by interfaceName, acquires one image, and returns the acquired image.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_RGB, IMAQ_IMAGE_HSL

Parameters

Name

Type

Description

interfaceName const char* A null-terminated string that specifies the name of the interface to open. Examples of interfaces are img0 and img1. For more information about interfaces, refer to the NI Vision Hardware Help or the Measurement & Automation Explorer help.

Return Value

Type

Description

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