VTK开发笔记（二）：Qt5.9.3+VS2017x64+VTK8.2创建兼容dll和嵌入源码窗口两种方式的Qt嵌入VTK8.2模板Demo

前言

前面编译好了Qt5.9.3+VS2017x64+VTK8.2的开发环境，但是Qt结合VTK没有。

本篇Qt融合VTK，搭建基础Qt界面搭载VTK显示引擎的模板Demo。

Demo

QVTKWidget

QVTKWidget+MyVTKWidget

注意

这是上一篇install的结果：

建立模板工程（QVTKWidget.dll方式）

步骤一：建立vtkDemo工程

略

步骤二：模块化

文件夹modules，老规矩：

建立模块文件夹：

建立vtkWIdget.pri

工程包含pri：

建立VTKWidget界面类，方便提升：

步骤三：引入vtk的库和开发环境

先把install复制过来，标记好qt和msvc版本，为了以后多版本vtk预留（能就别少，作为代码模块集合）：

添加进pri：

直接从文件夹复制进入pri，会是路径，再修改：

INCLUDEPATH += $$PWD
DEPENDPATH += $$PWD


HEADERS += \
    $$PWD/VTKWidget.h SOURCES += \ $$PWD/VTKWidget.cpp FORMS += \ $$PWD/VTKWidget.ui # vtk库包含 INCLUDEPATH += $$PWD/vtk-8.2.0-msvc2015x64-install/include \ $$PWD/vtk-8.2.0-msvc2015x64-install/include/vtk-8.2 LIBS += -L$$PWD/vtk-8.2.0-msvc2015x64-install/lib LIBS += -lvtkzlib-8.2 \ -lvtkChartsCore-8.2 \ -lvtkCommonColor-8.2 \ -lvtkCommonComputationalGeometry-8.2 \ -lvtkCommonCore-8.2 \ -lvtkCommonDataModel-8.2 \ -lvtkCommonExecutionModel-8.2 \ -lvtkCommonMath-8.2 \ -lvtkCommonMisc-8.2 \ -lvtkCommonSystem-8.2 \ -lvtkCommonTransforms-8.2 \ -lvtkDICOMParser-8.2 \ -lvtkDomainsChemistry-8.2 \ -lvtkDomainsChemistryOpenGL2-8.2 \ -lvtkdoubleconversion-8.2 \ -lvtkexodusII-8.2 \ -lvtkexpat-8.2 \ -lvtkFiltersAMR-8.2 \ -lvtkFiltersCore-8.2 \ -lvtkFiltersExtraction-8.2 \ -lvtkFiltersFlowPaths-8.2 \ -lvtkFiltersGeneral-8.2 \ -lvtkFiltersGeneric-8.2 \ -lvtkFiltersGeometry-8.2 \ -lvtkFiltersHybrid-8.2 \ -lvtkFiltersHyperTree-8.2 \ -lvtkFiltersImaging-8.2 \ -lvtkFiltersModeling-8.2 \ -lvtkFiltersParallel-8.2 \ -lvtkFiltersParallelImaging-8.2 \ -lvtkFiltersPoints-8.2 \ -lvtkFiltersProgrammable-8.2 \ -lvtkFiltersSelection-8.2 \ -lvtkFiltersSMP-8.2 \ -lvtkFiltersSources-8.2 \ -lvtkFiltersStatistics-8.2 \ -lvtkFiltersTexture-8.2 \ -lvtkFiltersTopology-8.2 \ -lvtkFiltersVerdict-8.2 \ -lvtkfreetype-8.2 \ -lvtkGeovisCore-8.2 \ -lvtkgl2ps-8.2 \ -lvtkglew-8.2 \ -lvtkGUISupportQt-8.2 \ -lvtkGUISupportQtSQL-8.2 \ -lvtkhdf5_hl-8.2 \ -lvtkhdf5-8.2 \ -lvtkImagingColor-8.2 \ -lvtkImagingCore-8.2 \ -lvtkImagingFourier-8.2 \ -lvtkImagingGeneral-8.2 \ -lvtkImagingHybrid-8.2 \ -lvtkImagingMath-8.2 \ -lvtkImagingMorphological-8.2 \ -lvtkImagingSources-8.2 \ -lvtkImagingStatistics-8.2 \ -lvtkImagingStencil-8.2 \ -lvtkInfovisCore-8.2 \ -lvtkInfovisLayout-8.2 \ -lvtkInteractionImage-8.2 \ -lvtkInteractionStyle-8.2 \ -lvtkInteractionWidgets-8.2 \ -lvtkIOAMR-8.2 \ -lvtkIOAsynchronous-8.2 \ -lvtkIOCityGML-8.2 \ -lvtkIOCore-8.2 \ -lvtkIOEnSight-8.2 \ -lvtkIOExodus-8.2 \ -lvtkIOExport-8.2 \ -lvtkIOExportOpenGL2-8.2 \ -lvtkIOExportPDF-8.2 \ -lvtkIOGeometry-8.2 \ -lvtkIOImage-8.2 \ -lvtkIOImport-8.2 \ -lvtkIOInfovis-8.2 \ -lvtkIOLegacy-8.2 \ -lvtkIOLSDyna-8.2 \ -lvtkIOMINC-8.2 \ -lvtkIOMovie-8.2 \ -lvtkIONetCDF-8.2 \ -lvtkIOParallel-8.2 \ -lvtkIOParallelXML-8.2 \ -lvtkIOPLY-8.2 \ -lvtkIOSegY-8.2 \ -lvtkIOSQL-8.2 \ -lvtkIOTecplotTable-8.2 \ -lvtkIOVeraOut-8.2 \ -lvtkIOVideo-8.2 \ -lvtkIOXML-8.2 \ -lvtkIOXMLParser-8.2 \ -lvtkjpeg-8.2 \ -lvtkjsoncpp-8.2 \ -lvtklibharu-8.2 \ -lvtklibxml2-8.2 \ -lvtkLocalExample-8.2 \ -lvtklz4-8.2 \ -lvtklzma-8.2 \ -lvtkmetaio-8.2 \ -lvtkNetCDF-8.2 \ -lvtkogg-8.2 \ -lvtkParallelCore-8.2 \ -lvtkpng-8.2 \ -lvtkproj-8.2 \ -lvtkpugixml-8.2 \ -lvtkRenderingAnnotation-8.2 \ -lvtkRenderingContext2D-8.2 \ -lvtkRenderingContextOpenGL2-8.2 \ -lvtkRenderingCore-8.2 \ -lvtkRenderingFreeType-8.2 \ -lvtkRenderingGL2PSOpenGL2-8.2 \ -lvtkRenderingImage-8.2 \ -lvtkRenderingLabel-8.2 \ -lvtkRenderingLOD-8.2 \ -lvtkRenderingOpenGL2-8.2 \ -lvtkRenderingQt-8.2 \ -lvtkRenderingVolume-8.2 \ -lvtkRenderingVolumeOpenGL2-8.2 \ -lvtksqlite-8.2 \ -lvtksys-8.2 \ -lvtktheora-8.2 \ -lvtktiff-8.2 \ -lvtkverdict-8.2 \ -lvtkViewsContext2D-8.2 \ -lvtkViewsCore-8.2 \ -lvtkViewsGeovis-8.2 \ -lvtkViewsInfovis-8.2 \ -lvtkViewsQt-8.2 # win平台的复制dll win32{ # copy vtk bin src_file = $$PWD/vtk-8.2.0-msvc2015x64-install/bin/* dst_file = $$OUT_PWD target_file = $$DESTDIR src_file ~= s,/,\\,g dst_file ~= s,/,\\,g target_file ~= s,/,\\,g system(xcopy $$src_file $$dst_file /y /s/q/e) system(xcopy $$src_file $$target_file /y /s/q/e) } 

