This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Stop video input object




stop(obj) halts an acquisition associated with the video input object obj. obj can be either a single video input object or an array of video input objects.

The stop function

  • Sets the object's Running property to 'Off'

  • Sets the object's Logging property to 'Off', if needed

  • Executes the object's StopFcn callback

An image acquisition object can also stop running under one of the following conditions:

  • 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.

The stop event is recorded in the object's EventLog property.


The stop function can be called by a video input object's event callback.

obj.TimerFcn = {'stop'};

Introduced before R2006a