,hf/ddlZddlZddlZddlZddlZ ddlmZ ddlmZejZ ejZ dZ dZ dZdZ ej Zej*Zej.edfZej4eZej4eZej4eZ ej4eZ!ej4ejDZ# dd ejHd dfd Z% dd efd Z&ddddd ejHdefdZ'd ejHdefdZ(dddd ddd dddddd dZ)ddejTejVzejXzejZzddd e.fdZ/ddejTejXzejVzejZzdfdej`dedede1de dedejdd e.fdZ3 dd ejHde dedejdd e1d e.f d!Z4 dd ejHde dedejdd e1d e.f d"Z5 dd ejHde dedejdd ef d#Z6 dd ejHd$e dejdd efd%Z7 dd ejHd&e d'e de dejdf d(Z8 dd ejHded)ed*ed+e1d,ed ejdfd-Z9dd ejHd.e1d/e1d e.fd0Z:dd ejHd e.fd1Z; dd ejHd2ede dedejdd e1f d3Z< ddej`ded2ede dedejdd e1d ej*fd4Z=ej|dej~ddd d5d ejHd6ed7ejde d8e1d9e1d ejfd:ZBej|dej~ddd d5dej`ded6ed7ejde d8e1d9e1d ejfd;ZCdd efd<ZDd ejHd e.fd=ZE ddej`d>e1d e.fd?ZFdej`d@ed dfdAZG ddej`d@edBe dCededDedEedFe dGedHed dfdIZHd efdJZIddej`dKed dfdLZJdedMed efdNZK ddej`dOe.dPed efdQZL ddRej`dSej`dTedUedVed df dWZM ddXej`dYej`dTedUedVed df dZZNd ejHd[ed efd\ZOd ejHd]ejd ejfd^ZQd ejHd[ed dfd_ZRdd ejHd[ed`e1d dfdaZSdbddddcdddddddddddd dddded ejHd$e dfej.ee.fdgedhediedjedkedledme#dne#doedpedqedredsedtedue#dve1dwedxedyed ef.dzZTdcddbdddddddddddd dddd{d ejHd|e dej.ee.fdkedledgedhediedjedme#dne#dtedsedredqedue#dve1dwedxedyef(d}ZUddddddd d~d efdZV ddej`dededed ejHf dZW ddej`dedej.ee.dfdkedededgedhedme#d efdZX dd ejHd&e d'e dme#dededededve1due#dwedxed ejfdZZ dd ejHd&e d'e dedme#dededededve1due#dwedxedyed ejfdZ[ dd ejHd&e d'e dedme#dededededve1due#dwedxedyed ejfdZ\ dd ejHd$e dme#dne#dededededue#dve1dwedxedyed ejfdZ] dd ejHdedme#dne#dededededue#dve1dwedxedyed ejfdZ^ dd ejHde.dme#dne#dededue#dededve1de1dwedxedyed ejfdZ_ dd ejHde dedme#dne#due#dededededve1dwedxedyed ejfdZ` dd ejHd$ej.e efdme#dne#dedue#dedededve1dwedxedyed ejfdZa dd ejHd&e d'e de dme#dne#dededue#de1dededve1dwedxedyed ejf"dZb dd ejHd&e d'e de de dme#dne#dededuede1dededve1dwedxedyed ejf$dZc dd ejHde d|e dedme#dne#dede1due#dede1dededve1dwedxedyed ejf$dZdd e.fdZed e.fdZfded egfdZhded egfdZidej`ded egfdZj ddej`deded@ede d e.f dZkGddZl dd ejHdededed e1f dZm ddej`de1de1de1de1de1de1de1dede1de1de1de1de1d dfdZndZo ddejd$e dej.ee.fde dej4ejdkedledpede1de1de1d egfdZrdej`ded efdZsdej`dedyed dfdZt ddej`dedej.e.dfdedej.e.dfd ef dńZudej`ded efdƄZv dDŽZwdȄZxdɄZyddʄZzd efd˄Z{d efd̄Z|ded efd΄Z}dτZ~dЄZdej`d e1fdфZdej`d e1fd҄Zdegdedegd ejfdքZdegded ejfdׄZddede.d ejfdڄZddegdede.d ejfd܄Zdegdeded ejfdބZddej`de1de1d efdZdddej`dedede.d df dZy#e$rddlZY wxYw#e$rddlZY wxYw#e$r eezezZY wxYw(N)pymupdf)mupdf point_like rect_like matrix_like quad_likeTpagereturnc t|tjsJ|s tdt |tj ur |dk(r||j ||||y|f}|dj} tj} | j|jj|jj} |D]%} | | jz} | j | ||'|| }|j|| d|||| |d} d} y)aWrite the text of one or more pymupdf.TextWriter objects. Args: rect: target rectangle. If None, the union of the text writers is used. writers: one or more pymupdf.TextWriter objects. overlay: put in foreground or background. keep_proportion: maintain aspect ratio of rectangle sides. rotate: arbitrary rotation angle. oc: the xref of an optional content object z$need at least one pymupdf.TextWriterrN)opacitycoloroverlaywidthheight)r r)rkeep_proportionrotateclipoc) isinstancerPage ValueErrortype TextWriter write_text text_rectDocumentnew_pagerectrr show_pdf_page) r r writersrrr rrrrtextdoctpagewriters O/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pymupdf/utils.pyrr6s* dGLL )) ?@@ G}*** Q;4<   tWE7  SjG 1:  D G   499??499;K;K  LE?    %>? |  '   G Ec ,dd} tj||j} | jr |js t d|j s |j r t d|dkr||jz }|dkr||} | jgk(r t d||jz} |s | jn| j|z} | j s | j r t d| | jz} | | | ||}| j|jDcgc]}|d }}|| j|jDcgc]}|d  c}z }|| j|jDcgc]}|d  c}z }d }d}|d z}||vr|dz }|t|z}||vr|j }| j |k(r t d | j"j%|d}|$tj&| }|| j"|<||f}| j(j%|d}|r|j+|j-| ||||| ||}|| j(|<|Scc}wcc}wcc}w)a@Show page number 'pno' of PDF 'src' in rectangle 'rect'. Args: rect: (rect-like) where to place the source image src: (document) source PDF pno: (int) source page number keep_proportion: (bool) do not change width-height-ratio overlay: (bool) put in foreground oc: (xref) make visibility dependent on this OCG / OCMD (which must be defined in the target PDF) rotate: (int) degrees (multiple of 90) clip: (rect-like) part of source page rectangle Returns: xref of inserted object (for reuse) rc J|j|jzdz }|j|jzdz }tjdddd|j |j tj|z}||z}|j |j z }|j|jz } |rt|| x}} |tj|| z}|tjdddd|j|j z}tj|S)a8Calculate transformation matrix from source to target rect. Notes: The product of four matrices in this sequence: (1) translate correct source corner to origin, (2) rotate, (3) scale, (4) translate to target's top-left corner. Args: sr: source rect in PDF (!) coordinate system tr: target rect in PDF coordinate system keep: whether to keep source ratio of width to height rotate: rotation angle in degrees Returns: Transformation matrix. g@rr) tlbrrMatrixxyrrminJM_TUPLE) srtrkeeprsmptmpmsr1fwfhs r& calc_matrixz"show_pdf_page..calc_matrixs uuruu}#uuruu}# NN1aAvv 69O O1f XX ! YY # "bk !B W^^B ## W^^Aq!Qsuu 55""r' is no PDF!rect must be finite and not emptyz#nothing to show - source page emptyz!clip must be finite and not empty)r3rrfzFrm0z%source document must not equal targetN)rmatrixxrefrrgraftmap_imgname)Tr)r CheckParentparentis_pdfris_empty is_infinite page_count get_contentstransformation_matrixr get_page_xobjectsnumberget_page_imagesget_page_fontsstr _graft_id GraftmapsgetGraftmap ShownPages wrap_contents_show_pdf_page)r r srcpnorrrrrr:docsrc_pagetar_rectsrc_rectrAiilstnrDisrcgmappno_idrBs r&r!r!js2 #D  ++C ::SZZ%% }}((<== ' s~~ '3xH"$>??t1111H$(x}}hmmd.BHH00<==89999H 8/& QF// < =QAaD =D =3..t{{; >  fa (D        D"CNN6 KQ > < ;s2 J J  J)filenamepixmapstreamrBcp|j}|j|s tdt|t|zt|zdk7r td|j |j |||}|j |||jd}|j|dd|_ y)aReplace the image referred to by xref. Replace the image by changing the object definition stored under xref. This will leave the pages appearance instructions intact, so the new image is being displayed with the same bbox, rotation etc. By providing a small fully transparent image, an effect as if the image had been deleted can be achieved. A typical use may include replacing large images by a smaller version, e.g. with a lower resolution or graylevel instead of colored. Args: xref: the xref of the image to replace. filename, pixmap, stream: exactly one of these must be provided. The meaning being the same as in Page.insert_image. zxref not an imagerz3Exactly one of filename/stream/pixmap must be given)rergrf N) rF xref_is_imagerbool insert_imager xref_copyrK update_stream _image_info)r rBrerfrgr[new_xreflast_contents_xrefs r& replace_imagerss ++C   T ",-- H~V $tF|3q8NOO   HVF!HMM(D!**,R0($/Dr'ctjtjdd}|j|j ||y)zDelete the image referred to by xef. Actually replaces by a small transparent Pixmap using method Page.replace_image. Args: xref: xref of the image to delete. )rrrrr)rfN)rPixmapcsGRAY clear_withrs)r rBpixs r& delete_imagery s7 ..q 9CNNtC(r'ri) alpharerrmaskrrrfrrgrrBc tj||j}|js t d| dk(r1t |t | zt | zdk7r t d|rNt |turnfzImgr@)rerfrgimaskrrrrBrrrrrzrDdigests)rrErFrGrrlrrQhasattrr~ospathexistsFileNotFoundErrorbytes bytearrayioBytesIOruRectrHrIrLrOrNrMrPrWInsertedImages _insert_image)r r rzrerrr{rrrfrrgrrBr[rrr_r`rarDrs r&rmrms`  ++C ::%% qyd8ntF|3d6lBaGOPP >S  Xz *8}H Xv &}}H^, ,x0 4x ?@@ DL 2::(FF>?? DL6:;; Vx;<< T 5)RZZ"@@<== 1*#  1* C-#  C- &&+,, TAzzQ]]<== *** *D--dkk: ;QAaD ;D ;300= >aQqT >>D3--dkk: ;aQqT ;;DA A3wH d  Qs1v: d    G&&  ''MD'"$ KC < > ;s! K> L< LF)rquadsflagstextpagec|tj|}tj||}||j||}nt |d|k7r t d|j ||}|~|S)a~Search for a string on a page. Args: text: string to be searched for clip: restrict search to this rectangle quads: (bool) return quads instead of rectangles flags: bit switches, default: join hyphened words textpage: a pre-created pymupdf.TextPage Returns: a list of rectangles or quads, each containing one occurrence. rrrFnot a textpage of this page)r)rrrE get_textpagegetattrrsearch)r textrrrrtprlists r& search_forrs0 ||D!  B z   D  6 X $ &677 IId%I (E  Lr'r[rZrrrrrc4||j|||||S)aSearch for a string on a page. Args: pno: page number text: string to be searched for clip: restrict search to this rectangle quads: (bool) return quads instead of rectangles flags: bit switches, default: join hyphened words textpage: reuse a prepared textpage Returns: a list of rectangles or quads, each containing an occurrence. )rrrr)r)r[rZrrrrrs r&search_page_forrs/4 s8      r'sortctj||tj}|}||j||}nt |d|k7r t d|j }|~|r|jd|S)a_Return the text blocks on a page. Notes: Lines in a block are concatenated with line breaks. Args: flags: (int) control the amount of data parsed into the textpage. Returns: A list of the blocks. Each item contains the containing rectangle coordinates, text lines, running block number and block type. rrFrc|d|dfSNr)bs r&z!get_text_blocks..s1Q41,r'key)rrETEXTFLAGS_BLOCKSrrr extractBLOCKSr)r rrrrrblockss r&get_text_blocksrs"  }(( B z   D  6 X $ &677    F   . / Mr'c fd}tj||tj}|}||j||}nt |d|k7r t d|j |} |]|[tj|}| D cgc];} t|| ddzdttj| ddzk\s:| =} } |~| r |r|| } | Scc} w)aReturn the text words as a list with the bbox for each word. Args: page: pymupdf.Page clip: (rect-like) area on page to consider flags: (int) control the amount of data parsed into the textpage. textpage: (pymupdf.TextPage) either passed-in or None. sort: (bool) sort the words in reading sequence. delimiters: (str,list) characters to use as word delimiters. tolerance: (float) consider words to be part of the same line if top or bottom coordinate are not larger than this. Relevant only if sort=True. Returns: Word tuples (x0, y0, x1, y1, "word", bno, lno, wno). c|jdg}|dg}tj|ddd}|ddD]}tj|dd}t|j|jz ks%t|j |j z kr|j |||z}||jd|j||g}|}|jd|j||S) z1Sort words line-wise, forgiving small deviations.c|d|dfSrrws r&rz4get_text_words..sort_words..s!A$!r'rrNr>rc |dSNrrrs r&rz4get_text_words..sort_words..)s !r'c |dSrrrs r&rz4get_text_words..sort_words...s !r')rrrabsy0y1appendextend)wordsnwordslinelrectrwrect tolerances r& sort_wordsz"get_text_words..sort_wordss - .az U1Xbq\*qr ALL2A'EEHHuxx'(I5uxx%((*+y8 A n - d#s  n % d r'NrrFrr>?) rrETEXTFLAGS_WORDSrrr extractWORDSrr) r rrrr delimitersrrrrrs ` r&get_text_wordsrs42  }'' B z   D  6 X $ &677 OOJ 'E 0||D! D1Ra5L 1S3w||AbqE?R;S5S SA    5! L s ;C! C!c ~d}t||||d|Dcgc]}tj|dd|df!}}|sytj}|D] \} } || z} g} |dg} |dd} |ddD]\} } | d \}}t | j | j z |ks%t | j | j z |kr| j| | f| | z} q||| }| j| |f| | fg} | } ||| }| j| |f| jd | dd} | ddj }| ddD]Y\} }ttt| j |z | jz d }d |dzz}| ||zz } | j }[| Scc}w)aExtract plain text avoiding unacceptable line breaks. Text contained in clip will be sorted in reading sequence. Some effort is also spent to simulate layout vertically and horizontally. Args: page: pymupdf.Page clip: (rect-like) only consider text inside flags: (int) text extraction flags textpage: pymupdf.TextPage tolerance: (float) consider words to be on the same line if their top or bottom coordinates do not differ more than this. Notes: If a TextPage is provided, all text is checked for being inside clip with at least 50% of its bbox. This allows to use some "global" TextPage in conjunction with sub- selecting words in parts of the defined TextPage rectangle. Returns: A text string in reading sequence. Left indentation of each line, inter-line and inter-word distances strive to reflect the layout. c |jdd}|j}tj}|D]\}}||z}t t t |j|z |jz t|z||jk(s|j|krdnd}|d|z|zz }|j}|S)aCreate the string of one text line. We are trying to simulate some horizontal layout here, too. Args: clip: (pymupdf.Rect) the area from which all text is being read. line: (list) word tuples (rect, text) contained in the line Returns: Text in this line. Generated from words in 'line'. Distance from predecessor is translated to multiple spaces, thus simulating text indentations and large horizontal distances. c |djSr)x0rs r&rz4get_sorted_text..line_text..{s!r'rrr ) rrr EMPTY_RECTmaxintroundrlenx1)rrltextrrrtdists r& line_textz"get_sorted_text..line_textns ' ( WW""$ DAq QJEE144"9/#a&89:DGGmqttrzD S4Z!^ #EB  r'T)rrrrrNr>rrrric |djSr)r)ls r&rz!get_sorted_text..sadggr'r ) rrrrrrrrrr/rrr)r rrrrrrrtotalboxwrrlinesrrw0r_rrdistancebreakss r&get_sorted_textrOs >@      ae ad# E  !!#HDB E !H:D !HQKE!"I DbQ uxx"%% I -UXX5E1F)1S KKT # RKEh-E LL% (J.full_ocrsRxnnT4(ooSo)"""""%%#$$Q'8==#6#66nnVV,t/E/EE%%E#%> }}T*  r'rdictrrrbboxrimagerr)rrN transformrzFalling back to full page OCR)rrE get_tessdatarget_textTEXT_PRESERVE_IMAGESrrrrurarzcsRGBrrrr r,extend_textpager RuntimeErrorr FzErrorBaseg_exceptions_verboseexception_infomessage)r rrrrrrr$blockr rximgdocimgpageimgrectshrinkrs ` r&get_textpage_ocrrs  ##H-H, c8U33   E  *EvW-I-IJ8T8 =A  ||E&M* ::?dkkQ.  8..w0Cuusyy A%nnW]]C8yynnS!,%%&&8&LF&&q)GCllG^^A $5q7>>7IJF5--C  # #E3 # ? LLN/8B Le//0 8E OO; <D#x7 7 8s9DG1-V   Nr'ct|ttfvr|d}nkt|tur|}nW|j Dcgc] }|d|k(s |}}|gk(r t dt |dk7r t d|dd}tj|j|}|j}~|jd}|s0|D cgc]#} | d|k(s tj| d %} } | S|D cgc]:} | d|k(r0tj| d tj| d f<} } | Scc}wcc} wcc} w) aReturn list of image positions on a page. Args: name: (str, list, int) image identification. May be reference name, an item of the page's image list or an xref. transform: (bool) whether to also return the transformation matrix. Returns: A list of pymupdf.Rect objects or tuples of (pymupdf.Rect, pymupdf.Matrix) for all image locations on the page. rr=zbad image namerzmultiple image names foundTr r!r r )rlisttuplerr#rrrrurFr!r(rr,) r r~r rBr_r&rxr!infosimbboxess r&get_image_rectsr/asT DzdE]"Aw ds "oo/@1Q44<1@@ b=-. . \Q 9: :qz!} ..d +C ZZF   t  ,E 5:Urblf>T',,r&z*UU M (|v%\\"V* %w~~bo'F G  M%AV s EE EE>?E optionc tjtjtjtjtj tj tjtjtjtjd }|j}||vsJ||vrd}|||}|dk(rt||||||S|dk(rt|||||S|dk(r|rt|||||Stj|d} |d vr |j}|tj|}d} n't!|tj"ur |j} |} | |j%|| } nt'| d |k7r t)d |d k(r| j+| |} n|dk(r| j-| |} n|dk(r| j/| |} nm|dk(r| j1| |} nT|dk(r| j3} n>|dk(r| j5} n(|dk(r| j7} n| j9|} |~ | S)aExtract text from a page or an annotation. This is a unifying wrapper for various methods of the pymupdf.TextPage class. Args: option: (str) text, words, blocks, html, dict, json, rawdict, xhtml or xml. clip: (rect-like) restrict output to this area. flags: bit switches to e.g. exclude images or decompose ligatures. textpage: reuse this pymupdf.TextPage and make no new one. If specified, 'flags' and 'clip' are ignored. Returns: the output of methods get_text_words / get_text_blocks or pymupdf.TextPage methods extractText, extractHTML, extractDICT, extractJSON, extractRAWDICT, extractXHTML or etractXML respectively. Default and misspelling choice is "text". ) rhtmljsonrawjsonxmlxhtmlr rawdictrrrNr)rrrrrr)rrrr)rrrr)r2r5r6rrFrr3)cbrr4r r7r2r5r6)r)rTEXTFLAGS_TEXTTEXTFLAGS_HTMLTEXTFLAGS_DICTTEXTFLAGS_RAWDICT TEXTFLAGS_XMLTEXTFLAGS_XHTMLrrlowerrrrrEcropboxrrrrrr extractJSONextractRAWJSON extractDICTextractRAWDICT extractHTML extractXML extractXHTML extractText) r r0rrrrrrformatsr8rrs r&rrsb8&&&&&&,,$$((&&,,((** G\\^F W  W }  !    t58$  D      B ))|| ||D!  dw|| # \\ B z   D  6 X $ &677  NNbtN , 9    $  / 6  NNbtN , 9    $  / 6  NN  5 MMO 7  OO  NNN %  Hr'c2||j||||S)aExtract a document page's text by page number. Notes: Convenience function calling page.get_text(). Args: pno: page number option: (str) text, words, blocks, html, dict, json, rawdict, xhtml or xml. Returns: output from page.TextPage(). )rrr)r)r[rZr0rrrrs r& get_page_textrKs"& s8  V$e$  GGr'rAr colorspacerrzannotsrArMrzrNc|r|dz }tj||}t|turX|j dk(rtj }n4|j dk(rtj }ntj}|jdvr td|j|}|j||||} d}|r| j||| S) aCreate pixmap of page. Keyword args: matrix: Matrix for transformation (default: Identity). dpi: desired dots per inch. If given, matrix is ignored. colorspace: (str/Colorspace) cmyk, rgb, gray - case ignored, default csRGB. clip: (irect-like) restrict rendering to this area. alpha: (bool) whether to include alpha channel annots: (bool) whether to also render annotations rGRAYCMYK)rrr>zunsupported colorspace)rN)rArMrzrN) rr,rrQupperrvcsCMYKrrarget_displaylistrset_dpi) r rArrMrrzrNrdlrxs r&rrs( Rxd+ J3     ' J    6 ) J J||9$122  V  ,B --v*EPT- UC B  C Jr'c6||j||||||S)aCreate pixmap of document page by page number. Notes: Convenience function calling page.get_pixmap. Args: pno: (int) page number matrix: pymupdf.Matrix for transformation (default: pymupdf.Identity). colorspace: (str,pymupdf.Colorspace) rgb, rgb, gray - case ignored, default csRGB. clip: (irect-like) restrict rendering to this area. alpha: (bool) include alpha channel annots: (bool) also render annotations rL)r)r[rZrArrMrrzrNs r&get_page_pixmaprX1s1. s8     r'ct|tjr|j|}n;t|tjr |j }nJdt |d|jdd} t|dr|j|d<tjdd}|jtjzr|j j"|_|jtj$zr|j j&|_|jtj(k(r|j*|d<|S|jtj,k(rS|j.|d <||d <|jtj0zr|j2j"|d <|Sd |d <|S|jtj4k(r|j6j9d d|d<|j.|d <|j.dkr|j |d <|S||d <|jtj0zr|j2j"|d <|Sd |d <|S|jtj:k(r!|j6j9d d|d<|S|jtj<k(ri|j>jA|jAzrJ|jC|j>d |vrtj|d |d <|S|j.|d <|S#t$r!tdk\rtjYwxYw)NrzUnexpected type(ln)=.)kindrBr fromurir torg\/file)"rrOutline destinationLinkdestrr[rr ExceptionrrPointrLINK_FLAG_L_VALIDltr-LINK_FLAG_T_VALIDr.LINK_URIr^ LINK_GOTOr LINK_FLAG_R_IS_ZOOMrb LINK_GOTOR file_specreplace LINK_LAUNCH LINK_NAMEDnamedkeysupdate)lndocumentrfnlpnts r& getLinkDictr|Qs"goo&~~h' B %ww,)R{!,,))Q 'B 2v BvJ --1 C zzG---  zzG---  yyG$$$HH5 D IA g'' 'YY6 4 ::33 3BvJ8 I5BvJ4 I1 g(( (^^++D#66 YY6 99q=yyBtH( I%BtHzzG777!WWYY6 I!6  I g)) )^^++D#66  I g(( (JJOO% 12 $** 2:}}RX.BtH IYY6 I[  1 $(>(>(@  s8L;;&M%$M%ctj||j}g}|r6t||j}|j ||j }|r6|gk7r|jjrtj|Dcgc]}|dtjk(r|}}t|t|k(r5tt|D]}||d||d<||d||d< |Scc}w)zrCreate a list of all links contained in a PDF page. Notes: see PyMuPDF ducmentation for details. rrrBr]id) rrE first_linkr|rFrnextrGJM_get_annot_xref_list2PDF_ANNOT_LINKrr$)r rxlinksrzr- linkxrefsr_s r& get_linksrs  B E T[[ ) R WW  {t{{))//51Q47111  y>SZ '3y>* 1#,Q<?a !*1aa 1 LsC=simplecfdjr tdjj}|sgSd}g}|||}jrsj ||S)zCreate a table of contents. Args: simple: a bool to control output. Returns a list, where each entry consists of outline level, title, page number and link destination (if simple = False). For details see PyMuPDF's documentation. c0|r|jjr|jr |j}nd}|jsR|jrC|j dk(r$j |j}|ddz}n|j dz}nd}nd} s"t|}|j||||gn|j|||g|jr|j||dz}|j}|r|jjr|S)zPRecursively follow the outline item chain and record item information in a list.rrirr) this m_internaltitle is_externalr^r resolve_linkr|rdownr) olItemlistelvlrresolver linkr[recursers r&rzget_toc..recurses//|| %%::{{b("%"2"26::">&qzA~%{{QD"63/ c5$56 c5$/0{{ UC!G<[[F5//6 r'document closedr) is_closedrinit_docoutlinerG_extend_toc_items)r[rrrrtocrs`` @r&get_tocrsl@ }}*++LLN [[F  C E &% %C zz& c" Jr'idxcL|j|}|j|y)z$Delete TOC / bookmark item by index.N)get_outline_xrefs_remove_toc_item)r[rrBs r& del_toc_itemrs%  "3 'Dr' dest_dictr[r^rr_rerc |j|} d} t|turf|dtjk(rp|d}|j |} |j |j} |jdtjdd}| |jz |_ ||d<t| |} | jds td|jd }|rNttt |}t#|d k7st%|dkst'|d kDr td |jd d}|jdd}|d|zz}|jd}|j)| | dd||||S|tj*k(r|j-|S||y||j)| d|S|tjk(r||t/d |j0d zvr td|j |d z } |j |d z j} |tjd| dz }n)tj|}| |jz |_ |||||| d}t| |} | dk(s| jds td|j)| | dd|S)aUpdate TOC item by index. It allows changing the item's title and link destination. Args: idx: (int) desired index of the TOC list, as created by get_toc. dest_dict: (dict) destination dictionary as created by get_toc(False). Outrules all other parameters. If None, the remaining parameters are used to make a dest dictionary. kind: (int) kind of link (pymupdf.LINK_GOTO, etc.). If None, then only the title will be updated. If pymupdf.LINK_NONE, the TOC item will be deleted. pno: (int) page number (1-based like in get_toc). Required if pymupdf.LINK_GOTO. uri: (str) the URL, required if pymupdf.LINK_URI. title: (str) the new title. No change if None. to: (point-like) destination on the target page. If omitted, (72, 36) will be used as target coordinates. filename: (str) destination filename, required for pymupdf.LINK_GOTOR and pymupdf.LINK_LAUNCH. name: (str) a destination name for pymupdf.LINK_NAMED. zoom: (float) a zoom factor for the target location (pymupdf.LINK_GOTO). rr[r r_r$z/Azbad bookmark destrrrzbad color valueboldFitalicr]collapseN)actionrrrr)rrzbad page number)r[r_r^r rbrr)rrr rrm page_xref page_cropboxrrTrhr. getDestStr startswithrr*mapfloatrr/r_update_toc_item LINK_NONErr$rJ)r[rrr[rZr^rr_rerrBr page_heightrrrrrrddicts r& set_toc_itemrsZ  "3 'DI I$ V  1 1 1F#C c*I**3/66KtW]]2r%:;B%BD IdOIy1  &01 1 g& UE*+E5zQ#e*q.CJN !233}}VU+x/T!==,## !": $   w   $$ |  |##DU#CC w   ;#U1cnnq.@%AA./ /MM#'* &&sQw/66 :r;#34Br"B%BD  E 5 )F |6,,T2,--   VABZu  EEr'c|d}t|dkDr|d}nd}ddddd}||d||dz d z}||jz|jzS) zUCalculate area of rectangle. parameter is one of 'px' (default), 'in', 'cm', or 'mm'.rrpx)rr)?R@)gRQ@r)gffffff9@r)rincmmmr])rrr)argsr unitufs r&get_arearTsh 7D 4y1}Aw[ LQA 4agaj Q&A tzz>DKK ''r'r6c |js td|js |jr td|i}nt |t ur tdddddddd d d d d d }t |j}t |jj|}|t k7rd|z}t||jdd\}}|dk7rd}nt|jdd}|ik(r|dk(ry|dk(r9|j}|j|d|jddd|zn)|ik(r$|jddd|jy|j!D cgc]\} } ||  | | fc} } D]D\} } || } t#| r| dvrd} nt%j&| } |j|| | F|jycc} } w)zWUpdate the PDF /Info object. Args: m: a dictionary like doc.metadata. r;document closed or encryptedNz bad metadataAuthorProducerCreatorTitle CreationDateModDateSubjectKeywordsTrapped) authorproducercreatorrformat encryption creationDatemodDatesubjectkeywordstrappedzbad dict key(s): %sriInforBr0 Rr<<>>%i 0 Rnull)noner)rGrr is_encryptedrr setrv difference xref_get_keyrrr get_new_xref update_object xref_set_keyritemsrlr get_pdf_str)r[r6keymap valid_keysdiff_setmsgrtemp info_xrefkvrvalpdf_keys r& set_metadatar`s ::%% }}((788y  a ((& FV[[]#J1668}'' 3H35#h.or6*GAtF{  UB/0 Bw9>A~$$&  )V, VX %9: b VV, () K1VAY5JaVK2S+CyC#33C%%c*C GS1 2LLN Ls  G5G5rc|syd}d}d}d}d}t|ttfvr ||d|d}|S|jdtj }|tj k(ry|dtj k(rJ|jd d} |jd t jdd} | \} } ||| | | }|S|dtjk(r |t j|d }|S|dtjk(r#t j|d } || | }|S|dtjk(rB|d dkr:t j|d } |t j|d | | }|S|dtjk(rO|d dk\rGt j|d } ||d |d j|d j|d | | }|Sy)zrCalculate the PDF action string. Notes: Supports Link annotations and outline items (bookmarks). rc,d|dt|||fdS)Nz/A<> _format_garcds r&rzgetDestStr..s#N1#Yy!QPQ?S>TTW"Xr'c 8d|dt|||fd|d|d S)Nz/A<>>>rrrrrers r&rzgetDestStr..s7OA3fYPQSTVWyEYDZZabcaddghigjj|*}r'cd|d|d|dS)Nz/A<.s>!F1#SCU!Vr'cd|d|dS)Nz/A<.s 3A3c!>rrs r&rzgetDestStr..s.2.r'rr[rr_r^rbr )rrrrTrrrmrhrlrrsrpr-r.)rBrstr_goto str_gotor1 str_gotor2 str_launchstr_urirfd_kindd_zoomr_d_leftd_topfspecs r&rrs XH}JVJOJ.G E{sEl"a* YYvw00 1F """ V})))61% YYtW]]1a0 1 feV4  V}(((w**5<8:  V}+++##E&M2%'  V}***uV}q/@##E&M2'--eDk:E5I  V}***uV}/A##E&M2 &M $KMM $KMM &M     r'rrc |js |jr td|js td|st |j St |ttfvr tdt |}|j}|d}t |ttfvr td|ddk7r tdtt|dz D]}||}||dz}d|d cxkr|ksntd |zt |ttfvs t |d vrtd |dzzt |dtus|ddkrtd |dzz|d|ddzkDstd |dzz|j } g} dg| z} |j| d<|t | kDr;t|t | z D]!}| j|j#ddi} ddd| ddg} t|D]}||} | d}tj | d}t#|jdz t%d| d dz }|j'|}|j)|j*}tj,d|dz }|tj.d}| d dkrtj0|d<t | dkDrt | dtt2fvr tj,d|| dz |d<nt | dt4ur| dj7n|}d|vr||d<no||}tj,|d}|j8j*|j:z |_||j<z}|j>|j:f|d<i}d|d<d|d<d|d<d|d<d|d<tA|||d<|d|d<||d<| |dz |d<| |dz|d<|jCd|d<|jCd dd |jCd!dzz|d"<|dz| |<| | |dz }|jCd#s|r||kDr|dxxdzcc<n |dxxdz cc<|ddk(r|dz|d<|dz|d<n |d|d<| |d}|dz|d<|dz|d<| j|tE| D]'\}}d$}|ddk7r |d%|dzz } ||dz } |ddkDr|d&| |dzz } |ddkDr|d'| |dzz } |ddkDr|d(| |dzz } |ddkDr|d)| |dzz } |ddkDr|d*| |dzz } |d+|dzz }|jCdr/t |ddk(r|d,tMt|dd-z }|jCd"ddkDr |d.|d"zz }|dk(r|d/z }|d0z }|jO| ||*|jQ|S#tF$r!tHd k\rtjJYAwxYw#tF$r!tHd k\rtjJYWwxYw#tF$r!tHd k\rtjJYmwxYw#tF$r!tHd k\rtjJYwxYw#tF$r!tHd k\rtjJYwxYw#tF$r!tHd k\rtjJYwxYw#tF$r!tHd k\rtjJYwxYw)1aCreate new outline tree (table of contents, TOC). Args: toc: (list, tuple) each entry must contain level, title, page and optionally top margin on the page. None or '()' remove the TOC. collapse: (int) collapses entries beyond this level. Zero or None shows all entries unfolded. Returns: the number of inserted items, or the number of removed items respectively. rr;z'toc' must be list or tuplerz'items must be sequences of 3 or 4 itemsrz#hierarchy level of item 0 must be 1rir]z row %i: page number out of range)rr>z bad row %izbad hierarchy level in row %i)countfirstlastrBrr)r_r[r[rr_r r rprevrrftoprrFrBrrrrrz<?? % # $ H V QZRU(j(?!CD D HT5M )c"gV.C\QU34 4 AKs "r!uqy<AFG G a52a519 <AFG G H  II 3?D""$DG IY/1 ,A KK((* + ,VF RT!WEFG6]8 Fd##AaD)#..1$c!QqTAX&67MM#& &&s+22 mmB b 01(9(9: Q4!8 ' 1 1If  q6A:AaDzc5\)")--K!A$4F"G $,0!:+=AaDIIK9 y(&)IdOs8D#MM)D/:E"ll11EGG;EG!D$8$88E',ww&8IdO ' ' & & & y)4& T?%' S1Wo( QK& ]]7+' ]]8Q/!immFA6N2NN' !es a) MM* %cHn 7Oq O 7Oq O '?b !eF7OUF6NvAfI6&>*Dq5DLUF6Nqq8z7#:(2 g;!  ;G, ,C  2f: C  '{Rbk)::: &zB~RZ(888 &zB~RZ(888  (|b '$r(|*<<<  &zB~RZ(888   8bk) )C 66'?s2g;/14 T)E"W+$678: :C 66'1  ! 7R[( (C 6 # #C t  $q'3'u:(xLLN Mo #q(G,B,B,D   #q(G,B,B,D    #q(G,B,B,D    #q(G,B,B,D   #q(G,B,B,D   #q(G,B,B,D    #q(G,B,B,D  s~X2Y2Z  Z9 [&7\ ]2&YY&Z Z  &Z65Z69&[#"[#&&\\&\=<\=&]*)]*tarrY from_pageto_pagestart_atc  -./|jsyd-d/.fd..fd}d-/fd }d} tj|} tj|} |jr| |} | jt j d} | jt j d }|j s| jt j d d }ntj| |} | jt j d| jt j dd | jt j d | jt j d d tj|| }tj| |}|jt j d} |jt j d }|j}tj| |d }tjtj| t j d }|jt j d |||krt!||dz}nt!||dz d}i}|D]}|||}|j#Dcgc]\}}}|tj$k(r|c}}}D]S}tj&| |}|jt j d||\}}|sKd |gd||<U|j)D]}tj&| |}tj||}tj| |} .| g}!| j}"tj| |"d }#| j+|#|"||d<|!||d<|D]S}|||z}$|||}|j#Dcgc]\}}}|tj$k(r|}%}}}|%sOtj,|$}&tj|&j/t j d}'tj |'s8tj|&j/t j dd }'|%D]f}tj&| |}tj0tj2|d}(tj|jt j d}|d k(rtj||})tj| |)}*|*j}tj| |d }+tj*|'|+tj*| |+nN||}|dj5|},|d|,}tj| |d }+tj*|'|+|(sQtj*||+iV|| | |ycc}}}wcc}}}w)zInsert widgets of copied page range into target PDF. Parameter values **must** equal those of method insert_pdf() which must have been previously executed. NcRt|jD]}|j|}|jt j d}t|jD]8}|j|}|j t j d|:y)z3 Make sure all kids have correct "Parent" pointers.KidsParentN)r$ pdf_array_len pdf_array_get pdf_dict_getrPDF_NAME pdf_dict_put) acro_fieldsr_rFkidsjkids r&clean_kid_parentsz%do_widgets..clean_kid_parentss{0023 EA ..q1F&&w'7'7'?@D4--/0 E((+  !1!1(!;VD E Er'c d}d}tj||}tj||}|jtjd} |jtjd} | j r||||| || y| j r||||| || y||||||||y)a^Called for each pair of widgets having the same name. Args: pdf: target MuPDF document acro_fields: object Root/AcroForm/Fields xref1, xref2: widget xrefs having same names name: (str) the name Result: Defined or updated widget parent that points to both widgets. ctj||d}tj||d}|j|}|j||j sqtj ||} | j tjd| jtjd||j|yt|jD]n} |j| } | jtjd|tj|| jd} |j| py)zMerge widget in xref2 into "Kids" list of widget xref1. Args: xref1, kids1: target widget and its "Kids" array. xref2, kids2: source wwidget and its "Kids" array (may be empty). rTr*N)rpdf_new_indirectpdf_array_findpdf_array_delete pdf_is_arraypdf_load_object pdf_dict_delrr.r/pdf_array_pushr$r+r, pdf_to_num) rr0xref1kids1xref2kids2w1_indw2_indrwidgetr_r3kid_inds r& re_targetz3do_widgets..join_widgets..re_targets++C:F++C:F,,V4C  ( ( -%%'..sE:##G$4$4S$9:##G$4$4X$>G$$V,u22452A--a0C$$W%5%5h%?H#44S#..:JANG((1 2r'c`tj|d}|jtjd||j tjdd}tj ||} | j} tj|| d} |jtjd} |jtjd| jtjd| |jtjd} |jtjd| jtjd| |jtjd|jtjd| |jtjd|jtjd| tj||d}tj||d}|j||j||j|}|j||j|}|j||j| y ) aMake new "Parent" for two widgets with same name. Args: xref1, w1: first widget xref2, w2: second widget name: field name Result: Both widgets have no "Kids". We create a new object with the name and a "Kids" array containing the widgets. Original widgets must be removed from AcroForm/Fields. rr7r)r]rFTAAr*N)r pdf_new_dictpdf_dict_put_text_stringrr.pdf_dict_put_arraypdf_add_objectr?r8r-r=r/r>r9r:)rr0r@w1rBw2r~newr1new_obj new_obj_xrefnew_indftaaind1ind2rs r& new_targetz4do_widgets..join_widgets..new_targets$$S!,C  ( ()9)9#)> E))'*:*:6*BAFD**34G"--/L,,S,BG!1!1$!78B OOG,,T2 3  !1!1$!7 <!1!1$!78B OOG,,T2 3  !1!1$!7 < OOG,,S1 2 OOG,,X6 @ OOG,,S1 2 OOG,,X6 @))#ua8D))#ua8D    %    %,,T2C  ( ( -,,T2C  ( ( -  & &w /r'r)N)rr<r-rr.r;) rr0r@rBr~rHrZrPrQrArCs r& join_widgetsz do_widgets..join_widgetss 2<0 0d " "3 .  " "3 . 0 0 89 0 0 89     c;ueU C    ! c;ueU C sKE2t Dr'c tj|tjd}|j s|St |j D]x}|j|}tjtj|tjdr ||}Z|j|jz|S)zVReturn xref list of leaf kids for a parent. Call with an empty list. r)) rr-rr.r;r$r+r, pdf_is_dictrr?)rF kids_listr1r_r3get_kidss r&r_zdo_widgets..get_kidss !!&'*:*:6*BC  " t))+, 3A$$Q'C  !3!3C9I9I&9Q!RS$S)4   !12  3 r'cg}tj|tjd}|j }|dk(r||fS||}||fS)z:Get the xref of top "Parent" and the list of leaf widgets.r*r)rr-rr.r?)rFr^rF parent_xrefr_s r& kids_xrefszdo_widgets..kids_xrefs,s] ##FG,<,.deduplicate_names6s#u**;78 A))+q9G%%'D..w8H8H8MNAIIa$E LL E!H !;;= QKD%5zA~ !9LE5S+ueTB2eWA.//U;001A1A#1FP Q +&r'c~tj|}tjtj|dS)z,Retrieve the AcroForm dictionary form a PDF.z Root/AcroForm)rpdf_document_from_fz_document pdf_dict_getp pdf_trailer)r[rs r& get_acroformz do_widgets..get_acroformRs011#6""5#4#4S#9?KKr'FieldsCOrrRootAcroFormrriP)rqold_kidsnew_kidsrqrvAnnotszAA/Cr*ru)reF) is_form_pdfrrlr-rr.r;rNpdf_deep_copy_objr=pdf_graft_mapped_objectrOr?r8rnr/r$ annot_xrefsPDF_ANNOT_WIDGETr<rvr>pdf_page_from_fz_pageobjr]rmindex)0r#rYrCr$r%r&rerbrjrotarpdfsrcpdfacror0tar_co acro_graftacro_tartar_xref acro_tar_indroot src_rangeparentsr_r\rBwtyperw_objrarurF parent_graft parent_tarkids_xrefs_newparent_xref_new parent_indtar_pagew_xrefs tar_page_pdf tar_annotsis_aac w_obj_graft w_obj_tar w_obj_tar_indrr4r_r[s0 @@@r& do_widgetsrs ??EhET &'8L  0 0 5F  0 0 5F C ''(8(8(BC ""7#3#3D#9:""$,,W-=-=d-CQGF&&|C'89 '**845  0 0 :A> '**401  0 0 6:228TB '' ;++G,<,&&(--fhB !!%"3"3F";W=M=Mf=UV '**:6 EG)Wq[1 )Wq["5 Gy|$#+"6"6"8  eQ000   D ))&$7E   w//4 5%/u$5 !K ! ( "( $ &  3&&vt444XvF ))&,? !*b1$//1++FOQG "":.$3 j!$2 j! 34<x!|$y|$ #+"6"6"8  eQ000    228< '' (8(8(:GJ Ka#;;HeL !00E $//1 % 6 6vx K $$Z?$$[-@ -Z(..t4!*-c2 % 6 6vx K $$Z?$$V];5 <54.cre_annots  K# q" v;'++ +$$W-C--F ,CD CA qssACCVdCEF C[G.. .6{a((2ggdGMM!Q$789GMM1!--1-CKEEEEKKK6 #((2((T3"XKB4( [G// /$$X.CF S[$7E [G,, ,$$U+CE D)E  E r'rrz'start_at' must be >= 0riNr[r ) rJrr*r$rrrrrLrrm_addAnnot_FromStringr+)rrr$r%r&rfprsaincrrr_pno_dstxref_srcrp_srcp_dstold_xrefrqpage_srcrrpage_dstlink_tabr annot_texts r&do_linksrs ,b1}  doo % __q  {g0 __q  !|233 Bb1bD5R$Y-.G$S\23!rAv3G3HH 3w< "  >>%(>>%(!! "3x= !< #""$ u:?H --- # ,AyG---1V9G3K"1h=J +  , r>  ) )5? ;)<4s Grc r|j}|}|d}tt||z}d}|dtjk(r|ddk\rtj d}|d}|j j|} |jdtjdd} |j |} | j} | } | | z}|| |j|j|jdd|}ntj d }|tj|d|}n|dtjk(r|ddk\rtj d }|jdtjdd} t| tjurtjdd} ||d| j| j|jdd|d |d |}ntj d }|tj|d|d |}n|dtjk(r$tj d }||d |d |}n|dtj k(r tj d}||d|}nJ|dtj"k(r4tj d}|jd}||d}|||}|s|St%|j'Dcgc]#}|dtj(k(s|d|df%c}}|jdd}|r|d|f|j+vr|}nBd}tj,j/dz} ||z}||j1vrn|dz }|j3dd|z}|Scc}w)Nr\rr[r rrr_rgoto2rrbrrr^rur~ nameddestrr]r~rBz-L%iz/Linkz /Link/NM(%s))rLrr+rrmrrFrrTrhr-r.rrprrsrlrtr r|rrTOOLSset_annot_stemvaluesrr)r rrictmrr rr!rZrBr{ dest_pagedest_ctm dest_ictmipntlnamer- link_namesold_namer~r_stems r& getLinkTextrUs  $ $C 4D F A U1t8_ %D E 6{g''' v;! $$W-Cf+C;;((-D''$ a 34C C(I 66H! I?Ddffdffcggfa.@$GE$$W-C++CI6=E V** * v;! $$X.C''$ a 34CCy -mmAq)F "F F E$$X.C++CI6F TJE V++ +  *CKVd3 V(( (  'CJ% V** *  ) = $EE4   #//1T!QqTW=S=S5S!A$!TJwwtR HS[(+z/?/?/AA }}++-6!8D:,,.. FA  MM'>D#8 9E L# Us >N4 N4rFc.tj|t|dd}| td|j}|j |d|j _t|jj}|D]}|j|=|S)z0Delete widget from page and return the next one._annotNzbad type: widget) rrErrr delete_annotrrFr*__dict__rv)r rFr nextwidgetkeylistrs r& delete_widgetrs  FHd +E }+,,JeFMM6??'')*G! OOC ! r'ctj|t||}|dk(r td|jj |d||y)z"Update a link on the current page.rlink kind not supportedrB)r N)rrErrrFr)r rrs r& update_linkrsL  c "E {233KKc&k5t= 0. It is the height of the unused (still available) rectangle stripe. Positive only if scale_min = 1 (no down scaling). scale: downscaling factor, 0 < scale <= 1. Set to 0 if spare_height = -1 (no fit). rrzbad rotation anglerrz'scale_low' must be in [0, 1]Nr)rrzbody {margin:1px;})r2user_cssrz"'text' must be a string or a Story) scale_min scale_maxrircRjjtjfSN)r rIdentity)rfits r& rect_functionz%insert_htmlbox..rect_function sxx7#3#333r'CAcaraz gs )rrrr]r\)rrrrrrrQStory fit_scale big_enoughfilled parameterr rwrite_with_links _set_opacityr_insert_contentsencoder!r*r+r,r-r.rr)r r rrrrrrr r temp_rectmycssstoryrrscale spare_heightrr[r$alp0smp1mp2rrrs @r&insert_htmlboxrE sJ B;! -.. 1*#  1* C-#  C- Q 899 899 { << D LLAt{{DJJ? LLAtzz4;;?  !3 &E$ 4%I D'-- (=>>"QA MI //)qI/ FC >>I ZZF  E88;;*L z\A% 4   /C GaA!!W!9vUO &&uahhj!< tS!Fr7K 88;; $ )E 1C 77TWW  !C uaECEE6CEE6: ..& ! " ..Aq!SUUCEE 2 3A  " V     r'rrc4|j|||||S)a<Create and return a new page object. Args: pno: (int) insert before this page. Default: after last page. width: (float) page width in points. Default: 595 (ISO A4 width). height: (float) page height in points. Default 842 (ISO A4 height). Returns: A pymupdf.Page object. r)_newPage)r[rZrrs r&rr sLLE&L1 s8Or'c t|j|||} t|sy| jd|||||} | S)zCreate a new PDF page and insert some text. Notes: Function combining pymupdf.Document.new_page() and pymupdf.Page.insert_text(). For parameter details see these methods. )rZrrr)2r)rrrr)rrlr) r[rZrrrrrrrr rs r& insert_pager sP" <PAJJ%!  JJw Hr'c |j}|jtj|tj||}|j |||d||| | | |  |j | |S)z-Draw a zigzag line from point p1 to point p2.r!Fr)r draw_zigzagrrhrrr#s r&r%r%> sx" .. C  b)7==+OQXQ^Q^_aQbcAJJ %!  JJw Hr'beta fullSectorc |j}|jtj|tj|||}|j |||| | | || ||| |j | |S)aDraw a circle sector given circle center, one arc end point and the angle of the arc. Parameters: center -- center of circle point -- arc end point beta -- angle of arc (degrees) fullSector -- connect arc ends with center rAr2)r draw_sectorrrhrr)r r4rr@rrrrArrrrrrrrrrr+s r&rDrDe s~6 .. C  f-w}}U/CTV`aAJJ %!  JJw Hr'c ltjDcgc] \}}}}| c}}}}Scc}}}}w)zP Returns a list of upper-case colour names. :rtype: list of strings rcolors_wx_list)r~rgrs r& getColorListrI s, '.&<&<&> ? ?]T1aD ?? ?s. c*tjS)z Returns list of (name, red, gree, blue) tuples, where: name: upper-case color name. read, green, blue: integers in range 0..255. :rtype: list of tuples rFrr'r&getColorInfoListrK s  ! ! ##r'r~cftjj|jdS)zRetrieve RGB color in PDF format by name. Returns: a triple of floats in range 0 to 1. In case of name-not-found, "white" is returned. )rrr)rcolors_pdf_dictrTr?)r~s r&getColorrN s&  " " $ ( (y AAr'c< ttj|j}|ddz }|ddz }|ddz }t|||}t|dzd}t|||}||z }|dk(rd} n6||k(rd||z |z d zz} n"||k(rd||z |z dzz} nd||z |z d zz} tt| } |dk(rd} n||z } tt| dz} | | |fS#t$rt rt jYywxYw) zRetrieve the hue, saturation, value triple of a color name. Returns: a triple (degree, percent, percent). If not found (-1, -1, -1) is returned. riririrgo@r]rdrgN@r>) rKrIrrRrgrrrrrr/r) r~r-rrHrcmaxVcmindeltahueHsatSs r& getColorHSVr[ sE   |~33DJJLA B !u A !u A !u A q!Q !((F X **FF#'(# X&A;(#(#J' ~v;#uoG( !|%% (6"HUOXj5I7TW HXHQK 3) Mr'c+eZdZdZedZdejfdZdZ de de dejfd Z d e dejfd Zde de d e d e dejf dZdej"eefdejfdZde dedejfdZde de d e dejfdZ dGde de dededejf dZdddedejfdZdedejfdZ dHde de dedejfd Z dHde de dejfd!Zd"dd#dd$d$ddd$d%d&d$dd&d&d$d'de d(ej"ee fd)ed*ed+ed,e d-ed.e!d/e"d0e"d1e!d2ed3ed4e!d5e"d6ed7ed8e!de!f&d9Z#d#dd"dd$d$ddd&d%d&d$d$d$dd&d&d$d:ded(ej"ee fd+e d,e d)ed*ed-ed.e!d/e"d0e"d;e!d2ed3eded/e"d0e"d?e!d@e!dAe dBed5e"dCed7ed6ed8e!ddfdDZ%dGdEeddfdFZ&y)JShapezCreate a new shape.cVtj||z j}tjt |j }|jdkr:|j dkrtj|z }|Stj|z }|S|j dk\r |S| }|S)zReturn the angle to the horizontal for the connection from C to P. This uses the arcus sine function and resolves its inherent ambiguity by looking up in which quadrant vector S = P - C is located. r) rrhrmathasinrr.r-pi)CrtrZalfas r&horizontal_anglezShape.horizontal_anglen s MM!a% % %yyQSS" 337ssax4( ww~  ssax u r'r ctj|||_|j|_|jj s t d|jj|_ |jj|_ |jj|_ |jj|_|j|_|j|_d|_d|_d|_d|_d|_y)Nr;r)rrEr rFr[rGr mediabox_sizer.rr-rcropbox_positionrLpctmipctm draw_cont text_cont totalcont last_pointr )selfr s r&__init__zShape.__init__ sD! ;;xx[) )((** '')) &&((&&((.. iiZ  r'c|jEt|dk(rtj|||_ytj||_yt|dk(rtj|}t |jj |j|j_t |jj|j|j_t|jj|j|j_ t|jj|j|j_ ytj|}t |jj |j |j_t |jj|j|j_t|jj|j|j_ t|jj|j|j_ y)Nr]) r rrrrhr/rr-rr.rrr)rr-s r& updateRectzShape.updateRect sP 99 1v{#LLA. #LLO 1v{MM!$"499<<5 "499<<5 "499<<5 "499<<5 LLO"499<<6 "499<<6 "499<<6 "499<<6 r'rrr ctj|}tj|}|j|k(sY|xjt tj ||j zdzz c_||_|j||xjt tj ||j zdzz c_|j|||_|jS)zDraw a line between two points. m  l )rrhrrrr0rr)rrrs r&rzShape.draw_line s ]]2  ]]2 2% NNi(8(8djj(IJVS SN DO OOB  )G$4$4R$**_$EFOO r'r0c tt|D]\}}|dk(r|jtj|k(s|xjt tj tj||jzdzz c_tj||_nT|xjt tj tj||jzdzz c_|j|tj|d|_|jS)z%Draw several connected line segments.rrrri) rrrrhrrr0rr)rr0r_rs r&r3zShape.draw_polyline sf% DAqAv7==+;;NNi0@0@qAQTXT^T^A^0_&`ci&iiN&-mmA&6DO)G,<,zinvalid arg lengthr __float__rr)rrrrrr,r/ulurlrllrrrr0rr<rr )rrqmtmrmbmls r&r9zShape.draw_oval st u:?12 2 58[ ) U#((A U#A TTQTTADD[C' ' TTQTTADD[C' ' TTQTTADD[C' ' TTQTTADD[C' '2% NNi(8(8djj(IJVS SN DO ADD"% ADD"% ADD"% ADD"% r'r4r(c|tjkDs tdtj|}||dfz }|j ||ddS)r6radius must be positiverrFrC)rEPSILONrrhrD)rr4r(rs r&r7zShape.draw_circle sP'67 7v& vqk !CEBBr'cd}tj|}tj|}tj|}|||z |zz}|||z |zz}|j||||S)z4Draw a curve between points using one control point.g7.SQ?)rrhr?)rrrr:kappak1k2s r&r<zShape.draw_curve sp ]]2  ]]2  ]]2  27e# # 27e# #BB//r'rr@rAc j tj|}tj|}d}d}d}tj| }tjtjd|dz} tjtjd|} | dz } t |dtj zkDr%|| z }t |dtj zkDr%|j|k(s?|xj|tj||jzz c_||_tjdd} |} |}|| z }t |}|tjkDs td |j||}t |t | kDr| jtj|| z|zz}| j tj"|| z|zz}tj||} | jtj|| z|ztj| z z}| j tj"|| z|ztj| z z}tj||}d tj| z d zd z t || z z }|t || z z}|||z |zz}| || z |zz}|xj|tjt%||jzt%||jzzt%| |jzzz c_|| z}|| z }| }t |t | kDrt |d kDr|dz }| jtj||z|zz}| j tj"||z|zz}tj||} | jtj||z|ztj|z z}| j tj"||z|ztj|z z}tj||}d tj|z d zd z t || z z }|t || z zd tj|z z }|||z |zz}| || z |zz}|xj|tjt%||jzt%||jzzt%| |jzzz c_|r|xj|tj||jzz c_|xj|tj||jzz c_|xj|tj| |jzz c_| |_|jS)zDraw a circle sector.c"t||fdzS)Nrrrs r&rz#Shape.draw_sector.. )QF+f4r'c*t||||||fdzS)Nrrrs r&rz#Shape.draw_sector.. siAq!Q0B&Cf&Lr'c"t||fdzS)Nrrrs r&rz#Shape.draw_sector.. rr'rrirr]rrrr>rgMbP?)rrhrradianscopysignrrrrr0rrrrr-cosr.sinr*)rr4rr@rAl3l4l5betarw360w90w45r+rrtrZradrq1q2r1r2Rkappahrcp1cp2beta2s r&rDzShape.draw_sector sv& e$ 4 L 4 dU#||DMM#u56"=ll4==U34Ag%j1tww;& TME%j1tww;&5( NNb'"2"254::3E"FG GN#DO MM!Q    E!fW__$67 7$$VU3%j3s8#txxs +c11Btxxs +c11B b"%Atxxs +c1DHHSMAABtxxs +c1DHHSMAAB b"%A$((3-'1,q03q1u:=FSQZ'Eq1uo%Cq1uo%C NNb'"2"2S4::%&cDJJ.>)??$q4::~BVV# N SLE CKDA#%j3s8#& u: AIEtxxu -33Btxxu -33B b"%Atxxu -3dhhuoEEBtxxu -3dhhuoEEB b"%A$((5/)Q.2SQZ?FSQZ'1txx+>?Eq1uo%Cq1uo%C NNb'"2"2S4::%&cDJJ.>)??$q4::~BVV# N  NNb'"2"254::3E"FG GN NNb'"2"26DJJ3F"GH HN NNb'"2"21tzz>"BC CNr'Nr'r c tj|}||xjttjt |j |jz|j|jgzdzz c_|j||j|_ |jSt|drE|dks|dkDrtd|dt|j|j|z}|df}d|f}n}t|drbt!|dk(rT|\}}||jzdf}d||jzf}t||dkst#||dkDrtd|dtd|d|j%|j|z|j |z } |j'| |j |j |z} |j%| |j(|z } |j'| |j(|j(|z } |j%| |j*|z} |j'| |j*|j*|z } |j%| |j|z} |j'| |j|j|z|_ |j||jS) aDraw a rectangle. Args: radius: if not None, the rectangle will have rounded corners. This is the radius of the curvature, given as percentage of the rectangle width or height. Valid are values 0 < v <= 0.5. For a sequence of two values, the corners will have different radii. Otherwise, the percentage will be computed from the shorter side. A value of (0.5, 0.5) will draw an ellipse. z re rrrzbad radius value rZ__len__r])rrrrr0r*blrrrrr*rrrr/rrrr<r+r2) rr r(rrrpyrxrylps r&r*zShape.draw_rectW sc LL  > NNi(8(8QTTDJJ&'177AHH*==) N OOA ddDO?? " 6; '{fsl #4VHA!>??AGGQXX&/AQBQB VY 'CK1,<FBqww,"BR!((]#B2r{a3r2;#4 #4VHA!>??0:; ; ^^ADD2Iqttby 1 __Rqttby 1 ^^Br * __Rqttby 1 ^^Br * __Rqttby 1 ^^Br *//"addADD2I> r'r,ctj|}|j|j|j|j |j |jgS)z Draw a Quad.)rr/r3rrrr)rr,rs r&r.zShape.draw_quad s@ LL !!144qttQTT144"@AAr'rcBtj|}tj|}||z }t|}dtt |d|zz dz}|dkr t d||z }tj tj||}|} g} td|D][} | dzdk(rtj| d|z} n#| dzdk(rtj| d|z} nH| j| | z]|j|g| z|gz|S)z%Draw a zig-zagged line from p1 to p2.r>rpoints too closerrir) rrhrrrrr,util_hor_matrixr$rr3) rrrrrZrcntrrAi_matr0r_rs r&r%zShape.draw_zigzag s]]2  ]]2  G!f#eC1w;/344 7/0 0 3Y 7 7B ?@q# %A1uzMM!R(2-Q!MM!Q'", MM!e) $ % B4&=B4/0 r'ctj|}tj|}||z }t|}dtt |d|zz dz}|dkr t d||z }tj tj||}|} d} g} td|D]t} | dzdk(rtj| | |z} n;| dzdk(rtj| | |z} ntj| d|z} | j| | zv|g| z|gz} t| }d} | dz|kr0|j| | | | dz| | dz| dz } | dz|kr0|S)z#Draw a squiggly line from p1 to p2.r>rrgh?3OP@rrr]) rrhrrrrr,rr$rrr<)rrrrrZrrrrArrr0r_rs r&r"zShape.draw_squiggle s]]2  ]]2  G!f#eC1w;/344 7/0 0 3Y 7 7B ?@ q# %A1uzMM!aR(2-Q!MM!Q'",MM!Q'", MM!e) $ %"%&k !eck OOF1Iva!e}fQUm D FA!eck r'rrrrr)rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrc z t|syt|ttfvr|j }n|}t |dkDsyt j|} tdj|Dcgc] }t|c}}|}|jdr|dd}|jj||||}t j |j"|}|d}|d}|d}|d}|d }|d }|r||z}n||z dkr|d z}n|||z z}|d kDr |j"j%||dz} n|d } g}!|D]4}"|r|dvrd}#n| }#|!j't j(|"|#||6|!}t j*| d}$t j*| d}%| s| dk(r| } t j*| d}%t j,|}&|}'|'dzdk7r t/d|'dkr |'dz }'|'dkr |'dz}'d}(d})d}*d}+d},|j0}-|j2}.|&rt j4dddd|dj6|j6z|-|dj8z |j8z }/|/|dz|/z}0t;t j<|0dz}1nd}1|-|j8z |j8z }2|j6|j6z}3|2}4|'dk(rJ|-|j8z |j8z }3|j6 |j6z }2|1|*z }1|.t?|2z }4n|'dk(rG|- |j8z|j8z}3|j6|j6z}2|1|+z }1t?|2}4nc|'dk(r^|j6 |j6z }3|- |j8z|j8z}2|1|,z }1t?|j8|j8z}4|jjA|}5|5d|5z}6d}7ndx}6}7|jjC||}8|8d}8nd |8z}8|(|6|8|1|3|2||}9| dkDr/|9d!| zz }9|9t;| |zd"zz }9| |9t;| d#zz }9| |9|$z }9| |9|%z }9|9|dz }9d}:t |dkDr |9|)|z }9n|9d$z }9tEdt |D](};|4|krn!|;dkDr|9d%z }9|9||;d$zz }9|4|z}4|:dz }:*|9d&|7zz }9|xjF|9z c_#|:Scc}w#t$rt jYywxYw)'Nrrrarrrrrrmrr~rbrcr_r{rzryrrrrrc Rd||d|dt||fd|dt|d S)N q BT 1 0 0 1 z Tm /r Tf r)rrrrrrrHs r&rz#Shape.insert_text..2sEuQCs$qc)UVXYTZJ[I\\bcdbeefgpqrgsfttx-yr'c dt|dS)NzTJ 0 -z TD rrs r&rz#Shape.insert_text..3sWYq\N%8r'0 1 -1 0 0 0 cm 0 -1 1 0 0 0 cm -1 0 0 -1 0 0 cm  cm rrr /OC /%s BDC EMC r/%s gs %i Tr  w  M TJz T* z ET %sQ )$rlrr*r+ splitlinesrrrhrjoinordrgrrr insert_fontr}r[rrgetTJstr ColorCode CheckMorphrrrr,r-r.rr0r_get_optional_contentrr$r):a3q6:;G    C !"IEyy$$XZ% ((48A;J'(#&!J'[) +G  !Q &nG(Y"67G S=XX--dGaK@Fh'F AA&(BB JJw''1fh? @  A %%eS1 $$T3/ q(D((4H%%e, 8q=/0 0Ag 3JCAgCiy8##$  1aE!HJJ,?%PQ(**ATW[W]W]A]^B#a.2%C7++C01G;BBuww'ww "9EGG#dff,D77(TVV#C %KBCH$ECZ7UWW$tvv-D''DFF"C %KBHECZGG8dff$D'EGG#dff,C %KB$&&()E))11"5  !G+CCNC# &&.\&J =E&Ec5"dCA ? H{* *D IlX56> >D& +.66   I D   H D Q t9q= F7O #D DLDq#d)$ Aw1u DGdN "D W E aKF  ## $ g;   " " $ s$T4TTTT:9T:)rrrrrrrrrrrrrrrrrrrrc PQtj|}|js |jr t dtj | d}tj | d}| |dk(r| } tj | d}|j j|}|d|z}d}ndx}}|j j|| }|d}nd |z}|d zdk7r t d |}|dkr |d z }|dkr |d z}t|s|dvr |jS|jSd}d}d}|j}|} | jdr| dd} |j j| |||}!tj|j|!}"|"d}#|#dQ|#d}$|#dP|#d}%|#d}&|#d}'|r|}(n|&|'z dkrd}(n|&|'z }(|(z})t!|t"t$fvrdj'|}*n|}*t)|*D+cgc] }+t+|+c}+},|$r4|,dkDr/dj'|*D+cgc]}+t+|+dkr|+ndc}+}*|*j-}*|jj/|!|,dzP|$r|%d vrd}-nP}-PQfd!}.Qdkr Pd"dz}/n}/d}0tj0|rtj2dddd|dj4|j4z|j|dj6z |j6z }1|1|dz|1z}2t9tj:|2d#z}3nd}3d}4tj<d|&z}5|dk(r(|j>|5z}6|j}7|j}8n|d k(rFtj<|&zd}5|j@|5z}6|j}7|j}8|3|z }3n|d$k(rItj<d|&z }5|jB|5z}6|j}7d%}4|j}8|3|z }3nHtj<|&zd }5|jD|5z}6|j}7d%}4|j}8|3|z }3g}9tG|*D]I\}:};|;jI| jKd&}|7}?tO|=D]}@|<|@}A|.|A}B|?|Bk\r|>Ad&zz }>|?B|/zz}?&|>r)|>jQdz}>|0|>z }0|9jSd'd}>|7}?B|7krAd&z}>|7Bz |/z }?htM|9dkDrd(|9d%<AD]9}+|.|>|7|.|+z kr|>|+z }>|>dz }>|0|>z }0|9jSd(|+}>;|>d&z }>|7|.|>z }?|>r$|0|>jQz }0|9jSd(|:tM|*dz ksE|0dz }0L|0jUdr|0dd%}0|0jWddz}C|)|Cz|'zz }D|D|8z }E|EtjXkDrd%EzSt[E}E|EtjXkrd}Ed)||d*|3z}Fd+}G|0j-}Hd(|9d%<tG|HD]?\}:}Id}J|7|.|Iz }K|6|5|:|(zzz}L|dk(rD|dvr Ltj<Kd,z d|4zz}LnLtj<dKd,z |4zz }Lnk|d,k(r>|dvrLtj<Kd|4zz}LnELtj<dK|4zz }Ln(|d-k(r#IjWd&}M|MdkDr |9|:rKMz }Jnd}J|Lj6z |j6z }N|Lj4|j4z}O|d k(r7|Lj6z |j6z }O|Lj4 |j4z }Nnx|d.k(r7| Lj6z|j6z}O|Lj4|j4z}Nn<|d$k(r7Lj4 |j4z }O| |Lj6z|j6z}NFGON| z }F|dkDr/Fd/|zz }F|Ft9| zd0zz }F| Ft9| d1zz }F|d-k(rFt9Jd2zz }F| F|z }F| F|z }FFd3tj\I|-|$Qzz }FBFd4|zz }F|xj^|Fz c_/|ja|EScc}+wcc}+w)5aQInsert text into a given rectangle. Args: rect -- the textbox to fill buffer -- text to be inserted fontname -- a Base-14 font, font name or '/name' fontfile -- name of a font file fontsize -- font size lineheight -- overwrite the font property color -- RGB stroke color triple fill -- RGB fill color triple render_mode -- text rendering control border_width -- thickness of glyph borders as percentage of fontsize expandtabs -- handles tabulators with string function align -- left, center, right, justified rotate -- 0, 90, 180, or 270 degrees morph -- morph box with a matrix and a fixpoint Returns: unused or deficit rectangle area (float) z%text box must be finite and not emptyrrNrrrrrrrzrotate must be multiple of 90r)rrrrrrarrrmrr{r~rbrcr_rrr|?rc dkr+t|Dcgc]}t|dc}zSt|zScc}w)zCalculate pixel length of x.rr)sumrr)r-rrr{rms r&pixlenz$Shape.insert_textbox..pixlensF!|q9!F3q6N1-9:XEE1v((:sA rrrirTFrrcBdt||fd|dt|dS)Nrz Tm /rrrrs r&rz&Shape.insert_textbox..s+XiA.?-@aS)TU,W[#\r'r]rrrrrz Tw z%sTJ zET %sQ )1rrrHrIrrr rrrlrrrrr}r[rr*r+rrrrrrr,r-r.rr0rhr*rr+r2rrsplitrr$rstriprendswithr rrrrr)Rrr rrrrrrrrrrrrrrrrrrrrrr r rrzrrrrrrrBrrkrrrbrclheight_factorrrrr tj_glyphsrblenrr rrprogrc_pntrmaxwidth maxheightjust_tabr_rline_t num_wordslbuffrestr2wordpl_wlb_count text_heightmorertempltext_trspacingplr{spacesrr r{rmsR ` @@r&rzShape.insert_textboxs X||D! ==D,,DE E%%eS1 $$T3/ >II  ) a<":a=8+DD   e $1aE!HJJ/uQxzz1IDFF1RB#a.2%C7++C01G;BB  aH!45 !8GGeOEzzH I BYMM(X"5q9EGGeOE{{H I %KB CZ]]1h&9::EGGeOEzzHE{{I %KB]]8h#6::EGGeOE{{HE I %KB  }2 GAt__Z066s;FF IED9%# 0ayd|4<TCZ'ED4K'D!LLNT1EEMDOOD)8# 3JE#d?T1Dx=1$#(HRL"Ae}6!9(<<    . !" &-/G# 0J &&3r7Q; e2 j == 9D::d#a'(9x+?? Y& '// !$; 4y '// !D"%u-2\" f%/ PDAqGF1I%B%1~#566Cz(? b1fa 85 @@C aa 85 @@C!(? b! 4u <Dby~.uuftvvow/eedffnvgo. E$UH5 5DQ;.. ,"9:UBB*Ik2U::Dz '*V33  !  Hw//9fhOO OD_/ Pb c!! $  ]+Bs c1c"rrrreven_oddrc |jdk(ry|dk(rd}n|d}tj|d} tj|d}|jj | }|d|z|jz|_d}nd}|jj | | }|d |z|jz|_|d k7r&|dk7r!|xjt |d zz c_|dk7rd |z|jz|_|dk7rd |z|jz|_|dvrd|z|jz|_| r|xjdz c_d|_||xj| z c_|s|xj|z c_|.|s|xjdz c_nY|xjdz c_nC|s|xjdz c_n+|xjdz c_n|xjdz c_|xj|z c_tj|rtjd ddd |dj|jz|j|djz |jz }||d z|z}t tj|dz|jz|_|xjd|jzdzz c_d|_d|_y)zFinish the current drawing segment. Notes: Apply colors, opacity, dashes, line style and width, or morphing. Also whether to close the path by connecting last to first point. rNrrrrrrrrz w z%i J z%i j )Nrz[] 0z%s d zh zB zB* zf zf* zS rrzQ )rrrr rrrrrr,r-rr.r0r)rrrrrrrr1rrrrrrrr rrzr rs r&rz Shape.finishs, >>R   A:E ]E%%eS1 $$T3/))11"5  ,w6GDNCC &&.\&J  '%/$..@DN A:%1* NNi.7 7N a<%/$..@DN q=%04>>ADN + +%.?DN  NNe #N"DO   NNi 'N   NNh &N NNe+NNNf,NNNe+NNNf,N NNe #N #   e $1aE!HJJ/uQxzz1IDFF1RB#a.2%C&w'7'7'<=G$..XDN 'DNN2U::r'rctj|j|xj|jz c_|jj |_|jrm|r|jj tjj|jd|}|jj||jd|_ d|_ d|_ d|_d|_y)zUpdate the page's /Contents object with Shape data. The argument controls whether data appear in foreground (default) or background. rjNr)rrEr rrrrWrrr[rorr r)rrrBs r&rz Shape.commit0s DII& $..(..0 >> '')==11$))T7KD HH " "4 8 r'T)r]) rrNrrNFNTrrr)'__name__ __module__ __qualname____doc__ staticmethodrrrrrrrhrr*r3r?typingUnionr rr9rr7r<rlrDr*r.r%r"rQOptFloatOptStrrOptSeqrrrrrr'r&rrk s&W\\(7* J J 7==  D W]]         .v||Iy,@Agmm0C*CeC C 0  0  0  0  0( HHH H  H  HT481i1GMM1fBiBGMMB      B # # #  #Z#" !)xx S$Y'x  x  xxxxxxxxxx !x"#x$%x&'x( )x* +xD"#" !-BB S$Y'B  B  BBBBBBBBBB !B"#B$%B&'B()B*+B, -B. /BL  !YYY Y  Y  YYYYYYY Y Yvddr'rimagesgraphicsc <d}tj||j}|js |jr t d|j s t dg}|jtjfD]!}|j|j#|gk(ry|j|||}|s t d|j} |D]} | d} | d} | r$| j| | j| | d | jvsF| d } | j!d d }| d }| d}| d}|| | ||}d}|d ks|dk\s| j#|| ||||}|dz}|d ks|dk\r(| j%y)aApply the redaction annotations of the page. Args: page: the PDF page. images: 0 - ignore images 1 - remove all overlapping images 2 - blank out overlapping image parts 3 - remove image unless invisible graphics: 0 - ignore graphics 1 - remove graphics if contained in rectangle 2 - remove all overlapping graphics text: 0 - remove text 1 - ignore text c|r|jtjkr|S tj|||}|dz}|j}tj||z |z}||jk\r|S|}|jj|jjz|z dz} | |_|S#tt j f$rtrtj|cYSwxYw)aCalculate minimal sub-rectangle for the overlay text. Notes: Because 'insert_textbox' supports no vertical text centering, we calculate an approximate number of lines here and return a sub-rect with smaller height, which should still be sufficient. Args: annot_rect: the annotation rectangle new_text: the text to insert. font: the fontname. Must be one of the CJK or Base-14 set, else the rectangle is returned unchanged. fsize: the fontsize Returns: A rectangle to use instead of the annot rectangle. r_r)rrrget_text_lengthrrrrrrceilrr*r.rr) annot_rectnew_textrhfsize text_width line_heightrjhrr.s r& center_rectz%apply_redactions..center_rect^s :++w>   004GJ ck    IIj5( )K 7 !! !   ]]__z}} . 2c 9E--. #&&(  sB555C-,C-rr;)typesFzError applying redactions.r r)rrrrrrr text_colorrir>)rrrrrT)rrErFrrrrGrNPDF_ANNOT_REDACTr_get_redact_values_apply_redactionsrr*rrvrTrr)r r@rArrLr[ redact_annotsrrshaperedactrFrrGrrrHrtrects r&apply_redactionsrVIs* D  ++C 3==788 ::%%M'')9 U5578 9   fh 7B 566 NN EF^ f~  OOJ ' LLd$L / V[[] "f~HJJw*E:&E:&E<(E HeUCEBq&UaZ))"" * q&UaZ!6 LLN r'attached_files clean_pagesembedded_files hidden_text javascriptmetadata redactions redact_images remove_links reset_fieldsreset_responses thumbnails xml_metadatacjd}|js td|js |jr td|sd}d}|r|j i|D]}| r%|j D]}|j | r(|j}|D]}|j|d}|jD]k}|jdtjk(r|r|jd| r|j|jdtj k(sjd}m|r|r|j#| |s|s|j%|j's|r_|j'd}|j)|}||j+}|r#d j-|}|j/||| sw|j1|j2d dd k7s|j5|j2d d |r&|j7D]}|j9|| r|j;| s|sd}n|j=}t?d |D]}|jA|sd|z}t||r-|j1|dd dk(rd}|jC||S| sV|j1|dd dk(r'|jC|d|j/|dd|j1|ddd k7s|j5|dd y)NcHg}d}d}d}|D]}|dk(rd}|j||dk(rd}|j|5|dk(rd}d}?|dddk(r|d d k7rd}|j|c|d k(rd}|j|||r|r|j||r|Sy) a_Remove hidden text from a PDF page. Args: cont_lines: list of lines with /Contents content. Should have status from after page.cleanContents(). Returns: List of /Contents lines from which hidden text has been removed. Notes: The input must have been created after the page's /Contents object(s) have been cleaned with page.cleanContents(). This ensures a standard formatting: one command per line, single spaces between operators. This allows for drastic simplification of this code. FsBTTsETs3 TrNsTrr3Qr) cont_lines out_linesin_textsuppress make_returnrs r& remove_hiddenzscrub..remove_hiddens    #Du}  &u}  &w" BCyE!d1go   &t|   &G   T "/ #0  r'r;zclosed or encrypted docFrrj)rT)r@ Thumbrrz(bad xref %i - clean PDF before scrubbingrZz /JavaScriptz<>Typez /Metadatarsdeleted)rRMetadata)"rGrrrrwidgetsresetr delete_linkrNrrPDF_ANNOT_FILE_ATTACHMENT update_filedelete_responsesrrOrVclean_contentsrK xref_streamrrrorrBr embfile_names embfile_deldel_xml_metadata xref_lengthr$ xref_objectr)r[rWrXrYrZr[r\r]r^r_r`rarbrcror rFrr found_redactsrrBcontrjr~ xref_limitrrs r&scrubrs /b ::%% 3==233    '= ,,.    NN$E '  & ' [[] %Ezz!} ? ??N!!!.&&(zz!} 8 88 $  % -  ! ! ! 7{    "  $$&q)D??4(D&t'89Jzz*-!!$-  73A6&@  GV.textlens" Z   r'c,j|S)z5Return list of single character lengths for a string.r) char_lengthsrs r&rz"fill_textbox..char_lengthss  X* MMr'c4j||}|S)N)rhrrri)rrretrhrrr%s r& append_thisz!fill_textbox..append_thiss(mmTxJ r'g?rclg}g}|D]}|}t|}||kr#|j||j|>t|}|dkDsOt|d|}||kr;|j|d||j|||d}||d}t|}n|dz}|dkDrY||fS)z.Cut any word in pieces no longer than 'width'.rNr)rrr) rrr word_lengthsrwl_lstwlrars r& norm_wordsz fill_textbox..norm_wordss  A!!_FVBU{ a ##B'F Aa%_;MM!BQ%( ''+!"A#ABZFF AFAa% (|##r'cN|jdDcgc] }|dk7s | }}t|}|dk(ry|dk(r  ||dyt|Dcgc] } | c}}|dz } |z |z }|D]"} ||\}} | j|z|_$ycc}wcc}w)zJustified output of a line.rrrNr)rrrr-) startrrrrr*gapsgaplrrr std_widthrs r&output_justifyz$fill_textbox..output_justifys!JJsO7qqBw77U Q;  Q; uQx (  e,'!*, -zB$& "Aq)EArddTkEG " 8-s BBB"rr_NzText must start in rectangle.rrr)rrzOnly fitting %i of %i lines.z Warning: r]r)%rrrHrrrarrrbrcrhr*TEXT_ALIGN_CENTERTEXT_ALIGN_RIGHTrQrrrrr.rrrrr- clean_rtlrrrrr$pop IndexErrorrrreversedTEXT_ALIGN_JUSTIFY))r%r rrrhrrrrrrr space_len std_startrrrfrgr LINEHEIGHTrfactor textlinesr max_lines new_lines no_justifyr_r*rrraline0rrrrrrrrs)` `` ` @@@@r& fill_textboxrcs6 << D }}455 Dz%||F# N 3I I Y&I)#I$4$ --C ..C  9>GCiGG#J E mmC ggHsN33 $899 ))) '** * DzSOO%   0D   T__. / 0TWWsuu_ 23a7IIJY'(4 9    dI. /JJ*E   s9~1 3  6GGceeOEJJ*E ##D)D T] ;   dBZ (   s9~1 3  3)6| JHHU2AY'E\"1%&a!e)<A%&&J 9   }}Q'HD" 778D>*D 6E G.. .1J3F2PY> 5$ 'EG GGz !G  q5CEEY& GG f, ,GE4  :14 / #q(G,B,B,D * / s.Q??&R*)R*c|js |jr td|j|d\}}|dk7s|dvrtd|z|j|d\}}|dk7ryt |j d d }|S) zReturn optional content object xref for an image or form xobject. Args: xref: (int) xref number of an image or form xobject. document close or encryptedSubtyper~z/Imagez/Formbad object type at xref %iOCrBrrr)rrrrrrr)r[rBrr~rrs r&get_ocrIs  }}((677tY/GAtF{d"555<==   T4 (EArF{ RZZr " #B Ir'c|js |jr td|j|d\}}|dk7s|dvrtd|z|dkDr,|j|d\}}|dk7s|dvrtd|z|dk(r'd |j |vr|j |d d y |j |d d |zy ) zAttach optional content object to image or form xobject. Args: xref: (int) xref number of an image or form xobject oc: (int) xref number of an OCG or OCMD rrr~rrrrr)z/OCGz/OCMDrrNr)rrrr xref_get_keysr)r[rBrrr~s r&set_ocr[s }}((677tY/GAtF{d"555<== Av""2v.4 ;$&779B>? ? Qw43,,T22 tV,T4B/ r'ocgspolicyvec t|jj fd d}|rst|tt fvr\t|j }|tk7rd|z}t||ddjtd|zdzz }|r=t|j}dd d d d }|d vrtd |z|d||zz }|r|d |zz }|dz }|dk(r|j}n d|j|dvr td|j|||S)aCreate or update an OCMD object in a PDF document. Args: xref: (int) 0 for creating a new object, otherwise update existing one. ocgs: (list) OCG xref numbers, which shall be subject to 'policy'. policy: one of 'AllOn', 'AllOff', 'AnyOn', 'AnyOff' (any casing). ve: (list) visibility expression. Use instead of 'ocgs' with 'policy'. Returns: Xref of the created or updated OCMD. ct|ttfvst|dkrt d|z|dj dvrt d|dz|dj dk(rt|dk7rt d|zd|dj z}|ddD]<}t|tur|vrt d |z|d |zz }/|d |zz }>|d z }|S) Nr]zbad 've' format: %sr)andornotzbad operand: %srz[/%srz bad OCG %iz %i 0 Rz %sr)rr*r+rrr?rr)rr'r-all_ocgsve_makers r&rzset_ocmd..ve_makers 8D%= (CGaK2R78 8 a5;;= 4 4.A67 7 a5;;=E !c"gl2R78 81 %AB ,AAw#~H$$\A%566 A % ++  ,   r'z <.s (Q,r'rAnyOnAllOnAnyOffAllOff)anyonallonanyoffalloffzbad policy: %sz/P/%sz/VE%srr /Type/OCMDT compressedzbad xref or not an OCMD)rget_ocgsrvrr*r+rrrrrQr?rrr) r[rBrrrrrrpolsrrs @@r&set_ocmdrrsU&3<<>&&()H$ D T tUm+ I  * : 1$CS/ ! 388C(>$EFFLL V""$   ? ?-67 7 $v,&&  (2,&&DLD qy! S__Td_C C233dD! Kr'c|t|jvr td|j|d}d|vr tdt |}|j d}|j d|}|dks|dkrd }n?||d z|j d d j}ttt|}|j d }|dkrd }nD|j d|}|dkr|j d|}|dkr td||dz|dz}|j d}|dkrd }ndx} } |}| dks| | k7r;|dz }||ks td||dk(r| dz } ||dk(r| dz } | dkr5| | k7r;||dz|dz}|j ddj ddj dd}|j ddj ddj dd }dd l } | j|}||||d"S#t$r.tjtj d!|wxYw)#atReturn the definition of an OCMD (optional content membership dictionary). Recognizes PDF dict keys /OCGs (PDF array of OCGs), /P (policy string) and /VE (visibility expression, PDF array). Via string manipulation, this info is converted to a Python dictionary with keys "xref", "ocgs", "policy" and "ve" - ready to recycle as input for 'set_ocmd()'. zbad xrefTrrzbad object typerrrNrRrrz/P/ffonzbad object at xrefrr]z/VE[r[z/Andz"and",z/Notz"not",z/Orz"or",z 0 R] 0 R,z][z],[z bad /VE key: )rBrrr)r$rrrrfindrrrr*rrr3loadsrgrrr) r[rBrrp0rrrrrrpr3s r&get_ocmdrsn 5*++$$ ??4D? 1D4*++$iG 8 B 3 B AvaBFR ((4::<CTN# 5 B Av YYtR  64$B 612 2"q&26*F 6 B Av  R 1fb !GB< !566Bx3aBx3a1fb"q&26 " JJvx ( WVX & WUG $ ZZ % - -fc : B B4 O BB $& CC    " " $ OOmB62 3  s 8H7Icf|\}}|ddjddd}|ddd}d}t|D]~\}}|rd} |d k(r||dz|d <d }|jd r+|ddjd djdd}||d<Z|jdslt |dd}||d<|S)a"Make a Python dict from a PDF page label rule. Args: item -- a tuple (pno, rule) with the start page number and the rule string like <>. Returns: A dict like {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}. r]rfrarNr) startpageprefix firstpagenumFrZstyleTrt()rStr)rrrrrr)r'rZrulerskipr_r-s r& rule_dictrsIC ":  C  $DR;A DT?"4 D  3;a!eAgJD  ??3 QR  b)11#r:AAhK  ??4 DH A !An " Hr'c|Dcgc] }|d|ks |c}d}t|}|jdd}|jdd}|dvrdnd}||dz |dz|z}t|||Scc}w) zReturn the label for this page number. Args: pgNo: page number, 0-based. labels: result of doc._get_page_labels(). Returns: The label (str) of the page number. Errors return an empty string. rrirrr)rArr)rrTconstruct_label) pgNolabelsr-r'rrrrV pagenumbers r& get_label_pnor4s .!1A .r 2D T?D XXh #F HHWb !E:%B1E[))D,@@5HJ 5&* 55 /s A2A2c|jj}|sy|jt|j|S)zReturn the label for this PDF page. Args: page: page object. Returns: The label (str) of the page. Errors return an empty string. r)rF_get_page_labelsrrrN)r rs r& get_labelrIs6[[ ) ) +F  KKM f --r'cg}|s|S|j}|gk(r|St|jD]*}t||}||k(s|j ||s)|S|S)aReturn a list of page numbers with the given label. Args: doc: PDF document object (resp. 'self'). label: (str) label. only_one: (bool) stop searching after first hit. Returns: List of page numbers having this label. )rr$rJrr)r[labelonly_onenumbersrr_plabels r&get_page_numbersrZstG   ! ! #F | 3>> "q&) U? NN1  N  Nr'c,d}|dk(r t|}n{|dk(rt|j}n\|dk(rt|j}n=|dk(rt |j}n|dk(rt |j}||z}|S)z9Construct a label based on style, prefix and page number.rDrrrr)rQintegerToRomanr?rRintegerToLetter)rrrZn_strresults r&rrus E |C #s#))+ #s#))+ #$**, #$**, e^F Mr'c \ddl}|j}d|}}td||kr7|tt jd|z}|dz }td||kr7d}t t |D]8}t|tt jd|\}}|||z }|}:|S)z-Returns letter sequence string for integer i.rNrr)stringascii_uppercasepowrrrr$divmod) r_r lsrarstr_tr2rrHs r&rrs   B aqA b!*/ S"a !! Q b!*/ E eAh aTXXb!_-.1 A  Lr'numcfdfd}dj||Dcgc]}|c}Scc}w)z$Return roman numeral for an integer.) )iM)iCM)ir)iCD)rQr)rXC)rL)(XL) X) IX)rrT)r>IV)rIc3lKD]*\}}t||\}}||z|||zz}|dks*yywr)r )rrltrr-rromans r& roman_numz!integerToRoman..roman_numsI FAs#q>DAq'M 1q5LCax  s,44r)r)rr!rr s @r&rrs2 E  77y~.!A. //.s .cZ|jDcgc] }t|c}Scc}w)zReturn page label definitions in PDF document. Args: doc: PDF document (resp. 'self'). Returns: A list of dictionaries with the following format: {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}. )rr)r[r's r&get_page_labelsr#s%),(<(<(> ?IdO ?? ?s(cDdfd}|j||y)aAdd / replace page label definitions in PDF document. Args: doc: PDF document (resp. 'self'). labels: list of label dictionaries like: {'startpage': int, 'prefix': str, 'style': str, 'firstpagenum': int}, as returned by get_page_labels(). cd|dz}|jdddk7r |d|dzz }|jdddk7r |d|dzz }|jdd d kDr |d |dzz }|d z }|S) zConvert Python label dict to corresponding PDF rule string. Args: label: (dict) build rule for the label. Returns: PDF label rule string wrapped in "<<", ">>". z%i<.create_label_strs U;' ' 99Xr "b ( E(O+ +A 99Wb !R ' 5>) )A 99^Q '! + E.11 1A T r'c|jddj|Dcgc] }| c}}|Scc}w)aReturn concatenated string of all labels rules. Args: labels: (list) dictionaries as created by function 'rule_dict'. Returns: PDF compatible string for page label definitions, ready to be enclosed in PDF array 'Nums[...]'. c |dS)Nrrrs r&rz6set_page_labels..create_nums..s !K.r'rr)rr)rrrr&s r& create_numsz$set_page_labels..create_numss>  0 1 GG&A%e,A BBs<N)_set_page_labels)r[rr)r&s @r&set_page_labelsr+s"$ V,-r'c|jr td|js tdt|jD]1}|j |D]}|dt jk(sy3y)z*Check whether there are links on any page.rr;rTF)rrrGr$rJpage_annot_xrefsrrr[r_r's r& has_linksr/ss }}*++ ::%% 3>> "((+ DAw'000  r'c |jr td|js tdt|jD]H}|j |D]2}|dt jk(r|dt jk(r1yJy)z0Check whether there are annotations on any page.rr;rTF) rrrGr$rJr-rrr}r.s r& has_annotsr1s }}*++ ::%% 3>> "((+ DGw555aGD\D\9\  r'line_dirrr cR||d}|\}}tj|}tjjrd}n |d|dz }||dz}||z}||z}|dk\rJ|dkrE|jd|fz } |j |dfz} |j|dfz } |j d|fz} n|dkrJ|dkrE|j |dfz} |jd|fz } |j d|fz} |j|dfz } n|dkrJ|dk\rE|j d|fz } |j|dfz} |j |dfz } |jd|fz} nD|j|dfz} |j d|fz } |jd|fz} |j |dfz } tj| | | | S)aCompute the quad located inside the bbox. The bbox may be any of the resp. tuples occurring inside the given span. Args: line_dir: (tuple) 'line["dir"]' of the owning line or None. span: (dict) the span. May be from get_texttrace() method. bbox: (tuple) the bbox of the span or any of its characters. Returns: The quad which is wrapped by the bbox. dirrrbrcsizer) rrrset_small_glyph_heightsrr2r+r*r/) r2rr rrrrhshcrrrrs r&recover_bbox_quadr9s;HC << D}},,.   tK0 0 f F #B #B Qw27 WW2w  WWAw  WWAw  WW2w  qR1W WWAw  WW2w  WW2w  WWAw  qR1W WW2w  WWAw  WWAw  WW2w  WWAw  WW2w  WW2w  WWAw  <<BB ''r'ct|tust|dk7r tdt|tur tdt |||dS)zRecover the quadrilateral of a text span. Args: line_dir: (tuple) 'line["dir"]' of the owning line. span: the span. Returns: The quadrilateral enveloping the span's text. r]bad line dir argumentbad span argumentr )rr+rrr r9)r2rs r& recover_quadr=FsR H~U"c(mq&8011 Dz,-- XtT&\ ::r'rspansc &||d}t|dk(r td|d}|\}}t||d}t|dkDrt||d}n|}|j}|j}t j ||} || z} t jj} t|D cgc]} | d| rdn | d| d z zc} } t jd| | jd}|j}|| z}|Scc} w) aCalculate the line quad for 'dict' / 'rawdict' text extractions. The lower quad points are those of the first, resp. last span quad. The upper points are determined by the maximum span quad height. From this, compute a rect with bottom-left in (0, 0), convert this to a quad and rotate and shift back to cover the text of the spans. Args: spans: (list, optional) sub-list of spans to consider. Returns: pymupdf.Quad covering selected spans. r>rz bad span listr4rrir5rbrc) rrr=rrr planish_linerr6rrr-r,)rr>r2rrq0rline_llline_lrmat0x_lrsmallrrK line_rect line_quads r&recover_line_quadrIVs }W  5zQ))E{HHC ha )B 5zA~ (E"I . eeGeeG    1D T>D MM 1 1 3E QVWA65aq}q~'E GW A QDFFA.II $I  Xs4Dcharsc||d}| t||Sd|jvr tdt|||d}t |dkDrt|||d}n|}|j }|j }tj||}||z}tjj} |d| rdn |d|d z z} tjd| |jd} | j} | |z} | S) a^Calculate the span quad for 'dict' / 'rawdict' text extractions. Notes: There are two execution paths: 1. For the full span quad, the result of 'recover_quad' is returned. 2. For the quad of a sub-list of characters, the char quads are computed and joined. This is only supported for the "rawdict" extraction option. Args: line_dir: (tuple) 'line["dir"]' of the owning line. span: (dict) the span. chars: (list, optional) sub-list of characters to consider. Returns: pymupdf.Quad covering selected characters. r4rJz)need 'rawdict' option to sub-select charsrrrir5rbrc)r=rvrrecover_char_quadrrrrr@rr6rr-r,) r2rrJrArspan_llspan_lrrDrErFrK span_rect span_quads r&recover_span_quadrQs"; }Hd++diik!DEE 8T58 4B 5zA~ xuRy 9 eeGeeG    1D T>D MM 1 1 3E V Uj)9D