libWetCloth 开源项目使用教程

1. 项目目录结构及介绍

libWetCloth 是一个用于物理模拟液体和湿布或纱线的开源项目。项目的目录结构如下：

libwetcloth
│
└───assets: 定义场景的文件
│   │
│   └───buoyancy_tests: 测试浮力效果的场景
│   │
│   └───drag_tests: 测试不同阻力模型的场景
│   │
│   └───general_examples: 论文中使用的演示场景
│   │
│   └───parameter_tests: 测试各种液体材料和纱线设置的场景
│   │
│   └───ring_tests: 论文中使用的环形测试场景
│   │
│   └───unit_tests: 测试动力学和碰撞的简单场景（包括干纱线和布料）
│
└───cmake: CMake 文件，用于查找包
│
└───houdini: Houdini 场景，用于生成论文中的渲染图
│
└───include: 第三方库（如 Eigen、libIGL 等）
│
└───libWetCloth
│   │
│   └───App: 用户界面，用于与模拟交互
│   │
│   └───Core: 实际的模拟代码
│   │
│   └───DER: 离散弹性杆的代码（用于纱线和头发）
│   │   │
│   │   └───Dependencies: 计算离散弹性杆模型中使用的几何信息
│   │
│   └───ThinShell: 离散弹性薄壳的代码（用于三角形布料）
│   │   │
│   │   └───Forces: 计算拉伸和弯曲力及其雅可比矩阵
│   │
│   └───PCGSolver: 带有 MIC 预处理器的 PCG 求解器

2. 项目启动文件介绍

项目的启动文件位于 libWetCloth/App 目录下，主要文件是 WetClothApp。该文件是一个用户界面程序，允许用户通过命令行参数指定要加载的场景，并进行交互式模拟。

启动 WetClothApp 的命令示例如下：

./WetClothApp -s /path/to/scene_file.xml

其中 -s 参数用于指定要加载的场景文件。

3. 项目配置文件介绍

项目的配置文件主要通过 CMake 进行管理。在 libWetCloth 目录下，主要的配置文件是 CMakeLists.txt。该文件定义了项目的构建配置，包括依赖库的查找路径、编译选项等。

在 Windows 平台上，还可以使用 CMake-GUI 进行配置。配置过程中需要指定第三方库的路径，例如：

set(ANT_TWEAK_BAR_INCLUDE_DIR <libwetcloth_thirdparty_win64>/include/AntTweakBar)
set(ANT_TWEAK_BAR_LIBRARY <libwetcloth_thirdparty_win64>/lib/AntTweakBar64.lib)

配置完成后，生成 Visual Studio 解决方案并编译项目。

---

以上是 libWetCloth 开源项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你顺利使用该项目。