Image Acquisition Toolbox™

imaqmontage - Sequence of image frames as montage

Syntax

imaqmontage(frames)
imaqmontage(obj)
imaqmontage(...,CLIM)
imaqmontage(..., 'CLim', CLIM, 'Parent', PARENT)
h = imaqmontage(...)

Description

imaqmontage(frames) displays a montage of image frames in a MATLAB figure window using the imagesc function.

frames can be any data set returned by getdata, peekdata, or getsnapshot.

imaqmontage(obj) calls the getsnapshot function on video input object obj and displays a single image frame in a MATLAB figure window using the imagesc function. obj must be a 1-by-1 video input object.

imaqmontage(...,CLIM) displays a montage of image frames, where CLIM is a two-element vector, [CLOW CHIGH], specifying the image scaling. Use CLIM to specify a scaling value when overscaling the image data is a risk, for example, when you are working with devices that provide data in a 12-bit format.

imaqmontage(..., 'CLim', CLIM, 'Parent', PARENT) where CLIM is as noted previously, and PARENT is a valid AXES object that allows you to specify where the montage is displayed. One or both property/value pairs can be specified. See the example below.

h = imaqmontage(...) returns a handle to an image object.

Examples

Construct a video input object associated with a Matrox device at ID 1.

obj = videoinput('matrox', 1);

Initiate an acquisition and access the logged data.

start(obj);
data = getdata(obj);

Create an axes object.

a = axes;

Display each image frame acquired on axes a.

imaqmontage(data, 'Parent', a);

Remove the video input object from memory.

delete(obj);

See Also

getdata, getsnapshot, imaqhelp, peekdata

imaqmem

imaqreset