# pyclipper

**Repository Path**: zhangjun93/pyclipper

## Basic Information

- **Project Name**: pyclipper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2022-06-09
- **Last Updated**: 2022-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pyclipper

## 简介
> pyclipper是图形处理库，用于剪裁和偏移直线和多边形。

![](screenshot/result.png)

## 下载安装
直接在OpenHarmony-SIG仓中搜索pyclipper并下载。

## 使用说明
以OpenHarmony 3.1 Beta的rk3568版本为例

1. 将下载的pyclipper库代码存在以下路径：./third_party/pyclipper

2. 修改添加依赖的编译脚本，路径：/developtools/bytrace_standard/ohos.build

```

{
  "subsystem": "developtools",
  "parts": {
    "bytrace_standard": {
      "module_list": [
        "//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
        "//developtools/bytrace_standard/bin:bytrace_target",
        "//developtools/bytrace_standard/bin:bytrace.cfg",
        "//developtools/bytrace_standard/interfaces/kits/js/napi:bytrace",
        "//third_party/clipper:clipper",
        "//third_party/clipper:clipper_test"
      ],
      "inner_kits": [
        {
          "type": "so",
          "name": "//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
          "header": {
            "header_files": [
              "bytrace.h"
            ],
            "header_base": "//developtools/bytrace_standard/interfaces/innerkits/native/include"
          }
        }
      ],
      "test_list": [
        "//developtools/bytrace_standard/bin/test:unittest"
      ]
    }
  }
}

```

3. 编译：./build.sh --product-name rk3568 --ccache

4. 生成库文件和一些可执行测试文件，路径：out/rk3568/developtools/profiler

## 接口说明
1. 图形取交（并，差，异或）：
   ```
   import pyclipper
   pc = pyclipper.Pyclipper()
   pc.AddPaths(paths,pyclipper.PT_CLIP,True)
   pc.AddPaths(squrd,pyclipper.PT_SUBJECT,True)
   result = pc.Execute(pyclipper.CT_INTERSECTION,pyclipper.PFT_EVENODD,pyclipper.PFT_EVENODD)
   ```
2. 图形内缩：
   ```
   import pyclipper
   pco = pyclipper.PyclipperOffset()
   pco.AddPaths(points,pyclipper.JT_ROUND,pyclipper.ET_CLOSEDPOLYGON)
   solution = pco.Execute(-int(line_width/2))
   ```
3. 图形简化：
   `pyclipper.SimplifyPolygons()`
4. 消除重复点(共线点)：
   `pyclipper.CleanPolygons()`
5. 判断点与多边形的位置关系：
   `pyclipper.PointInPolygon()`

## 兼容性
支持 OpenHarmony系统 3.0 及以上版本。

## 目录结构
````
|---- pyclipper
|     |---- src
|           |---- clipper.cpp      #Bala Vatti剪裁算法的扩展
|     |---- tests                  #测试脚本文件
|     |---- README.md              #安装使用方法
````

## 贡献代码
使用过程中发现任何问题都可以提 [Issue](https://gitee.com/openharmony-sig/pyclipper/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/openharmony-sig/pyclipper/pulls) 。

## 开源协议
本项目基于 [MIT License](https://gitee.com/openharmony-sig/pyclipper/blob/master/LICENSE) ，请自由地享受和参与开源。