NI-SCOPE .NET Class Library Help

ScopeTVTrigger.Configure Method

Download PDF

Updated2023-09-06
2 minute(s) read

ScopeTVTriggerConfigure Method

Configures the common properties for video triggering, including the signal format, TV event, line number, polarity, and enable DC restore. A video trigger occurs when the digitizer finds a valid video signal sync. When you initiate an acquisition, the digitizer waits for the start trigger, which is configured through the Source attribute. The default is Immediate. Upon receiving the start trigger the digitizer begins sampling pretrigger points. After the digitizer finishes sampling pretrigger points, the digitizer waits for a reference (stop) trigger that you specify with a method such as this one. Upon receiving the reference trigger the digitizer finishes the acquisition after completing posttrigger sampling. With each Configure Trigger method, you specify configuration parameters such as the trigger source and the amount of trigger delay.

Namespace: NationalInstruments.ModularInstruments.NIScope
Assembly: NationalInstruments.ModularInstruments.NIScope.Fx45 (in NationalInstruments.ModularInstruments.NIScope.Fx45.dll) Version: 2023

Syntax

public void Configure(
	ScopeTriggerSource triggerSource,
	bool triggerDCRestoreEnable,
	ScopeTVTriggerSignalFormat triggerSignalFormat,
	ScopeTVTriggerEvent triggerEvent,
	long triggerLineNumber,
	ScopeTVTriggerPolarity triggerPolarity,
	ScopeTriggerCoupling triggerCoupling,
	PrecisionTimeSpan triggerHoldoff,
	PrecisionTimeSpan triggerDelay
)

Public Sub Configure ( 
	triggerSource As ScopeTriggerSource,
	triggerDCRestoreEnable As Boolean,
	triggerSignalFormat As ScopeTVTriggerSignalFormat,
	triggerEvent As ScopeTVTriggerEvent,
	triggerLineNumber As Long,
	triggerPolarity As ScopeTVTriggerPolarity,
	triggerCoupling As ScopeTriggerCoupling,
	triggerHoldoff As PrecisionTimeSpan,
	triggerDelay As PrecisionTimeSpan
)

Parameters

triggerSource: Type: NationalInstruments.ModularInstruments.NIScopeScopeTriggerSource
The trigger source. Refer to ScopeTriggerSource for defined values.
triggerDCRestoreEnable: Type: SystemBoolean
Offsets each video line so the clamping level (the portion of the video line between the end of the color burst and the beginning of the active image) is moved to zero volt. Refer to DCRestoreEnabled for defined values.
triggerSignalFormat: Type: NationalInstruments.ModularInstruments.NIScopeScopeTVTriggerSignalFormat
The type of video signal sync the digitizer should look for. Refer to SignalFormat for more information.
triggerEvent: Type: NationalInstruments.ModularInstruments.NIScopeScopeTVTriggerEvent
The TV event you want to trigger on. You can trigger on a specific or on the next coming line or field of the signal.
triggerLineNumber: Type: SystemInt64
The line number to trigger on. The line number range covers an entire frame and is referenced as shown on Vertical Blanking and Synchronization Signal. Refer to LineNumber for more information. Default value is 1
triggerPolarity: Type: NationalInstruments.ModularInstruments.NIScopeScopeTVTriggerPolarity
The polarity of the video signal sync.
triggerCoupling: Type: NationalInstruments.ModularInstruments.NIScopeScopeTriggerCoupling
Applies coupling and filtering options to the trigger signal. Refer to Coupling for more information.
triggerHoldoff: Type: NationalInstrumentsPrecisionTimeSpan
The length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Refer to Holdoff for more information.
triggerDelay: Type: NationalInstrumentsPrecisionTimeSpan
The amount of time the digitizer waits after receiving the trigger to start acquiring data. Refer to Delay for more information.

NI-SCOPE .NET Class Library Help

Table of Contents

ScopeTVTrigger.Configure Method

Syntax

Parameters

See Also

Reference

Log in to get a better experience