User`s guide

preview
The Video Preview wind ow remains acti ve until it is either stopped
using
stoppreview or closed using closeprevi ew.Ifyoudeletethe
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 th e im age ob ject spe c if ied by the handle him age. preview scales
the image data to fill the entire area of the image object but does not
modifythevaluesofanyimageobjectproperties. Usethissyntaxto
preview video data in a custo m GUI of your o wn design (see Example s).
himage = preview(... ) returns himage, a handle to the image object
containingtheprevieweddata.Toobtainahandletothefigurewindow
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.
Image data is previewed in its native color space, indicated by the
default value of the
ReturnedColorSpace property of the video input
object. Todeterminethedefaultvalueforthe
ReturnedColorSpace
property, use propinfo.
Notes The behavior of the Video Preview window depends on the video input
object’s current state a nd trigger configuration.
Object State Preview Window Behavior
Running=off
Displays a live view of the image being acquired
from the d ev ice, fo r all trigger ty pes. The image is
updatedtoreflectchangesmadetoconfigurationsof
object properties. (The
FrameGrabInterval property
is ignored until a trigger occurs.)
12-44