Release candidate for PyMuPDF-1.21.0: PyMuPDF-1.21.0rc1

Install with: python -m pip install pymupdf==1.21.0rc1

• Uses mupdf-1.21.0-rc1.
• New Story support.
• Added wheels for Python-3.11.
• Docs: https://pymupdf.readthedocs.io/en/1.21.0rc1/
  • Changelog: https://pymupdf.readthedocs.io/en/1.21.0rc1/changes.html

PyMuPDF-1.20.2

• Built with MuPDF-1.20.3.
• Fix #1787.
• Fix #1824.
• Improvements to documentation:
  • Moved old docs/faq.rst into separate docs/recipes-* files.
  • Improved information about building from source in docs/installation.rst.
  • Clarified memory allocation setting JM_MEMORY in docs/tools.rst.
  • Fixed link to PDF Reference manual in docs/app3.rst.
  • Fixed building of html documentation on OpenBSD.

Wheels for Windows, Linux and MacOS, and the sdist, are available on pypi.org and can be installed in the usual way, for example:

pip install --upgrade pymupdf

PyMuPDF-1.20.1

• Fix #1724.
• Fix #1771.
• Fix #1751.
• Fix #1645.
• Improvements to sphinx-generated documentation.

PyMuPDF-1.20.0

This release integrates the recently-released MuPDF-1.20.0, and has fixes for #1733 and #1738. The latter also contains an additional fix for occasional SEGVs when freeing documents.

Building from source works slightly differently from before:

• We now automatically download the required MuPDF source and build it into PyMuPDF.
• Python sdists (source distributions) already contain the required MuPDF source and build without downloading.
• One can override the default build behaviour by setting environmental variables, for example to build with a system-installed mupdf. See the doc-comment at the start of setup.py for details.

Bug fixes and minor enhancements

Fixes:
#1620, #1601

Enhancements:

• new method Page.load_widget() to load a widget from its xref
• new dictionary pdfcolor which contains 500 predefined PDF colors
• Quad class supports operator algebra
• text search and extraction default flags now accessible as predefined constants
• iterators Page.annots() and Page.widgets() now prohibit reloading the page within their scope
• removed multiple utility functions from the Tools class and redefined them as standalone
• Parameter new in Document.update_stream() is now obsolete.

Bug fixes and, minor enhancements

Fixes: #1583, #1552, #1550, #1521, #1518, #1513, #1510, #1417, #1550.
Also fixed some undocumented errors that caused the span["origin"] to be incorrectly set in corner cases.

Added new items "orientation" and associated transformtion matrix to the output of fitz.image_properties(), which contains EXIF data of supporting image files.

A new method Document.xref_copy() allows making xref objects duplicates of each other.

Minor bug fixes and enhancements

Fixes: #1505, #1484, #1479, #1474.

Changes:

• Full support of PDF page rectangles like /ArtBox etc.
• New global variable TESSDATA_PREFIX for comfortably checking presence of OCR support
• Changed Document.xref_set_key() such that dictionary keys will physically be removed if set to value "null".
• Changed Document.extract_font() to optionally return a dictionary (instead of a tuple).

New features for class Pixmap and several fixes

Fixes:
#1351, #1417, #1418, #1430, #1433

• New or changed Pixmap methods color_topusage(), color_count(), warp(). Some of them solve #1397.
• New Annot method and property irt_xref, set_irt_xref(). Implements #1450.
• New Rect / IRect method torect() which creates a matrix to transform between given rectangles.
• Page.get_texttrace() now also supports non-horizontal text.

Improvements for drawings extraction and bug fixes

Improvements:

• Page.get_drawings() now includes area orientation for rectangles
• Page pixmap creation has a new parameter "dpi"
• New check for monochrome / unicolor pixmaps and number of colors

Fixes:
#1388, #1375, #1364, #1342, #1355, #1397, #1408.

Important improvements for OCR support

OCR of a document page has been improved a lot compared to v1.19.0.
Text extractions now also come with an integrated sort.
Fixes: #1328