半岛外围网上直营

内容

本教程主要为大家介绍如何在Microsoft Visual Studio 2010/2013 .NET C#项目中使用LightningChart Ultimate v6.4 (LC)的SampleDataSeries来绘制固定时间间隔的数据。在其他的Visual Studio版本中，LC的接口程序也是类似的。在Visual Studio中安装的LightningChart信息被描述在安装文件夹的另一个文档中。

前提条件

• 掌握C＃和Visual Studio的基本知识。
• 已经安装LightningChart，示例项目能正常运行。
• 在Visual Studio中手动安装Arction工具箱，或者在LightningChart Ultimate安装过程中自动安装Arction工具箱。

描述

通过signal generator.LightningChart来使图表显示生成的采样数据，这其中必须包括在SampleDataSeries系列中由事件处理函数连接到信号发生器上的被添加的数据。信号发生器具有一个用户界面，它可以编辑所产生的波形。在本示例中，信号发生器在代码和用户界面的相应更新中进行初始化。

SampleData series

SampleData series允许较固定间隔的信号数据。当添加数据时，没有必要给定X点的值，使用FirstSampleTimeStamp、SamplingFrequency和示例索引可以自动计算X点的位置。

添加LightningChart和SignalGenerator控件到窗体中

创建一个能自动打开主要窗体的Windows Forms应用程序。从工具箱中找到LightningChart控件并将其拖放到窗体中。用同样的方法步骤添加SignalGenerator控件。

在Form编辑器中设置LC Anchor属性的Top、Bottom、Left、Right和SignalGenerator Anchor属性的Bottom、Left、Right 。这样使它们能很好的被定位，从而不需要调整大小。

构造函数

调用构造函数初始化。

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

初始化LightningChart控件

编辑Form1.cs的源代码（在Solution资源管理器中右键单击Form1.cs并选择"View Code"）来添加一个单独的SampleDataSeries到LC中。下面是一个示例代码：

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通过使用LC能生成样本数据，信号发生器被初始化生成1 Hz的正弦波样本。下面是一个示例方法来初始化信号发生器，用户可以使用同样的方法来初始化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();
}

信号发生器生成的时间应被用来初始化、显示和结束采样显示。以下是在信号发生器初始化方法中引用的方法。

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();
}

结果

编译并运行该项目，其结果应如下图所示：

按下启动按钮，启动信号发生器。LC应该以较正弦曲线小的幅度绘制波形。