User`s guide

getsnapshot
Purpose Immediately return single image frame
Syntax frame = getsnapshot( obj)
Description frame = getsnapshot( obj) immediately returns one single image
frame,
frame, from the video input object obj. The frame of data
returned is independent of the vide o input obje ct
FramesPerTrigger
property and has no effect o n the value of the Frames Available or
FramesAcquired property.
The object
obj mustbea1-by-1videoinputobject.
frame is returned as an H-by-W-by-B matrix where
H
Image height, as specified in the
ROIPosition property
W
Image width, as s pecified in the
ROIPosition property
B
Number of bands associated with
obj,asspecifiedinthe
NumberOfBands property
frame is returned to the MATLAB workspace in its native data type
using the color space specified by the
ReturnedColorSpace property.
You can us e the MATLAB
image or imagesc function to view the
returned data.
Note If obj is running but not logging, and has been configured with a
hardware trigger, a timeout error will occur.
To interrupt the getsnapshot function and return control to the
MATLAB command line, issue the
^C (Ctrl+C) command.
Examples Create a video input o bject.
obj = videoinput('mat rox', 1);
12-14