至此，运行环境引入好了。

步骤四：vkt引擎融入Qt界面

这里我们是直接通过QVTKWidget.h头文件和其lib、dll的方式引入：

建立模板工程（MyVTKWidget.cpp方式）

为了最大化兼容代码，这里QVTKWidget.dll就不动了，QVTKWidget源码里面实际是跟osgWidget一样，映射了窗口对于渲染器的操作，这里我们可以直接拿过来改个名字即可，所以先找到QVTKWidget.h和QVTKWIdget.cpp的源码，改成MyVTKWidget.h，MyVTKWidget.cpp：

复制改名：

加入源码：

修改里面的类名为MyVTKWidget，注意修改头文件宏：

编译通过，修改加入之后，出现一些错误：

这是因为代码默认定义了宏是导出dll的，所以需要修改，先去掉类的导出dll宏，然后编译，出错如下：

检查：

点开查看：

是因为这个类在这个库里面压根没有导出来cpp。

现在直接反过来去添加导出，修改源码（测试加头文件定义宏也报错，直接加入导出的代码吧）：

然后重新编译：

安装并将库引过去替换试一试：

再次编译，解决了库定义的问题，还剩一个问题：

还是往回退到VS2017去搜索，搜索不到，这就是windows的函数，连接到对应的库就好了：

编译成功，运行失败：

怀疑是没包含dll，下面直接exe进行探测：

先补完qt的库：

