images/pycairo.svg


pycairo是一个python模块,为 cairo graphics library . 这取决于 cairo >= 1.13.1 并与 Python 2.7+ 以及 Python 3.5+ . pycairo,包括本文档,根据 LGPLv2.1 以及 MPLv1.1 .

pycairo绑定的设计目的是尽可能接近cairo C API,并且仅在以更“pythonic”的方式更好地实现的情况下会有改变。

pip install pycairo

安装pycairo需要包含其头的cairo。有关详细信息,请参阅“Getting Started<https://pycairo.readthedocs.io/en/latest/getting_started.html> uuuuuu”。


https://cdn.rawgit.com/pygobject/pycairo/master/docs/images/example.svg
import cairo

with cairo.SVGSurface("example.svg", 200, 200) as surface:
    context = cairo.Context(surface)
    x, y, x1, y1 = 0.1, 0.5, 0.4, 0.9
    x2, y2, x3, y3 = 0.6, 0.1, 0.9, 0.5
    context.scale(200, 200)
    context.set_line_width(0.04)
    context.move_to(x, y)
    context.curve_to(x1, y1, x2, y2, x3, y3)
    context.stroke()
    context.set_source_rgba(1, 0.2, 0.2, 0.6)
    context.set_line_width(0.02)
    context.move_to(x, y)
    context.line_to(x1, y1)
    context.move_to(x2, y2)
    context.line_to(x3, y3)
    context.stroke()

pycairo绑定的功能:

  • 提供到cairo的面向对象接口。

  • 查询对象的错误状态并将其转换为异常。

  • 提供可供其他Python扩展使用的C API。

如果 Pycairo 不是你需要的,看看 cairocffi ,这是一个与API兼容的包,使用 cffiQahirah ,它正在使用 ctypes 并且提供了一个更“pythonic”的API,而对匹配cairo C API的关注较少。

有关详细信息,请访问https://pycairo.readthedocs.io

https://travis-ci.org/pygobject/pycairo.svg?branch=master https://dev.azure.com/pygobject/pycairo/_apis/build/status/pygobject.pycairo https://codecov.io/gh/pygobject/pycairo/branch/master/graph/badge.svg
PyPI:

https://pypi.org/project/pycairo

焦油球:

https://github.com/pygobject/pycairo/releases

Git回购:

https://github.com/pygobject/pycairo

Bug跟踪器:

https://github.com/pygobject/pycairo/issues

邮件列表:

https://lists.cairographics.org/cgi-bin/mailman/listinfo/cairo

有关更多详细信息,请参见“:ref:reference_index”。

要使用pycairo库:

import cairo

要生成/安装库,请执行以下操作:

python2/3 setup.py build
python2/3 setup.py install

运行测试:

python2/3 setup.py test

python 2版本支持 xpyb 默认禁用的集成。要启用,请按以下方式生成:

python2 setup.py build --enable-xpyb
# and for running tests:
python2 setup.py test --enable-xpyb

有关pycairo代码的示例,请参阅pycairo发行版附带的“examples”目录。

有关作者信息,请参阅git历史记录以及git历史记录中现已删除的“changelog”文件。