Main Content

stop

Stop video input object

Syntax

stop(obj)

Description

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.

Examples

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

obj.TimerFcn = {'stop'};

Version History

Introduced before R2006a