然后点击运行：

是因为更新了这个lib，但是没有更新对应的dll过来：

Ok了，运行起来了，使用修改 源码大法可以 搞定，这样以后做其他的对映射操作就很方便了：

运行起来一个黑色一个白色：

去掉父类，测试左侧这种就是白色的。

为了确保可靠性，咱们还需要确认下，黑色和白色是否都是正常的，黑色肯定是正常的，写个常规代码：

跑起来后：

怀疑是哪个地方没有跑，导致初始化没有黑色，但是有场景的时候不影响。

建立模板工程（MyVTKWidget.cpp方式，失败，仅供参考）

为了最大化兼容代码，这里QVTKWidget.dll就不动了，QVTKWidget源码里面实际是跟osgWidget一样，映射了窗口对于渲染器的操作，这里我们可以直接拿过来改个名字即可，所以先找到QVTKWidget.h和QVTKWIdget.cpp的源码，改成MyVTKWidget.h，MyVTKWidget.cpp：

复制改名：

加入源码：

修改里面的类名为MyVTKWidget，注意修改头文件宏：

编译通过，修改加入之后，出现一些错误：

这是因为代码默认定义了宏是导出dll的，所以需要修改，先去掉类的导出dll宏，然后编译，出错如下：

检查是需要包含win：

继续编译：

#error: "No Target Architecture"

直接返回vs2017编译源码，查找编译的时候定义了哪些宏：

WIN32
_WINDOWS
NDEBUG
QT_NO_DEBUG
_CRT_SECURE_NO_DEPRECATE
_CRT_NONSTDC_NO_DEPRECATE
_CRT_SECURE_NO_WARNINGS
_SCL_SECURE_NO_DEPRECATE
_SCL_SECURE_NO_WARNINGS
VTK_IN_VTK
QT_WIDGETS_LIB
QT_GUI_LIB
QT_CORE_LIB
QT_UIPLUGIN_LIB
CMAKE_INTDIR="Release"
QVTKWidgetPlugin_EXPORTS

此方式行不通！！！

换个方式，退回去

注意

对比下osg和vtk的库大小：

源码

VTKWidget.h

#ifndef VTKWIDGET_H
#define VTKWIDGET_H #include <QWidget> #include "QVTKWidget.h" #include "MyVTKWidget.h" #include "vtkSphereSource.h" #include "vtkPolyDataMapper.h" #include "vtkActor.h" #include "vtkProperty.h" #include "vtkRenderer.h" #include "vtkRenderWindow.h" #include "vtkInteractorStyleTrackballCamera.h" #include "vtkOutputWindow.h" #include "vtkAutoInit.h" //VTK_MODULE_INIT(vtkRenderingOpenGL); VTK_MODULE_INIT(vtkRenderingOpenGL2); VTK_MODULE_INIT(vtkInteractionStyle); namespace Ui { class VTKWidget; } class VTKWidget : public QWidget { Q_OBJECT public: explicit VTKWidget(QWidget *parent = 0); ~VTKWidget(); protected: void initControl(); protected: void createSphere(QVTKWidget *pVTKWidget); // 临时代码，忽略代码规则 void createSphere(MyVTKWidget *pVTKWidget); // 临时代码，忽略代码规则 protected: void resizeEvent(QResizeEvent *event); private: Ui::VTKWidget *ui; private: QVTKWidget *_pQVTKWidget; MyVTKWidget *_pMyVTKWidget; }; #endif // VTKWIDGET_H 

VTKWidget.cpp

