RealSkel 项目使用教程

1. 项目介绍

RealSkel 是一个用于实时骨骼化（Skeletonization）的工具，主要用于基于草图的建模（Sketch-based Modeling）。该项目提供了一个可执行软件，允许用户通过简单的草图绘制来创建复杂的3D模型，并实时生成骨骼结构。RealSkel 支持在 Ubuntu 和 Windows 系统上运行，并且依赖于 Qt、OpenCV、Boost 和 Libigl 等库。

2. 项目快速启动

2.1 环境准备

Ubuntu 20.04 LTS

1. 安装 Qt 5.12.2

   • 下载并安装 qt-opensource-linux-x64-5.12.2.run。
   • 运行安装文件并按照提示完成安装。

2. 安装 OpenCV

   sudo apt-get install libopencv-dev
   

3. 安装 Boost

   sudo apt-get install libboost-all-dev
   

Windows 10

1. 安装 Qt 5.12.2

   • 下载并安装 qt-opensource-windows-x86-5.12.2.exe。
   • 选择 MSVC 2017 64-bit 进行安装。

2. 安装 OpenCV

   • 下载 OpenCV 4.2.0 源码。
   • 使用 CMake 配置并生成解决方案，然后在 Visual Studio 中编译并安装。

3. 安装 Boost

   • 下载并安装适合的 Boost 版本（如 boost_1_74_0-msvc-14.2-64.exe 对应 VS2019）。

2.2 编译与运行

Ubuntu 20.04 LTS

mkdir build
cd build
cmake ..
make -j8
./main

Windows 10

1. 使用 VS Code 和 CMake 工具编译源码。
2. 选择构建类型为 Release。
3. 配置 CMake 并等待依赖项下载完成。
4. 编译解决方案，并将 demo_exe 目录中的所有 .dll 文件和 platforms/ 目录复制到 build/Release/ 目录。
5. 运行 main.exe。

3. 应用案例和最佳实践

3.1 创建一个带骨骼的猫模型

1. 打开软件：启动 RealSkel 软件。
2. 分割视图：在左侧窗口（2D 视图）和右侧窗口（3D 视图）之间分割视图。
3. 打开图像：使用 Ctrl+O 打开 demo_exe/image/cat.png。
4. 绘制躯干：在 2D 视图中绘制猫的躯干。
5. 调整轮廓：根据需要调整轮廓。
6. 创建腿部：在前方和后方分别创建对称腿部。
7. 创建其他部分：按下 Space 键切换到草图模式，绘制其他部分（如耳朵）。
8. 优化骨骼：最后，选择关节并按住鼠标左键移动，调整骨骼结构。

3.2 最佳实践

• 使用 VS Code：推荐使用 VS Code 进行开发和调试，以提高效率。
• 依赖库管理：确保所有依赖库正确安装，并根据需要修改 CMakeLists.txt 文件。
• 实时调整：利用软件的实时骨骼化功能，快速调整和优化模型。

4. 典型生态项目

• Libigl：一个轻量级的 C++ 几何处理库，广泛用于计算机图形学和计算几何领域。
• OpenCV：开源计算机视觉库，提供丰富的图像处理和计算机视觉算法。
• Boost：一个高效的 C++ 库集合，提供多种功能模块，如智能指针、多线程等。

通过结合这些生态项目，RealSkel 能够提供强大的功能和灵活的开发环境，适用于各种复杂的3D建模任务。