_raster.py 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. """Shared page rasterizer with a fallback chain: pypdfium2 -> pdftoppm.
  2. Returns PIL Images so callers can annotate/save. Not a CLI.
  3. """
  4. from __future__ import annotations
  5. import shutil
  6. import subprocess
  7. import tempfile
  8. from pathlib import Path
  9. def available_backends() -> list[str]:
  10. """Names of usable rasterizer backends, in preference order."""
  11. backends = []
  12. try:
  13. import pypdfium2
  14. backends.append("pypdfium2")
  15. except ImportError:
  16. pass
  17. if shutil.which("pdftoppm"):
  18. backends.append("pdftoppm")
  19. return backends
  20. def missing_hints() -> list[str]:
  21. """Install hints for when no backend is available."""
  22. return [
  23. "pypdfium2: rerun with the documents interpreter $PY from the pdf skill's Prerequisites setup block",
  24. "poppler-utils (provides pdftoppm), e.g. apt-get install poppler-utils",
  25. ]
  26. def rasterize_page(pdf_path: str, page: int, dpi: int = 150, password: str | None = None):
  27. """Render one 1-based page to a PIL Image, or None if no backend works.
  28. Raises ValueError for an out-of-range page when a backend is present.
  29. """
  30. for backend in available_backends():
  31. if backend == "pypdfium2":
  32. return _via_pdfium(pdf_path, page, dpi, password)
  33. if backend == "pdftoppm":
  34. img = _via_pdftoppm(pdf_path, page, dpi, password)
  35. if img is not None:
  36. return img
  37. return None
  38. def _via_pdfium(pdf_path: str, page: int, dpi: int, password: str | None):
  39. import pypdfium2 as pdfium
  40. doc = pdfium.PdfDocument(pdf_path, password=password)
  41. try:
  42. if not 1 <= page <= len(doc):
  43. raise ValueError(f"page {page} out of range 1-{len(doc)}")
  44. bitmap = doc[page - 1].render(scale=dpi / 72.0)
  45. return bitmap.to_pil().convert("RGB")
  46. finally:
  47. doc.close()
  48. def _via_pdftoppm(pdf_path: str, page: int, dpi: int, password: str | None):
  49. from PIL import Image
  50. with tempfile.TemporaryDirectory() as tmp:
  51. prefix = str(Path(tmp) / "page")
  52. cmd = ["pdftoppm", "-png", "-r", str(dpi), "-f", str(page), "-l", str(page)]
  53. if password:
  54. cmd += ["-upw", password]
  55. cmd += [pdf_path, prefix]
  56. proc = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8", check=False)
  57. if proc.returncode != 0:
  58. raise ValueError(f"pdftoppm failed: {proc.stderr.strip()}")
  59. produced = sorted(Path(tmp).glob("page*.png"))
  60. if not produced:
  61. raise ValueError(f"page {page} out of range (pdftoppm produced no image)")
  62. with Image.open(produced[0]) as img:
  63. return img.convert("RGB")