libigl 开源项目简介与安装教程

libigl 开源项目简介与安装教程

libiglSimple MPL-2.0-licensed C++ geometry processing library.项目地址:https://gitcode.com/gh_mirrors/li/libigl

Libigl 是一个用于几何处理的简洁C++库，提供多种功能，包括离散微分几何算子构造、有限元矩阵等。本教程将指导你了解该项目的目录结构、启动文件以及配置文件。

1. 项目目录结构及介绍

在解压或克隆的libigl仓库中，主要目录和文件如下：

• libigl/include: 库的核心头文件，包含了所有libigl的功能模块。
• examples: 包含了使用libigl的示例代码，可帮助理解如何调用库函数。
• tutorial: 教程代码，逐步展示了库的各种用法。
• contrib: 第三方贡献的代码和扩展。
• cmake: 提供CMake配置文件来编译项目。
• scripts: 辅助脚本，如下载依赖项和构建过程。
• doc: 文档目录，包括Doxygen生成的API参考。
• .gitignore, LICENSE, README.md 等常规项目管理文件。

2. 项目启动文件介绍

hello.cpp: 这是libigl的一个简单入门程序，可以作为如何使用库的模板。它展示了如何计算并打印三角网格的cotangent Laplacian矩阵。

#include <igl/cotmatrix.h>
#include <Eigen/Dense>
#include <Eigen/Sparse>
#include <iostream>

int main()
{
  // Define mesh vertices and faces
  Eigen::MatrixXd V(4,2);
  V << 0 0, 1 0, 1 1, 0 1;
  Eigen::MatrixXi F(2,3);
  F << 0 1 2, 0 2 3;

  // Compute cotangent Laplacian matrix
  Eigen::SparseMatrix<double> L;
  igl::cotmatrix(V, F, L);

  // Print "Hello Mesh"
  std::cout << "Hello mesh:\n" << L*V << std::endl;

  return 0;
}

要编译此程序，你需要确保Eigen也在你的include路径中，并且执行类似以下的编译命令：

g++ -std=c++11 -lpthread -I/path/to/Eigen -I/path/to/libigl/include hello.cpp -o hello

运行./hello即可看到输出结果。

3. 项目的配置文件介绍

Libigl主要使用CMake进行构建。在项目根目录下，你可以找到CMakeLists.txt文件，这是CMake的配置文件。这个文件定义了如何设置库、编译选项以及如何查找依赖库，例如Eigen和可选的CGAL库。通过运行cmake .和make（或者在Windows上使用Visual Studio generator），你可以根据此文件来构建整个库及其示例。

如果你需要自定义构建设置，比如改变编译器或者添加额外的编译标志，可以通过调整CMake的命令行选项来实现，例如-DCMAKE_CXX_COMPILER 和 -DENABLE_CGAL=ON/OFF。

请注意，完整的文档可以在libigl的官方文档上找到，包括更多详细信息和如何配置特定的编译选项。

libiglSimple MPL-2.0-licensed C++ geometry processing library.项目地址:https://gitcode.com/gh_mirrors/li/libigl