IMAQ1394 Configure Trigger

NI-IMAQ for IEEE 1394 Cameras VI

IMAQ1394 Configure Trigger

Configures the trigger conditions for an acquisition. Use this VI before any configuration or acquisition VI to set up a triggered image acquisition.

Polarity specifies polarity for the trigger line. FALSE sets the polarity to the falling edge. TRUE sets the polarity to the rising edge.
IMAQ1394 Session In is a unique reference to the camera, which you can obtain with IMAQ1394 Init.
Timeout specifies the time, in milliseconds, allowed for the image acquisition to complete. If the acquisition cannot complete in time, an error returns.
Trigger Mode specifies the trigger mode. The following descriptions are valid for low-active polarity. All states are inverted for high-active polarity.

Disabled—No trigger. The camera starts integration immediately.

Mode 0—The camera starts integration on every falling edge of the external trigger input. Integration time is defined in the Shutter attribute.

Mode 1—The camera starts integration on every falling edge of the external trigger input. Integration time is equal to the low state of the external trigger.

Mode 2—The camera starts integration on the first falling edge of the external trigger input. At the Nth external trigger input falling edge, integration stops. N is defined in Parameter (optional).

Mode 3—This is the internal trigger mode. The camera issues a trigger internally. The cycle time is N times the cycle time of fastest frame rate. N is defined in Parameter (optional).The integration time is defined in the Shutter attribute.

Mode 4—The camera starts frame integration when the external trigger input changes to an active value. Each frame is exposed for a duration specified in the Shutter attribute. The number of frames is specified in Parameter (optional), which must have a value of 1 or more.

Mode 5—The camera starts frame integration when the external trigger input changes to an active value. Each frame is exposed while the external trigger is active. The number of frames is specified in Parameter (optional), which must have a value of 1 or more.

Note  Some cameras may not support every trigger mode.
error in (no error) is a cluster that describes the error status before this VI executes. If error in indicates that an error occurred before this VI was called, this VI may choose not to execute its function, but just pass the error through to its error out cluster. If no error has occurred, then this VI executes normally and sets its own error status in error out. Use the error handler VIs to look up the error code and to display the corresponding error message. Using the error in and error out clusters is a convenient way to check errors and to specify execution order by wiring the error output from one subVI to the error input of the next.
status is TRUE if an error occurred before this VI was called, or FALSE if not. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code.

code is a number identifying an error or warning. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code. Use the error handler VIs to look up the meaning of this code and display the corresponding error message.

source is a string that indicates the origin of the error, if any. Typically, source is the name of the VI in which the error occurred.

Parameter (optional) defines N in trigger modes 2 and 3.
IMAQ1394 Session Out is a unique reference to the camera. IMAQ1394 Session Out is the same as IMAQ1394 Session In.
error out is a cluster that describes the error status after this VI executes. If an error occurred before this VI was called, error out is the same as error in. Otherwise, error out shows the error, if any, that occurred in this VI. Use the error handler VIs to look up the error code and to display the corresponding error message. Using error in and error out clusters is a convenient way to check errors and to specify execution order by wiring the error output from one subVI to the error input of the next.
status is TRUE if an error occurred, or FALSE if not. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code.

code is a number identifying an error or warning. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code. Use the error handler VIs to look up the meaning of this code and display the corresponding error message.

source is a string that indicates the origin of the error, if any. Typically, source is the name of the VI in which the error occurred.

Note  Refer to Error Handling for error input and output information and error codes.