User`s guide

17 Functions — Alphabetical List
17-68
The Video Preview window remains active until it is either stopped using stoppreview
or closed using closepreview. If you delete the object, by calling delete(obj), the
Video Preview window stops previewing and closes automatically.
preview(obj,himage) displays live video data for video input object obj in the
image object specified by the handle himage. preview scales the image data to fill
the entire area of the image object but does not modify the values of any image object
properties. Use this syntax to preview video data in a custom GUI of your own design
(see Examples).
himage = preview(...) returns himage, a handle to the image object containing the
previewed data. To obtain a handle to the figure window containing the image object,
use the ancestor function. For more information about using image objects, see image.
See the Custom Update Function section for more information about the image object
returned.
Notes
The behavior of the Video Preview window depends on the video input object's current
state and trigger configuration.
Object State Preview Window Behavior
Running=off Displays a live view of the image being acquired from the device,
for all trigger types. The image is updated to reflect changes made
to configurations of object properties. (The FrameGrabInterval
property is ignored until a trigger occurs.)
Running=on If TriggerType is set to immediate or manual, the Video Preview
window continues to update the image displayed.
If TriggerType is set to hardware, the Video Preview window
stops updating the image displayed until a trigger occurs.
Logging=on Video Preview window might drop some data frames, but this will
not affect the frames logged to memory or disk.
Note: The Image Acquisition Toolbox Preview window and the Preview window that is
built into the Image Acquisition Tool support the display of up to 16-bit image data. The
Preview window was designed to only show 8-bit data, but many cameras return 10-, 12-,