上篇介绍了Qt Charts二维图表模块，本篇笔记总结Qt三维图表模块——Data Visualization。同样，在Qt5.7之前之后商业版才有，从Qt5.7开始免费开放在了社区版中。与QtCharts类似，也是基于Qt的Graphics View图形视图架构。当然，目前的Data Visualization还无法和一些专业的三维显示类库相提并论，但是对于一些简单的三维数据显示是比较实用的。另外，本人目前为止还未用过这个模块，所以文中不适当的地方请多包涵，也请评论区提宝贵意见。
概述
Data Visualization的三维显示功能主要由三种三维图形来实现，分别是三维柱状图Q3DBars,三维空间散点Q3DScatter，三维曲面Q3DSurface。这三个类的父类都是QAbstract3DGraph，从QWindow继承而来。
Data Visualization与Qt Charts类似都是基于Qt Graphics View的图形视图结构，所以一个三维图形也是由图表、序列、坐标轴等元素构成。响应的序列类有：QBar3DSeries，QScatter3DSeries，QSurface3DSeries类。这三个序列类是与图形类Q3DBars，Q3DScatter，Q3DSurface一一对应的。在一个图中可以有多个同类型的序列，但不能有不同类型的序列。另外，三维图形也有坐标轴类，共有两种坐标轴类：QValue3DAxis和QCategory3DAxis，前者用于数值型坐标轴，后者用于文字型坐标轴。
Data Visualization模块中还有数据代理（Data Proxies），数据代理类就是与序列对应，用于存储序列的数据的类。这也涉及一些具体的功能类：QBarDataProxy，QScatterDataProxy和QSurfaceDataProxy，这也与三种图表一一对应。
在使用时，需要在Qt工程.pro文件中加入：
QT += datavisualization
如果是VS工程，需要在Qt Settings中勾选这一模块。
在调用时源码中添加：
#include <QtDataVisualization>
using namespace QtDataVisualization;
如果你仅仅用到了其中部分头文件，比如只用到了Q3DBars，建议只include相关的几个头文件。
三维柱状图
Q3DBars实现创建图表，QBar3DSeries and QBarDataProxy用于设置序列和数据，同时可以控制可视化属性。场景默认具备旋转，缩放，可以选中某一条目等。
#include <QtWidgets/QApplication>
#include <QtDataVisualization>
using namespace QtDataVisualization;
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
//构造一个三维柱状图对象
Q3DBars bars;
bars.setFlags(bars.flags() ^ Qt::FramelessWindowHint); //top level
//设置坐标轴的显示范围
bars.rowAxis()->setRange(0, 4);
bars.columnAxis()->setRange(0, 4);
//创建5行数据，放入序列，添加到图形
QBar3DSeries *series = new QBar3DSeries;
QBarDataRow *data = new QBarDataRow;
*data << 1.0f << 3.0f << 7.5f << 5.0f << 2.2f;
series->dataProxy()->addRow(data);
bars.addSeries(series);
bars.show();
return a.exec();
}
三维散点图
Q3DScatter实现图形，QScatter3DSeries and QScatterDataProxy实现序列和数据，并控制图表的可视化属性。场景默认具备旋转，缩放，可以选中某一条目等。
#include <QtWidgets/QApplication>
#include <QtDataVisualization>
using namespace QtDataVisualization;
int main(int argc, char **argv)
{
QGuiApplication app(argc, argv);
//创建Q3DScatter三维散点图类对象
Q3DScatter scatter;
scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);
//新建序列和数据，在序列中加入3个点，把序列添加到图形
QScatter3DSeries *series = new QScatter3DSeries;
QScatterDataArray data;
data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f);
series->dataProxy()->addItems(data);
scatter.addSeries(series);
scatter.show();
return app.exec();
}
三维曲面图
Q3DSurface类实现图形，QSurface3DSeries and QSurfaceDataProxy实现序列和数据，并控制可视化属性。同样，具备旋转，缩放和选中数据的基本操作。
#include <QtWidgets/QApplication>
#include <QtDataVisualization>
using namespace QtDataVisualization;
int main(int argc, char **argv)
{
QGuiApplication app(argc, argv);
//创建一个三维曲面对象
Q3DSurface surface;
surface.setFlags(surface.flags() ^ Qt::FramelessWindowHint);
//创建数据对象
QSurfaceDataArray *data = new QSurfaceDataArray;
QSurfaceDataRow *dataRow1 = new QSurfaceDataRow;
QSurfaceDataRow *dataRow2 = new QSurfaceDataRow;
//为数据对象赋值
*dataRow1 << QVector3D(0.0f, 0.1f, 0.5f) << QVector3D(1.0f, 0.5f, 0.5f);
*dataRow2 << QVector3D(0.0f, 1.8f, 1.0f) << QVector3D(1.0f, 1.2f, 1.0f);
*data << dataRow1 << dataRow2;
//创建序列，加入数据，添加到Q3DSurface
QSurface3DSeries *series = new QSurface3DSeries;
series->dataProxy()->resetArray(data);
surface.addSeries(series);
surface.show();
return app.exec();
}
数据管理
序列（Series）拥有一系列被data proxy控制的数据，可以控制可视化渲染属性，比如颜色等。每一个三维图都有它自己对应的series类。实际使用时，用户想要显示的数据通常是很多格式的，直接添加到Series中是不支持的。Qt实现了数据代理data proxies，以使得用户可以用自己熟知的类型定义数据，通过data proxies转化传递。，每一种图形也是有对应的basic proxy类型。比如，QBar3DSeries对应QBarDataProxy，QBarDataProxy中保存有QBarDataItem对象，每一个QBarDataItem对象保存一个单独的bar value。
Q3DBars graph;
QBarDataProxy *newProxy = new QBarDataProxy;
QBarDataArray *dataArray = new QBarDataArray;
dataArray->reserve(10);
for (int i = 0; i < 10; i++) {
QBarDataRow *dataRow = new QBarDataRow(5);
for (int j = 0; j < 5; j++)
(*dataRow)[j].setValue(myData->getValue(i, j));
dataArray->append(dataRow);
}
newProxy->resetArray(dataArray);
graph->addSeries(new QBar3DSeries(newProxy));
上述例子描述了用基本的数据代理实现自定义数据mydata对象的传递。特别的，Series对象一次只能拥有一个proxy。当有新的proxy被设置到Series后，之前的proxy会被删除。但是图表可以同时拥有多条Series，如果你想在两组数据中转换，建议用两个Series会更加有效。
因为三维绘图也是基于Model/View架构，我们当然可以用model管理数据，这也是Qt的常见方式。每个三维图类型也提供了特殊的proxy类以实现Model数据的传递。比如，QItemModelBarDataProxy则可以实现将Model数据于QBar3DSeries关联起来。这些类使用起来很简单，只需要给出Model Item的指针和如何映射到basic proxy就可以。这种映射规则类似于告诉proxy在model item中的哪个值属于哪一行，属于哪一列，哪个值表示了具体的数值等等。通常，item Models只有一种角色，但是包含了映射所需的多个值。这时候将用到item model proxies的模式匹配和自动替换技术。
const VariantDataItemList &itemList = m_dataSet->itemList();
int rowIndex = m_mapping->rowIndex();
int columnIndex = m_mapping->columnIndex();
int valueIndex = m_mapping->valueIndex();
const QStringList &rowList = m_mapping->rowCategories();
const QStringList &columnList = m_mapping->columnCategories();
// Sort values into rows and columns
typedef QHash<QString, float> ColumnValueMap;
QHash <QString, ColumnValueMap> itemValueMap;
foreach (const VariantDataItem *item, itemList) {
itemValueMap[item->at(rowIndex).toString()][item->at(columnIndex).toString()]
= item->at(valueIndex).toReal();
}
例子
最后上一个地形图的三维例子：https://download.csdn.net/download/bjtuwayne/12033065
