Oscilloscope Reference Writing math plugins
Plugin rules
Plugins require at least one and at most two vector inputs (either INormalizedVector or IFastFrame). If two
vector inputs are used by the plugin, they both must be the same type. Additionally, plugins may take an
unlimited number of IStrings as input. When using IString inputs, it is important to remember that the
entire math e
quation, when typed into the editor, is limited to 128 characters.
Plugins can generate an INormalizedVector, IFastFrame or IWaveformDB waveform as output. If the
output type
is INormalizedVector, the vector input(s) must also be INormalizedVector. For IFastFrame and
IWaveformDB outputs, the inputs can be INormalizedVector or IFastFrame.
If FastFra
me is turned off and the plugin takes IFastFrames as input, the plugin is given IFastFrames that
consist of only one frame. How the plugin behaves when FastFrame is turned on depends on the output
waveform type. If the output is an INormalizedVe ctor, which takes only INormalizedVector as input, the
plugin is called once per frame and the math system handles iterating through all of the frames. If the
plugin produces IFastFrame or IWaveformDB it is called once per FastFrame acquisition. When the plugin
takes as input an IFastFrame, it is given all of the frames at once. If the plugin takes an INormalizedVector
as input
, the plugin will only see the fi rst frame which is put into the INormalizedVector. The rest of the
frames in the FastFrame are not seen by the plugin.
Summary of valid plugin signatures and behavior
Output Type Vector Input Type FastFrame Off FastFrame On
INormalizedVector INormalizedVector
Called once per acq Called once per frame
IFastFrame INormalizedVector
Called once per acq First frame put into
INormalizedVector
IFastFrame IFastFrame
Called once per acq; Only
contains one frame
Called once per FastFrame
IWaveformDB
INormalizedVector
Called once per acq First frame put into
INormalizedVector
IWaveformDB
IFastFrame
Called once per acq; Only
contains one frame
Called once per FastFrame
xxx
Example plugins
If the Application Developer Kit h as been installed on the instrument, example plugins can be found in
Microsoft Visual Studio. When you create a new project, choose Visual C#->Tektronix->Math to access
the examples.
Create a plugin
To create a p lugin, you need to use either one of our Visual Studio templates or create a new project using
the .NET language of your choice. To create a C# plugin from scratch, you firstneedtocreateanew,empty
C# project. On ce you create your project, add references to ScopeSupportBase, TekScriptingEngine,
System.Data, System.Data.DataSequence, System.XML and System.Xml.Linq. In your code, use System,
System.Collections.Generic, System.Linq, System.Text, and Tek.Scope.Support.
There are no requirements for the name of the class or namespace the plugins use. In this example
the namespace is MyMathPlugins and the class name is MyMath. The plugin function is a public,
DSA/DPO70000D, MSO/DPO/DSA70000C, DPO7000C, and MSO/DPO5000 Series 755
To Next Page
Loading...
Need help?
General
