Pigo 项目教程

1. 项目目录结构及介绍

Pigo 项目的目录结构如下：

pigo/
├── cmd/
│   └── pigo/
├── core/
├── examples/
├── testdata/
├── utils/
├── vendor/
├── wasm/
├── .gitattributes
├── .gitignore
├── LICENSE
├── Makefile
├── README.md
├── build.sh
├── go.mod
├── go.sum
└── snapcraft.yaml

目录介绍

• cmd/: 包含项目的命令行工具入口文件。
  • pigo/: 具体的命令行工具实现。
• core/: 包含 Pigo 库的核心代码，负责人脸检测、瞳孔/眼睛定位和面部特征点检测。
• examples/: 包含一些示例代码，展示了如何在实际应用中使用 Pigo 库。
• testdata/: 包含测试数据文件。
• utils/: 包含一些实用工具函数。
• vendor/: 包含项目的依赖库。
• wasm/: 包含 WebAssembly 相关的代码和示例。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• Makefile: 用于构建项目的 Makefile 文件。
• README.md: 项目介绍和使用说明。
• build.sh: 构建脚本。
• go.mod: Go 模块定义文件。
• go.sum: Go 模块依赖的校验和文件。
• snapcraft.yaml: Snapcraft 配置文件，用于构建 Snap 包。

2. 项目启动文件介绍

Pigo 项目的启动文件位于 cmd/pigo/main.go。该文件是命令行工具的入口点，负责解析命令行参数并调用 Pigo 库进行人脸检测。

主要功能

• 命令行参数解析: 使用 flag 包解析命令行参数，如输入文件、输出文件、级联文件路径等。
• 人脸检测: 调用 Pigo 库的核心功能进行人脸检测，并将结果输出到指定文件或标准输出。

3. 项目的配置文件介绍

Pigo 项目没有传统的配置文件，其配置主要通过命令行参数传递。以下是一些常用的命令行参数：

• -in: 输入图像文件路径。
• -out: 输出图像文件路径。
• -cf: 级联文件路径，用于人脸检测。
• -angle: 级联旋转角度，用于检测平面旋转的人脸。
• -iou: 交并比（IoU）阈值，用于过滤检测结果。
• -json: 输出检测点的 JSON 文件路径。
• -mark: 是否标记检测到的眼睛。
• -marker: 检测标记类型，可选值为 rect、circle 或 ellipse。
• -max: 人脸的最大尺寸。
• -min: 人脸的最小尺寸。
• -scale: 检测窗口的缩放比例。
• -shift: 检测窗口的移动比例。

通过这些参数，用户可以灵活配置 Pigo 的行为，以适应不同的应用场景。

---

以上是 Pigo 项目的教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用 Pigo 项目。