Qt Vulkan 项目教程

Qt Vulkan 项目教程

1. 项目目录结构及介绍

qtvulkan/
├── CMakeLists.txt
├── README.md
├── src/
│   ├── main.cpp
│   ├── VulkanWindow.cpp
│   ├── VulkanWindow.h
│   ├── VulkanRenderer.cpp
│   ├── VulkanRenderer.h
│   └── resources/
│       ├── shader.vert
│       └── shader.frag
└── include/
    └── qtvulkan/
        ├── qtvulkan.h
        └── qtvulkan_global.h

目录结构介绍

• CMakeLists.txt: 项目的 CMake 构建文件，用于配置项目的构建过程。
• README.md: 项目的说明文件，包含项目的概述、安装和使用说明。
• src/: 源代码目录，包含项目的所有源文件。
  • main.cpp: 项目的启动文件，包含应用程序的入口点。
  • VulkanWindow.cpp 和 VulkanWindow.h: 实现 QVulkanWindow 子类的文件，负责管理 Vulkan 窗口。
  • VulkanRenderer.cpp 和 VulkanRenderer.h: 实现 QVulkanWindowRenderer 子类的文件，负责 Vulkan 渲染器的初始化和渲染逻辑。
  • resources/: 资源目录，包含项目的着色器文件。
    • shader.vert: 顶点着色器文件。
    • shader.frag: 片段着色器文件。
• include/: 头文件目录，包含项目的公共头文件。
  • qtvulkan/: 包含项目的公共头文件。
    • qtvulkan.h: 项目的公共头文件。
    • qtvulkan_global.h: 项目的全局头文件。

2. 项目的启动文件介绍

main.cpp

main.cpp 是项目的启动文件，包含应用程序的入口点。以下是 main.cpp 的主要内容：

#include <QGuiApplication>
#include <QVulkanInstance>
#include "VulkanWindow.h"

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

    QVulkanInstance inst;
    inst.setLayers({ "VK_LAYER_KHRONOS_validation" });

    if (!inst.create())
        qFatal("Failed to create Vulkan instance: %d", inst.errorCode());

    VulkanWindow window;
    window.setVulkanInstance(&inst);
    window.resize(1024, 768);
    window.show();

    return app.exec();
}

启动文件介绍

• QGuiApplication: 创建 Qt 应用程序对象，管理应用程序的事件循环。
• QVulkanInstance: 创建 Vulkan 实例对象，并启用验证层。
• VulkanWindow: 创建 VulkanWindow 对象，并将其与 Vulkan 实例关联。
• window.show(): 显示窗口，启动渲染循环。

3. 项目的配置文件介绍

CMakeLists.txt

CMakeLists.txt 是项目的 CMake 构建文件，用于配置项目的构建过程。以下是 CMakeLists.txt 的主要内容：

cmake_minimum_required(VERSION 3.10)
project(QtVulkan)

set(CMAKE_CXX_STANDARD 17)

find_package(Qt6 REQUIRED COMPONENTS Gui)

add_executable(QtVulkan
    src/main.cpp
    src/VulkanWindow.cpp
    src/VulkanRenderer.cpp
)

target_include_directories(QtVulkan PRIVATE include)

target_link_libraries(QtVulkan PRIVATE Qt6::Gui)

配置文件介绍

• cmake_minimum_required: 设置 CMake 的最低版本要求。
• project: 定义项目名称。
• set(CMAKE_CXX_STANDARD 17): 设置 C++ 标准为 C++17。
• find_package(Qt6 REQUIRED COMPONENTS Gui): 查找并加载 Qt6 的 GUI 模块。
• add_executable: 定义可执行文件，并指定源文件。
• target_include_directories: 指定头文件的包含目录。
• target_link_libraries: 链接 Qt6 的 GUI 库。

通过以上配置，项目可以正确编译并运行，使用 Vulkan API 进行渲染。