/******************************************************************************* * Author : Angus Johnson * * Date : 14 May 2024 * * Website : http://www.angusj.com * * Copyright : Angus Johnson 2010-2024 * * Purpose : This module exports the Clipper2 Library (ie DLL/so) * * License : http://www.boost.org/LICENSE_1_0.txt * *******************************************************************************/ /* Boolean clipping: cliptype: None=0, Intersection=1, Union=2, Difference=3, Xor=4 fillrule: EvenOdd=0, NonZero=1, Positive=2, Negative=3 Polygon offsetting (inflate/deflate): jointype: Square=0, Bevel=1, Round=2, Miter=3 endtype: Polygon=0, Joined=1, Butt=2, Square=3, Round=4 The path structures used extensively in other parts of this library are all based on std::vector classes. Since C++ classes can't be accessed by other languages, these paths are converted into very simple array data structures (of either int64_t for CPath64 or double for CPathD) that can be parsed by just about any programming language. CPath64 and CPathD: These are arrays of consecutive x and y path coordinates preceeded by a pair of values containing the path's length (N) and a 0 value. __________________________________ |counter|coord1|coord2|...|coordN| |N, 0 |x1, y1|x2, y2|...|xN, yN| __________________________________ CPaths64 and CPathsD: These are also arrays containing any number of consecutive CPath64 or CPathD structures. But preceeding these consecutive paths, there is pair of values that contain the total length of the array structure (A) and the number of CPath64 or CPathD it contains (C). The space these structures will occupy in memory = A * sizeof(int64_t) or A * sizeof(double) respectively. _______________________________ |counter|path1|path2|...|pathC| |A , C | | _______________________________ CPolytree64 and CPolytreeD: These are also arrays consisting of CPolyPath structures that represent individual paths in a tree structure. However, the very first (ie top) CPolyPath is just the tree container that doesn't have a path. And because of that, its structure will be very slightly different from the remaining CPolyPath. This difference will be discussed below. CPolyPath64 and CPolyPathD: These are simple arrays consisting of a series of path coordinates followed by any number of child (ie nested) CPolyPath. Preceeding these are two values indicating the length of the path (N) and the number of child CPolyPath (C). ____________________________________________________________ |counter|coord1|coord2|...|coordN| child1|child2|...|childC| |N , C |x1, y1|x2, y2|...|xN, yN| | ____________________________________________________________ As mentioned above, the very first CPolyPath structure is just a container that owns (both directly and indirectly) every other CPolyPath in the tree. Since this first CPolyPath has no path, instead of a path length, its very first value will contain the total length of the CPolytree array (not its total bytes length). Again, all theses exported structures (CPaths64, CPathsD, CPolyTree64 & CPolyTreeD) are arrays of either type int64_t or double, and the first value in these arrays will always be the length of that array. These array structures are allocated in heap memory which will eventually need to be released. However, since applications dynamically linking to these functions may use different memory managers, the only safe way to free up this memory is to use the exported DisposeArray64 and DisposeArrayD functions (see below). */ #ifndef CLIPPER2_EXPORT_H #define CLIPPER2_EXPORT_H #include #include #include "clipper2/clipper.core.h" #include "clipper2/clipper.engine.h" #include "clipper2/clipper.offset.h" #include "clipper2/clipper.rectclip.h" namespace Clipper2Lib { typedef int64_t* CPath64; typedef int64_t* CPaths64; typedef double* CPathD; typedef double* CPathsD; typedef int64_t* CPolyPath64; typedef int64_t* CPolyTree64; typedef double* CPolyPathD; typedef double* CPolyTreeD; template struct CRect { T left; T top; T right; T bottom; }; typedef CRect CRect64; typedef CRect CRectD; template inline bool CRectIsEmpty(const CRect& rect) { return (rect.right <= rect.left) || (rect.bottom <= rect.top); } template inline Rect CRectToRect(const CRect& rect) { Rect result; result.left = rect.left; result.top = rect.top; result.right = rect.right; result.bottom = rect.bottom; return result; } #ifdef _WIN32 #define EXTERN_DLL_EXPORT extern "C" __declspec(dllexport) #else #define EXTERN_DLL_EXPORT extern "C" #endif ////////////////////////////////////////////////////// // EXPORTED FUNCTION DECLARATIONS ////////////////////////////////////////////////////// EXTERN_DLL_EXPORT const char* Version(); EXTERN_DLL_EXPORT void DisposeArray64(int64_t*& p) { delete[] p; } EXTERN_DLL_EXPORT void DisposeArrayD(double*& p) { delete[] p; } EXTERN_DLL_EXPORT int BooleanOp64(uint8_t cliptype, uint8_t fillrule, const CPaths64 subjects, const CPaths64 subjects_open, const CPaths64 clips, CPaths64& solution, CPaths64& solution_open, bool preserve_collinear = true, bool reverse_solution = false); EXTERN_DLL_EXPORT int BooleanOp_PolyTree64(uint8_t cliptype, uint8_t fillrule, const CPaths64 subjects, const CPaths64 subjects_open, const CPaths64 clips, CPolyTree64& sol_tree, CPaths64& solution_open, bool preserve_collinear = true, bool reverse_solution = false); EXTERN_DLL_EXPORT int BooleanOpD(uint8_t cliptype, uint8_t fillrule, const CPathsD subjects, const CPathsD subjects_open, const CPathsD clips, CPathsD& solution, CPathsD& solution_open, int precision = 2, bool preserve_collinear = true, bool reverse_solution = false); EXTERN_DLL_EXPORT int BooleanOp_PolyTreeD(uint8_t cliptype, uint8_t fillrule, const CPathsD subjects, const CPathsD subjects_open, const CPathsD clips, CPolyTreeD& solution, CPathsD& solution_open, int precision = 2, bool preserve_collinear = true, bool reverse_solution = false); EXTERN_DLL_EXPORT CPaths64 InflatePaths64(const CPaths64 paths, double delta, uint8_t jointype, uint8_t endtype, double miter_limit = 2.0, double arc_tolerance = 0.0, bool reverse_solution = false); EXTERN_DLL_EXPORT CPathsD InflatePathsD(const CPathsD paths, double delta, uint8_t jointype, uint8_t endtype, int precision = 2, double miter_limit = 2.0, double arc_tolerance = 0.0, bool reverse_solution = false); // RectClip & RectClipLines: EXTERN_DLL_EXPORT CPaths64 RectClip64(const CRect64& rect, const CPaths64 paths); EXTERN_DLL_EXPORT CPathsD RectClipD(const CRectD& rect, const CPathsD paths, int precision = 2); EXTERN_DLL_EXPORT CPaths64 RectClipLines64(const CRect64& rect, const CPaths64 paths); EXTERN_DLL_EXPORT CPathsD RectClipLinesD(const CRectD& rect, const CPathsD paths, int precision = 2); ////////////////////////////////////////////////////// // INTERNAL FUNCTIONS ////////////////////////////////////////////////////// template static void GetPathCountAndCPathsArrayLen(const Paths& paths, size_t& cnt, size_t& array_len) { array_len = 2; cnt = 0; for (const Path& path : paths) if (path.size()) { array_len += path.size() * 2 + 2; ++cnt; } } static size_t GetPolyPath64ArrayLen(const PolyPath64& pp) { size_t result = 2; // poly_length + child_count result += pp.Polygon().size() * 2; //plus nested children :) for (size_t i = 0; i < pp.Count(); ++i) result += GetPolyPath64ArrayLen(*pp[i]); return result; } static void GetPolytreeCountAndCStorageSize(const PolyTree64& tree, size_t& cnt, size_t& array_len) { cnt = tree.Count(); // nb: top level count only array_len = GetPolyPath64ArrayLen(tree); } template static T* CreateCPaths(const Paths& paths) { size_t cnt = 0, array_len = 0; GetPathCountAndCPathsArrayLen(paths, cnt, array_len); T* result = new T[array_len], * v = result; *v++ = array_len; *v++ = cnt; for (const Path& path : paths) { if (!path.size()) continue; *v++ = path.size(); *v++ = 0; for (const Point& pt : path) { *v++ = pt.x; *v++ = pt.y; } } return result; } CPathsD CreateCPathsDFromPaths64(const Paths64& paths, double scale) { if (!paths.size()) return nullptr; size_t cnt, array_len; GetPathCountAndCPathsArrayLen(paths, cnt, array_len); CPathsD result = new double[array_len], v = result; *v++ = (double)array_len; *v++ = (double)cnt; for (const Path64& path : paths) { if (!path.size()) continue; *v = (double)path.size(); ++v; *v++ = 0; for (const Point64& pt : path) { *v++ = pt.x * scale; *v++ = pt.y * scale; } } return result; } template static Path ConvertCPath(T* path) { Path result; if (!path) return result; T* v = path; size_t cnt = static_cast(*v); v += 2; // skip 0 value result.reserve(cnt); for (size_t j = 0; j < cnt; ++j) { T x = *v++, y = *v++; result.push_back(Point(x, y)); } return result; } template static Paths ConvertCPaths(T* paths) { Paths result; if (!paths) return result; T* v = paths; ++v; size_t cnt = static_cast(*v++); result.reserve(cnt); for (size_t i = 0; i < cnt; ++i) { size_t cnt2 = static_cast(*v); v += 2; Path path; path.reserve(cnt2); for (size_t j = 0; j < cnt2; ++j) { T x = *v++, y = *v++; path.push_back(Point(x, y)); } result.push_back(path); } return result; } static Paths64 ConvertCPathsDToPaths64(const CPathsD paths, double scale) { Paths64 result; if (!paths) return result; double* v = paths; ++v; // skip the first value (0) size_t cnt = static_cast(*v++); result.reserve(cnt); for (size_t i = 0; i < cnt; ++i) { size_t cnt2 = static_cast(*v); v += 2; Path64 path; path.reserve(cnt2); for (size_t j = 0; j < cnt2; ++j) { double x = *v++ * scale; double y = *v++ * scale; path.push_back(Point64(x, y)); } result.push_back(path); } return result; } template static void CreateCPolyPath(const PolyPath64* pp, T*& v, T scale) { *v++ = static_cast(pp->Polygon().size()); *v++ = static_cast(pp->Count()); for (const Point64& pt : pp->Polygon()) { *v++ = static_cast(pt.x * scale); *v++ = static_cast(pt.y * scale); } for (size_t i = 0; i < pp->Count(); ++i) CreateCPolyPath(pp->Child(i), v, scale); } template static T* CreateCPolyTree(const PolyTree64& tree, T scale) { if (scale == 0) scale = 1; size_t cnt, array_len; GetPolytreeCountAndCStorageSize(tree, cnt, array_len); if (!cnt) return nullptr; // allocate storage T* result = new T[array_len]; T* v = result; *v++ = static_cast(array_len); *v++ = static_cast(tree.Count()); for (size_t i = 0; i < tree.Count(); ++i) CreateCPolyPath(tree.Child(i), v, scale); return result; } ////////////////////////////////////////////////////// // EXPORTED FUNCTION DEFINITIONS ////////////////////////////////////////////////////// EXTERN_DLL_EXPORT const char* Version() { return CLIPPER2_VERSION; } EXTERN_DLL_EXPORT int BooleanOp64(uint8_t cliptype, uint8_t fillrule, const CPaths64 subjects, const CPaths64 subjects_open, const CPaths64 clips, CPaths64& solution, CPaths64& solution_open, bool preserve_collinear, bool reverse_solution) { if (cliptype > static_cast(ClipType::Xor)) return -4; if (fillrule > static_cast(FillRule::Negative)) return -3; Paths64 sub, sub_open, clp, sol, sol_open; sub = ConvertCPaths(subjects); sub_open = ConvertCPaths(subjects_open); clp = ConvertCPaths(clips); Clipper64 clipper; clipper.PreserveCollinear(preserve_collinear); clipper.ReverseSolution(reverse_solution); if (sub.size() > 0) clipper.AddSubject(sub); if (sub_open.size() > 0) clipper.AddOpenSubject(sub_open); if (clp.size() > 0) clipper.AddClip(clp); if (!clipper.Execute(ClipType(cliptype), FillRule(fillrule), sol, sol_open)) return -1; // clipping bug - should never happen :) solution = CreateCPaths(sol); solution_open = CreateCPaths(sol_open); return 0; //success !! } EXTERN_DLL_EXPORT int BooleanOp_PolyTree64(uint8_t cliptype, uint8_t fillrule, const CPaths64 subjects, const CPaths64 subjects_open, const CPaths64 clips, CPolyTree64& sol_tree, CPaths64& solution_open, bool preserve_collinear, bool reverse_solution) { if (cliptype > static_cast(ClipType::Xor)) return -4; if (fillrule > static_cast(FillRule::Negative)) return -3; Paths64 sub, sub_open, clp, sol_open; sub = ConvertCPaths(subjects); sub_open = ConvertCPaths(subjects_open); clp = ConvertCPaths(clips); PolyTree64 tree; Clipper64 clipper; clipper.PreserveCollinear(preserve_collinear); clipper.ReverseSolution(reverse_solution); if (sub.size() > 0) clipper.AddSubject(sub); if (sub_open.size() > 0) clipper.AddOpenSubject(sub_open); if (clp.size() > 0) clipper.AddClip(clp); if (!clipper.Execute(ClipType(cliptype), FillRule(fillrule), tree, sol_open)) return -1; // clipping bug - should never happen :) sol_tree = CreateCPolyTree(tree, (int64_t)1); solution_open = CreateCPaths(sol_open); return 0; //success !! } EXTERN_DLL_EXPORT int BooleanOpD(uint8_t cliptype, uint8_t fillrule, const CPathsD subjects, const CPathsD subjects_open, const CPathsD clips, CPathsD& solution, CPathsD& solution_open, int precision, bool preserve_collinear, bool reverse_solution) { if (precision < -8 || precision > 8) return -5; if (cliptype > static_cast(ClipType::Xor)) return -4; if (fillrule > static_cast(FillRule::Negative)) return -3; const double scale = std::pow(10, precision); Paths64 sub, sub_open, clp, sol, sol_open; sub = ConvertCPathsDToPaths64(subjects, scale); sub_open = ConvertCPathsDToPaths64(subjects_open, scale); clp = ConvertCPathsDToPaths64(clips, scale); Clipper64 clipper; clipper.PreserveCollinear(preserve_collinear); clipper.ReverseSolution(reverse_solution); if (sub.size() > 0) clipper.AddSubject(sub); if (sub_open.size() > 0) clipper.AddOpenSubject(sub_open); if (clp.size() > 0) clipper.AddClip(clp); if (!clipper.Execute(ClipType(cliptype), FillRule(fillrule), sol, sol_open)) return -1; solution = CreateCPathsDFromPaths64(sol, 1 / scale); solution_open = CreateCPathsDFromPaths64(sol_open, 1 / scale); return 0; } EXTERN_DLL_EXPORT int BooleanOp_PolyTreeD(uint8_t cliptype, uint8_t fillrule, const CPathsD subjects, const CPathsD subjects_open, const CPathsD clips, CPolyTreeD& solution, CPathsD& solution_open, int precision, bool preserve_collinear, bool reverse_solution) { if (precision < -8 || precision > 8) return -5; if (cliptype > static_cast(ClipType::Xor)) return -4; if (fillrule > static_cast(FillRule::Negative)) return -3; double scale = std::pow(10, precision); int err = 0; Paths64 sub, sub_open, clp, sol_open; sub = ConvertCPathsDToPaths64(subjects, scale); sub_open = ConvertCPathsDToPaths64(subjects_open, scale); clp = ConvertCPathsDToPaths64(clips, scale); PolyTree64 tree; Clipper64 clipper; clipper.PreserveCollinear(preserve_collinear); clipper.ReverseSolution(reverse_solution); if (sub.size() > 0) clipper.AddSubject(sub); if (sub_open.size() > 0) clipper.AddOpenSubject(sub_open); if (clp.size() > 0) clipper.AddClip(clp); if (!clipper.Execute(ClipType(cliptype), FillRule(fillrule), tree, sol_open)) return -1; // clipping bug - should never happen :) solution = CreateCPolyTree(tree, 1/scale); solution_open = CreateCPathsDFromPaths64(sol_open, 1 / scale); return 0; //success !! } EXTERN_DLL_EXPORT CPaths64 InflatePaths64(const CPaths64 paths, double delta, uint8_t jointype, uint8_t endtype, double miter_limit, double arc_tolerance, bool reverse_solution) { Paths64 pp; pp = ConvertCPaths(paths); ClipperOffset clip_offset( miter_limit, arc_tolerance, reverse_solution); clip_offset.AddPaths(pp, JoinType(jointype), EndType(endtype)); Paths64 result; clip_offset.Execute(delta, result); return CreateCPaths(result); } EXTERN_DLL_EXPORT CPathsD InflatePathsD(const CPathsD paths, double delta, uint8_t jointype, uint8_t endtype, int precision, double miter_limit, double arc_tolerance, bool reverse_solution) { if (precision < -8 || precision > 8 || !paths) return nullptr; const double scale = std::pow(10, precision); ClipperOffset clip_offset(miter_limit, arc_tolerance, reverse_solution); Paths64 pp = ConvertCPathsDToPaths64(paths, scale); clip_offset.AddPaths(pp, JoinType(jointype), EndType(endtype)); Paths64 result; clip_offset.Execute(delta * scale, result); return CreateCPathsDFromPaths64(result, 1 / scale); } EXTERN_DLL_EXPORT CPaths64 RectClip64(const CRect64& rect, const CPaths64 paths) { if (CRectIsEmpty(rect) || !paths) return nullptr; Rect64 r64 = CRectToRect(rect); class RectClip64 rc(r64); Paths64 pp = ConvertCPaths(paths); Paths64 result = rc.Execute(pp); return CreateCPaths(result); } EXTERN_DLL_EXPORT CPathsD RectClipD(const CRectD& rect, const CPathsD paths, int precision) { if (CRectIsEmpty(rect) || !paths) return nullptr; if (precision < -8 || precision > 8) return nullptr; const double scale = std::pow(10, precision); RectD r = CRectToRect(rect); Rect64 rec = ScaleRect(r, scale); Paths64 pp = ConvertCPathsDToPaths64(paths, scale); class RectClip64 rc(rec); Paths64 result = rc.Execute(pp); return CreateCPathsDFromPaths64(result, 1 / scale); } EXTERN_DLL_EXPORT CPaths64 RectClipLines64(const CRect64& rect, const CPaths64 paths) { if (CRectIsEmpty(rect) || !paths) return nullptr; Rect64 r = CRectToRect(rect); class RectClipLines64 rcl (r); Paths64 pp = ConvertCPaths(paths); Paths64 result = rcl.Execute(pp); return CreateCPaths(result); } EXTERN_DLL_EXPORT CPathsD RectClipLinesD(const CRectD& rect, const CPathsD paths, int precision) { if (CRectIsEmpty(rect) || !paths) return nullptr; if (precision < -8 || precision > 8) return nullptr; const double scale = std::pow(10, precision); Rect64 r = ScaleRect(CRectToRect(rect), scale); class RectClipLines64 rcl(r); Paths64 pp = ConvertCPathsDToPaths64(paths, scale); Paths64 result = rcl.Execute(pp); return CreateCPathsDFromPaths64(result, 1 / scale); } EXTERN_DLL_EXPORT CPaths64 MinkowskiSum64(const CPath64& cpattern, const CPath64& cpath, bool is_closed) { Path64 path = ConvertCPath(cpath); Path64 pattern = ConvertCPath(cpattern); Paths64 solution = MinkowskiSum(pattern, path, is_closed); return CreateCPaths(solution); } EXTERN_DLL_EXPORT CPaths64 MinkowskiDiff64(const CPath64& cpattern, const CPath64& cpath, bool is_closed) { Path64 path = ConvertCPath(cpath); Path64 pattern = ConvertCPath(cpattern); Paths64 solution = MinkowskiDiff(pattern, path, is_closed); return CreateCPaths(solution); } } // end Clipper2Lib namespace #endif // CLIPPER2_EXPORT_H