Change Log

==========

**Changes in version 2.1** (2026-11-02)

Fixed issues:

* **Fixed** `5196 <https://github.com/pymupdf/PyMuPDF/issues/5196>`_: PyMuPDF 2.0 eagerly initializes layout on import, increasing CPU and thread overhead in spawned workers

* **Fixed** `5214 <https://github.com/pymupdf/PyMuPDF/issues/5214>`_: get_label() and get_page_labels() mangle page-label prefixes that contain '/', string escapes or UTF-16 text

* **Fixed** `5216 <https://github.com/pymupdf/PyMuPDF/issues/5216>`_: Documentation: Mention PDF rotation in Page.show_pdf() documentation

* **Fixed** `5220 <https://github.com/pymupdf/PyMuPDF/issues/5220>`_: Page.get_texttrace(): character bbox height follows X scale instead of Y scale

Other:

* Improve upgrade from 1.x to 2.x via pymupdf4llm or pymupdf_layout.

* Reduced startup time using lazy internal import of large modules.

* Retrospectively added date of 2.0 release.

* Retrospectively marked #5115 as fixed in 2.0.

* Use MuPDF-1.28.6.

**Changes in version 2.0** (2026-10-19)

Fixed issues:

* **Fixed** `4994 <https://github.com/pymupdf/PyMuPDF/issues/4994>`_: Dehyphenate does no longer work since 1.27.1

* **Fixed** `5054 <https://github.com/pymupdf/PyMuPDF/issues/5054>`_: clean_contents(sanitize=True) drops glyph positioning, duplicating an overprinted leading glyph (regression in 1.28.0 from 1.27.2.3)

* **Fixed** `5055 <https://github.com/pymupdf/PyMuPDF/issues/5055>`_: insert_file(...) breaks radio button groups

* **Fixed** `5059 <https://github.com/pymupdf/PyMuPDF/issues/5059>`_: Annotations disappear or move when using Page.remove_rotation() for 90 or 270 rotated pages

* **Fixed** `5067 <https://github.com/pymupdf/PyMuPDF/issues/5067>`_: Memory leak in extractBLOCKS (_as_blocks): text object reference never released

* **Fixed** `5077 <https://github.com/pymupdf/PyMuPDF/issues/5077>`_: Page.remove_rotation() takes minutes on pages with thousands of links

* **Fixed** `5082 <https://github.com/pymupdf/PyMuPDF/issues/5082>`_: Regression in 1.28.x: get_pixmap() and get_text() hang at 100% CPU on a specific PDF; works in 1.27.2.3

* **Fixed** `5100 <https://github.com/pymupdf/PyMuPDF/issues/5100>`_: Import of fitz prints to console instead of generating a DeprecationWarning

* **Fixed** `5101 <https://github.com/pymupdf/PyMuPDF/issues/5101>`_: Cyclic Widget /Parent makes page operations fail with FzErrorFormat: code=7: cycle in resources

* **Fixed** `5108 <https://github.com/pymupdf/PyMuPDF/issues/5108>`_: Page.clip_to_rect() drops 'sh' (shading) operators

* **Fixed** `5112 <https://github.com/pymupdf/PyMuPDF/issues/5112>`_: Stack-based buffer overflow in JM_set_annot_callout_line

* **Fixed** `5115 <https://github.com/pymupdf/PyMuPDF/issues/5115>`_: Pixmap export 'unmultiply' option has no effect

* **Fixed** `5122 <https://github.com/pymupdf/PyMuPDF/issues/5122>`_: get_drawings() reports a wrong start point for a subpath following a re with negative width/height

* **Fixed** `5125 <https://github.com/pymupdf/PyMuPDF/issues/5125>`_: get_pixmap() never returns on a tagged PDF page with many MCIDs - pdf_lookup_mcid_in_mcids is a linear scan, making rendering O(n**2) per page

* **Fixed** `5140 <https://github.com/pymupdf/PyMuPDF/issues/5140>`_: Page.get_label() raises IndexError when the page precedes the first label definition

* **Fixed** `5152 <https://github.com/pymupdf/PyMuPDF/issues/5152>`_: apply_redactions() does not remove text shown with the ' operator after TL + Td (regression in 1.28)

* **Fixed** `5154 <https://github.com/pymupdf/PyMuPDF/issues/5154>`_: insert_pdf raises ValueError: <xref> is not in list when a widget's /Parent does not list it in /Kids

* **Fixed** `5165 <https://github.com/pymupdf/PyMuPDF/issues/5165>`_: Page.add_widget fails for radio buttons

Other:

* Added support for form field hierarchies.

* Added support for radio button groups.

* Added support for widget aliases.

* Fixed builds with swig-4.5.

* Fixed `https://bugs.ghostscript.com/show_bug.cgi?id=709683`_ Path Traversal and Arbitrary File Write in PyMuPDF CLI Font Extraction (CVE-2026-82035)

* Fixed ignoring aspect ratio for square images.

* Fixed potential SEGV in pymupdf.Page.get_cdrawings() if callback raises exception.

* Fixed use with python-3.15.

* Remove the debug timing loop from `Annot.update()`.

* Retrospectively marked #3478 fixed in 1.25.3.

* Retrospectively marked #4158 fixed in 1.27.2.2

* Retrospectively marked #4896 fixed in 1.28.0.

* Retrospectively marked #4918 fixed in 1.28.0.

* Supported Python versions are now 3.11-3.15.

* Use MuPDF-1.28.5.

* Warning for use of deprecated `fitz` API now uses `warnings.warn()` with `FutureWarning`.

**Changes in version 1.28.2** (2026-08-06)

Fixed issues:

* **Fixed** `4670 <https://github.com/pymupdf/PyMuPDF/issues/4670>`_: scrub fails to remove hidden text after clean_contents stopped including line breaks (\u2265 1.24.0)

* **Fixed** `4943 <https://github.com/pymupdf/PyMuPDF/issues/4943>`_: enh: applying redactions with image cropping for currently unsupported colorspaces

* **Fixed** `5030 <https://github.com/pymupdf/PyMuPDF/issues/5030>`_: find_tables() with layout enabled can return a zero-cell Table, and Table.bbox then raises "ValueError: min() iterable argument is empty"

* **Fixed** `5042 <https://github.com/pymupdf/PyMuPDF/issues/5042>`_: Page.get_texttrace() leaks None references \u2014 Fatal Python error (none_dealloc) in long-running processes (1.27.2.3 & 1.28.0)

* **Fixed** `5044 <https://github.com/pymupdf/PyMuPDF/issues/5044>`_: Outline (TOC) parsing bug

* **Fixed** `5049 <https://github.com/pymupdf/PyMuPDF/issues/5049>`_: font subsetting segfaults in 1.28.0, regression from 1.27.2.2 #5049

* **Fixed** `5056 <https://github.com/pymupdf/PyMuPDF/issues/5056>`_: Option for reproducible/deterministic save output (omit MuPDF version banner + Producer)

Other:

* Use MuPDF-1.28.2.

* Output warning when legacy `fitz` module is imported.

* Cope better with markdown containing illegal utf8 sequences.

