User`s guide

17 Functions — Alphabetical List

17-98

An image acquisition object stops running or logging when one of the following conditions

is met:

• The stop function is issued.

• The requested number of frames is acquired. This occurs when

FramesAcquired = FramesPerTrigger * (TriggerRepeat + 1)

where FramesAcquired, FramesPerTrigger, and TriggerRepeat are properties

of the video input object.

• A run-time error occurs.

• The object's Timeout value is reached.

Examples

Create a video input object.

vid = videoinput('winvideo');

Specify an acquisition that should take several seconds. The example sets the

FramesPerTrigger property to 300.

vid.FramesPerTrigger = 300;

Start the object. Because it is configured with an immediate trigger (the default),

acquisition begins when the object is started. The example calls the wait function after

calling the start function. Notice how wait blocks the MATLAB command line until the

acquisition is complete.

start(vid), wait(vid);