#include "VTKWidget.h"
#include "ui_VTKWidget.h" #include <QDebug> #include <QDateTime> //#define LOG qDebug()<<__FILE__<<__LINE__ //#define LOG qDebug()<<__FILE__<<__LINE__<<__FUNCTION__ //#define LOG qDebug()<<__FILE__<<__LINE__<<QThread()::currentThread() //#define LOG qDebug()<<__FILE__<<__LINE__<<QDateTime::currentDateTime().toString("yyyy-MM-dd") #define LOG qDebug()<<__FILE__<<__LINE__<<QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss:zzz") // QtCreator在msvc下设置编码也或有一些乱码，直接一刀切,避免繁琐的设置 #define MSVC #ifdef MSVC #define QSTRING(s) QString::fromLocal8Bit(s) #else #define QSTRING(s) QString(s) #endif VTKWidget::VTKWidget(QWidget *parent) : QWidget(parent), ui(new Ui::VTKWidget), _pQVTKWidget(0), _pMyVTKWidget(0) { ui->setupUi(this); initControl(); } VTKWidget::~VTKWidget() { delete ui; } void VTKWidget::initControl() { // 下面二选一，注意：这里必须在new之前设置好，new QVTKWidget窗口之后是无效的 vtkOutputWindow::GlobalWarningDisplayOff(); // 两段代码效果应该一致 vtkOutputWindow::SetGlobalWarningDisplay(0); // 设置消息登记显示，0-都不显示 _pQVTKWidget = new QVTKWidget(this); createSphere(_pQVTKWidget); _pMyVTKWidget = new MyVTKWidget(this); createSphere(_pMyVTKWidget); } void VTKWidget::createSphere(QVTKWidget *pVTKWidget) { // 1. 创建球体数据 vtkSphereSource* sphere = vtkSphereSource::New(); sphere->SetRadius(1.0); // 球体半径 sphere->SetThetaResolution(30); // 纬线方向分辨率 sphere->SetPhiResolution(30); // 经线方向分辨率 // 2. 创建映射器（连接数据与渲染） vtkPolyDataMapper* mapper = vtkPolyDataMapper::New(); mapper->SetInputConnection(sphere->GetOutputPort()); // 3. 创建演员（设置显示属性） vtkActor* actor = vtkActor::New(); actor->SetMapper(mapper); actor->GetProperty()->SetColor(0.3, 0.6, 0.9); // 蓝色球体 // 4. 创建渲染器并添加球体 vtkRenderer* renderer = vtkRenderer::New(); renderer->AddActor(actor); renderer->SetBackground(0.1, 0.1, 0.1); // 深灰色背景 // 5. 关联到QVTKWidget的渲染窗口 pVTKWidget->GetRenderWindow()->AddRenderer(renderer); // 6. 设置交互（支持鼠标旋转、缩放） vtkRenderWindowInteractor* interactor = vtkRenderWindowInteractor::New(); interactor->SetRenderWindow(pVTKWidget->GetRenderWindow()); interactor->SetInteractorStyle(vtkInteractorStyleTrackballCamera::New()); interactor->Initialize(); } void VTKWidget::createSphere(MyVTKWidget *pVTKWidget) { // 1. 创建球体数据 vtkSphereSource* sphere = vtkSphereSource::New(); sphere->SetRadius(1.0); // 球体半径 sphere->SetThetaResolution(30); // 纬线方向分辨率 sphere->SetPhiResolution(30); // 经线方向分辨率 // 2. 创建映射器（连接数据与渲染） vtkPolyDataMapper* mapper = vtkPolyDataMapper::New(); mapper->SetInputConnection(sphere->GetOutputPort()); // 3. 创建演员（设置显示属性） vtkActor* actor = vtkActor::New(); actor->SetMapper(mapper); actor->GetProperty()->SetColor(0.3, 0.6, 0.9); // 蓝色球体 // 4. 创建渲染器并添加球体 vtkRenderer* renderer = vtkRenderer::New(); renderer->AddActor(actor); renderer->SetBackground(0.1, 0.1, 0.1); // 深灰色背景 // 5. 关联到QVTKWidget的渲染窗口 pVTKWidget->GetRenderWindow()->AddRenderer(renderer); // 6. 设置交互（支持鼠标旋转、缩放） vtkRenderWindowInteractor* interactor = vtkRenderWindowInteractor::New(); interactor->SetRenderWindow(pVTKWidget->GetRenderWindow()); interactor->SetInteractorStyle(vtkInteractorStyleTrackballCamera::New()); interactor->Initialize(); } void VTKWidget::resizeEvent(QResizeEvent *event) { if(_pQVTKWidget) { _pQVTKWidget->setGeometry(rect().x(), rect().y(), rect().width() / 2 - 10, rect().height()); } if(_pMyVTKWidget) { _pMyVTKWidget->setGeometry(rect().width() / 2 + 10, rect().y(), rect().width() / 2 - 10, rect().height()); } } 

工程模板v1.0.0

入坑

入坑一：运行渲染窗口弹出8.1remove

问题

出错点击关闭，提示截图图下：

尝试

添加头文件

初始化

然后结果：

调试窗口还是存在，关闭或者设置等级0，即可消息窗口输出即可。

解决

头文件

#include "vtkAutoInit.h"

初始化

VTK_MODULE_INIT(vtkRenderingOpenGL2);
VTK_MODULE_INIT(vtkInteractionStyle); 

添加关闭打印信息输出或者设置输出等级

// 下面二选一，注意：这里必须在new之前设置好，new QVTKWidget窗口之后是无效的
vtkOutputWindow::GlobalWarningDisplayOff(); // 两段代码效果应该一致 vtkOutputWindow::SetGlobalWarningDisplay(0); // 设置消息登记显示，0-都不显示