Main Content

Image Preview and Device Configuration

Preview image and adjust acquisition parameters such as brightness, resolution, and region of interest (ROI)

It is common to do two things before starting an acquisition — set properties and preview the image. The preview function opens a live preview window after you create a videoinput or other type of acquisition object.

You can set object-specific properties or device-specific properties to control the acquisition. For more information, see Configuring Image Acquisition Object Properties.

Note: The functionality for all supported hardware is now available via the Support Package Installer. Starting with R2014a, each adaptor is available separately through the Support Package Installer, and you must install the appropriate support packages to use the toolbox with your hardware. For more information, see Image Acquisition Support Packages for Hardware Adaptors.


closepreviewClose Video Preview window
getReturn image acquisition object properties
getselectedsourceReturn currently selected video source object
imaqhelpImage acquisition object function and property help
previewPreview of live video data
propinfoProperty characteristics for image acquisition objects
setConfigure or display image acquisition object properties
stoppreviewStop previewing video data


Image Acquisition ToolAcquire images and video from hardware

Examples and How To

Previewing Data

You can view the incoming video stream without actually acquiring data.

Configuring Image Acquisition Object Properties

Modify characteristics of the acquisition using properties of the image acquisition objects.

Using Tab Completion for Functions

Get a list of options you can use on a function using tab completion.

Use Advanced Property Support in the GigE Vision and GenICam GenTL Interfaces

The GigE Vision® and GenICam™ GenTL interfaces offer advanced property support.

Use Advanced Property Support with Point Grey Camera

The Point Grey interface offers advanced property support.

Setting Acquisition Parameters in Image Acquisition Tool

The tool allows you to set acquisition parameters directly in the desktop using the Acquisition Parameters tabs. You can set frames per trigger, color space, Region of Interest, device-specific properties, memory and disk logging, and triggering options.


Image Acquisition Toolbox Properties

These properties are available in the toolbox.

Featured Examples