You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
160 lines
4.8 KiB
160 lines
4.8 KiB
Metadata-Version: 2.4
|
|
Name: rlPyCairo
|
|
Version: 0.4.0
|
|
Summary: Plugin backend renderer for reportlab.graphics.renderPM
|
|
Author-email: Robin Becker <robin@reportlab.com>
|
|
License: BSD license, Copyright (c) 2000-2022, ReportLab Inc.
|
|
Classifier: Development Status :: 2 - Pre-Alpha
|
|
Classifier: Environment :: Web Environment
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: License :: OSI Approved :: BSD License
|
|
Classifier: Operating System :: OS Independent
|
|
Classifier: Programming Language :: Python
|
|
Classifier: Programming Language :: Python :: 2
|
|
Classifier: Programming Language :: Python :: 2.7
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3.6
|
|
Classifier: Programming Language :: Python :: 3.7
|
|
Classifier: Programming Language :: Python :: 3.8
|
|
Classifier: Programming Language :: Python :: 3.9
|
|
Classifier: Topic :: Utilities
|
|
Requires-Python: >=3.7
|
|
Description-Content-Type: text/plain
|
|
Requires-Dist: pycairo>=1.20.0
|
|
Requires-Dist: freetype-py>=2.3
|
|
|
|
=====================================
|
|
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 creation
|
|
of charts in a variety of bitmap and vector formats.
|
|
|
|
This plugin is intended to replace most of the usage of the
|
|
libart based C extension _renderPM which has been shown to
|
|
have issues when rendering complex documents.
|
|
|
|
This backend can be brought into use by setting
|
|
reportlab.rl_config.renderPMBackend = 'rlPyCairo'
|
|
any of the methods detailed in reportlab/rl_config.py
|
|
can 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 the
|
|
rendering of scaled images and the speed with which it draws
|
|
text.
|
|
|
|
At present the rlPyCairo backend only uses the _renderPM extension
|
|
to use its mapping of ReportLab font names to extract paths for
|
|
rendering this is no doubt the reason for its slowness when
|
|
rendering text.
|
|
|
|
Currently we are not making use of any of the more advanced
|
|
abilities of PyCairo such as transparency, patterns etc,
|
|
but that may change in the future.
|
|
|
|
Contents of this file:
|
|
|
|
1. Licensing
|
|
|
|
2. Installation
|
|
|
|
2.1 General Prerequisites
|
|
|
|
2.2 Source Distribution mercurial
|
|
|
|
|
|
3. Prerequisites / Dependencies
|
|
|
|
4. Documentation
|
|
|
|
5. Tests
|
|
|
|
6. Acknowledgements and Thanks
|
|
|
|
|
|
1. 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 reportlab
|
|
and ideally PIL or Pillow with Freetype support; more notes on prerequisites
|
|
follow below.
|
|
|
|
2.2. Where to get the code
|
|
------------------------------------------
|
|
Latest sources are available from ReportLab's
|
|
open source download area::
|
|
|
|
https://hg.reportlab.com/hg-pulic/rlPyCairo
|
|
|
|
You can obtain the latest code from our Mercurial repository with::
|
|
|
|
hg clone https://hg.reportlab.com/hg-public/rlPyCairo
|
|
|
|
All released packages are available from our pypi at
|
|
|
|
https://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 at
|
|
|
|
https://github.com/MrBitBucket/rlPyCairo-mirror
|
|
|
|
please do not use this for issue reporting etc; use the mail list at
|
|
|
|
https://pairlist2.pair.net/mailman/listinfo/reportlab-users
|
|
|
|
|
|
3. Prerequisites / Dependencies
|
|
===============================
|
|
This works with Python versions 2.7 or >=3.6. Older versions are available
|
|
going back to Python 1.5 or thereabouts.
|
|
|
|
There are no absolute prerequisites beyond the Python
|
|
standard 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 package
|
|
about the standard renderPM renderer. This package is intended as an
|
|
alternative to the lgpl_libart based backend reportlab.graphics._renderPM.
|
|
|
|
To enable this backend the reportlab.rl_config.renderPMBackend should be set
|
|
to the string 'rlPyCairo'. Use any of the methods outlined in
|
|
reportlab/rl_config.py to accomplish this.
|
|
|
|
5. Test suite
|
|
=============
|
|
Tests are in the ``reportlab/tests/`` directory. They can be executed by cd'ing into the
|
|
directory and executing ``python runAll.py`` with an environment variable
|
|
set as RL_renderPMBackend=rlPyCairo. Obviously you need to have rlPyCairo
|
|
installed.
|
|
|
|
5.1 Building
|
|
============
|
|
python setup.py sdist to make a tar.gz package in folder dist.
|
|
pip wheel -w dist . --no-deps to make a wheel in folder dist.
|
|
|
|
6. Acknowledgements and Thanks
|
|
==============================
|
|
Claude Paroz for failing examples of the base backend.
|