Package: rlPyCairo
=====================================README=====================================(C) Copyright ReportLab Europe Ltd. 2000-2021.See ``LICENSE.txt`` for license details.This is a plugin for the ReportLab PDF Toolkit.which constructs rich PDF documents, and also creationof charts in a variety of bitmap and vector formats.This plugin is intended to replace most of the usage of thelibart based C extension _renderPM which has been shown tohave issues when rendering complex documents.This backend can be brought into use by settingreportlab.rl_config.renderPMBackend = 'rlPyCairo'any of the methods detailed in reportlab/rl_config.pycan be used to accomplish this.The new backend seems able to handle all the same behaviour as_renderPM and the only place where it seems inferior is in therendering of scaled images and the speed with which it drawstext.At present the rlPyCairo backend only uses the _renderPM extensionto use its mapping of ReportLab font names to extract paths forrendering this is no doubt the reason for its slowness whenrendering text.Currently we are not making use of any of the more advancedabilities of PyCairo such as transparency, patterns etc,but that may change in the future.Contents of this file:1. Licensing2. Installation2.1 General Prerequisites2.2 Source Distribution mercurial3. Prerequisites / Dependencies4. Documentation5. Tests6. Acknowledgements and Thanks1. Licensing============BSD license.  See ``LICENSE.txt`` for details.2. Installation===============In most cases, pip install reportlab`` will do the job.2.1 General prerequisites--------------------------You need to have installed Python (versions 2.7 or >=3.6) and reportlaband ideally PIL or Pillow with Freetype support; more notes on prerequisitesfollow below.2.2. Where to get the code------------------------------------------Latest sources are available from ReportLab'sopen source download area::https://hg.reportlab.com/hg-pulic/rlPyCairoYou can obtain the latest code from our Mercurial repository with::hg clone https://hg.reportlab.com/hg-public/rlPyCairoAll released packages are available from our pypi athttps://www.reportlab.com/pypi/Main releases are also available from the Python Package Index:https://pypi.python.org/A mirror only repository is available for git users athttps://github.com/MrBitBucket/rlPyCairo-mirrorplease do not use this for issue reporting etc; use the mail list athttps://pairlist2.pair.net/mailman/listinfo/reportlab-users3. Prerequisites / Dependencies===============================This works with Python versions 2.7 or >=3.6. Older versions are availablegoing back to Python 1.5 or thereabouts.There are no absolute prerequisites beyond the Pythonstandard library; but the Python Imaging Library (PIL or Pillow)is needed to produce images with this package.4. Documentation================There is no documentation other than that provided in the reportlab packageabout the standard renderPM renderer. This package is intended as analternative to the lgpl_libart based backend reportlab.graphics._renderPM.To enable this backend the reportlab.rl_config.renderPMBackend should be setto the string 'rlPyCairo'. Use any of the methods outlined inreportlab/rl_config.py to accomplish this.5. Test suite=============Tests are in the ``reportlab/tests/`` directory.  They can be executed by cd'ing into thedirectory and executing ``python runAll.py`` with an envinment variableset as RL_renderPMBackend=rlPyCairo. Obviously you need to have rlPyCairoinstalled.6. Acknowledgements and Thanks==============================Claude Paroz for failing examples of the base backend.