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.
Note
To get a list of options you can use on a function, press the Tab key
after entering a function on the MATLAB command line. The list
expands, and you can scroll to choose a property or value. For information
about using this advanced tab completion feature, see Using Tab Completion for Functions.
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);
Introduced before R2006a