Clipper2 多边形裁剪库使用指南

2026-02-06 05:34:33作者：董斯意

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);