86 lines
3.5 KiB
Plaintext
86 lines
3.5 KiB
Plaintext
Metadata-Version: 1.1
|
||
Name: pycairo
|
||
Version: 1.20.1
|
||
Summary: Python interface for cairo
|
||
Home-page: https://pycairo.readthedocs.io
|
||
Author: Christoph Reiter
|
||
Author-email: reiter.christoph@gmail.com
|
||
License: LGPL-2.1-only OR MPL-1.1
|
||
Description: .. image:: https://raw.githubusercontent.com/pygobject/pycairo/master/docs/images/pycairo.svg
|
||
:align: center
|
||
:width: 370px
|
||
|
||
|
|
||
|
||
Pycairo is a Python module providing bindings for the `cairo graphics library
|
||
<https://cairographics.org/>`__. It depends on **cairo >= 1.15.10** and works
|
||
with **Python 3.6+**. Pycairo, including this documentation, is licensed under
|
||
the `LGPL-2.1-only OR MPL-1.1 <https://spdx.org/ids-how>`__.
|
||
|
||
The Pycairo bindings are designed to match the cairo C API as closely as
|
||
possible, and to deviate only in cases which are clearly better implemented in
|
||
a more ‘Pythonic’ way.
|
||
|
||
.. code:: shell
|
||
|
||
pip install pycairo
|
||
|
||
Installing Pycairo requires cairo including its headers. For more info see
|
||
"`Getting Started
|
||
<https://pycairo.readthedocs.io/en/latest/getting_started.html>`__".
|
||
|
||
----
|
||
|
||
.. image:: https://raw.githubusercontent.com/pygobject/pycairo/master/docs/images/example.svg
|
||
:align: right
|
||
:width: 200px
|
||
|
||
.. code:: python
|
||
|
||
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()
|
||
|
||
----
|
||
|
||
Features of the Pycairo bindings:
|
||
|
||
* Provides an object oriented interface to cairo.
|
||
* Queries the error status of objects and translates them to exceptions.
|
||
* Provides a C API that can be used by other Python extensions.
|
||
|
||
If Pycairo is not what you need, have a look at `cairocffi
|
||
<https://cairocffi.readthedocs.io>`__, which is an API compatible package
|
||
using `cffi <https://cffi.readthedocs.io/>`__ or `Qahirah
|
||
<https://github.com/ldo/qahirah>`__, which is using `ctypes
|
||
<https://docs.python.org/3/library/ctypes.html>`__ and provides a more
|
||
"pythonic" API with less focus on matching the cairo C API.
|
||
|
||
For more information visit https://pycairo.readthedocs.io
|
||
|
||
.. image:: https://codecov.io/gh/pygobject/pycairo/branch/master/graph/badge.svg
|
||
:target: https://codecov.io/gh/pygobject/pycairo
|
||
|
||
Platform: UNKNOWN
|
||
Classifier: Operating System :: OS Independent
|
||
Classifier: Programming Language :: Python :: 3
|
||
Classifier: Programming Language :: Python :: Implementation :: CPython
|
||
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
||
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
|
||
Classifier: License :: OSI Approved :: Mozilla Public License 1.1 (MPL 1.1)
|