clipper2

项目地址： https://github.com/AngusJohnson/Clipper2

官方文档： http://www.angusj.com/clipper2/Docs/Overview.htm

包管理器： NuGet Clipper2 2.0.0 ｜ vcpkg clipper2 ｜ npm clipper2-js 1.2.4 ｜ 源码 tag Clipper2_2.0.1（2025-12-19，截至 2026-10）

版本： 上游 tag Clipper2_2.0.1；NuGet 稳定包仍为 2.0.0，二者 API 相同，装包时以 NuGet 版本为准

许可证： Boost Software License 1.0

概述

Clipper2 相对 Clipper1 的提升：

• 全新算法，速度更快、内存更省
• 支持浮点（PathsD）与整数（Paths64）双模式
• 全新偏移引擎：更鲁棒的 mitre/square/round 端帽与连接
• 简洁 API：Union/Intersect/Difference/Xor 顶级函数
• 多语言：C++、C#、Delphi、JS（Clipper2.js 移植）

---

安装

C#

dotnet add package Clipper2     # 2.0.0，提供 Clipper2Lib 命名空间

C++

# vcpkg
vcpkg install clipper2
# 或直接 add subdirectory CPP/Clipper2Lib 到 CMake

JavaScript

npm install clipper2-js        # 1.2.4，第三方原生 TS/JS 移植；另有 WASM 移植 js-angusj-clipper 1.3.1

验证

# C#：包能还原且命名空间可解析，跑通一个 union 即可视为就绪
dotnet list package | grep Clipper2

# Node：确认版本
node -e "console.log(require('clipper2-js/package.json').version)"

---

核心 API

核心数据结构（C#）

using Clipper2Lib;

PointD pd = new(10.5, 20.7);            // 浮点点
PathD  path = new() { new(0,0), new(10,0), new(10,10), new(0,10) };
PathsD subj = new() { path };           // 多个 path
PathsD clip = new() { /* ... */ };

整数版本：Point64 / Path64 / Paths64，避免浮点误差。

---

布尔运算

using Clipper2Lib;

PathsD a = new() { Clipper.MakePath(new[] { 0d,0, 100,0, 100,100, 0,100 }) };
PathsD b = new() { Clipper.MakePath(new[] { 50d,50, 150,50, 150,150, 50,150 }) };

PathsD u = Clipper.Union(a, b, FillRule.NonZero);
PathsD i = Clipper.Intersect(a, b, FillRule.NonZero);
PathsD d = Clipper.Difference(a, b, FillRule.NonZero);
PathsD x = Clipper.Xor(a, b, FillRule.NonZero);

FillRule：

• EvenOdd（奇偶）
• NonZero（非零）
• Positive（正向缠绕）
• Negative（负向缠绕）

---

多边形偏移（Inflate / 缩进）

PathsD outline = new() {
    Clipper.MakePath(new[] { 0d,0, 100,0, 100,100, 0,100 })
};

// 向外偏移 10 单位
PathsD outer = Clipper.InflatePaths(outline, 10,
    JoinType.Round,        // Square / Miter / Round
    EndType.Polygon);       // Polygon / Joined / Butt / Square / Round

// 向内偏移：负数
PathsD inner = Clipper.InflatePaths(outline, -10,
    JoinType.Miter, EndType.Polygon);