README: include an example
This commit is contained in:
parent
17bfa18f6d
commit
7c1ca674a0
32
README.rst
32
README.rst
|
@ -5,7 +5,9 @@
|
|||
|
|
||||
|
||||
Pycairo is a Python module providing bindings for the `cairo graphics library
|
||||
<https://cairographics.org/>`__.
|
||||
<https://cairographics.org/>`__. It depends on **cairo >= 1.13.1** and
|
||||
works with **Python 2.7+** as well as **Python 3.3+**. Pycairo, including this
|
||||
documentation, is licensed under the **LGPLv2.1** as well as the **MPLv1.1**.
|
||||
|
||||
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
|
||||
|
@ -17,9 +19,31 @@ Features of the Pycairo bindings:
|
|||
* Queries the error status of objects and translates them to exceptions.
|
||||
* Provides a C API that can be used by other Python extensions.
|
||||
|
||||
Pycairo depends on **cairo >= 1.13.1** and works with **Python 2.7+** as well
|
||||
as **Python 3.3+**. Pycairo, including this documentation, is licensed under
|
||||
the **LGPLv2.1** as well as the **MPLv1.1**.
|
||||
.. image:: https://cdn.rawgit.com/pygobject/pycairo/master/docs/images/example.svg
|
||||
:align: right
|
||||
:width: 200px
|
||||
|
||||
.. code:: python
|
||||
|
||||
import cairo
|
||||
|
||||
surface = cairo.SVGSurface("example.svg", 200, 200)
|
||||
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()
|
||||
surface.finish()
|
||||
|
||||
If Pycairo is not what you need, have a look at `cairocffi
|
||||
<https://cairocffi.readthedocs.io>`__, which is an API compatible package
|
||||
|
|
|
@ -0,0 +1,7 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="200pt" height="200pt" viewBox="0 0 200 200" version="1.1">
|
||||
<g id="surface1">
|
||||
<path style="fill:none;stroke-width:0.04;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 0.1 0.5 C 0.4 0.9 0.6 0.1 0.9 0.5 " transform="matrix(200,0,0,200,0,0)"/>
|
||||
<path style="fill:none;stroke-width:0.02;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,20%,20%);stroke-opacity:0.6;stroke-miterlimit:10;" d="M 0.1 0.5 L 0.4 0.9 M 0.6 0.1 L 0.9 0.5 " transform="matrix(200,0,0,200,0,0)"/>
|
||||
</g>
|
||||
</svg>
|
After Width: | Height: | Size: 674 B |
Loading…
Reference in New Issue