Admin Production ni-theme
Current Publication

Configure TV Trigger Source

IVI Compliance Package

IviScope Configure TV Trigger Source

IviScopeTVTrigger Capability Group [TV]

This VI configures the oscilloscope for TV triggering. It configures the TV signal format, the event, and the signal polarity.

Note  This VI affects instrument behavior only if the trigger type is IVISCOPE_VAL_TV_TRIGGER. Call the IviScope Configure Trigger and IviScope Configure Trigger Coupling VIs to set the trigger type and trigger coupling before calling this VI.


instrument handle The instrument handle that you obtain from the IviScope Initialize or the IviScope Initialize With Options VI.
trigger source Pass the source you want the oscilloscope to monitor for a trigger. The driver sets the IviScope Trigger Source property to this value.

After you call one of the IviScope Read Waveform, IviScope Read Min Max Waveform [MmW], IviScope Read Waveform Measurement [WM], or IviScope Initiate Acquisition VIs, the oscilloscope waits for the trigger from the source you specify in this parameter.

This control accepts one of the valid channel names or additional trigger sources listed below.

Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel in MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names.

Additional Trigger Sources

IVISCOPE_VAL_EXTERNAL—External

IVISCOPE_VAL_TTL0 —PXI TRIG0 or VXI TTL0

IVISCOPE_VAL_TTL1—PXI TRIG1 or VXI TTL1

IVISCOPE_VAL_TTL2—PXI TRIG2 or VXI TTL2

IVISCOPE_VAL_TTL3—PXI TRIG3 or VXI TTL3

IVISCOPE_VAL_TTL4—PXI TRIG4 or VXI TTL4

IVISCOPE_VAL_TTL5—PXI TRIG5 or VXI TTL5

IVISCOPE_VAL_TTL6—PXI TRIG6 or VXI TTL6

IVISCOPE_VAL_TTL7—PXI TRIG7 or VXI TTL7

IVISCOPE_VAL_ECL0—VXI ECL0

IVISCOPE_VAL_ECL1—VXI ECL1

IVISCOPE_VAL_PXI_STAR—PXI Star

IVISCOPE_VAL_RTSI_0—RTSI line 0

IVISCOPE_VAL_RTSI_1—RTSI line 1

IVISCOPE_VAL_RTSI_2—RTSI line 2

IVISCOPE_VAL_RTSI_3—RTSI line 3

IVISCOPE_VAL_RTSI_4—RTSI line 4

IVISCOPE_VAL_RTSI_5—RTSI line 5

IVISCOPE_VAL_RTSI_6—RTSI line 6

Note  IVISCOPE_VAL_EXTERNAL—The oscilloscope waits for a trigger on the external trigger input.
tv signal format Pass the type of TV signal on which the oscilloscope triggers. The driver sets the IviScope TV Trigger Signal Format [TV] property to this value.

Defined Values:

IVISCOPE_VAL_NTSC—NTSC video signal

IVISCOPE_VAL_PAL—PAL video signal

IVISCOPE_VAL_SECAM—SECAM video signal

Default Value: IVISCOPE_VAL_NTSC

tv event Pass the TV event on which you want the oscilloscope to trigger. The driver sets the IviScope TV Trigger Event [TV] property to this value.

Defined Values:

IVISCOPE_VAL_TV_EVENT_FIELD1—Trigger on field 1

IVISCOPE_VAL_TV_EVENT_FIELD2—Trigger on field 2

IVISCOPE_VAL_TV_EVENT_ANY_FIELD—Trigger on any field

IVISCOPE_VAL_TV_EVENT_ANY_LINE—Trigger on any line

IVISCOPE_VAL_TV_EVENT_LINE_NUMBER—Trigger on a line you specify

Default Value: IVISCOPE_VAL_TV_EVENT_FIELD1

Note  If you specify IVISCOPE_VAL_TV_EVENT_LINE_NUMBER, you must set the line number on which the oscilloscope triggers by calling the IviScope Configure TV Trigger Line Number [TV] VI.
trigger polarity Pass the polarity of the TV signal. The driver sets the IviScope TV Trigger Polarity  property to this value.

Defined Values:

IVISCOPE_VAL_TV_POSITIVE—Trigger on a positive video sync

IVISCOPE_VAL_TV_NEGATIVE—Trigger on a negative video sync

Default value: IVISCOPE_VAL_TV_POSITIVE

error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviScope Initialize or the IviScope Initialize With Options VI.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.