Clipper2 多边形裁剪库使用指南

Clipper2 是一个功能强大的开源多边形裁剪和偏移库，支持 C++、C# 和 Delphi 三种主流编程语言。该库提供了高效的几何运算能力，广泛应用于计算机图形学、CAD 设计、游戏开发和地理信息系统等领域。

项目架构概览

Clipper2 采用清晰的多语言并行架构，让开发者能够根据项目需求灵活选择适合的实现版本：

Clipper2/
├── CPP/           # C++ 版本核心源码
│   ├── Clipper2Lib/
│   │   ├── include/clipper2/
│   │   │   ├── clipper.h
│   │   │   ├── clipper.core.h
│   │   │   └── clipper.offset.h
│   └── src/
│       ├── clipper.engine.cpp
│       └── clipper.offset.cpp
├── CSharp/        # C# 版本实现代码
│   ├── Clipper2Lib/
│   │   ├── Clipper.cs
│   │   ├── Clipper.Core.cs
│   │   └── Clipper.Offset.cs
├── Delphi/        # Delphi 版本模块
│   ├── Clipper2Lib/
│   │   ├── Clipper.pas
│   │   ├── Clipper.Core.pas
│   │   └── Clipper.Offset.pas
├── LICENSE        # Boost 1.0 开源许可证
└── README.md      # 项目说明文档

核心功能特性

Clipper2 库主要提供以下几何运算功能：

布尔运算

• 交集 (Intersection)
• 并集 (Union)
• 差集 (Difference)
• 异或 (XOR)

多边形操作

• 多边形偏移 (Offsetting)
• 路径简化 (Path Simplification)
• 矩形裁剪 (Rectangle Clipping)

快速入门指南

C++ 版本使用

要开始使用 C++ 版本的 Clipper2，首先包含核心头文件：

#include "clipper2/clipper.h"
using namespace Clipper2Lib;

// 创建多边形路径
Paths64 subject, clip, solution;
subject.push_back(MakePath({100, 50, 10, 79, 65, 2, 65, 98, 10, 21}));
clip.push_back(MakePath({98, 63, 4, 68, 77, 8, 52, 100, 19, 12}));

// 执行交集运算
solution = Intersect(subject, clip, FillRule::NonZero);

C# 版本集成

C# 版本提供了类似的 API 接口：

Paths64 subj = new Paths64();
Paths64 clip = new Paths64();
subj.Add(Clipper.MakePath(new int[] { 100, 50, 10, 79, 65, 2, 65, 98, 10, 21 }));
clip.Add(Clipper.MakePath(new int[] { 98, 63, 4, 68, 77, 8, 52, 100, 19, 12 }));
Paths64 solution = Clipper.Intersect(subj, clip, FillRule.NonZero);

Delphi 版本接入

Delphi 开发者可以使用以下代码：

var
  subject, clip, solution: TPaths64;
begin
  SetLength(subject, 1);
  subject[0] := MakePath([100, 50, 10, 79, 65, 2, 65, 98, 10, 21]);
  SetLength(clip, 1);
  clip[0] := MakePath([98, 63, 4, 68, 77, 8, 52, 100, 19, 12]);
  solution := Intersect(subject, clip, frNonZero);

实用示例代码

项目提供了丰富的示例代码，位于 CPP/Examples/ 目录下，包括：

• 简单裁剪：基础多边形运算演示
• 偏移操作：等距偏移功能展示
• 矩形裁剪：矩形区域裁剪应用
• 多边形采样：复杂几何形状处理

编译要求

C++ 版本

• 需要 C++17 标准编译器
• 可修改为支持 C++11

C# 版本

• 使用 .NET Standard 2.0
• 示例代码基于 .NET 6

Delphi 版本

• 兼容 Delphi 7 到最新版本

最佳实践建议

1. 数据预处理：确保输入多边形路径的有效性
2. 填充规则选择：根据需求合理选择 NonZero 或 EvenOdd 规则
3. 性能优化：对于大量运算，考虑批量处理
4. 错误处理：妥善处理空路径和无效输入

实际应用场景

Clipper2 库在以下领域有广泛应用：

• 工业设计：CAD 软件中的几何运算
• 游戏开发：碰撞检测和地形生成
• 地理信息系统：地图叠加和区域分析
• 计算机视觉：图像分割和轮廓处理

通过掌握 Clipper2 的核心功能和使用方法，开发者可以轻松实现复杂的几何运算需求，提升项目的图形处理能力。