TriggerMode

Description

Returns or sets the trigger mode as defined by DCAM 1.31 specifications. The values 0 - 5 and 14 - 15 correspond to the following modes (the TriggerPolarity is assumed to be set to Low Active):

0 - Mode 0

Camera starts integration of the incoming light from the external trigger input falling edge. Integration time is defined by the Shutter option.

1 - Mode 1

Camera starts integration of the incoming light from the external trigger input falling edge. Integration time is equal to low state time of the external trigger input.

2 - Mode 2

Camera starts integration of the incoming light from the external trigger input falling edge. At the TriggerCounter-th external trigger input falling edge, integration will be stopped.

3 - Mode 3

Internal trigger mode. Camera will issue the trigger signal internally, with a cycle time equal to TriggerCounter times of the cycle time of the fastest frame. Integration time of the incoming light is defined by the Shutter property.

4 - Mode 4

Multiple shutter preset mode. Camera starts integration of incoming light from first external trigger input falling edge and exposes incoming light at Shutter time. Repeat this sequence TriggerCounter times and then finish integration.

5 - Mode 5

Multiple shutter pulse width mode. Camera starts integration of incoming light from first external trigger input falling edge and exposes incoming light until trigger is inactive. Repeat this sequence TriggerCounter times and then finish integration.

14 - Mode 14

Vendor unique trigger 0. Refer to the camera documentation for details.

15 - Mode 15

Vendor unique trigger 1. Refer to the camera documentation for details.

Syntax

[VB]
objActiveDcam.TriggerMode [= Value]

[C/C++]
HRESULT get_TriggerMode( long *pTriggerMode );
HRESULT put_TriggerMode( long TriggerMode );


Data Type [VB]

Long


Parameters [C/C++]

pTriggerMode [out,retval]

Pointer to the ordinal number of the currently selected palette

TriggerMode [in]

The number of the palette to be selected

Return Values

S_OK

Success

E_FAIL

Failure.

E_INVALIDARG

Invalid property value.

Example

This VB example sets Mode 1 for the trigger input operation.

ActiveDcam1.TriggerMode = 1
MsgBox ActiveDcam1.TriggerMode

Remarks

Trigger modes 2, 3, 4 and 5 work in combination with TriggerCounter. If trigger modes 0, 2, and 4 are used with the software TriggerSource, there is no need to reset the trigger signal (by issuing SoftTrigger with the False argument), as the trigger will reset itself. For more information on the DCAM trigger modes refer to "IIDC 1394-based Digital Camera Specification, Version 1.31" published by the 1394 Trade Association.

Note that only certain trigger modes are available for a specific camera. To retrieve the list of available trigger modes use GetTriggerInfo.