VTK 9.4 + QtQuick6从编译到Demo

已于 2025-05-25 00:54:19 修改
阅读量1.1k 收藏 24
点赞数 25
CC 4.0 BY-SA版权
文章标签： c++ vtk qml 图形渲染
于 2025-05-25 00:33:33 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34524246/article/details/148197748

VTK 9.4 + QtQuick6从编译到Demo

  • 编写这篇博客的主要原因是个人接触到的3D相关开发需求越来越多了，比如在3D Slicer上开发一些简单插件，处理3D数据并显示之类的
  • 其次直接使用OpenGL函数库编写难度又比较大，Slicer的渲染使用了VTK的代码，所以个人也打算进行尝试
  • 个人参加工作后使用的UI技术就是QML，VTK网上看到的示例一般是很旧的Widget，本着学新不学旧的原则，还是坚持使用QML+VTK的方式进行测试开发
  • 博客的测试时间: 2025.05.25

文章目录

一、基础环境安装

1. Visual Studio 2019

https://docs.vtk.org/en/latest/build_instructions/index.html

  • 没错就是2019, 官方的编译指导说的很重，所以个人也没有去测试其他的编译器类型
  • 微软官方似乎有意减少旧版的编译器使用，如果需要安装还是搜索一些大哥的安装器, 这里贴一个: https://zhuanlan.zhihu.com/p/740245143
    在这里插入图片描述

2. Qt6开发环境

  • Qt Online Installer下载地址: https://download.qt.io/official_releases/online_installers/
  • 选择一个比较新的版本(个人是6.7.0)直接全勾上就行了
  • 可以将Tools中的CMake勾上(如果没有的话)
    在这里插入图片描述

二、开始进行库编译

1. VTK源码下载

  • 在官方下载页面: https://vtk.org/download/
  • 下载Source那个压缩包就可以了，这里贴一下gitlab地址: https://gitlab.kitware.com/vtk/vtk，不是很推荐除非遇上了奇怪的问题需要最新的代码解决
    在这里插入图片描述

2. 开始添加CMake编译参数

这里的官方的编译指导就没有什么特别的指导意义了，由社区以及各种帖子给出，这里给出一些简单说明

  • VTK_QT_VERSION: 指定为6否则容易在自动搜索的时候出错
  • VTK_GROUP_ENABLE_Qt: 开源项目Qt-VTK-viewer中看到的，大意是给Qt编译一些接口，以允许访问VTK的数据结构
  • QML的支持在源码的GUISupport/QtQuick中，其中有个vtk.module的文件描述了其依赖关系(没错不是直接通过cmake组织的，所以编译的时候推荐在CLion中进行，只要参数填对后代码提示可以正常显示，那这个参数就是正确的)
    • GUISupportQtQuick模块依赖于GUISupportQt，所以这两个都需要开启
    • 关于开启方法来自于社区的一个编译bug: https://discourse.vtk.org/t/unable-to-build-vtk-9-4-with-qt-6-8/14857/6，个人看了老半天还是感谢前人探路
  • 最后的两个是Qt的开发环境
    • VTK用到了Qt的一些基础事件需要QtCore
    • Qt6QmlTools则是GUISupportQtQuick生成插件使用的工具
set(VTK_QT_VERSION 6)
set(VTK_GROUP_ENABLE_Qt YES)
set(VTK_MODULE_ENABLE_VTK_GUISupportQt YES)
set(VTK_MODULE_ENABLE_VTK_GUISupportQtQuick YES)
set(Qt6_DIR "D:/Development/Envs/QtEnv/6.7.0/msvc2019_64/lib/cmake/Qt6")
set(Qt6QmlTools_DIR "D:/Development/Envs/QtEnv/6.7.0/msvc2019_64/lib/cmake/Qt6QmlTools")

在这里插入图片描述

  • 当Clion能够正常跳转类、函数的时候，说明参数填写正确
    在这里插入图片描述

3. 编译以及安装

  • 编译的话简单点击Build All即可，编译过程比较长只要能通过说明编译成功，如果中间失败的话需要自寻大佬解决
    在这里插入图片描述
  • 这里贴一些安装命令，以方便包管理
