內(nèi)容

本教程主要為大家介紹如何在Microsoft Visual Studio 2010/2013 .NET C#項(xiàng)目中使用LightningChart Ultimate v6.4 (LC)的SampleDataSeries來(lái)繪制固定時(shí)間間隔的數(shù)據(jù)。在其他的Visual Studio版本中，LC的接口程序也是類似的。在Visual Studio中安裝的LightningChart信息被描述在安裝文件夾的另一個(gè)文檔中。

前提條件

• 掌握C＃和Visual Studio的基本知識(shí)。
• 已經(jīng)安裝LightningChart，示例項(xiàng)目能正常運(yùn)行。
• 在Visual Studio中手動(dòng)安裝Arction工具箱，或者在LightningChart Ultimate安裝過(guò)程中自動(dòng)安裝Arction工具箱。

描述

通過(guò)signal generator.LightningChart來(lái)使圖表顯示生成的采樣數(shù)據(jù)，這其中必須包括在SampleDataSeries系列中由事件處理函數(shù)連接到信號(hào)發(fā)生器上的被添加的數(shù)據(jù)。信號(hào)發(fā)生器具有一個(gè)用戶界面，它可以編輯所產(chǎn)生的波形。在本示例中，信號(hào)發(fā)生器在代碼和用戶界面的相應(yīng)更新中進(jìn)行初始化。

SampleData series

SampleData series允許較固定間隔的信號(hào)數(shù)據(jù)。當(dāng)添加數(shù)據(jù)時(shí)，沒(méi)有必要給定X點(diǎn)的值，使用FirstSampleTimeStamp、SamplingFrequency和示例索引可以自動(dòng)計(jì)算X點(diǎn)的位置。

添加LightningChart和SignalGenerator控件到窗體中

創(chuàng)建一個(gè)能自動(dòng)打開(kāi)主要窗體的Windows Forms應(yīng)用程序。從工具箱中找到LightningChart控件并將其拖放到窗體中。用同樣的方法步驟添加SignalGenerator控件。

在Form編輯器中設(shè)置LC Anchor屬性的Top、Bottom、Left、Right和SignalGenerator Anchor屬性的Bottom、Left、Right 。這樣使它們能很好的被定位，從而不需要調(diào)整大小。

構(gòu)造函數(shù)

調(diào)用構(gòu)造函數(shù)初始化。

public Form1()
{
InitializeComponent();
InitializeChart();
InitializeSignalGenerator();
}

初始化LightningChart控件

編輯Form1.cs的源代碼（在Solution資源管理器中右鍵單擊Form1.cs并選擇"View Code"）來(lái)添加一個(gè)單獨(dú)的SampleDataSeries到LC中。下面是一個(gè)示例代碼：

private void InitializeChart()
{
// Disable repaints caused by property changes
lightningChartUltimate1.BeginUpdate();
// Properties could be also set at Form editor
lightningChartUltimate1.Name = "SampleDataSeries chart" ;
// Hide legend box
lightningChartUltimate1.ViewXY.LegendBox.Visible = false ;
// Add SampleData series with sample format as double (default).
// Double format due easy sample data update on generated sample data (see below)
SampleDataSeries series = new SampleDataSeries (lightningChartUltimate1.ViewXY,
lightningChartUltimate1.ViewXY.XAxes[0], lightningChartUltimate1.ViewXY.YAxes[0]);
// Add the created series into SampleDataSeries list
lightningChartUltimate1.ViewXY.SampleDataSeries.Add(series);
// Allow automatic destruction of outscrolled data
lightningChartUltimate1.ViewXY.DropOldSeriesData = true ;
// Allow chart drawing
lightningChartUltimate1.EndUpdate();
}

初始化SignalGenerator

SignalGenerator通過(guò)使用LC能生成樣本數(shù)據(jù)，信號(hào)發(fā)生器被初始化生成1 Hz的正弦波樣本。下面是一個(gè)示例方法來(lái)初始化信號(hào)發(fā)生器，用戶可以使用同樣的方法來(lái)初始化Visual Studio的屬性編輯器。

