ChartDirector应用笔记（一）

ChartDirector介绍

ChartDirector是一款小巧精细的商业图表库。其适用的语言范围非常广泛，包括.Net, Java, Asp, VB, PHP, Python, Ruby, C++等。ChartDirector既可以为WEB应用提供图表支持，还能为桌面应用提供良好的图表体验。除此之外，ChartDirector还能与MFC, Qt等界面框架无缝结合。这一点，在官方提供的帮助文档中即可窥知一二。在本系列文章中，也将以Qt应用程序框架作为基础，编写各种图表的应用实例。

正如上面所说的，ChartDirector是一款商业图表库。在未获得官方使用授权的情况下使用，图表中会出现黄色标识符。作为独立的个人开发者，显然无法也不必要去购买该库的使用证书。网上的破解方式也比较多，基本上是对官方附带的Dll文件进行破解覆盖即可。

ChartDirector类层次

ChartDirector库中有三大类继承结构较为常用，下面画出了这三大类继承结构：

图表类继承层次是对整个ChartDirector库的功能总结。从上图可以看出，ChartDirector类库能够绘制七大种类的图表：MultiChart, PolarChart, ThreeDChart, BaseMeter, PieChart, XYChart, PyramidChart。其中，金融类图表FinanceChart继承自MultiChart。金融类图表常常包含各种参数和指标，因此使用MultiChart作为基类继承也是情理中的事情。ThreeDChart类派生出了两个子类：SurfaceChart和ThreeDScatterChart。这两个子类用于绘制3D图表，3D图表经常用于立体表现数据差异，绘制出来的图表具有较强的立体视效。BaseMeter类代表仪表基类，派生子类包括：AngularMeter和LinearMeter类。如类名所示的那样，AngularMeter绘制的仪表常常带有弧度，而LinearMeter类则是线性绘制仪表，通常具有水平或者垂直外观。

XYChart类是ChartDirector类库中的一个大类，凡是包含X、Y坐标的图表都属于XYChart。因此，用于XYChart类的Layer类也派生出了丰富的子类，用于实现不同类型的XY图表。Layer类的具体作用是什么呢？由于官方文档上并未对ChartDirector的设计架构进行阐述，因此只能对Layer的功能进行推测理解。我的理解是，Layer就是一般意义上的图层，如果需要在同一个画板上绘制多个XY图表，需要组合不同的Layer类。不同的Layer可以组合在一起，实现复杂的功能。一般在绘制图表的时候，需要根据不同的图表类型添加不同的Layer派生类。

下面是Polar/Radar类的图层类继承层次：

可以看到，PolarChart类的图层类相对较少，样式比较固定。以PolarLayer类为基类派生出了PolarLineLayer, PolarAreaLayer, PolarVectorLayer三个类。

整个ChartDirector类库基本上主要就是由上述这些类组成的。当然，还包括Array, Axis, Box, Sector类辅助类。从这方面考察，ChartDirector类库还是足够轻巧的，学习使用上也较为简单。遗憾的是，附带的说明文档并未涉及太多的架构方面的说明。因此，在完全理解ChartDirector库的设计理念方面存在一定困难。

重要概念

要熟练运用ChartDirector类库需要理解好一些概念。下面是本人的一些总结和理解：

• Chart对象。Chart对象是绘图的基础，可以是上述图表类继承层次中的任意一个类的对象。每一个绘制出来的图表都属于特定的图表类。如帮助文档中的Simple Bar Chart，这是一个简单的XYChart的应用实例，生成的chart对象是XYChart类的实例。总之，在绘制每一个图表前都需要实例化一个Chart对象。
• Layer类。Layer类在上面稍微提过，我将之理解为图片处理中的图层。Layer之间可以叠加以组合绘制出更加复杂的图表。值得注意的是，不同的图表组件需要对应的Layer类来实现。在XYChart类中，实现了很多了add*函数用于给chart对象添加图层。如addLineLayer, addBarLayer,  addBoxLayer等。
• PlotArea。PlotArea类表示XY图表中的绘图区域。在绘制XY图表的过程中，设置PlotArea是Chart对象实例化完成后需要做的第一件事。PlotArea使用像素坐标系统，也就是说：(0,0)位于绘制区域的左上方，X轴往右增加，Y轴往下增加。对于其他种类的图表，PlotArea这个概念并不存在。
• DrawArea。DrawArea类处于绘图底层，是整个类库绘图的重要基础。ChartDirector类库中所有的图表类都在内部维护一个DrawArea对象，该对象用于提供绘制原语，如绘制线条、形状、文本等。用户也可以通过获取DrawArea对象来自定义绘制选项。
• QChartViewer. QChartViewer是用来整合ChartDirector类库到Qt框架中来的中间类。该类继承自QLabel和ViewPortManager类，用于表现图表绘制结果，处理鼠标、键盘交互事件等。在ChartDirector类库中，QChartViewer类以源代码的形式附带。用户可以查看其的实现方式，也可以直接包含进Qt工程中进行使用。

绘制步骤

以simple bar chart为例：

1. 生成Chart对象：XYChart* c = new XYChart(250, 250);
2. 设置绘图区域（可选）：c->setPlotArea(30, 20, 200, 200);
3. 添加图层（可选）：c->addBarLayer(...);
4. 设置坐标参数：c->xAxis()->setLabels(...); c->yAxis()->setLabels(...);

下一篇讲述Simple Bar Chart的使用。