imgSessionTriggerDrive

NI IMAQ Function

imgSessionTriggerDrive

Usage

rval imgSessionTriggerDrive(SESSION_ID sid, uInt32 trigger, uInt32 polarity, uInt32 source);

Purpose

Configures the specified trigger line to drive a signal out.

Note  This function is obsolete. The replacement function is imgSessionTriggerDrive2, which incorporates the functionality of imgSessionTriggerDrive but also returns additional information.

Parameters

Name Type Direction
sid SESSION_ID input
trigger uInt32 input
polarity uInt32 input
source uInt32 input
rval Int32 output

Parameter Discussion

sid: valid SESSION_ID.

trigger: trigger line to drive. trigger can be one of the following constants:

IMG_EXT_TRIG0 IMG_EXT_RTSI2
IMG_EXT_TRIG1 IMG_EXT_RTSI3
IMG_EXT_TRIG2 IMG_EXT_RTSI4
IMG_EXT_TRIG3 IMG_EXT_RTSI5
IMG_EXT_RTSI0 IMG_EXT_RTSI6
IMG_EXT_RTSI1  
Note  IMG_EXT_TRIG ‹0..3› refers to the external trigger lines of the image acquisition device. IMG_EXT_RTSI ‹0..6› refers to the internal pins on the RTSI controller of the image acquisition device.

polarity: polarity of the trigger line. polarity can be one of the following constants:

IMG_TRIG_POLAR_ACTIVELDrives the line low when the signal is true.
IMG_TRIG_POLAR_ACTIVEHDrives the line high when the signal is true.

source: specifies the signal that drives the trigger line as specified by the following constants:

IMG_TRIG_DRIVE_DISABLED
IMG_TRIG_DRIVE_AQ_IN_PROGRESS
IMG_TRIG_DRIVE_AQ_DONE
IMG_TRIG_DRIVE_ASSERTED
IMG_TRIG_DRIVE_UNASSERTED
IMG_TRIG_DRIVE_HSYNC
IMG_TRIG_DRIVE_VSYNC
IMG_TRIG_DRIVE_FRAME_START
IMG_TRIG_DRIVE_FRAME_DONE

Return Value

This function returns 0 on success. On failure, this function returns an error code. For information about the error code, call imgShowError.

For more information, refer to the Obsolete functions topic.