Interactive All-Hex Meshing 项目教程

Interactive All-Hex Meshing 项目教程

interactive-hex-meshing Source code for "Interactive All-Hex Meshing via Cuboid Decomposition" [SIGGRAPH Asia 2021]. 项目地址: https://gitcode.com/gh_mirrors/in/interactive-hex-meshing

1. 项目的目录结构及介绍

interactive-hex-meshing/
├── assets/
│   └── tutorial/
├── external/
│   ├── geomlib/
│   └── vkoo/
├── hex/
├── CMakeLists.txt
├── LICENSE
├── README.md
└── ...

目录结构介绍

• assets/: 包含项目所需的一些资源文件，如教程文件等。
• external/: 包含项目依赖的外部库，如 geomlib 和 vkoo。
  • geomlib/: 一个独立的 C++ 库，包含基于 GPU 的几何操作。
  • vkoo/: 一个基于 Vulkan 的图形引擎。
• hex/: 包含项目的核心代码，特别是与交互式六面体网格生成相关的代码。
• CMakeLists.txt: 项目的 CMake 构建文件。
• LICENSE: 项目的许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

项目的启动文件是 hex 目录下的 main.cpp 文件。该文件负责初始化项目并启动交互式六面体网格生成流程。

// hex/main.cpp

#include <iostream>
#include "hex/HexMeshingApp.h"

int main(int argc, char** argv) {
    HexMeshingApp app;
    app.run();
    return 0;
}

启动文件介绍

• HexMeshingApp: 这是项目的主要应用程序类，负责管理整个应用程序的生命周期。
• app.run(): 启动应用程序的主循环，开始交互式六面体网格生成过程。

3. 项目的配置文件介绍

项目的配置文件主要是 CMakeLists.txt 文件，该文件定义了项目的构建配置。

# CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(interactive-hex-meshing)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 14)

# 添加子目录
add_subdirectory(external/geomlib)
add_subdirectory(external/vkoo)
add_subdirectory(hex)

# 添加可执行文件
add_executable(hex hex/main.cpp)

# 链接库
target_link_libraries(hex geomlib vkoo)

配置文件介绍

• cmake_minimum_required(VERSION 3.10): 指定所需的 CMake 最低版本。
• project(interactive-hex-meshing): 定义项目名称。
• set(CMAKE_CXX_STANDARD 14): 设置 C++ 标准为 C++14。
• add_subdirectory: 添加子目录，包括 geomlib 和 vkoo。
• add_executable(hex hex/main.cpp): 定义可执行文件 hex，并指定主文件为 hex/main.cpp。
• target_link_libraries(hex geomlib vkoo): 链接 geomlib 和 vkoo 库。

通过以上配置，项目可以正确编译并生成可执行文件 hex，用户可以通过运行该文件启动交互式六面体网格生成过程。

interactive-hex-meshing Source code for "Interactive All-Hex Meshing via Cuboid Decomposition" [SIGGRAPH Asia 2021]. 项目地址: https://gitcode.com/gh_mirrors/in/interactive-hex-meshing