Image Acquisition Toolbox

triggerconfig

Configure video input object trigger properties

Syntax

• triggerconfig(obj,'type')
  triggerconfig(obj,'type','condition')
  triggerconfig(obj,'type','condition','source')
  config = triggerconfig(obj)
  triggerconfig(obj,config)
  

Description

triggerconfig(obj,'type')
triggerconfig(obj,'type','condition')
triggerconfig(obj,'type','condition','source') configures the values of the TriggerType, TriggerCondition, and TriggerSource properties of video input object obj to the values specified by type, condition, and source, respectively.

obj can be either a single video input object or an array of video input objects. If an error occurs, any video input objects in the array that have already been configured are returned to their original configurations.

type, condition, and source are text strings. For a list of valid trigger configurations, use triggerinfo(obj). condition and source are optional parameters as long as a unique trigger configuration can be determined from the parameters provided.

config = triggerconfig(obj) returns a MATLAB structure config containing the object's current trigger configuration. obj must be a 1-by-1 video input object. The field names of config are TriggerType, TriggerCondition, and TriggerSource. Each field contains the current value of the object's property.

triggerconfig(obj,config) configures the TriggerType, TriggerCondition, and TriggerSource property values for video input object obj using config, a MATLAB structure with field names TriggerType, TriggerCondition, and TriggerSource, each containing the desired property value.

Examples

Example 1

Construct a video input object.

• vid = videoinput('winvideo', 1);
  

Configure trigger properties for the object.

• triggerconfig(vid, 'manual')
  

Trigger the acquisition.

• start(obj)
  trigger(obj)
  

Remove video input object from memory.

• delete(vid);
  

Example 2

This example uses a structure returned from triggerinfo to configure trigger parameters.

Create a video input object.

• vid = videoinput('winvideo', 1);
  

Use triggerinfo to get all valid configurations for the trigger properties for the object.

• config = triggerinfo(vid);
  

Pass one of the configurations to the triggerconfig function.

• triggerconfig(vid,config(2));
  

Remove video input object from memory.

• delete(vid);
  

See Also

imaqhelp, trigger, triggerinfo, videoinput

trigger

triggerinfo