User`s guide
stop
17-85
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.