Clipper2

A Polygon Clipping, Offsetting and Triangulation library (in C++, C# & Delphi)

  

The Clipper2 library performs intersection, union, difference and XOR boolean operations on both simple and complex polygons. It also performs polygon offsetting, and Constrained Delaunay Triangulation. This is a major update of my original Clipper library that was written over 10 years ago. That library I'm now calling Clipper1, and while it still works very well, Clipper2 is just better.

Installation

To use the library, it must be created as a submodule in git within the path of a project:

git submodule add https://github.com/SmartBuildingDesign/Clipper2.git lib/clipper2

This will create the clipper2 folder inside lib. Then, within CMakeLists.txt:

import_library(lib/clipper2/CPP)
target_link_libraries(${PROJECT_NAME} Clipper2)

Compilers

Clipper2 can be compiled using any one of three supported programming languages: C++, or C#, or Delphi Pascal. The library can also be accessed from other languages by dynamically linking to exported functions in the C++ compiled Clipper2 library. (Since the C++ compiled code is measurably faster, even C# and Delphi developers may prefer this approach in applications where the library's performance is critical.)

Lang.	Requirements
C++:	Requires C++17, or
C#:	The library uses Standard Library 2.0 but the sample code uses .NET6, or
Delphi:	Compiles with any version of Delphi from version 7 to current.

Documentation

Extensive HTML documentation

Examples

Clipping

C++

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/CPP/Examples/SimpleClipping/SimpleClipping.cpp#L29-L34

C#

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/CSharp/Clipper2Lib.Examples/ConsoleDemo/Main.cs#L112-L116

Delphi

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/Delphi/Examples/Example1/Example1.dpr#L21-L26

Inflating (aka Offsetting)

C++

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/CPP/Examples/Inflate/Inflate.cpp#L36-L47

C#

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/CSharp/Clipper2Lib.Examples/InflateDemo/Main.cs#L89-L100

Delphi

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/Delphi/Examples/Example2/Example2.dpr#L20-L31

Constrained Delaunay Triangulation

C++

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/CPP/Examples/Triangulation/Triangulation.cpp#L135-L138

C#

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/CSharp/Clipper2Lib.Examples/Triangulation/Main.cs#L110-L115

Delphi

https://github.com/AngusJohnson/Clipper2/blob/fa7add77364eb3877dd1b8caf9b3cbd5486347f6/Delphi/Examples/Triangulation/ClipperTri.dpr#L28-L33

C++

https://github.com/AngusJohnson/Clipper2/blob/2970649befb89af85e2132e5242a7d6926cbfa11/CPP/Examples/UsingZ/UsingZ.cpp#L173-L184

---

Ports to other languages

lang.	link
Java	https://github.com/micycle1/Clipper2-java/
TypeScript	https://github.com/countertype/clipper2-ts
Kotlin	https://github.com/Monkey-Maestro/clipper2-kotlin
golang	https://github.com/epit3d/goclipper2
Lua	https://github.com/Ark223/Clipper2-Lua
WASM	https://github.com/ErikSom/Clipper2-WASM/