* Fixed building with PYMUPDF_SETUP_MUPDF_VS_UPGRADE.

* pymupdf.Page.find_tables():

* new args `use_layout: bool = True` `union: bool = False` `refine: bool = False`.

* Improved speed.

* Retrospectively added fix for #4936 in release 1.28.0 below.

* Added windows-arm64 wheel.

**Changes in version 1.28.0** (2026-06-29)

Fixed issues:

* **Fixed** `4114 <https://github.com/pymupdf/PyMuPDF/issues/4114>`_: ComboBox choice_values full of empty strings despite PDF having valid choices.

* **Fixed** `4950 <https://github.com/pymupdf/PyMuPDF/issues/4950>`_: remove_rotation() raises ValueError on widgets with empty/infinite rects

* **Fixed** `5001 <https://github.com/pymupdf/PyMuPDF/issues/5001>`_: Formulae incorrectly rendered as black boxes

* **Fixed** `5033 <https://github.com/pymupdf/PyMuPDF/issues/5033>`_: Annot.set_rotation(0) followed by Annot.update() throws AttributeError

* **Fixed** `4936 <https://github.com/pymupdf/PyMuPDF/issues/4936>`_: bug: incomplete redaction of vector graphics (line art)

* **Fixed** `4896 <https://github.com/pymupdf/PyMuPDF/issues/4896>`_: write_images() and saving with garbage>1 spoils fonts (xrefs)

Other:

* Use MuPDF-1.28.0.

* pymupdf.Document.__init__(): new arg `archive` to support documents with archives.

* pymupdf.Document.convert_to_pdf(): also generate links.

* Fixed MacOS x64 platform tag - used to be macosx_10_9_x86_64, but we actually

require MacOS 10.15, so platform tag is now macosx_10_15_x86_64.

* Support Windows builds with free thread python.

* pymupdf.Document.save() now saves non-PDF documents in PDF format.

* New method pymupdf.Document.apply_css().

* Pyodide wheel is available on pypi.org.

**Changes in version 1.27.2.3** (2026-04-24)

* Fixed issues:

* **Fixed** `4928 <https://github.com/pymupdf/PyMuPDF/issues/4928>`_: pymupdf.Document.scrub raises AttributeError for a document with annotations

* **Fixed** `4942 <https://github.com/pymupdf/PyMuPDF/issues/4942>`_: bug: IndexError for Page.get_links after Page.clip_to_rect

* **Fixed** `4954 <https://github.com/pymupdf/PyMuPDF/issues/4954>`_: get_drawings() returns incorrect lineJoin and width

* **Fixed** `4958 <https://github.com/pymupdf/PyMuPDF/issues/4958>`_: bug: inserting rotated pages to another document messes up link coordinates

* Other:

* Fixed incorrect generation of `lineJoin j` in PDF content, introduced in 1.27.2.2.

* Allow build to (incorrectly) claim to be thread-safe, for #4760. See setup.py for details.

* Use pypi.org's pipcl package instead of our own pipcl.py file.

**Changes in version 1.27.2.2** (2026-03-20)

* Fixed issues:

* **Fixed** `4902 <https://github.com/pymupdf/PyMuPDF/issues/4902>`_: Incorrect linewidth in elements returned by Page.get_texttrace()

* **Fixed** `4932 <https://github.com/pymupdf/PyMuPDF/issues/4932>`_: "Page" has no attribute "find_tables" in PyMuPDF 1.27

* **Fixed** `4158 <https://github.com/pymupdf/PyMuPDF/issues/4158>`_: PyMuPDF Pro 1.25.0: Some graphical elements of a .docx file not visible with get_pixmap()

* Other:

* Added `Annot.__bool__()`.

**Changes in version 1.27.2** (2026-03-10)

* Use MuPDF-1.27.2.

* Fixed issues:

* **Fixed** `4903 <https://github.com/pymupdf/PyMuPDF/issues/4903>`_: Typing broken because of `*_forward_decl`

* **Fixed** `3842 <https://github.com/pymupdf/PyMuPDF/issues/3842>`_: Partial OCR using "get_textpage_ocr" ignores image masks while extracting text

* Other:

* Retrospectively marked #4907 as fixed in pymupdf-1.27.1.

* Improved `get_textpage_ocr()`.

For partial OCR, **all** page areas outside legible text are now OCRed, not

just those within images. This means that OCR will now also be performed

for vector graphics, and for text containing illegible characters.

* Provide a Linux wheel for free-threading python,

specifically cp314-cp314t-manylinux_2_28_x86_64.

**Changes in version 1.27.1** (2026-02-11)

* Use MuPDF-1.27.1.

* Fixed issues:

* **Fixed** `4599 <https://github.com/pymupdf/PyMuPDF/issues/4599>`_: page.cluster_drawings extract a lot of small clusters once upgraded to 1.26

* **Fixed** `4751 <https://github.com/pymupdf/PyMuPDF/issues/4751>`_: Memory leaking in page.widgets()

* **Fixed** `4762 <https://github.com/pymupdf/PyMuPDF/issues/4762>`_: Importing pymupdf make pillow segmentation fault for converting jp2 file on ArchLinux

* **Fixed** `4790 <https://github.com/pymupdf/PyMuPDF/issues/4790>`_: Problem to delete pages on PDF

* **Fixed** `4857 <https://github.com/pymupdf/PyMuPDF/issues/4857>`_: Package is missing py.typed file required for type checking

* **Fixed** `4886 <https://github.com/pymupdf/PyMuPDF/issues/4886>`_: <IMG> width attribute behaviour seems wrong

* **Fixed** `4907 <https://github.com/pymupdf/PyMuPDF/issues/4907>`_: signal 11:SIGSEGV while using display_list.get_textpage()

* Other:

* Added `pymupdf.TEXT_CLIP`.

* Removed support for mupdf < 1.26.

* New arg `raise_on_repair` in `Document.save()`.

* New method `Document.repair()`.

**Changes in version 1.26.7** (2025-12-11)

* Use MuPDF-1.26.12.

* **Fixed** `4801 <https://github.com/pymupdf/PyMuPDF/issues/4801>`_: Build failure dumping all environment variables

Other:

* Retrospectively mark `4756 <https://github.com/pymupdf/PyMuPDF/issues/4756>`_ as fixed in 1.26.6.

* Improved safety of `pymupdf embed-extract`. This now refuses to write to

an existing file or outside current directory, unless `-output` or new flag

`-unsafe` is specified.

**Changes in version 1.26.6** (2025-11-05)

* Use MuPDF-1.26.11.

* Supported Python versions are now 3.10-3.14.

* Fixed issues:

* **Fixed** `4699 <https://github.com/pymupdf/PyMuPDF/issues/4699>`_: cannot find ExtGState resource

* **Fixed** `4712 <https://github.com/pymupdf/PyMuPDF/issues/4712>`_: Crash with "corrupted double-linked list"

* **Fixed** `4720 <https://github.com/pymupdf/PyMuPDF/issues/4720>`_: Memory leaking in rewrite_images?

* **Fixed** `4742 <https://github.com/pymupdf/PyMuPDF/issues/4742>`_: 'Rect' object has no attribute 'get_area'

