Image Acquisition Toolbox

preview

Activate a live image preview window

Syntax

• preview(obj)
  

Description

preview(obj) immediately activates a live image preview window for the video input object obj. The size of the previewed images reflects the ROIPosition property configuration. The preview window remains active until it is closed with the closepreview function.

The behavior of the preview window depends on the object's current state and trigger configuration.

While an object is stopped (Running = 'off'), the preview window shows 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.)

When an object is started (Running = 'on'), the behavior of the preview window depends on the trigger type. If the trigger type is set to immediate or manual, the preview window continues to update the image displayed. If the trigger type is set to hardware, the preview window stops updating the image displayed until a trigger occurs.

While an object is logging (Logging = 'on'), the preview window might drop some data frames, but this does not affect the frames logged to memory or disk.

If you delete obj with the delete function, any associated preview windows are closed.

See Also

closepreview, videoinput

peekdata

propinfo