Clipper for Grasshopper and Rhino
Clipper is a 2D polygon Clipper offering polygon boolean operations (clipping): Intersection, Join, Difference, XOR. Offsets for polygons and Minkowski Sum and Differences.
Download from this page, from github (no login required), or using the experimental package manager for Rhino 6 (type command: TestPackageManager.
For support installing this plugin, please do not use the comments below, but use the grasshopper and rhino forum at discourse.mcneel.com with the tag clipper.
The good stuff:
- it accepts all types of polygons including self-intersecting ones
- it supports multiple polygon filling rules (EvenOdd, NonZero)
- it's very fast relative to the RhinoCommon counterparts
- it also performs line and polygon offsetting
- it's numerically robust
- it's free to use in both freeware and commercial applications
- it's open source
- it's native .NET
What is does not do
- Curved shapes are not supported, and are translated to polylines in the command.
- Only planar operations are supported
For windows: Install the clipper-[version].rhi, this will install both the rhino plugin and the grasshopper plugin.
For Mac OSX: Install the clipper-[version].macrhi, this will install both the rhino plugin and the grasshopper plugin
Package manager: Using rhino 6+'s experimental package manager/yak (from version 0.3.0): using the command TestPackageManager
Manual installation: Download the .zip file, and place in rhino's plugin and grasshopper component folder.
Usage in Rhino:
The commands OffsetPolyline and BooleanPolyline offer interactive commands for the clipper library. This means multiple sets of curves/polylines will be
Usage in Grasshopper:
Examples can be found on github in the folder examples
- Example 1: Simple single polygon offset (Star offset)
- Example 2: Multiple polygon offsets (Urban plan)
- Example 3: Moire effect
- Example 4: Slide an object over another
Usage in python
The components are available in the ClipperComponents namespace
import ghpythonlib.components as ghcomp
Older versions can be downloaded from the github release page.
2021-10-12: Version 0.3.3: Polyline Boolean component no longer throws an exception when the A input list is empty.
2020-04-20: Version 0.3.2: Added offset type selector and improved compatiblity with RhinoInside and RhinoCompute, thanks to Andrew Heumann
2020-04-01: Version 0.3.1: Released new version that fixes compatiblity with ShapeDiver
2019-10-09: Version 0.3.0: Released new version for yak and macrhi. Improved placement in grasshopper menu's
2019-07-22: Version 0.2.3: Updated to clipper version 6.4.2
2017-02-15: Version 0.2.2: Update to new clipper version (6 .4.0), release for Rhino WIP
2014-07-06: Version 0.1, first beta release
API's may change, components may change, and things may stop working in the way they do now in the future.
- Api documentation
Angus Johnson for writing the clipper library.
Andrew Heumann for kindly contributing code improvements
Thanks goes out to the friends at APTO who triggered the requirements for this plugin, and to Maarten Filius for the initial testing.
Arend van Waart email@example.com