potrace Python绑定的技术文档

1. 安装指南

Ubuntu

安装系统依赖：

$ sudo apt-get install build-essential python-dev libagg-dev libpotrace-dev pkg-config

安装pypotrace：

$ git clone https://github.com/flupke/pypotrace.git
$ cd pypotrace
$ pip install numpy
$ pip install .

CentOS/RedHat

安装系统依赖：

$ sudo yum -y groupinstall "Development Tools"
$ sudo yum -y install agg-devel potrace-devel python-devel

安装pypotrace：

$ git clone https://github.com/flupke/pypotrace.git
$ cd pypotrace
$ pip install numpy
$ pip install .

OSX

安装系统依赖：

$ brew install libagg pkg-config potrace

安装pypotrace：

$ git clone https://github.com/flupke/pypotrace.git
$ cd pypotrace
$ pip install numpy
$ pip install .

Windows

感谢klonuo <https://github.com/klonuo>_ 提供的Windows安装指导。以下是在Windows系统上使用MinGW环境安装该包的步骤。

首先，需要下载以下两个包：

1. potrace源码: potrace下载页面
2. agg源码: agg下载页面

将这两个包解压到C:\src目录下。在MSYS提示符下，分别执行./configure; make和./autogen.sh; make来编译这两个包。

接着，设置一些变量以便成功编译pypotrace：

• 包含路径：

  • "numpy/arrayobject.h": C:/Python27/Lib/site-packages/numpy/core/include
  • potrace头文件: C:/src/potrace-1.11/src
  • agg头文件: C:/src/agg-2.5

  注意，由于agg源码中的路径引用了agg2/*.h，而下载的agg包中没有agg2目录，可以将C:/src/agg-2.5/include重命名为C:/src/agg-2.5/agg2，并将C:/src/agg-2.5作为agg的头文件目录。

• 库路径：

  • potrace: C:/src/potrace-1.11/src/.libs
  • agg: C:/src/agg-2.5/src

然后构建pypotrace：

python setup.py build_ext -IC:/Python27/Lib/site-packages/numpy/core/include;C:/src/potrace-1.11/src;C:/src/agg-2.5 -LC:/src/potrace-1.11/src/.libs;C:/src/agg-2.5/src

最后安装该包：

C:\src\git\pypotrace>python setup.py install

2. 项目的使用说明

使用potrace Python绑定，可以通过numpy数组表示输入图像：

import numpy as np
import potrace

# 创建一个中间有矩形的numpy数组
data = np.zeros((32, 32), np.uint32)
data[8:32-8, 8:32-8] = 1

# 从数组创建位图
bmp = potrace.Bitmap(data)

# 跟踪位图生成路径
path = bmp.trace()

# 遍历路径曲线
for curve in path:
    print("start_point =", curve.start_point)
    for segment in curve:
        print(segment)
        end_point_x, end_point_y = segment.end_point
        if segment.is_corner:
            c_x, c_y = segment.c
        else:
            c1_x, c1_y = segment.c1
            c2_x, c2_y = segment.c2

3. 项目API使用文档

potrace Python绑定的完整API文档可以在这里找到。这里简要介绍几个关键类：

• Bitmap: 表示位图对象的类，可以从中跟踪路径。
• Path: 表示跟踪结果的路径。
• Curve: 路径中的曲线段。

4. 项目安装方式

项目的安装方式已在"安装指南"部分详细说明。简而言之，可以通过以下步骤进行安装：

1. 克隆项目仓库。
2. 安装numpy依赖。
3. 使用pip安装项目。

请按照上述指南操作，确保成功安装potrace Python绑定。