cd D:\Development\Envs\PACS-env\Archive\VTK-9.4.2\cmake-build-debug
cmake --install . --prefix=D:\Development\Envs\vtk-9.4.2-debug

在这里插入图片描述
在这里插入图片描述

  • 请注意此文件夹，这是成功的标志
  • 还有就是别忘记把bin目录加入环境变量中

三、从源码中复现Demo

1. 创建基础Quick项目

在这里插入图片描述

  • 一路按下去，无中文路径即可，然后开始添加VTK支持
  • 此修改遵守示例: Examples/GUI/QML/QtQuickChartsOn3DScene/CMakeLists.txt
cmake_minimum_required(VERSION 3.16)
project(01-VTKQtBuildVertify VERSION 0.1 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>")
add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>")

### 添加VTK支持, 模块内容来自Example ########
set(VTK_DIR "D:/Development/Envs/vtk-9.4.2-debug/lib/cmake/vtk-9.4")
find_package(VTK
    COMPONENTS
        CommonCore
        CommonColor
        ChartsCore
        GUISupportQtQuick
        RenderingContextOpenGL2
)
#####################
find_package(Qt6 REQUIRED COMPONENTS Quick)

qt_standard_project_setup()
qt_add_executable(app01-VTKQtBuildVertify
    main.cpp
)

qt_add_qml_module(app01-VTKQtBuildVertify
    URI app01-VTKQtBuildVertify
    VERSION 1.0
    QML_FILES
        Main.qml
)

# Qt for iOS sets MACOSX_BUNDLE_GUI_IDENTIFIER automatically since Qt 6.1.
# If you are developing for iOS or macOS you should consider setting an
# explicit, fixed bundle identifier manually though.
set_target_properties(app01-VTKQtBuildVertify PROPERTIES
#    MACOSX_BUNDLE_GUI_IDENTIFIER com.example.app01-VTKQtBuildVertify
    MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
    MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
    MACOSX_BUNDLE TRUE
    WIN32_EXECUTABLE TRUE
)

target_link_libraries(app01-VTKQtBuildVertify
    PRIVATE Qt6::Quick ${VTK_LIBRARIES}
)
########### VTK模块初始化 ##############
vtk_module_autoinit(
        TARGETS app01-VTKQtBuildVertify
        MODULES ${VTK_LIBRARIES}
)
######################################
include(GNUInstallDirs)
install(TARGETS app01-VTKQtBuildVertify
    BUNDLE DESTINATION .
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

2. 允许QML编辑器对VTK进行代码提示

参考了GUISupport/QtQuick/qml/QQmlVTKPlugin.h

  • 官方说直接添加第二章最后编译出来的QML文件夹到环境变量即可，但个人尝试无效
    在这里插入图片描述
  • 下列是个人成功的方法，将编译出的插件目录直接贴到Qt开发的QML目录即可
    在这里插入图片描述

3. UI部分逻辑

完成2的步骤后，import VTK就不会报错了

  • 注意这个import后面的数字应该是你贴到QtQML组件的文件夹，个人查看里面的qmltypes文件时发现其描述的9.1，倍感迷惑
  • 并且在qmltypes中，qml可以调用的组件只有三个，所以推荐大家直接放弃在QML中直接绘制逻辑的想法，求大佬封装一个牛逼的Quick3D库，或者推荐推荐也行
import QtQuick
import QtQuick.Controls
import VTK 9.4

// M300的可能解决方案: https://forum.qt.io/topic/92025/unknown-component-m300-for-custom-qml-class

Window {
    width: 800
    height: 600
    visible: true
    title: qsTr("Hello World")

    Row{
        Button{
            width: 200
            height: 40
            text: "hhhhhh"
            onClicked: {
                console.log("hhhhhhh")
            }
        }
        Button{
            width: 200
            height: 40
            text: "hhhhhh"
            onClicked: {
                console.log("hhhhhhh")
            }
        }
        Button{
            width: 200
            height: 40
            text: "hhhhhh"
            onClicked: {
                console.log("hhhhhhh")
            }
        }
    }

    VTKRenderWindow{
        id: vtkWindow
        // anchors和width,height一样，无效，即便存在父对象
        // 源码的sync()函数似乎直接设置成了窗口大小
        // anchors.fill: parent
        width: 100
        height: 100
    }

    VTKRenderItem{
        objectName: "ConeView"
        x: 200
        y: 200
        width: 200
        height: 200
        renderWindow: vtkWindow
    }
}

4. main文件部分

#include <QGuiApplication>
#include <QQmlApplicationEngine>

#include "QQuickVTKItem.h"
#include "QQuickVTKRenderItem.h"
#include "vtkPolyDataMapper.h"
#include "vtkConeSource.h"

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickVTKItem::setGraphicsApi();

    // 等价于使用环境变量QML2_IMPORT_PATH
    // https://doc.qt.io/qt-5/qtqml-syntax-imports.html#qml-import-path
    QQmlApplicationEngine engine;
    // engine.addImportPath("D:/Development/Envs/vtk-9.4.2-debug/lib/qml/VTK.9.4");
    // qDebug() << "Import Path List: "
    //          << engine.importPathList();

    // load ui
    const QUrl url(QStringLiteral("qrc:/app01-VTKQtBuildVertify/Main.qml"));
    QObject::connect(
        &engine,
        &QQmlApplicationEngine::objectCreationFailed,
        &app,
        []() { QCoreApplication::exit(-1); },
        Qt::QueuedConnection);
    engine.load(url);

    // Fetch the QQuick window using the standard object name set up in the constructor
    QObject* topLevel = engine.rootObjects().value(0);
    QQuickVTKRenderItem* qquickvtkItem = topLevel->findChild<QQuickVTKRenderItem*>("ConeView");

    // Create a cone pipeline and add it to the view
    vtkNew<vtkActor> actor;
    vtkNew<vtkPolyDataMapper> mapper;
    vtkNew<vtkConeSource> cone;
    mapper->SetInputConnection(cone->GetOutputPort());
    actor->SetMapper(mapper);
    qquickvtkItem->renderer()->AddActor(actor);
    qquickvtkItem->renderer()->ResetCamera();
    qquickvtkItem->renderer()->SetBackground(0.5, 0.5, 0.7);
    qquickvtkItem->renderer()->SetBackground2(0.7, 0.7, 0.7);
    qquickvtkItem->renderer()->SetGradientBackground(true);
    qquickvtkItem->update();

    return app.exec();
}

5. 最后效果

3,4的实现参考了源码的GUISupport/QtQuick/QQuickVTKRenderWindow.h中的注释

在这里插入图片描述

  • 虽然成功完成了一个Demo的制作和显示，但确实又诸多不足
  • 如果大家跟着做后会发现，QQuickVTKRenderWindow，QQmlVTKPlugin均已经被标记了遗弃标签，并且现在的代码是直接在事件循环前添加的，也就是运行期间无法修改
  • 所以本博客将这次试错定义为一个测试模块是否正确编译的Demo
  • 正常开发的话，还是得看看社区大佬的实现，否则过于玩具了

四、没有解决的问题

在试错过程中发现的一些恶性问题，如果有大神，评论区指点下

1. QQuickVTKRenderWindow

  • 无法正确调整组件大小，会直接覆盖整个界面
    • 源码中的sync()函数似乎直接将整个窗体作为了绘制对象
  • 然后有种Qt绘制到了VTK上，而不是VTK被QML的容器接管的奇妙现象

在这里插入图片描述

2. QML编辑器M300问题

  • 没有尝试过纯QQuickItem的发布方式，个人只能保证导入VTK的时候以及运行的时候不报错，不知道大神有没有解决方案

参考

  • https://discourse.vtk.org/t/qml-vtkrenderwindow-inside-a-rectangle/11850
  • https://github.com/martijnkoopman/Qt-VTK-viewer/blob/master/doc/Build-VTK.md
  • https://discourse.vtk.org/t/unable-to-build-vtk-9-4-with-qt-6-8/14857/6
  • https://forum.qt.io/topic/92025/unknown-component-m300-for-custom-qml-class
VTK编程指南＜二＞：VTK9.3.1+VS2019+Qt5.15.2编译及环境配置
欧特GO
11-25 972
VTK编程指南＜二＞：VTK9.3.1+VS2019+Qt5.15.2编译及环境配置
QVTKDemo-master.zip
10-25
vtk和qt的例子包含了二三維,使用的了vtk的各种技术，自己安装vtk，配置环境直接编译
（1）VTK环境配置
mahuifa的博客
04-13 1223
ubuntu、windows中VTK编译配置和在vscode、qt中使用cmake、qmake加载使用VTK。
F3D项目对VTK 9.4图形渲染库的兼容性升级
最新发布
gitblog_07354的博客
06-14 285
F3D项目对VTK 9.4图形渲染库的兼容性升级 在计算机图形学领域，可视化工具包(VTK)是一个广泛使用的开源系统，用于3D计算机图形、图像处理和可视化。近期VTK发布了9.4版本，引入了一项重要的底层架构变更：将OpenGL加载器从GLEW切换到了Glad。这一变更对依赖VTK的项目产生了影响，特别是F3D这样的3D模型查看器项目。 技术背景 OpenGL作为跨平台的图形API，需要特定的加载...
QT Creator(MSVC2022)从源码编译和使用VTK 9.4.2
TeAmo
06-05 2418
非常详细的QT Creator从源码编译和使用VTK 9.3.0，仅限MinGW64.
QML加载VTK窗口
weixin_43248755的博客
08-14 1564
qml 中 渲染 VTK
win11下的VS2022+QT6+VTK9.2+PCL1.13.1联合开发环境配置及踩坑记录
mjmald的博客
10-14 6669
PCL学习笔记
VTK 在 Qt 下的编译
Neverland_LY‘s Domain
10-07 1605
· 前言 本文转自 天狐9102-win10环境下VTK7.1的编译和Qt调用VTK的详细教程二（VS2013编译支持Qt的VTK库）。该作者的 win10环境下VTK7.1的编译和Qt调用VTK的详细教程（本文链接含VTK库和测试代码的分享）也值得一看。 编译 Qt 的 VTK 库，是个需要耐心的事情，希望大家看完后能有所收获。 · 用到的软件 VS 2013 Qt (qt-ope...
QVTK demo
weixin_37603532的博客
03-01 174
QVTK demo
VTK应用示例之VTK与Qt整合的示例
03-13
http://blog.csdn.net/www_doling_net/article/details/8668870这篇博文的完整示例以及完整的文档。
VTK与QT源码编译和示例
weixin_41202834的博客
05-28 1388
一：介绍VTK：是一个用于三维计算机图形学、图像处理、数据可视化和科学可视化的开源软件库。VTK提供了丰富的基础算法和数据结构，包括点、线、多边形、二维和三维图像、体绘制等，以及许多高级算法，例如曲面重建、流体力学模拟、拟合和插值、图像分割和成像处理等。QT：提供了一套完整的库，包括GUI、网络、数据库、XML、蓝牙、多媒体、OpenGL等，可以用来编写桌面、移动设备、嵌入式及实时应用程序。Qt的...
探索3D可视化艺术：QVTKDemo项目深度剖析
gitblog_00084的博客
06-13 400
探索3D可视化艺术：QVTKDemo项目深度剖析 在数据可视化与科学计算的广阔天地里，QVTKDemo如同一盏明灯，照亮了工程师和科学家们探索复杂数据结构的道路。作为一款基于VTK-Qt绑定开发的开源项目，它不仅展示了强大的视觉特效，还完美地融合了Qt界面的便利性，为用户提供了直观且功能丰富的3D可视化工具包。 项目介绍 QVTKDemo以简洁而高效的方式，向我们展示了一系列VTK的核心功能和高级...
编译好的VTK+Qt5可视化库（VTK9.0）
05-08
编译好的Vtk9.0三维可视化库，c++版本，是与QT5 绑定的，可以直接使用，包括debug版本的库和release版本的库。
VTK8.0.0库 vs2015 x64编译版 支持QT5
06-20
PCL1.8.1 AllinOne中集成的VTK库存在一些问题，导致在QT5环境下编译工程失败。压缩文件中包含了vs2015 x64环境下的VTK替换文件。用于替换3rdParty\VTK，也可用于其它需要vtk项目。具体可参考https://blog.csdn.net/jepco1/article/details/80752954
VTK 9.4 + QML 集成Demo
05-25
如果需要更详细的指导，可以参考提供的文章链接，该文章详细记录了从VTK与Qt集成环境的搭建到Demo实现的每一步细节，让开发者能够按图索骥，快速实现自己的可视化项目。 无论如何，VTK与QML的集成给开发者提供了更...
使用VTK、QT6和VS2019编译的详细指南
EknOcaml的博客
09-17 497
以下是一步一步的详细说明，以帮助您成功地设置和编译您的项目。您已经成功地使用VTK、QT6和VS2019编译并运行了一个简单的示例项目。您可以根据您的需求修改和扩展此示例，以创建更复杂的可视化应用程序。现在，我们将编写一个简单的示例代码，以演示VTK和QT6的集成。在此步骤中，我们将编写和构建一个示例项目，以演示VTK和QT6的集成。最后，我们将构建和运行项目以验证我们的设置是否正确。在此步骤中，我们将配置VTK以与QT6一起使用。在本步骤中，我们将配置QT6以与VTK一起使用。步骤4：编写和构建项目。
基于VTK的Qt应用程序开发
热门推荐
东灵工作室
03-13 4万+
VTK附带的程序示例中大多是基于控制台的，作为可视化开发工具包，VTK也可以与很多流行的GUI开发工具整合，比如MFC、Qt(题外话：Qt已经被Digia从诺基亚手中收购了，Qt现在的链接是：http://qt-project.org/，也有已经编译好的版本：http://code.google.com/p/qt-msvc-installer/downloads/list直接下载安装。可能因为大学
VTK之基于Qt的VTK应用程序
阿兵-AI医疗的专栏
07-16 1万+
　　友好的用户图形界面是应用程序必须的因素之一，对于VTK应用程序也是如此。VTK附带的程序示例大多数是基于控制台的，但是VTK也可以与很多流行的GUI开发工具整合。本文介绍如何把VTK（7.1.0）和GUI开发工具Qt(5.x)进行整合。 VTK之基于Qt的VTK应用程序 　　Qt是跨平台的GUI开发工具，VTK也提供了大量的类支持Qt。VTK工程是用CMake进行管理的，而Qt自身有qma...
VTK+Qt Demo2：vtklight测试出现的问题
qq_42103801的博客
02-07 232
qvtkwidgetsapplication1.h #pragma once #include <QtWidgets/QWidget> #include "ui_qvtkwidgetsapplication1.h" #include "vtkSmartPointer.h" #include "vtkCylinderSource.h" #include "vtkPolyDataMapper.h" #include "vtkActor.h" #include "vtkLight.h" #incl
vs2022+vtk9.1+qt6编译部署
06-14
VS2022、VTK9.1 和 QT6 是目前最新版本的集成开发环境、可视化工具库和跨平台应用程序框架。在编写软件时，它们提供了很多丰富和强大的功能，可以让开发者更快地完成工作。 编译 VS2022、VTK9.1 和 QT6 的过程并不复杂，但也需要仔细地遵循一些步骤和规则。首先，我们需要确保自己的电脑上已经安装了这三个软件，最好都是最新的版本。然后，我们需要打开 VS2022 编辑器，引入 VTK9.1 和 QT6 的相关文件并进行设置。这里需要特别注意各个库的版本和依赖关系，不同版本之间可能会存在不兼容的问题。 接下来就是编写代码和调试程序的过程了。在使用 VTK9.1 和 QT6 的时候，我们可以利用其提供的丰富的功能和组件来实现我们的需求。例如，VTK可以用来进行可视化处理和渲染，而QT则提供了图形界面的开发和设计工具。 最后，在完成程序的开发和测试之后，我们还需要对代码进行打包和部署。这个过程可以用 VS2022 中提供的工具和插件来完成。打包和部署的目的是将程序打包成一个可执行文件，方便用户下载和安装，而不需要再安装各种依赖库和组件。 总的来说，使用 VS2022、VTK9.1 和 QT6 可以让开发者更快速、方便地实现自己的代码和项目。同时，编译部署也可以通过一些简单的步骤和工具轻松完成。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

tacom_

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值