* **Fixed** `4746 <https://github.com/pymupdf/PyMuPDF/issues/4746>`_: Document.__init__() got an unexpected keyword argument 'encoding'

* **Fixed** `4756 <https://github.com/pymupdf/PyMuPDF/issues/4756>`_: swig --version doesn't work in all versions of swig; -version should be used instead

**Changes in version 1.26.5** (2025-10-10)

* Use MuPDF-1.26.10.

* Fixed issues:

* **Fixed** `2883 <https://github.com/pymupdf/PyMuPDF/issues/2883>`_: Improve the Python type annotations for fitz_new

* **Fixed** `4507 <https://github.com/pymupdf/PyMuPDF/issues/4507>`_: Bugs in pyodide

* **Fixed** `4613 <https://github.com/pymupdf/PyMuPDF/issues/4613>`_: Thai and number blocks are not auto-scaled and get wrong hyphen when using in insert_htmlbox

* **Fixed** `4700 <https://github.com/pymupdf/PyMuPDF/issues/4700>`_: pymupdf.open() processes .zip file without raising

* **Fixed** `4716 <https://github.com/pymupdf/PyMuPDF/issues/4716>`_: Problems with unreadable characters

* Other:

* Supported Python versions are now 3.9-3.14.

* We now define all class methods explicitly instead of with dynamic assignment; this improves type hints.

* Removed `pymupdf.utils.Shape` class, was duplicate of `pymupdf.Shape`.

* Allow use of cibuildwheel to build and test on Pyodide.

* Fixed various Pyodide bugs.

* In documentation, added section about Linux wheels and glibc compatibility.

* Improved documentation of pymupdf.open()'s <filetype> arg.

* Retrospectively mark `4544 <https://github.com/pymupdf/PyMuPDF/issues/4544>`_ as fixed in 1.26.4.

**Changes in version 1.26.4 (2025-08-25)**

* Use MuPDF-1.26.7.

* Fixed issues:

* **Fixed** `3806 <https://github.com/pymupdf/PyMuPDF/issues/3806>`_: pdf to image rendering ignore optional content offs

* **Fixed** `4388 <https://github.com/pymupdf/PyMuPDF/issues/4388>`_: Incorrect PixMap from page due to cached data from other PDF

* **Fixed** `4457 <https://github.com/pymupdf/PyMuPDF/issues/4457>`_: Wrong characters displayed after font subsetting (w/ native method)

* **Fixed** `4462 <https://github.com/pymupdf/PyMuPDF/issues/4462>`_: delete_pages() does not accept a single int

* **Fixed** `4533 <https://github.com/pymupdf/PyMuPDF/issues/4533>`_: Open PDF error segmentation fault

* **Fixed** `4544 <https://github.com/pymupdf/PyMuPDF/issues/4544>`_: About pdf_clip_page

* **Fixed** `4565 <https://github.com/pymupdf/PyMuPDF/issues/4565>`_: MacOS uses Tesseract and not Tesseract-OCR

* **Fixed** `4571 <https://github.com/pymupdf/PyMuPDF/issues/4571>`_: Broken merged pdfs.

* **Fixed** `4590 <https://github.com/pymupdf/PyMuPDF/issues/4590>`_: TypeError in utils.py scrub(): annot.update_file(buffer=...) is invalid

* **Fixed** `4614 <https://github.com/pymupdf/PyMuPDF/issues/4614>`_: Intercept bad widgets when inserting to another PDF

* **Fixed** `4639 <https://github.com/pymupdf/PyMuPDF/issues/4639>`_: pymupdf.mupdf.FzErrorGeneric: code=1: Director error: <class 'AttributeError'>: 'JM_new_bbox_device_Device' object has no attribute 'layer_name'

* Other:

* Check that #4392 `Segfault when running with pytest and -Werror` is fixed if PyMuPDF is built with swig>=4.4.

* Add `Page.clip_to_rect()`.

* Improved search for Tesseract data.

* Retrospectively mark #4496 as fixed in 1.26.1.

* Retrospectively mark #4503 as fixed in 1.26.3.

* Added experimental support for Graal.

**Changes in version 1.26.3 (2025-07-02)**

* Use MuPDF-1.26.3.

* Fixed issues:

* **Fixed** `4462 <https://github.com/pymupdf/PyMuPDF/issues/4462>`_: delete_pages() does not accept a single int

* **Fixed** `4503 <https://github.com/pymupdf/PyMuPDF/issues/4503>`_: Undetected character styles

* **Fixed** `4527 <https://github.com/pymupdf/PyMuPDF/issues/4527>`_: Rect.intersects() is much slower than necessary

* **Fixed** `4564 <https://github.com/pymupdf/PyMuPDF/issues/4564>`_: Possible encoding issue in PDF metadata

* **Fixed** `4575 <https://github.com/pymupdf/PyMuPDF/issues/4575>`_: Bug with IRect contains method

* Other:

* Class Shape is now available as pymupdf.Shape.

* Added table cell markdown support.

**Changes in version 1.26.2**

[Skipped.]

**Changes in version 1.26.1 (2025-06-11)**

* Use MuPDF-1.26.2.

* Fixed issues:

* **Fixed** `4520 <https://github.com/pymupdf/PyMuPDF/issues/4520>`_: show_pdf_page does not like empty pages created by new_page

* **Fixed** `4524 <https://github.com/pymupdf/PyMuPDF/issues/4524>`_: fitz.get_text ignores 'pages' kwarg

* **Fixed** `4412 <https://github.com/pymupdf/PyMuPDF/issues/4412>`_: Regression? Spurious error? in insert_pdf in v1.25.4

* **Fixed** `4496 <https://github.com/pymupdf/PyMuPDF/issues/4496>`_: pymupdf4llm with pymupdfpro

* Other:

* Partial fix for `4503 <https://github.com/pymupdf/PyMuPDF/issues/4503>`_: Undetected character styles

* New method `Document.rewrite_images()`, useful for reducing file size, changing image formats, or converting color spaces.

* `Page.get_text()`: restrict positional args to match docs.

* Removed bogus definition of class `Shape`.

* Removed release date from module, docs and changelog.

* `pymupdf.pymupdf_date` and `pymupdf.VersionDate` are now both None.

* They will be removed in a future release.

**Changes in version 1.26.0 (2025-05-22)**

* Use MuPDF-1.26.1.

* Fixed issues:

* **Fixed** `4324 <https://github.com/pymupdf/PyMuPDF/issues/4324>`_: cluster_drawings() fails to cluster horizontal and vertical thin lines

* **Fixed** `4363 <https://github.com/pymupdf/PyMuPDF/issues/4363>`_: Trouble with searching

* **Fixed** `4404 <https://github.com/pymupdf/PyMuPDF/issues/4404>`_: IndexError in page.get_links()

* **Fixed** `4412 <https://github.com/pymupdf/PyMuPDF/issues/4412>`_: Regression? Spurious error? in insert_pdf in v1.25.4

* **Fixed** `4423 <https://github.com/pymupdf/PyMuPDF/issues/4423>`_: pymupdf.mupdf.FzErrorFormat: code=7: cannot find object in xref error encountered after version 1.25.3

* **Fixed** `4435 <https://github.com/pymupdf/PyMuPDF/issues/4435>`_: get_pixmap method stuck on one page

* **Fixed** `4439 <https://github.com/pymupdf/PyMuPDF/issues/4439>`_: New Xml class from data does not work - bug in code

* **Fixed** `4445 <https://github.com/pymupdf/PyMuPDF/issues/4445>`_: Broken XREF table incorrectly repaired

* **Fixed** `4447 <https://github.com/pymupdf/PyMuPDF/issues/4447>`_: Stroke color of annotations cannot be correctly set

* **Fixed** `4479 <https://github.com/pymupdf/PyMuPDF/issues/4479>`_: set_layer_ui_config() toggles all layers rather than just one

* **Fixed** `4505 <https://github.com/pymupdf/PyMuPDF/issues/4505>`_: Follow Widget flag values up its parent structure

* Other:

* Partial fixed for `4457 <https://github.com/pymupdf/PyMuPDF/issues/4457>`_: Wrong characters displayed after font subsetting (w/ native method)

* Support image stamp annotations.

* Support recoloring pages.

* Added example of using Django's file storage API to open files with pymupdf.

* Clarified FreeText annotation color options.

We now raise an exception if an attempt is made to set attributes that can not be supported.

* Fixed potential segv in Pixmap.is_unicolor().

* Added runtime assert that that PyMuPDF and MuPDF were built with compatible

NDEBUG settings (related to `4390 <https://github.com/pymupdf/PyMuPDF/issues/4390>`_).

* Simplified handling of filename/filetype when opening documents.

* Removed PDF linearization support.

* Calls to `Document.save()` with `linear` set to true will now raise an exception.

* See https://artifex.com/blog/mupdf-removes-linearisation for more information.

**Changes in version 1.25.5 (2025-03-31)**

* Fixed issues:

* **Fixed** `4372 <https://github.com/pymupdf/PyMuPDF/issues/4372>`_: Text insertion fails due to missing /Resources object

* **Fixed** `4400 <https://github.com/pymupdf/PyMuPDF/issues/4400>`_: Infinite loop in fill_textbox

* **Fixed** `4403 <https://github.com/pymupdf/PyMuPDF/issues/4403>`_: Unable to get_text() - layer/clip nesting too deep

* **Fixed** `4415 <https://github.com/pymupdf/PyMuPDF/issues/4415>`_: PDF page is mirrored, origin is at bottom-left

* Other:

* Use MuPDF-1.25.6.

* Fixed MuPDF SEGV on MacOS with particular fonts.

* Fixed `Annot.get_textpage()`'s `clip` arg.

* Fixed Python-3.14 (pre-release) build error.

**Changes in version 1.25.4 (2025-03-14)**

* Use MuPDF-1.25.5.

* Fixed issues:

* **Fixed** `4079 <https://github.com/pymupdf/PyMuPDF/issues/4079>`_: Unexpected result for apply_redactions()

* **Fixed** `4224 <https://github.com/pymupdf/PyMuPDF/issues/4224>`_: MuPDF error: format error: negative code in 1d faxd

* **Fixed** `4303 <https://github.com/pymupdf/PyMuPDF/issues/4303>`_: page.get_image_info() returns outdated cached results after replacing image

* **Fixed** `4309 <https://github.com/pymupdf/PyMuPDF/issues/4309>`_: FzErrorFormat Error When Deleting First Page

* **Fixed** `4336 <https://github.com/pymupdf/PyMuPDF/issues/4336>`_: Major Performance Regression: pix.color_count is 150x slower in version 1.25.3 compared to 1.23.8

* **Fixed** `4341 <https://github.com/pymupdf/PyMuPDF/issues/4341>`_: Invalid label retrieval when /Kids is an array of multiple /Nums

* Other:

* Fixed handling of duplicate widget names when joining PDFs (PR #4347).

* Improved Pyodide build.

* Avoid SWIG-related build errors with Python-3.13 by disabling PY_LIMITED_API.

**Changes in version 1.25.3 (2025-02-06)**

* Use MuPDF-1.25.4.

* Fixed issues:

* **Fixed** `4139 <https://github.com/pymupdf/PyMuPDF/issues/4139>`_: Text color numbers change between 1.24.14 and 1.25.0

* **Fixed** `4141 <https://github.com/pymupdf/PyMuPDF/issues/4141>`_: Some insertion methods fails for pages without a /Resources object

* **Fixed** `4180 <https://github.com/pymupdf/PyMuPDF/issues/4180>`_: Search problems

* **Fixed** `4182 <https://github.com/pymupdf/PyMuPDF/issues/4182>`_: Text coordinate extraction error

* **Fixed** `4245 <https://github.com/pymupdf/PyMuPDF/issues/4245>`_: Highlighting issue distorted on recent versions

* **Fixed** `4254 <https://github.com/pymupdf/PyMuPDF/issues/4254>`_: add_freetext_annot is drawing text outside the annotation box

* **Fixed** `3478 <https://github.com/pymupdf/PyMuPDF/issues/3478>`_: Page.delete_widget() doesn't fully remove the widget, other programs still detect the widgets

* Other:

* In annotations:

* Added support for subtype FreeTextCallout.

* Added support for rich text.

* Added miter_limit arg to insert_text*() to allow suppression of spikes caused by long miters.

* Add Widget Support to `Document.insert_pdf()`.

* Add `bibi` to span dicts.

* Add `synthetic' to char dict.

* Fixed Pyodide builds.

**Changes in version 1.25.2 (2025-01-17)**

* Fixed issues:

* **Fixed** `4055 <https://github.com/pymupdf/PyMuPDF/issues/4055>`_: "Yes" for all checkboxes does not work for all PDF rendering engines.

* **Fixed** `4155 <https://github.com/pymupdf/PyMuPDF/issues/4155>`_: samples_mv is unsafe

* **Fixed** `4162 <https://github.com/pymupdf/PyMuPDF/issues/4162>`_: Got AttributeError, when tried to add Signature field

* **Fixed** `4186 <https://github.com/pymupdf/PyMuPDF/issues/4186>`_: Incorrect handling of JPEG with color space CMYK image extraction

* **Fixed** `4195 <https://github.com/pymupdf/PyMuPDF/issues/4195>`_: Pixmaps that are inverted and have an alpha channel are not rendered properly

* **Fixed** `4225 <https://github.com/pymupdf/PyMuPDF/issues/4225>`_: pixmap.pil_save() fails due to colorspace definition

* **Fixed** `4232 <https://github.com/pymupdf/PyMuPDF/issues/4232>`_: Incorrect Font style and Size

* Other:

* Use Python's built-in glyphname <> unicode conversion.

* Improve speed of pixmap color inversion.

* Add new `char_flags` member to span dictionary, for example allows detection of invisible text.

* Detect image masks in TextPage output.

* Added `Pixmap.pil_image()`.

**Changes in version 1.25.1 (2024-12-11)**

* Use MuPDF-1.25.2.

* Fixed issues:

* **Fixed** `4125 <https://github.com/pymupdf/PyMuPDF/issues/4125>`_: memory leak while convert Pixmap's colorspace

* **Fixed** `4034 <https://github.com/pymupdf/PyMuPDF/issues/4034>`_: Possible regression in pdf cleaning during save.

**Changes in version 1.25.0 (2024-12-05)**

* Use MuPDF-1.25.1.

* Fixed issues:

* **Fixed** `4026 <https://github.com/pymupdf/PyMuPDF/issues/4026>`_: page.get_text('blocks') output two piece of very similar text with different bbox

* **Fixed** `4004 <https://github.com/pymupdf/PyMuPDF/issues/4004>`_: Segmentation Fault When Updating PDF Form Field Value

* **Fixed** `3887 <https://github.com/pymupdf/PyMuPDF/issues/3887>`_: Subset Fonts problem using Fallback Font

* **Fixed** `3886 <https://github.com/pymupdf/PyMuPDF/issues/3886>`_: Another issue with destroying PDF when inserting html

* **Fixed** `3751 <https://github.com/pymupdf/PyMuPDF/issues/3751>`_: apply_redactions causes part of the page content to be hidden / transparent

.. codespell:ignore-begin

**Changes in version 1.24.14 (2024-11-19)**

* Use MuPDF-1.24.11.

* Fixed issues:

* **Fixed** `3448 <https://github.com/pymupdf/PyMuPDF/issues/3448>`_: get_pixmap function removes the table and leaves just the content behind

* **Fixed** `3758 <https://github.com/pymupdf/PyMuPDF/issues/3758>`_: Got "malloc(): unaligned tcache chunk detected Aborted (core dumped)" while using add_redact_annot/apply_redactions

* **Fixed** `3813 <https://github.com/pymupdf/PyMuPDF/issues/3813>`_: Stories: Ordered list count broken with nested unordered list

* **Fixed** `3933 <https://github.com/pymupdf/PyMuPDF/issues/3933>`_: font.valid_codepoints() - malfunction

* **Fixed** `4018 <https://github.com/pymupdf/PyMuPDF/issues/4018>`_: PyMuPDF hangs when iterating over zero page PDF pages backwards

* **Fixed** `4043 <https://github.com/pymupdf/PyMuPDF/issues/4043>`_: fullcopypage bug

* **Fixed** `4047 <https://github.com/pymupdf/PyMuPDF/issues/4047>`_: Segmentation Fault in add_redact_annot

* **Fixed** `4050 <https://github.com/pymupdf/PyMuPDF/issues/4050>`_: Content of dict returned by doc.embfile_info() does not fit to documentation

* Other:

* Ensure that words from `Page.get_text()` never contain RTL/LTR char mixtures.

* Fix building with system MuPDF.

* Add dot product for points and vectors.

**Changes in version 1.24.13 (2024-10-29)**

* Fixed issues:

* **Fixed** `3848 <https://github.com/pymupdf/PyMuPDF/issues/3848>`_: Piximap program crash

* **Fixed** `3950 <https://github.com/pymupdf/PyMuPDF/issues/3950>`_: Unable to consistently extract field labels from PDFs

* **Fixed** `3981 <https://github.com/pymupdf/PyMuPDF/issues/3981>`_: PyMuPDF 1.24.12 with pyinstaller throws error.

* **Fixed** `3994 <https://github.com/pymupdf/PyMuPDF/issues/3994>`_: pix.color_topusage raise Segmentation fault (core dumped)

**Changes in version 1.24.12 (2024-10-21)**

* Fixed issues:

* **Fixed** `3914 <https://github.com/pymupdf/PyMuPDF/issues/3914>`_: Ability to print MuPDF errors to logging instead of stdout

* **Fixed** `3916 <https://github.com/pymupdf/PyMuPDF/issues/3916>`_: insert_htmlbox error: int too large to convert to float

* **Fixed** `3950 <https://github.com/pymupdf/PyMuPDF/issues/3950>`_: Unable to consistently extract field labels from PDFs

* Supported Python versions are now 3.9-3.13.

* Dropped support for Python-3.8 because end-of-life.

* Added support for Python-3.13 because now released.

* See: https://devguide.python.org/versions/

**Changes in version 1.24.11 (2024-10-03)**

* Use MuPDF-1.24.10.

* Fixed issues:

* **Fixed** `3624 <https://github.com/pymupdf/PyMuPDF/issues/3624>`_: Pdf file transform to image have a black block

* **Fixed** `3859 <https://github.com/pymupdf/PyMuPDF/issues/3859>`_: doc.need_appearances() fails with "AttributeError: module 'pymupdf.mupdf' has no attribute 'PDF_TRUE' "

* **Fixed** `3863 <https://github.com/pymupdf/PyMuPDF/issues/3863>`_: apply_redactions() does not work as expected

* **Fixed** `3905 <https://github.com/pymupdf/PyMuPDF/issues/3905>`_: open stream can raise a FzErrorFormat error instead of FileDataError

* Wheels now use the Python Stable ABI:

* There is one PyMuPDF wheel for each platform.

* Each wheel works with all supported Python versions.

* Each wheel is built using the oldest supported Python version (currently 3.8).

* There is no PyMuPDFb wheel.

* Other:

* Improvements to get_text_words() with sort=True.

* Tests now always get the latest versions of required Python packages.

* Removed dependency on setuptools.

* Added item to PyMuPDF-1.24.10 changes below - fix of #3630.

**Changes in version 1.24.10 (2024-09-02)**

* Use MuPDF-1.24.9.

* Fixed issues:

* **Fixed** `3450 <https://github.com/pymupdf/PyMuPDF/issues/3450>`_: get_pixmap function takes too long to process

* **Fixed** `3569 <https://github.com/pymupdf/PyMuPDF/issues/3569>`_: Invalid OCGs not ignored by SVG image creation

* **Fixed** `3603 <https://github.com/pymupdf/PyMuPDF/issues/3603>`_: ObjStm compression and PDF linearization doesn't work together

* **Fixed** `3650 <https://github.com/pymupdf/PyMuPDF/issues/3650>`_: Linebreak inserted between each letter

* **Fixed** `3661 <https://github.com/pymupdf/PyMuPDF/issues/3661>`_: Update Document to check the /XYZ len

* **Fixed** `3698 <https://github.com/pymupdf/PyMuPDF/issues/3698>`_: documentation issue - old code in the annotations documentation

* **Fixed** `3705 <https://github.com/pymupdf/PyMuPDF/issues/3705>`_: Document.select() behaves weirdly in some particular kind of pdf files

* **Fixed** `3706 <https://github.com/pymupdf/PyMuPDF/issues/3706>`_: extend Document.__getitem__ type annotation to reflect that the method also accepts slices

* **Fixed** `3727 <https://github.com/pymupdf/PyMuPDF/issues/3727>`_: Method get_pixmap() make the program exit without any exceptions or messages

* **Fixed** `3767 <https://github.com/pymupdf/PyMuPDF/issues/3767>`_: Cannot get Tessdata with Tesseract-OCR 5

* **Fixed** `3773 <https://github.com/pymupdf/PyMuPDF/issues/3773>`_: Link.set_border gives TypeError: '<' not supported between instances of 'NoneType' and 'int'

* **Fixed** `3774 <https://github.com/pymupdf/PyMuPDF/issues/3774>`_: fitz.__version__` does not work anymore

* **Fixed** `3789 <https://github.com/pymupdf/PyMuPDF/issues/3789>`_: ValueError: not enough values to unpack (expected 3, got 2) is thrown when call insert_pdf

* **Fixed** `3820 <https://github.com/pymupdf/PyMuPDF/issues/3820>`_: class improves namedDest handling

* **Fixed** `3630 <https://github.com/pymupdf/PyMuPDF/issues/3630>`_: page.apply_redactions gives unwanted black rectangle

* Other:

* Object streams and linearization cannot be used together; attempting to do

so will raise an exception. (#3603)

* Fixed handling of non-existing /Contents object.

**Changes in version 1.24.9 (2024-07-24)**

* Use MuPDF-1.24.8.

**Changes in version 1.24.8 (2024-07-22)**

* Fixed issues:

* **Fixed** `3636 <https://github.com/pymupdf/PyMuPDF/issues/3636>`_: API documentation for the open function is not obvious to find.

* **Fixed** `3654 <https://github.com/pymupdf/PyMuPDF/issues/3654>`_: docx parsing was broken in 1.24.7

* **Fixed** `3677 <https://github.com/pymupdf/PyMuPDF/issues/3677>`_: Unable to extract subset font name using the newer versions of PyMuPDF : 1.24.6 and 1.24.7.

* **Fixed** `3687 <https://github.com/pymupdf/PyMuPDF/issues/3687>`_: Page.get_text results in AssertionError for epub files

Other:

* Fixed various spelling mistakes spotted by codespell.

* Improved how we modify MuPDF's default configuration on Windows.

* Make text search to work with ligatures.

**Changes in version 1.24.7 (2024-06-26)**

* Fixed issues:

* **Fixed** `3615 <https://github.com/pymupdf/PyMuPDF/issues/3615>`_: Document.pagemode or Document.pagelayout crashes for epub files

* **Fixed** `3616 <https://github.com/pymupdf/PyMuPDF/issues/3616>`_: not last version reported

**Changes in version 1.24.6 (2024-06-25)**

* Use MuPDF-1.24.4

* Fixed issues:

* **Fixed** `3599 <https://github.com/pymupdf/PyMuPDF/issues/3599>`_: Story.fit_width() has a weird line

* **Fixed** `3594 <https://github.com/pymupdf/PyMuPDF/issues/3594>`_: Garbled extraction for Amazon Sustainability Report

* **Fixed** `3591 <https://github.com/pymupdf/PyMuPDF/issues/3591>`_: 'width' in Page.get_drawings() returns width equal as 0

* **Fixed** `3561 <https://github.com/pymupdf/PyMuPDF/issues/3561>`_: ZeroDivisionError: float division by zero with page.apply_redactions()

* **Fixed** `3559 <https://github.com/pymupdf/PyMuPDF/issues/3559>`_: SegFault 11 when empty H1 H2 H3 H4 etc element is used in insert_htmlbox

* **Fixed** `3539 <https://github.com/pymupdf/PyMuPDF/issues/3539>`_: Add dotted gridline detection to table recognition

* **Fixed** `3519 <https://github.com/pymupdf/PyMuPDF/issues/3519>`_: get_toc(simple=False) AttributeError: 'Outline' object has no attribute 'rect'

* **Fixed** `3510 <https://github.com/pymupdf/PyMuPDF/issues/3510>`_: page.get_label() gets wrong label on the first page of doc

* **Fixed** `3494 <https://github.com/pymupdf/PyMuPDF/issues/3494>`_: 1.24.2/1.24.3: spurious characters introduced when using subset_fonts and insert_pdf

* **Fixed** `3470 <https://github.com/pymupdf/PyMuPDF/issues/3470>`_: subset_fonts error exit without exception/warning

* **Fixed** `3400 <https://github.com/pymupdf/PyMuPDF/issues/3400>`_: set_toc alters link coordinates for some rotated pages on pymupdf 1.24.2

* **Fixed** `3347 <https://github.com/pymupdf/PyMuPDF/issues/3347>`_: Incorrect links to points on pages having different heights

* **Fixed** `3237 <https://github.com/pymupdf/PyMuPDF/issues/3237>`_: Set_metadata() does not work

* **Fixed** `3493 <https://github.com/pymupdf/PyMuPDF/discussions/3493>`_: Isolate PyMuPDF from other libraries; issues when PyMuPDF is loaded with other libraries like GdkPixbuf

* Other:

* Fixed concurrent use of PyMuPDF caused by use of constant temporary filenames.

* Add musllinux x86_64 wheels to release.

* Added clearer version information:

* `pymupdf.pymupdf_version`.

* `pymupdf.mupdf_version`.

* `pymupdf.pymupdf_date`.

**Changes in version 1.24.5 (2024-05-30)**

* Fixed issues:

* **Fixed** `3479 <https://github.com/pymupdf/PyMuPDF/issues/3479>`_: regression: fill_textbox: IndexError: pop from empty list

* **Fixed** `3488 <https://github.com/pymupdf/PyMuPDF/issues/3488>`_: set_toc method error

* Other:

* Some more fixes to use MuPDF floating formatting.

* Removed/disabled some unnecessary diagnostics.

* Fixed utils.do_links() crash.

* Experimental new functions `pymupdf.apply_pages()` and `pymupdf.get_text()`.

* Addresses wrong label generation for label styles "a" and "A".

**Changes in version 1.24.4 (2024-05-16)**

* **Fixed** `3418 <https://github.com/pymupdf/PyMuPDF/issues/3418>`_: Re-introduced bug, text align add_redact_annot

* **Fixed** `3472 <https://github.com/pymupdf/PyMuPDF/issues/3472>`_: insert_pdf gives SystemError

* Other:

* Fixed sysinstall test failing to remove all of prior installation before

new install.

* Fixed `utils.do_links()` crash.

* Correct `TextPage` creation Code.

* Unified various diagnostics.

* Fix bug in `page_merge()`.

**Changes in version 1.24.3 (2024-05-09)**

*

The Python module is now called `pymupdf`. `fitz` is still supported for

backwards compatibility.

* Use MuPDF-1.24.2.

* Fixed issues:

* **Fixed** `3357 <https://github.com/pymupdf/PyMuPDF/issues/3357>`_: PyMuPDF==1.24.0 will hanging when using page.get_text("text")

* **Fixed** `3376 <https://github.com/pymupdf/PyMuPDF/issues/3376>`_: Redacting results are not as expected in 1.24.x.

* **Fixed** `3379 <https://github.com/pymupdf/PyMuPDF/issues/3379>`_: Documentation mismatch for get_text_blocks return value order.

* **Fixed** `3381 <https://github.com/pymupdf/PyMuPDF/issues/3381>`_: Contents stream contains floats in scientific notation

* **Fixed** `3402 <https://github.com/pymupdf/PyMuPDF/issues/3402>`_: Cannot add Widgets containing inter-field-calculation JavaScript

* **Fixed** `3414 <https://github.com/pymupdf/PyMuPDF/issues/3414>`_: missing attribute set_dpi()

* **Fixed** `3430 <https://github.com/pymupdf/PyMuPDF/issues/3430>`_: page.get_text() cause process freeze with certain pdf on v1.24.2

* Other:

* New/modified methods:

* `Page.remove_rotation()`: new, set page rotation to zero while keeping appearance.

* Fixed some problems when checking for PDF properties.

* Fixed pip builds from sdist

(see discussion `3360 <https://github.com/pymupdf/PyMuPDF/discussions/3360>`_:

Alpine linux docker build failing "No matching distribution found for pymupdfb==1.24.1").

**Changes in version 1.24.2 (2024-04-17)**

* Removed obsolete classic implementation from releases

(previously available as module `fitz_old`).

* Fixed issues:

* **Fixed** `3331 <https://github.com/pymupdf/PyMuPDF/issues/3331>`_: Document.pages() is incorrectly type-hinted

* **Fixed** `3354 <https://github.com/pymupdf/PyMuPDF/issues/3354>`_: PyMuPDF==1.24.1: AttributeError: property 'metadata' of 'Document' object has no setter

* Other:

* New/modified methods:

* `Document.bake()`: new, make annotations / fields permanent content.

* `Page.cluster_drawings()`: new, identifies drawing items

(i.e. vector graphics or line-art)

that belong together based on their geometrical vicinity.

* `Page.apply_redactions()`: added new parameter `text`.

* `Document.subset_fonts()`: use MuPDF's `pdf_subset_fonts()` instead of PyMuPDF code.

* The `Document` class now supports page numbers specified as slices.

* Avoid causing MuPDF warnings.

**Changes in version 1.24.1 (2024-04-02)**

* Fixed issues:

* **Fixed** `3278 <https://github.com/pymupdf/PyMuPDF/issues/3278>`_: apply_redactions moves some unredacted text

* **Fixed** `3301 <https://github.com/pymupdf/PyMuPDF/issues/3301>`_: Be more permissive when classifying links as kind LINK_URI

* **Fixed** `3306 <https://github.com/pymupdf/PyMuPDF/issues/3306>`_: Text containing capital 'ET' not appearing as annotation

* Other:

* Use MuPDF-1.24.1.

* Support ObjStm Compression.

Methods `Document.save()`, `Document.ez_save()` and `Document.write()`

now support new parameters `use_objstm`, compression_effort` and

`preserve_metadata`.

**Changes in version 1.24.0 (2024-03-21)**

* Fixed issues:

* **Fixed** `3281 <https://github.com/pymupdf/PyMuPDF/issues/3281>`_: Preparing metadata (pyproject.toml) did not run successfully

* **Fixed** `3279 <https://github.com/pymupdf/PyMuPDF/issues/3279>`_: PyMuPDF no longer builds in Alpine Linux

* **Fixed** `3257 <https://github.com/pymupdf/PyMuPDF/issues/3257>`_: apply_redactions() deleting text outside of annotated box

* **Fixed** `3216 <https://github.com/pymupdf/PyMuPDF/issues/3216>`_: AttributeError: 'Annot' object has no attribute '__del__'

* **Fixed** `3207 <https://github.com/pymupdf/PyMuPDF/issues/3207>`_: get_drawings's items is missing line from h path operator

* **Fixed** `3201 <https://github.com/pymupdf/PyMuPDF/issues/3201>`_: Memory leaks when merging PDFs

* **Fixed** `3197 <https://github.com/pymupdf/PyMuPDF/issues/3197>`_: page.get_text() returns hexadecimal text for some characters

* **Fixed** `3196 <https://github.com/pymupdf/PyMuPDF/issues/3196>`_: Remove text not working in 1.23.25 version vs 1.20.2

* **Fixed** `3172 <https://github.com/pymupdf/PyMuPDF/issues/3172>`_: PDF's 45º lines disappearing in png conversion

* **Fixed** `3135 <https://github.com/pymupdf/PyMuPDF/issues/3135>`_: Do not log warnings to stdout

* **Fixed** `3125 <https://github.com/pymupdf/PyMuPDF/issues/3125>`_: get_pixmap method stuck on one page and runs forever

* **Fixed** `2964 <https://github.com/pymupdf/PyMuPDF/issues/2964>`_: There is an issue with the image generated by the page.get_pixmap() function

* Other:

* Use MuPDF-1.24.0.

* Add support for redacting vector graphics.

* Several fixes for table module

* Add new method for outputting the table as a markdown string.

* Address errors in computing the table header object:

We now allow None as the cell value, because this will be resolved where

needed (e.g. in the pandas DataFrame).

We previously tried to enforce rect-like tuples in all header cell

bboxes, however this fails for tables with all-None columns. This fix

enables this and constructs an empty string in the corresponding cell

string.

We now correctly include start / stop points of lines in the bbox of the

clustered graphic. We previously joined the line's rectangle - which had

no effect because this is always empty.

* Improved exception text if we fail to open document.

* Fixed build with new libclang 18.

**Changes in version 1.23.26 (2024-02-29)**

* Fixed issues:

* **Fixed** `3199 <https://github.com/pymupdf/PyMuPDF/issues/3199>`_: Add entry_points to setuptools configuration to provide command-line console scripts

* **Fixed** `3209 <https://github.com/pymupdf/PyMuPDF/issues/3209>`_: Empty vertices in ink annotation

* Other:

* Improvements to table detection:

* Improved check for empty tables, fixes bugs when determining table headers.

* Improved computation of enveloping vector graphic rectangles.

* Ignore more meaningless "pseudo" tables

* Install command-line 'pymupdf' command that runs fitz/__main__.py.

* Don't overwrite MuPDF's config.h when building on non-Windows.

* Fix `Story` constructor's `archive` arg to match docs - now accepts a single `Archive` constructor arg.

* Do not include MuPDF source in sdist; will be downloaded automatically when building.

**Changes in version 1.23.25 (2024-02-20)**

* Fixed issues:

* **Fixed** `3182 <https://github.com/pymupdf/PyMuPDF/issues/3182>`_: Pixmap.invert_irect argument type error

* **Fixed** `3186 <https://github.com/pymupdf/PyMuPDF/issues/3186>`_: extractText() extracts broken text from pdf

* **Fixed** `3191 <https://github.com/pymupdf/PyMuPDF/issues/3191>`_: Error on .find_tables()

* Other:

* When building, be able to specify python-config directly, with environment

variable `PIPCL_PYTHON_CONFIG`.

**Changes in version 1.23.24 (2024-02-19)**

* Fixed issues:

* **Fixed** `3148 <https://github.com/pymupdf/PyMuPDF/issues/3148>`_: Table extraction - vertical text not handled correctly

* **Fixed** `3179 <https://github.com/pymupdf/PyMuPDF/issues/3179>`_: Table Detection: Incorrect Separation of Vector Graphics Clusters

* **Fixed** `3180 <https://github.com/pymupdf/PyMuPDF/issues/3180>`_: Cannot show optional content group: AttributeError: module 'fitz.mupdf' has no attribute 'pdf_array_push_drop'

* Other:

* Be able to test system install using `sudo pip install` instead of a venv.

**Changes in version 1.23.23 (2024-02-18)**

* Fixed issues:

* **Fixed** `3126 <https://github.com/pymupdf/PyMuPDF/issues/3126>`_: Initialising Archive with a pathlib.Path fails.

* **Fixed** `3131 <https://github.com/pymupdf/PyMuPDF/issues/3131>`_: Calling the next attribute of an Annot raises a "No attribute .parent" warning

* **Fixed** `3134 <https://github.com/pymupdf/PyMuPDF/issues/3134>`_: Using an IRect as clip parameter in Page.get_pixmap no longer works since 1.23.9

* **Fixed** `3140 <https://github.com/pymupdf/PyMuPDF/issues/3140>`_: PDF document stays in use after closing

* **Fixed** `3150 <https://github.com/pymupdf/PyMuPDF/issues/3150>`_: doc.select() hangs on this doc.

* **Fixed** `3163 <https://github.com/pymupdf/PyMuPDF/issues/3163>`_: AssertionError on using fitz.IRect

* **Fixed** `3177 <https://github.com/pymupdf/PyMuPDF/issues/3177>`_: fitz.Pixmap(None, pix) Unrecognised args for constructing Pixmap

* Other:

*

Improved `Document.select() by using new MuPDF function

`pdf_rearrange_pages()`. This is a more complete (and faster)

implementation of what needs to be done here in that not only pages will

be rearranged, but also consequential changes will be made to the table

of contents, links to removed pages and affected entries in the Optional

Content definitions.

* `TextWriter.appendv()`: added `small_caps` arg.

* Fixed some valgrind errors with MuPDF master.

* Fixed `Document.insert_image()` when build with MuPDF master.

**Changes in version 1.23.22 (2024-02-12)**

* Fixed issues:

* **Fixed** `3143 <https://github.com/pymupdf/PyMuPDF/issues/3143>`_: Difference in decoding of OCGs names between doc.get_ocgs() and page.get_drawings()

* **Fixed** `3139 <https://github.com/pymupdf/PyMuPDF/issues/3139>`_: Pixmap resizing needs positional arg "clip" - even if None.

* Other:

* Removed the use of MuPDF function `fz_image_size()` from PyMuPDF.

**Changes in version 1.23.21 (2024-02-01)**

* Fixed issues:

* Other:

* Fixed bug in set_xml_metadata(), PR `3112 <https://github.com/pymupdf/PyMuPDF/pull/3112>`_: Fix pdf_add_stream metadata error

* Fixed lack of `.parent` member in `TextPage` from `Annot.get_textpage()`.

* Fixed bug in `Page.add_widget()`.

**Changes in version 1.23.20 (2024-01-29)**

* Bug fixes:

* **Fixed** `3100 <https://github.com/pymupdf/PyMuPDF/issues/3100>`_: Wrong internal property accessed in get_xml_metadata

* Other:

* Significantly improved speed of `Document.get_toc()`.

**Changes in version 1.23.19 (2024-01-25)**

* Bug fixes:

* **Fixed** `3087 <https://github.com/pymupdf/PyMuPDF/issues/3087>`_: Exception in insert_image with mask specified

* **Fixed** `3094 <https://github.com/pymupdf/PyMuPDF/issues/3094>`_: TypeError: '<' not supported between instances of 'FzLocation' and 'int' in doc.delete_pages

* Other:

* When finding tables:

* Allow addition of user-defined "virtual" vector graphics when finding tables.

* Confirm that the enveloping bboxes of vector graphics are inside the clip rectangle.

* Avoid slow finding of rectangle intersections.

* Added `Font.bbox` property.

**Changes in version 1.23.18 (2024-01-23)**

* Bug fixes:

* **Fixed** `3081 <https://github.com/pymupdf/PyMuPDF/issues/3081>`_: doc.close() not closing the document

* Other:

* Reduced size of sdist to fit on pypi.org (by reducing size of two test files).

* Fix `Annot.file_info()` if no `Desc` item.

**Changes in version 1.23.17 (2024-01-22)**

* Bug fixes:

* **Fixed** `3062 <https://github.com/pymupdf/PyMuPDF/issues/3062>`_: page_rotation_reset does not return page to original rotation

* **Fixed** `3070 <https://github.com/pymupdf/PyMuPDF/issues/3070>`_: update_link(): AttributeError: 'Page' object has no attribute 'super'

* Other:

* Fixed bug in `Page.links()` (PR #3075).

* Fixed bug in `Page.get_bboxlog()` with layers.

* Add support for timeouts in scripts/ and tests/run_compound.py.

**Changes in version 1.23.16 (2024-01-18)**

* Bug fixes:

* **Fixed** `3058 <https://github.com/pymupdf/PyMuPDF/issues/3058>`_: Pixmap created from CMYK JPEG delivers RGB format

* Other:

* In table detection strategy "lines_strict", exclude fill-only vector graphics.

* Fixed sysinstall test failure.

* In documentation, update feature matrix with item about text writing.

**Changes in version 1.23.15 (2024-01-16)**

* Bug fixes:

* **Fixed** `3050 <https://github.com/pymupdf/PyMuPDF/issues/3050>`_: python3.9 pix.set_pixel has something wrong in c.append( ord(i))

* Other:

* Improved docs for Page.find_tables().

**Changes in version 1.23.14 (2024-01-15)**

* Bug fixes:

* **Fixed** `3038 <https://github.com/pymupdf/PyMuPDF/issues/3038>`_: JM_pixmap_from_display_list > Assertion Error : Checking for wrong type

* **Fixed** `3039 <https://github.com/pymupdf/PyMuPDF/issues/3039>`_: Issue with doc.close() not closing the document in PyMuPDF

* Other:

* Ensure valid "re" rectangles in `Page.get_drawings()` with derotated pages.

**Changes in version 1.23.13 (2024-01-15)**

* Bug fixes:

* **Fixed** `2979 <https://github.com/pymupdf/PyMuPDF/issues/2979>`_: list index out of range in to_pandas()

* **Fixed** `3001 <https://github.com/pymupdf/PyMuPDF/issues/3001>`_: Calling find_tables() on one document alters the bounding boxes of a subsequent document

* Other:

* Fixed `Rect.height` and `Rect.width` to never return negative values.

* Fixed `TextPage.extractIMGINFO()`'s returned `dictkey_yres` value.

**Changes in version 1.23.12 (2024-01-12)**

* * **Fixed** `3027 <https://github.com/pymupdf/PyMuPDF/issues/3027>`_: Page.get_text throws Attribute Error for 'parent'

**Changes in version 1.23.11 (2024-01-12)**

* Fixed some Pixmap construction bugs.

* Fixed Pixmap.yres().

**Changes in version 1.23.10 (2024-01-12)**

* Bug fixes:

* **Fixed** `3020 <https://github.com/pymupdf/PyMuPDF/issues/3020>`_: Can't resize a PixMap

* Other:

* Fixed Page.delete_image().

**Changes in version 1.23.9 (2024-01-11)**

* Default to new "rebased" implementation.

* The old "classic" implementation is available with `import fitz_old as fitz`.

* For more information about why we are changing to the rebased implementation,