private void InitializeSignalGenerator()
{
// Set name
signalGenerator1.Name = "Signal" ;
// Clear sine waveform table
signalGenerator1.WaveFormSines.Clear();
// Clear random noise table
signalGenerator1.WaveFormRandomNoises.Clear();
// Set sampling frequency
signalGenerator1.SamplingFrequency = 1000;
// Set signal generator output interval
signalGenerator1.OutputInterval = 2;
// Set thread type
signalGenerator1.ThreadType = ThreadType .Timer;
// Add some event listeners
signalGenerator1.DataGenerated += new
DataGeneratedEventHandler(signalGenerator1_DataGenerated);
signalGenerator1.Started += signalGenerator1_Started;
signalGenerator1.Stopped += signalGenerator1_Stopped;
// Create sine waveform component
SineComponent sineComp = new SineComponent ();
sineComp.Amplitude = 10.0;
sineComp.DelayMs = 0;
sineComp.Frequency = 1;
sineComp.Offset = 0;
sineComp.Enabled = true ;
signalGenerator1.WaveFormSines.Add(sineComp);
// Create noise waveform component
RandomNoiseComponent noiseComp = new RandomNoiseComponent ();
noiseComp.Amplitude = 1.0;
noiseComp.Offset = 0;
noiseComp.Enabled = true ;
signalGenerator1.WaveFormRandomNoises.Add(noiseComp);
// Update signal generator ui from added components
signalGenerator1.UpdateUIFromWaveFormComponents();
}

信號(hào)發(fā)生器生成的時(shí)間應(yīng)被用來(lái)初始化、顯示和結(jié)束采樣顯示。以下是在信號(hào)發(fā)生器初始化方法中引用的方法。

void signalGenerator1_Started(StartedEventArgs args)
{
// Prepare chart for property updates, in batch
lightningChartUltimate1.BeginUpdate();
// Update title
lightningChartUltimate1.Title.Text = string .Format( "LightningChart Ultimate,
sfreq = {0} kHz" , ( double )signalGenerator1.SamplingFrequency / 1000.0);
// Set x axis range
lightningChartUltimate1.ViewXY.XAxes[0].SetRange(0, 10);
// Set scroll position to the beginning
lightningChartUltimate1.ViewXY.XAxes[0].ScrollPosition = 0;
// Scrollmode to scrolling
lightningChartUltimate1.ViewXY.XAxes[0].ScrollMode = XAxisScrollMode .Scrolling;
// Chart has one Y axis ready to go. Just set the range
lightningChartUltimate1.ViewXY.YAxes[0].SetRange(-10, 10);
// Update series properties
SampleDataSeries series = lightningChartUltimate1.ViewXY.SampleDataSeries[0];
series.Clear();
series.FirstSampleTimeStamp = 1.0 / signalGenerator1.SamplingFrequency;
series.SamplingFrequency = signalGenerator1.SamplingFrequency;
series.MouseInteraction = false ;
// Allow chart to update view
lightningChartUltimate1.EndUpdate();
}
void signalGenerator1_Stopped()
{
// Prepare chart for property updates
lightningChartUltimate1.BeginUpdate();
// Set the scroll mode to None for data review
lightningChartUltimate1.ViewXY.XAxes[0].ScrollMode = XAxisScrollMode .None;
// Set view to data end
double dMin = lightningChartUltimate1.ViewXY.XAxes[0].ScrollPosition -
(lightningChartUltimate1.ViewXY.XAxes[0].Maximum -
lightningChartUltimate1.ViewXY.XAxes[0].Minimum);
lightningChartUltimate1.ViewXY.XAxes[0].SetRange( Math .Max(0, dMin),
lightningChartUltimate1.ViewXY.XAxes[0].ScrollPosition);
// Allow mouse interaction with series
lightningChartUltimate1.ViewXY.SampleDataSeries[0].MouseInteraction = true ;
// Allow chart to update view
private void signalGenerator1_DataGenerated(DataGeneratedEventArgs args)
{
// This event handler is raised when new data points are generated.
// 'samples' is a multi-channel input. In this example, only the
// first channel (samples[0]) is used.
if (args.Samples.Length == 0) return;
lightningChartUltimate1.BeginUpdate();
lightningChartUltimate1.ViewXY.SampleDataSeries[0].AddSamples(args.Samples[0],
false);
lightningChartUltimate1.ViewXY.XAxes[0].ScrollPosition =
args.FirstSampleTimeStamp
+ (double)(args.Samples[0].Length - 1) / signalGenerator1.SamplingFrequency;
lightningChartUltimate1.EndUpdate();
}

結(jié)果

編譯并運(yùn)行該項(xiàng)目，其結(jié)果應(yīng)如下圖所示：

按下啟動(dòng)按鈕，啟動(dòng)信號(hào)發(fā)生器。LC應(yīng)該以較正弦曲線小的幅度繪制波形。