j5j#UdZddlmZddlZddlZddlmZmZmZddl m Z ddl Z ddl m Z ejeZdZe d Gd d Zdd Zdd ZddZd dZej,dfej,dfej,dfej,dfej.dfdZded<ehdZdZd!dZ d"dZd#dZy)$uValidate and repair malformed page-boundary boxes. A page's boundary boxes (``/MediaBox``, ``/CropBox``, ``/TrimBox``, ``/ArtBox``, ``/BleedBox``) are sometimes malformed in ways that PDF readers tolerate but that crash or corrupt downstream processing. This module normalizes them in place following the PDF 2.0 specification (ISO 32000-2:2020): - **Non-decimal coordinates** (§7.3.3): a coordinate written in exponential notation is invalid PDF number syntax and is stored by qpdf/pikepdf as a string. We coerce it back to a number (issue #1398). - **Reversed corners** (§7.9.5): a rectangle is "a pair of diagonally opposite corners"; ``[llx lly urx ury]`` is only the typical order. We normalize to ``[min_x, min_y, max_x, max_y]`` (issue #1526). - **Sub-box outside the MediaBox** (§14.11.2): "If the bounds of the crop, trim, bleed or art box extends outside of the bounds of the media box, a processor shall treat the box as its intersection with the media box." We clamp to that intersection, or discard the sub-box (so it inherits the MediaBox) when the intersection is empty (issue #1400). A rectangle is treated as empty when its width or height is ``<= 0``; PDF 2.0 permits zero-dimension rectangles and defines no minimum page size, so no other size floor is imposed. ) annotationsN)IterableMappingSequence) dataclass)Name)CropBoxTrimBoxArtBoxBleedBoxT)frozenc&eZdZUdZded<ded<y) BoxRepairaA single change made to a page box. Attributes: box: The box name, e.g. ``"CropBox"``. kind: One of ``"reordered"`` (reversed corners normalized; lossless), ``"recoded"`` (non-numeric/exponential coordinate coerced), ``"clamped"`` (sub-box clamped to the MediaBox), ``"discarded"`` (sub-box removed because its MediaBox intersection was empty), or ``"degenerate_mediabox"`` (MediaBox has zero width or height). strboxkindN)__name__ __module__ __qualname____doc____annotations__I/var/www/html/qr/venv/lib/python3.12/site-packages/ocrmypdf/_pageboxes.pyrr,s  H Irrct|dk7ryg}d}|D]6} t|}t j |sy|j|8|\}}}}t||t||t||t||g} | |k7} | || fS#ttf$r2 tt |}n#ttf$rYYywxYwd}YwxYw)aOCoerce a box array to floats and normalize corner order. Returns ``(normalized_values, recoded, reordered)`` where ``recoded`` is True if any element needed string/exponential coercion and ``reordered`` is True if the corners were given in non-standard order. Returns None if the array is not four finite numbers. NFT) lenfloat TypeError ValueErrorrmathisfiniteappendminmax) valuesnumsrecodedvnx0y0x1y1 normalized reordereds r _read_boxr1=s 6{aDG   aA}}Q A NBBb"+s2r{CBKREJd"I w )):&  #a&Mz*  G  s5 BCB32C3CCCCCc t|}t|}||dSg}|D]} |jt||S#tt f$r&|jtt |YVwxYw)aSReturn box values coerced to floats with corner order normalized. Robust against exponential/string coordinates and reversed corners, so callers that only need to read a box (e.g. dimension calculations) do not crash on malformed input. Falls back to best-effort per-element coercion if the array is not four numbers. r)listr1r#rrr r)r&resultcoercedr)s r coerce_boxr6[s&\F v F ayG * * NN58 $* N:& * NN5Q= ) *sA2A98A9c>|d|dz dkxs|d|dz dkS)z>A rectangle is empty when its width or height is non-positive.rrrs r _is_emptyr<ps/ FSVO ! ;c!fs1vo!%;;rc g}d} tt|jj}||\}}}|r|jtdd|r|jtdd|s|r$tj||j_ t|r|jtddd}tD]m}td|z}||jvr! tt|j|}|F|\} }}|r|jt|d|r|jt|d|s|r"tj| |j|<|t#| d|dt#| d|dt%| d |d t%| d |d g} t| r*|j|=|jt|d *| | k7s1tj| |j|<|jt|d p|S#tt t f$rd}Y$wxYw#t t f$rYwxYw) a Validate and repair the boundary boxes of a single page, in place. Returns the list of changes made (empty if the page was already valid). Only boxes that actually change are written back, so valid pages are left untouched. Performs no logging or I/O. NMediaBoxr0r(degenerate_mediabox/rr:r8r9 discardedclamped)r1r3mediaboxas_listAttributeErrorKeyError RuntimeErrorr#rpikepdfArrayobjr>r< _SUBBOXESrrr%r$) pagerepairsrC mb_resultr(r0rname sub_resultr& intersections rrepair_page_boxesrRus@ "G$(Hd4==#8#8#:;< '0$'9  NN9Z= >  NN9Z; < i ' h 7DHH  X  NN9Z1FG HH6C#I txx   "4#78J   %/"  NN9S+6 7  NN9S)4 5 i$]]62DHHTN    q 8A; ' q 8A; ' q 8A; ' q 8A; '  \ " NN9S+6 7 V #$]]<8DHHTN NN9S)4 5?6B N_ Hl 3 (<(   s#,H=,!I=III-,I-zN{box} lies outside the MediaBox and was discarded; the full page will be shownz8{box} extended beyond the MediaBox and was clamped to itzK{box} used invalid (e.g. exponential) coordinates, which were reinterpretedzRMediaBox has zero width or height and could not be repaired; output may be invalidz4{box} corners were reversed and have been normalized)rArBr(r?r0zdict[str, tuple[int, str]]_KIND_MESSAGES>rBr(rAz( Please visually inspect the output PDF.ctd|D}g}|dx}}|ddD]$}||dzk(r|}|j||f|x}}&|j||fdjd|DS)z>Format 0-based page numbers as a compact 1-based range string.c3&K|] }|dz yw)r:Nr).0ps r z _format_pages..s)A!a%)srr:Nz, c3@K|]\}}||k(r|n|d|yw)-Nr)rVabs rrXz _format_pages..s+I$!QqAvsaS!:5Is)sortedr#join)pagenosr'rangesstartprevr*s r _format_pagesrcs )) )D$&F7ED !"X q=D  udm$   MM5$- 99I&I IIrci}|jD]K\}}|D]A}|j|j|jft j |CMg}t |jD]Z\\}}}t|\} } dt|d| j|d} |tvr | tz } |j| | f\|S)zAggregate per-page repairs into ``(log_level, message)`` pairs. Repairs are grouped by ``(kind, box)`` so a defect shared across many pages yields a single message listing the affected pages, rather than one message per page. zPage(s) z: r;.) items setdefaultrrsetaddr]rSrcformat_INSPECT_KINDS_INSPECTr#) repairs_by_pagegroupspagenorMrepairmessagesrrpagesleveltemplatetexts rsummarize_box_repairsrvs/1F*002L LF   v{{FJJ7 ? C CF K LL')H$V\\^4' sU(.x-./r(//c/2J1K1M > ! H D & ' OrcVt|D]\}}tj||y)zCEmit aggregated log messages for the repairs made across all pages.N)rvlog)rmrsmessages rlog_box_repairsrzs(/@ w w r)r&rreturnz%tuple[list[float], bool, bool] | None)r&rr{z list[float])rzSequence[float]r{bool)rLz pikepdf.Pager{zlist[BoxRepair])r_z Iterable[int]r{r)rm!Mapping[int, Sequence[BoxRepair]]r{zlist[tuple[int, str]])rmr}r{None) r __future__rloggingr!collections.abcrrr dataclassesrrHr getLoggerrrxrKrr1r6r<rRWARNINGDEBUGrSr frozensetrkrlrcrvrzrrrrs 0# 77!g! 8  $    *<*< <D  & B U    >'.*4>? 5 J60 r