Live-Charts 仓库技术指南:Simple、Flexible、Interactive 与 Powerful 的 .NET 图表库全景解读
Live-Charts 仓库技术指南:Simple、Flexible、Interactive 与 Powerful 的 .NET 图表库全景解读
本指南以 Live-Charts 仓库根目录的 README.md 为骨架,系统梳理这个面向 .NET 的图表、地图与仪表盘库的定位、核心机制与实战用法:它如何做到“像操作 List 一样简单”地驱动图表实时更新,如何通过 Mapper 配置机制把任意类型绘成图表,以及它支持哪些平台、图表类型与交互能力。读完你既能快速上手(安装、示例、基础折线图),也能从源码层面理解其数据驱动、自动更新与可定制架构的底层原理。
项目定位:一个“简单、灵活、交互、强大”的 .NET 图表库
README 用三组关键词概括了 Live-Charts 的设计目标:Flexible, Customizable(灵活、可定制)、Simple, Interactive(简单、交互)、Powerful(强大)。这三个词不是宣传口号,而是贯穿整个源码架构的设计原则:
- 简单:数据接入方式与操作普通泛型列表无异,图表会随数据变化实时更新并自动播放动画;
- 灵活:任何类型(甚至是你自己定义的类)都可以绘图,只需通过 Mapper 告诉图表“怎么取坐标”;
- 交互:支持缩放、平移、多轴、分区(Sections)、UI 元素叠加等;
- 强大:覆盖柱状图、折线图、热力图、仪表盘、地图、饼图、财务图、堆叠图等大量图表类型。
从仓库结构看,这套目标通过三层项目划分实现:Core(与 UI 框架无关的纯逻辑与数学核心)、Core40(面向 .NET 4.0 的便携核心副本)、以及三个平台视图层 WpfView、UwpView、WinFormsView(负责具体平台的渲染)。
简单:像操作 List 一样驱动图表,数据一变图表就动
README 中最核心的技术承诺是:"As easy as manipulating any generic list in .Net, LiveCharts updates and animates as your data changes in real time, charts are also sensitive to size changes." 这一承诺的源码实现基石是 ChartValues<T> 与 NoisyCollection<T>。
ChartValues:自带“噪音通知”的数据集合
ChartValues<T>(见 Core/ChartValues.cs)继承自 NoisyCollection<T>(见 Core/Helpers/NoisyCollection.cs)。所谓 “Noisy”(吵闹),是指这个集合在每次增删改数据时都会主动发出通知:
Add/AddRange/Insert/InsertRange/RemoveAt/Clear/ 索引赋值都会触发NoisyCollectionChanged事件;- 同时实现
INotifyCollectionChanged与INotifyPropertyChanged,与 WPF/UWP 的绑定体系天然兼容; - 内部用
List<T>存储并用lock保证线程安全,枚举时会拷贝一份快照再返回(NoisyCollection.GetEnumerator)。
在 Core/ChartValues.cs 中,OnChanged 回调会把变更事件转发给所有关联图表:
private void OnChanged(IEnumerable<T> oldItems, IEnumerable<T> newItems)
{
if (Trackers.Keys.All(x => x != null && x.Model.Chart != null))
Trackers.Keys.ForEach(x => x.Model.Chart.Updater.Run());
}
也就是说:你只要 chartValues.Add(x),图表就会自动重绘并播放过渡动画,这正是 README 所称“像操作泛型 List 一样简单”的底层机制。
官方示例:BasicLine
仓库 Examples/Wpf/CartesianChart/BasicLine/BasicLineExample.xaml.cs 演示了最基础的用法——把 ChartValues<double> 直接塞进 LineSeries:
SeriesCollection = new SeriesCollection
{
new LineSeries
{
Title = "Series 1",
Values = new ChartValues<double> { 4, 6, 5, 2, 7 }
},
new LineSeries
{
Title = "Series 2",
Values = new ChartValues<double> { 6, 7, 3, 4, 6 }
}
};
// 运行时修改 SeriesCollection,图表会自动动画更新
SeriesCollection.Add(new LineSeries
{
Values = new ChartValues<double> { 5, 3, 2, 4 },
LineSmoothness = 0 // 0 表示直线,1 表示非常平滑的曲线
});
// 运行时修改任意 Series 的 Values,同样会触发更新
SeriesCollection[2].Values.Add(5d);
对应 XAML(BasicLineExample.xaml)只需声明 CartesianChart、绑定 Series 与两个轴:
<lvc:CartesianChart Series="{Binding SeriesCollection}" LegendLocation="Right">
<lvc:CartesianChart.AxisY>
<lvc:Axis Title="Sales" LabelFormatter="{Binding YFormatter}"></lvc:Axis>
</lvc:CartesianChart.AxisY>
<lvc:CartesianChart.AxisX>
<lvc:Axis Title="Month" Labels="{Binding Labels}"></lvc:Axis>
</lvc:CartesianChart.AxisX>
</lvc:CartesianChart>
其中 LineSmoothness(曲线平滑度)、Title(轴标题)、Labels(X 轴分类标签)、LabelFormatter(数值格式化函数)都是官方公开的可配置项。
更新链路:从数据变更到画面重绘
数据驱动更新的完整调用链,可以从 Core/ChartUpdater.cs 中还原:
- 数据集合发生变化 →
NoisyCollectionChanged被触发; ChartValues.OnChanged调用Chart.Updater.Run();ChartUpdater.Update()依次执行:series.ActualValues.Initialize(series)(评估每个点的坐标与极值)、Chart.PrepareAxes()(计算轴范围)、series.Model.Update()(运行各系列绘制算法,如 Core/SeriesAlgorithms/LineAlgorithm.cs)、CollectGarbage(回收被移除的点视图);- 点级别的实时更新则由
ObservablePoint的INotifyPropertyChanged驱动——ChartValues.GetPoints会为每个可观察点订阅PropertyChanged事件,任一属性变化都会再次触发Updater.Run()(见 Core/ChartValues.cs)。
此外,图表对尺寸变化同样敏感:README 强调 "charts are also sensitive to size changes",配合 WpfView/CartesianChart.cs 中构造 CartesianChartCore 并把 Series、VisualElements 等暴露为依赖属性的实现,控件尺寸变化会自动触发重算布局。
灵活:任何类型都能绘图,全靠 Mapper 配置机制
README 的 “Flexible, Customizable” 部分强调图表本身的高度可定制性,而其技术根基是 类型映射(Mapper)机制:LiveCharts 可以绘制任何类型,前提是告诉它“如何从你的对象里取出坐标”。
全局配置注册:Charting.For<T>
静态类 Charting(见 Core/Charting.cs)维护一张“类型 → 映射器”的全局字典。For<T>(object config, SeriesOrientation orientation) 负责注册:
public static void For<T>(object config, SeriesOrientation orientation = SeriesOrientation.All)
orientation默认为All(横竖同用);传入Horizontal或Vertical时,横/竖方向可分别配置不同的映射;- 未注册的类型在绘图时会抛出
LiveChartsException,提示你“使用已配置类型或自行配置该类型”(见 Core/Charting.cs)。
Mappers 工厂与默认配置表
Mappers 静态工厂(见 Core/Configurations/Mappers.cs)提供六种现成映射器:Xy<T>(笛卡尔 X/Y)、Financial<T>(开高低收)、Weighted<T>(X/Y/权重,用于散点与热力)、Gantt<T>(甘特起止点)、Polar<T>(半径/角度)、Pie<T>(饼图)。
Charting 的静态构造函数为常用类型预置了默认配置,下表整理自 Core/Charting.cs:
| 数据类型 | 映射器 | 映射规则(Horizontal 方向) |
|---|---|---|
int / double / decimal / short / float / long |
Xy<T> |
X 取数组索引,Y 取数值本身 |
ObservablePoint |
Xy<ObservablePoint> |
X 取 X 属性,Y 取 Y 属性 |
ObservableValue |
Xy<ObservableValue> |
X 取索引,Y 取 Value 属性 |
DateTimePoint |
Xy<DateTimePoint> |
X 取 DateTime.Ticks,Y 取 Value 属性 |
ScatterPoint / HeatPoint |
Weighted<T> |
X、Y、Weight 三属性 |
OhlcPoint |
Financial<OhlcPoint> |
X 取索引,Open/High/Low/Close 四属性 |
PolarPoint |
Polar<PolarPoint> |
Radius、Angle 属性 |
GanttPoint |
Gantt<GanttPoint> |
StartPoint、EndPoint 属性 |
也就是说,你完全可以用自定义类 MyPoint { public double X; public double Y; } 直接喂给 ChartValues<MyPoint>,只需先注册:
Charting.For<MyPoint>(Mappers.Xy<MyPoint>()
.X(value => value.X)
.Y(value => value.Y));
CartesianMapper 源码解析
以 Core/Configurations/CartesianMapper.cs 为例,映射器本质是一组委托的持有者:
private Func<T, int, double> _x = (v, i) => i; // 默认 X = 索引
private Func<T, int, double> _y = (v, i) => i; // 默认 Y = 索引
private Func<T, int, object> _stroke;
private Func<T, int, object> _fill;
public void Evaluate(int key, T value, ChartPoint point)
{
point.X = _x(value, key);
point.Y = _y(value, key);
if (_stroke != null) point.Stroke = _stroke(value, key);
if (_fill != null) point.Fill = _fill(value, key);
}
Evaluate 是核心入口:它把每个原始数据对象转换成一个 ChartPoint(见 Core/ChartPoint.cs,内含 X/Y、Open/High/Low/Close、Weight、From/To/Sum 等全部坐标与堆叠字段)。X()/Y() 各提供两个重载:Func<T, double> 只取值,Func<T, int, double> 额外提供索引;Stroke()/Fill() 甚至支持按数据点动态指定画笔,实现逐点着色。
映射器的解析优先级在 Core/ChartValues.cs 的 GetConfig 中体现:单个 Series 自带配置(view.Configuration) → SeriesCollection 级配置(SeriesCollection.Configuration,见 Core/SeriesCollection.cs) → 全局 Charting 配置。
交互:缩放、平移与滚动由枚举选项直接控制
README 在 “Powerful” 部分明确列出 "we support zooming, panning, multiple axes, sections, merged UIElements and much more!"。其中缩放与平移由三个枚举直接控制:
ZoomingOptions(缩放)
| 值 | 含义 |
|---|---|
None |
禁用缩放 |
X |
仅 X 轴缩放 |
Y |
仅 Y 轴缩放 |
Xy |
X、Y 双轴缩放 |
PanningOptions(平移)
见 Core/PanningOptions.cs,默认值 Unset 表示“跟随缩放设置”;其余 None/X/Y/Xy 语义与缩放一致。
ScrollMode(滚动条)
见 Core/ScrollMode.cs:None 禁用滚动条,X/Y/XY 分别在对应轴启用滚动模式,适合大数据量下的窗口浏览。
轴范围变更事件
WPF 的 Axis(见 WpfView/Axis.cs)额外暴露 RangeChanged 与 PreviewRangeChanged 事件及对应命令(RangeChangedCommand/PreviewRangeChangedCommand),当用户通过缩放或平移改变轴范围时触发,便于联动其他 UI。仓库中 Examples/Wpf/CartesianChart/ZoomingAndPanning 与 Examples/Wpf/CartesianChart/SectionsDragable 都是这类交互的完整范例。
强大:图表类型全家桶与 10 万点压力示例
README 声称示例中包含 100,000 个数据点且图表持续刷新,并支持 "bars, lines, heat maps, gauges, maps" 等多种图表。仓库源码与示例目录可以逐一印证:
- 基础系列:折线
LineSeries、柱状ColumnSeries、行RowSeries、阶梯StepLineSeries、散点ScatterSeries(见 WpfView 目录); - 堆叠系列:
StackedAreaSeries、StackedColumnSeries、StackedRowSeries以及垂直变体,配合 Core/StackMode.cs 的Values(累加值)与Percentage(按占比堆叠)两种模式; - 财务图:
CandleSeries与OhlcSeries,示例见 Examples/Wpf/CartesianChart/Financial; - 热力图:
HeatSeries,示例见 Examples/Wpf/CartesianChart/HeatChart; - 饼图/环图:
PieChart与PieSeries,示例见 Examples/Wpf/PieChart; - 仪表盘:
AngularGauge、Gauge、Gauge360,示例见 Examples/Wpf/Gauges; - 地图:
GeoMap,示例见 Examples/Wpf/Maps/GeoMapExample.xaml; - 高级特性:多轴(MultiAxes)、分区(Sections)、UI 元素叠加(UIElements)、VisualElements 集合(Core/VisualElementsCollection.cs)等。
每种系列在 Core/SeriesAlgorithms 下都有对应的绘制算法类(如 LineAlgorithm、ColumnAlgorithm、PieAlgorithm、CandleAlgorithm 等),视图层通过 Model = new XxxAlgorithm(this) 挂接算法(见 WpfView/LineSeries.cs、WpfView/ColumnSeries.cs),形成“视图 Series → 核心 Algorithm → ChartPoint → 屏幕坐标”的渲染管线。数值到像素的换算由 Core/ChartFunctions.cs 的 ToPlotArea / FromPlotArea 完成,即 README 中 "Powerful" 的数学基础。
平台支持、.NET 版本与安装
支持的平台
README 明确指出:当前支持 WPF 与 WinForms,UWP 处于进行中(In progress),并正在向跨 .NET 库演进。仓库结构与此一致:
- WpfView/WpfView.nuspec:NuGet 包
LiveCharts.Wpf,依赖核心包LiveCharts,同时提供net40与net45两个目标; - WinFormsView/WinFormsView.nuspec:NuGet 包
LiveCharts.WinForms,依赖LiveCharts与LiveCharts.Wpf(WinForms 视图实际承载于 WPF 控件之上,因此需要引用 WPF 相关框架程序集); - UwpView/UwpView.csproj:UWP 视图层,对应 README 路线图中“UWP In progress”的状态。
.NET 版本要求
README 明确要求 .NET 4.0 或更高版本(.Net 4.0 or greater)。核心项目 Core/Core.csproj 通过条件编译符号 NET40/NET45 同时兼容两个目标框架(例如反射 API 在 .NET 4.5 下走 GetTypeInfo() 分支,见 Core/ChartValues.cs)。
安装方式
- WPF:通过 NuGet 引用
LiveCharts.Wpf包(依赖核心包LiveCharts),仓库内附带 install.ps1 与打包描述 WpfView.nuspec; - WinForms:通过 NuGet 引用
LiveCharts.WinForms包,见 WinFormsView/WinFormsView.nuspec 与 winforms.docs。
安装后建议直接运行仓库内的示例工程(LiveCharts.sln),示例分布于 Examples/Wpf、Examples/WinForms 与 Examples/UWP 三个目录,覆盖前述全部图表类型。
路线图与项目现状
README 的 Road Map 部分记录了项目演进计划,其中已勾选完成的是:在 WPF 与 WinForms 上构建了其他图表库所具备的全部特性。进行中的目标包括:
- 高性能算法(In progress);
- 平台扩展:WPF、WinForms 已完成,UWP 进行中,Xamarin 待启动;
- 1.0 版本发布计划(当时计划 WPF/WinForms 先行发布 1.0,其他平台以 beta 形式跟进)。
需要特别说明的是,README 顶部明确写道:"This project will continue in another repo, please see LiveCharts2 for more info"——即本项目(0.x 分支)的后续开发已迁移到名为 LiveCharts2 的新仓库,本项目处于维护/归档状态。这一迁移的背景在 README 的 1.0 重写说明中有详细交代:新版本将数学核心抽取为独立工程、以提升 WPF/UWP/WinForms 各平台版本的同步维护效率,并聚焦性能(新高性能包计划借助 SharpDx 以 DirectX 直接绘制)。因此,阅读本仓库源码的价值在于理解 0.x 时代成熟稳定的数据驱动架构,而新项目开发应转向 LiveCharts2。
从源码结构看整体架构(附阅读地图)
最后,为方便继续深入,这里给出本仓库的源码阅读地图(均为仓库根目录相对路径):
| 关注点 | 推荐阅读文件 |
|---|---|
| 全局类型配置与默认映射 | Core/Charting.cs、Core/Configurations/Mappers.cs |
| 数据集合与自动更新 | Core/ChartValues.cs、Core/Helpers/NoisyCollection.cs |
| 更新调度 | Core/ChartUpdater.cs、Core/Charts/ChartCore.cs |
| 坐标换算 | Core/ChartFunctions.cs、Core/AxisCore.cs |
| 系列绘制算法 | Core/SeriesAlgorithms(Line/Column/Pie/Candle/Stacked 等) |
| 平台视图层 | WpfView/CartesianChart.cs、WpfView/Axis.cs、WpfView/Series.cs |
| 开箱即用的数据点类型 | Core/Defaults(ObservablePoint/DateTimePoint/OhlcPoint 等) |
通过这张地图,你可以把 README 中“简单、灵活、交互、强大”的每一条主张,都在源码里找到对应实现,从而真正掌握 Live-Charts 0.x 的数据驱动绘图思想。