Skip to Main Content Skip to Search
Product Documentation

start - Obtain exclusive use of image acquisition device

Syntax

start(obj)

Description

start(obj) obtains exclusive use of the image acquisition device associated with the video input object obj and locks the device's configuration. Starting an object is a necessary first step to acquire image data, but it does not control when data is logged.

obj can either be a 1-by-1 video input object or an array of video input objects.

Data logging is controlled with the TriggerType property.

Trigger Type

Logging Behavior

'hardware'

Data logging occurs when the condition specified in the object's TriggerCondition property is met via the TriggerSource.

'immediate'

Data logging occurs immediately.

'manual'

Data logging occurs when the trigger function is called.

Use the triggerconfig function to configure the object's trigger settings.

When an acquisition is started, obj performs the following operations:

  1. Transfers the object's configuration to the associated hardware.

  2. Executes the object's StartFcn callback.

  3. Sets the object's Running property to 'On'.

If the object's StartFcn errors, the hardware is never started and the object's Running property remains 'Off'.

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

An image acquisition object stops running when one of the following conditions is met:

Examples

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

obj.StopFcn = {'start'};

See Also

imaqfind | imaqhelp | propinfo | stop | trigger | triggerconfig

  


Recommended Products

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.

 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS