[dolfim-ibm]

Summary

• The image backend now reads only the frame count when it opens an image and decodes each frame in load_page. max_num_pages is checked before any pixel data is decoded, and only the pages in flight are kept in memory.
• New max_image_pixels option (default 89,478,485, Pillow's Image.MAX_IMAGE_PIXELS default) limits width x height of one decoded image:
  • image inputs: an oversized first frame rejects the document; an oversized later frame fails that page.
  • HTML / Markdown / MHTML (and other users of the shared image loader): an oversized image, or one Pillow refuses to open, is skipped with a warning; the rest of the document converts.
• Base64 data URIs are size-checked before decoding.

Behavior changes

• A decode error in one frame of a multi-page image now fails that page instead of the whole document at load time.
• The image source stays open until the backend is unloaded.

Tests

• Multi-frame TIFF over max_num_pages is rejected without decoding frames.
• Pixel limit on image inputs (first frame and later frame).
• Loader, HTML and Markdown skip oversized images and keep the other content.

Docs: docs/usage/advanced_options.md and the usage skill reference.

[github-actions]

✅ DCO Check Passed

Thanks @dolfim-ibm, all your commits are properly signed off. 🎉

[mergify]

Merge Protections

🟢 Merge protection satisfied — ready to merge.

Show 1 satisfied protection

🟢 Enforce conventional commit

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?(!)?:

[github-actions]

AI triage (advisory)

Checked commit 6b223ba7c2. The analysis read the diff only. It did not run code from this pull request.

Warning

The AI analysis did not finish. Only the deterministic checks are shown.

Topic labels added: bug, html, markdown.

CI safety: not assessed.

Possibly related pull requests

PR	State	Signal	Assessment
#4912	open	changes the same code	not assessed
#3891	open	changes the same code	not assessed

_{The ai:* labels are advisory. They do not approve CI and they do not add tests:full. A new push runs this check again.}

[codecov]

Codecov Report

❌ Patch coverage is 95.74468% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
docling/backend/image_backend.py	92.85%	0 Missing and 2 partials ⚠️

📢 Thoughts on this report? Let us know!