,h@ UddlZddlZddlZddlmZddlmZmZmZm Z m Z m Z m Z m Z mZmZmZddlmZmZddlmZddlmZmZmZmZmZmZmZddlmZ dd lm!Z"dd lm#Z$dd lm%Z&dd l'm(Z(dd l)m*Z*ddl+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6da7e8e9d<da:e8e9d<ga;e e8e9d< d/deedede+C CC$>s1B*selfnamedefaultsc|j|}t|tr|S||D]}|j|}|nt|tr|jj |}t|}t ||||SN)getr4r)r%pdf get_object_set_rectangle)r<r=r>retvalds r:_get_rectanglerG~s;?88D>F&/*  ~ AXXa[F! &.)$$V, V $F4v& Mc4tddt|||S)N getRectangle3.0.0)rrG)r<r=r>s r:rJrJs~w7 $h //rHvaluec$t|}|||<yr@r&r<r=rLs r:rDrDs d DDJrHc6tddt|||y)N setRectanglerK)rrDrOs r:rQrQs~w74u%rHc ||=yr@r<r=s r:_delete_rectanglerUs  T rHc"tdd||=y)NdeleteRectanglerK)rrTs r:rWrWs0': T rHfallbackc4tfdfdfdS)Nct|Sr@)rG)r<rXr=s r:z,_create_rectangle_accessor..s^D$9rHct||Sr@)rD)r<rLr=s r:r[z,_create_rectangle_accessor..sN4u=rHct|Sr@)rUrTs r:r[z,_create_rectangle_accessor..s&tT2rH)propertyr=rXs``r:_create_rectangle_accessorr`s 9=2 rHc2tddt||S)NcreateRectangleAccessorrK)rr`r_s r:rbrbs8'B %dH 55rHceZdZdZddefdZedefdZe dedefdZ dde d e ddfd Z dd e e d e e ddfdZde ddfdZdefdZdeeeefee e fee fdeee e fee ffdZy )Transformationu Represent a 2D transformation. The transformation between two coordinate systems is represented by a 3-by-3 transformation matrix matrix with the following form:: a b 0 c d 0 e f 1 Because a transformation matrix has only six elements that can be changed, it is usually specified in PDF as the six-element array [ a b c d e f ]. Coordinate transformations are expressed as matrix multiplications:: a b 0 [ x′ y′ 1 ] = [ x y 1 ] × c d 0 e f 1 Example ------- >>> from PyPDF2 import Transformation >>> op = Transformation().scale(sx=2, sy=3).translate(tx=10, ty=20) >>> page.add_transformation(op) ctmc||_yr@rer<res r:__init__zTransformation.__init__s rHr2c|jd|jddf|jd|jddf|jd|jddffS)z Return the transformation matrix as a tuple of tuples in the form: ((a, b, 0), (c, d, 0), (e, f, 1)) rrrgr<s r:matrixzTransformation.matrixs\XXa[$((1+q ) XXa[$((1+q ) XXa[$((1+q )  rHrpcZ|dd|dd|dd|dd|dd|ddfS)a Compresses the transformation matrix into a tuple of (a, b, c, d, e, f). Args: matrix: The transformation matrix as a tuple of tuples. Returns: A tuple representing the transformation matrix as (a, b, c, d, e, f) rrrkrS)rps r:compresszTransformation.compresssP 1IaL 1IaL 1IaL 1IaL 1IaL 1IaL   rHtxtyc n|j}t|d|d|d|d|d|z|d|zfS)z Translate the contents of a page. Args: tx: The translation along the x-axis. ty: The translation along the y-axis. Returns: A new `Transformation` instance rrrkrlrmrnrg)rerd)r<rsrtms r: translatezTransformation.translatesE HH1Q41qtQqT1Q4"9adRi"PQQrHNsxsyc| | td||}||}|J|J|ddfd|dfdf}tjt|j|}t|S)a Scale the contents of a page towards the origin of the coordinate system. Typically, that is the lower-left corner of the page. That can be changed by translating the contents / the page boxes. Args: sx: The scale factor along the x-axis. sy: The scale factor along the y-axis. Returns: A new Transformation instance with the scaled matrix. z!Either sx or sy must be specifiedrrrr) ValueErrorrdrrrrp)r<rxryopres r:scalezTransformation.scale s{ :"*@A A :B :B~~)+Q QAJ 'J%%odkk2&FGc""rHrotationcDtj|}tj|tj|dftj| tj|dfdf}tj t |j|}t |S)z Rotate the contents of a page. Args: rotation: The angle of rotation in degrees. Returns: A new `Transformation` instance with the rotated matrix. rr{)mathradianscossinrdrrrrp)r<rr}res r:rotatezTransformation.rotate%s<<) XXh (!3Q 7hhx $((8"4a 8 (  %%odkk2&FGc""rHc"d|jdS)NzTransformation(ctm=)rgros r:__repr__zTransformation.__repr__8s$TXXJa00rHptcpt|d|jdzt|d|jdzz|jdzt|d|jdzt|d|jdzz|jdzf}t|tr t|S|S)a Apply the transformation matrix on the given point. Args: pt: A tuple or list representing the point in the form (x, y) Returns: A tuple or list representing the transformed point in the form (x', y') rrrkrmrlrn)floatrer4r8)r<rpt1s r:apply_onzTransformation.apply_on;s "Q%L488A; &r!u )C Cdhhqk Q "Q%L488A; &r!u )C Cdhhqk Q 'r40tCy9c9rH))rrrrrr)rrNN)__name__ __module__ __qualname____doc__rrir^rrp staticmethodrrrrwr r~rr6rr r rr rrSrHr:rdrds<:  0     1 6T  & RE R5 R9I RAE#5/#.6uo# #8#u#)9#&1#1:gw./ue|1Dd5kQR: uUE\"DK/ 0:rHrdc eZdZUdZded< dndeedeedeeddfdZe deefd Z e jd eeddfd Z de ffd Z e defd Ze dndeedeeedfdeeedfddfdZe dndeedeeedfdeeedfddfdZe deefdZe defdZejdeeefddfdZdodZdeddfdZdeddfdZdeddfdZdeddfdZede de dede!e"e#efe"e#efffdZ$ed e%d!e"eefdede%fd"Z&ed#edede%fd$Z'ed#eded%e(de%fd&Z)dee%fd'Z*dee%fd(Z+dpd)dd*e,ddfd+Z-dqd,Z. drd)dd-ee/ege%fd%ee(d*e,ddf d.Z0d)dd%ee(ddfd/Z1 dpd)dd%ee(e2fd*e,ddfd0Z3 dpd)dd1ed*e,ddfd2Z4 dpd)dd3ed*e,ddfd4Z5 dpd)dd5ed6ed*e,ddf d7Z6 dpd)dd3ed5ed6ed*e,ddf d8Z7 dpd)dd3ed1ed*e,ddf d9Z8 dpd)dd1ed5ed6ed*e,ddf d:Z9 dpd)dd3ed1ed5ed6ed*e,ddfd;Z: dpd%ee2e(fd*e,ddfd<Z;d%e(ddfd=Zed?eddfd@Z=dAeddfdBZ>dAeddfdCZ?dededdfdDZ@dededdfdEZAdodFZBdodGZCde#fdHZDdIdJeEjdddfdKededLe!edMfdNedOee#dPee/eeeegdfdQee/eeeegdfdRee/eeeeegdfde#fdSZGdddIdJddddTdUedVe#dWe#dLeee!edMffdNedPee/eeeegdfdQee/eeeegdfdRee/eeeeegdfde#fdXZH dsdYeIdLe!edMfdNedPee/eeeegdfdQee/eeeegdfdRee/eeeeegdfde#fdZZJ dtdVe#dWe#de#fd[ZKde!eLe#eLe#ffd\ZMeNeEjd]ZP e deQfd^ZReRjd eQddfd_ZReNd`eEjfZS e deQfdaZTeTjd eQddfdbZTeNdcd`eEjfZU e deQfddZVeVjd eQddfdeZVeNdfd`eEjfZW e deQfdgZXeXjd eQddfdhZXeNdid`eEjfZY e deQfdjZZeZjd eQddfdkZZe dee[fdlZ\e\jd ee[ddfdmZ\xZ]S)u PageObjecta) PageObject represents a single page within a PDF file. Typically this object will be created by accessing the :meth:`get_page()` method of the :class:`PdfReader` class, but it is also possible to create an empty page with the :meth:`create_blank_page()` static method. Args: pdf: PDF file the page belongs to. indirect_reference: Stores the original indirect reference to this object in its source PDF original_pageNrBindirect_reference indirect_refr2ctj|||_|)tjdt | t d|}||_y)Nzoindirect_ref is deprecated and will be removed in PyPDF2 4.0.0. Use indirect_reference instead of indirect_ref.z/Use indirect_reference instead of indirect_ref.)r"rirBwarningswarnDeprecationWarningr|r)r<rBrrs r:rizPageObject.__init__`sX !!$'03  # MMT#  "- !RSS!- "4rHcNtjdt|jS)Nzmindirect_ref is deprecated and will be removed in PyPDF2 4.0.0Use indirect_reference instead of indirect_ref.)rrrrros r:rzPageObject.indirect_refvs' B   &&&rHrLc||_yr@)rr<rLs r:rzPageObject.indirect_refs "'rHcFt|}|dt|zz }|S)Ns%d)superhash_value_dataid)r<data __class__s r:rzPageObject.hash_value_datas(w&( 4   rHcB|jtjdS)a A read-only positive number giving the size of user space units. It is in multiples of 1/72 inch. Hence a value of 1 means a user space unit is 1/72 inch, and a value of 3 means that a user space unit is 3/72 inch. r)rAPG USER_UNITros r: user_unitzPageObject.user_unitsxx a((rHwidthheightc t|}|jttjtd|jttj t |jttjt||r|jt|jdkDrR|jt|jdz }|jj}|jj}nt|jttjt!dd||f|S)aB Return a new blank page. If ``width`` or ``height`` is ``None``, try to get the page size from the last page of *pdf*. Args: pdf: PDF file the page belongs to width: The width of the new page expressed in default user space units. height: The height of the new page expressed in default user space units. Returns: The new blank page Raises: PageSizeNotDefinedError: if ``pdf`` is ``None`` or contains no page z/Pagerr)r __setitem__r&rTYPEPARENTr' RESOURCESr"lenpagesmediaboxrrrMEDIABOXr))rBrrpagelastpages r:create_blank_pagezPageObject.create_blank_pages4# BGG,j.AB BII. = BLL13C3EF =FN3syy>A#599S^a%78 ))//!**11--  r{{ #_aE65J%K  rHcJtdddtj|||S)z\ .. deprecated:: 1.28.0 Use :meth:`create_blank_page` instead. createBlankPagerrK)rrr)rBrrs r:rzPageObject.createBlankPages' %%68KWU++C??rHclg}tj|tjvr|S|tjtjj }|D]U}||t j dk(st||\}}|1|dd|}|jt||W|S)z Get a list of all images of the page. This requires pillow. You can install it via 'pip install PyPDF2[image]'. For the moment, this does NOT include inline images. They will be added in future. /ImageNr)r=r) RESXOBJECTrrrCIASUBTYPErappendr)r<images_extractedx_objectobj extension byte_streamfilenames r:imageszPageObject.imagess(* ;;d2<<0 0# # %ckk2==? SC}RZZ(H4)7 )F& ;("%ab'9+6H$++Dh[,QR  S  rHcTt|jtjdS)z The VISUAL rotation of the page. This number has to be a multiple of 90 degrees: 0,90,180,270 This property does not affect "/Contents" r)r5rArROTATEros r:rzPageObject.rotations488BIIq)**rHrcxtt|dzdzdzdz|ttj<y)N-Zh)r(r5r&rr)r<rs r:rzPageObject.rotations2&2c!frkb5HB4NRU3U&VZ "#rHc |j }d|_t|j}tj t |j |jdz z t |j|jdz z j|}|j|j}|j|j}|j t|d|d t|d|d }|j|ddD]}||vst||}|j|j}|j|j}tt|d|dt|d|dt!|d|dt!|d|df|t#|<y)z Apply the rotation of the page to the content and the media/crop/... boxes. It's recommended to apply this function before page merging. rrkrF)z /MediaBox/CropBox /BleedBox/TrimBox/ArtBoxN)rr)rrdrwrleftrbottomrrr lower_left upper_rightminadd_transformationmaxr&)r<rmbtrsfrpt2brrs r:transfer_rotation_to_contentz'PageObject.transfer_rotation_to_contents ]]N T]] +   YrwwA-..ryy299q=7P1Q0QVAY mmBMM*mmBNN+~~s3q63q622SQQ5H4HI e,N ADy$T!W-mmBMM2mmBNN3&5CFCF+CFCF+CFCF+CFCF+ 'Z]# rHanglec|dzdk7r td|jtjd}t |t r|n|j }t||z|ttj<|S)z Rotate a page clockwise by increments of 90 degrees. Args: angle: Angle to rotate the page. Must be an increment of 90 deg. rrz'Rotation angle must be a multiple of 90) r|rArrr4r5rCr(r&)r<r rotate_obj current_angles r:rzPageObject.rotateso 2:?FG GXXbii+ $Z5J:;P;P;R '3=53H&IZ "# rHc>tddd|j|S)Nrotate_clockwiserrKrrr<rs r:rzPageObject.rotate_clockwise's$%77K{{5!!rHc>tddd|j|S)z[ .. deprecated:: 1.28.0 Use :meth:`rotate_clockwise` instead. rotateClockwiserrKrrs r:rzPageObject.rotateClockwise+s %%6'J{{5!!rHc@tddd|j| S)zt .. deprecated:: 1.28.0 Use :meth:`rotate_clockwise` with a negative argument instead. rotateCounterClockwiserrKrrs r:rz!PageObject.rotateCounterClockwise4s" %%=xQ{{E6""rHres1res2resourcec&t}|j|j|tjt t|j|tj}i}t |j D]y}||vrZ|j||j|k7r7t|ttjz}|||<||||<a||vsf|j|||<{||fSr@) r"updaterArCrr8keysraw_getr&r6uuiduuid4)rrrnew_respage2res rename_reskeynewnames r:_merge_resourceszPageObject._merge_resources=s#$txx*:*<=HHJK dhhx1A1CDOOQ   ( 5Cg~'//#"6(:J:J3:O"O$S3tzz|+<%<=") 3#+C= G#'//4  5 ""rHstreamrenamec|s|St||}|jD]\}}t|trEt t |D]-}||}t|t s|j||||</[t|tr3|D]-}||}t|t s|j||||</tdt||S)Nztype of operands is ) r! operationsr4r8rangerr&rAdictKeyErrortype)rrrBoperands _operatorir}s r:_content_stream_renamez!PageObject._content_stream_renamePsMvs+#)#4#4 H Hi(D)s8}-9A!!B!"j1&,jjR&8 9Hd+!9A!!B!"j1&,jjR&8 9 !5d8n5EFGG H rHcontentsct||}|jjdgdf|jjgdf|S)NrqQ)r!rinsertr)rrBrs r: _push_pop_gszPageObject._push_pop_gsfsG x-  RI.  "c+ rHrec |\}}}}}}t||}|jjdt|t|t|t|t|t|gdg|S)Nrz cm)r!rr r$) rrBrearcrFefs r:_add_transformation_matrixz%PageObject._add_transformation_matrixps{ 1aAq 3/""  NNNNNN   rHcjtj|vr!|tjjSy)z Access the page contents. :return: the ``/Contents`` object, or ``None`` if it doesn't exist. ``/Contents`` is optional, as described in PDF Reference 7.7.3.3 N)rCONTENTSrCros r: get_contentszPageObject.get_contentss+ ;;$  $//1 1rHc<tddd|jS)zW .. deprecated:: 1.28.0 Use :meth:`get_contents` instead. getContentsrrK)rrros r:rzPageObject.getContentss %]NGL  ""rHpage2expandc*|j||y)a Merge the content streams of two pages into one. Resource references (i.e. fonts) are maintained from both pages. The mediabox/cropbox/etc of this page are not altered. The parameter page's content stream will be added to the end of this page's content stream, meaning that it will be drawn after, or "on top" of this page. Args: page2: The page to be merged into this one. Should be an instance of :class:`PageObject`. expand: If true, the current page dimensions will be expanded to accommodate the dimensions of the page to be merged. )rN) _merge_page)r<rrs r: merge_pagezPageObject.merge_pages v.rHc>tddd|j|S)zU .. deprecated:: 1.28.0 Use :meth:`merge_page` instead. mergePagerrK)rr)r<rs r:rzPageObject.mergePages %[,Hu%%rHpage2transformationc t}i} tt|tjj } tt|tjj }t } ||fD]Q} tj| vs| tj} t| t s:| D]} | j| Stjtjtjtjtjtj tj"fD]>} t$j'||| \}}|s ||t)| <|j+|@t t-|j/tj0t j j3t-|j/tj0t j |t)tj0<t }|j5}|/|jt$j7||j8|j5}|t;||j8}|j<}|j>jAdtCtD|jF|jH|jJ|jLgdf|j>jAdgdf|j>jAdgdf|||}t$jO|||j8}t$j7||j8}|j||r|jQ||t;||j8|t)tjR<||t)tj<| |t)tj<y#t $rt}YwxYw#t $rt}YwxYw)NrrerWrkn)*r"rrrrCrr ANNOTSr4rr EXT_G_STATEFONTr COLOR_SPACEPATTERNSHADING PROPERTIESrrr&r frozensetrAPROC_SETunionrr rBr!trimboxrr mapr$rrrrr_expand_mediaboxr)r<rr rer new_resourcesroriginal_resourcespage2resources new_annotsrannotsrefresnew newrenamenew_content_arrayoriginal_content page2contentrects r:rzPageObject._merge_pagesw)*  4!%&6R\\8J8U8U8W!X  0!"2E",,4G4R4R4TUN!] 5M /DyyD biifk2%/"))#./  / OO HH KK OO KK KK NN  )C(88"NCNC14 jo. i( )"3> "&&s||[]CNNP e.,,S\\;=ITTVW3 j./(M,,.  '  $ $''(8$((C ))+  #(txx@L==D  # # * *# II KK JJ KK     # # * *1r3i 8  # # * *1r3i 8".2<@ %<<fdhhL&22<JL  $ $\ 2   ! !% -(56G(RZ $%)6Z %&&0Z "#g 4!1!3  4 0-/N 0s"/P/P0P-,P-0QQc N|jjj|jjj|jjj|jj jf}|jjj|jjj|jjj|jj j|jjj|jj j|jjj|jjjfSt dDt fdtdddD}t fdtdddD}nddd}ddd}t|t|f}t|t|f}t|d|dt|d|df}t|d|dt|d|df}||j_ ||j_ y) Nc32K|]}t|ywr@r.0r9s r: z.PageObject._expand_mediabox..0.Qa.c3^K|]$}d|zd|dzzzdz&yw)rrkrrmNrSrCrcorners2res r:rDz.PageObject._expand_mediabox..1EA!$s1vQ'??#a&H*-rrkc3^K|]$}d|zd|dzzzdz&yw)rrlrnNrSrHs r:rDz.PageObject._expand_mediabox..5rJrKrrl) rr as_numericrrighttoptuplerrrrr) r<rrecorners1new_xnew_y lowerleft upperrightrIs ` @r:r1zPageObject._expand_mediaboxs& MM   ) ) + MM + + - MM   * * , MM   ( ( *   NN   * * , NN ! ! , , . NN   * * , NN   ) ) + NN + + - NN   ) ) + NN + + - NN ! ! , , .   ?.#..Cq!QEq!QE QqUOEQqUOEZU, %j#e*- !il3S!iPQl5ST  Z] +  Z] + $-  $. !rHctdddttr jt t |j fd|y)ah mergeTransformedPage is similar to merge_page, but a transformation matrix is applied to the merged stream. :param PageObject page2: The page to be merged into this one. Should be an instance of :class:`PageObject`. :param tuple ctm: a 6-element tuple containing the operands of the transformation matrix :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z%page.mergeTransformedPage(page2, ctm)z5page2.add_transformation(ctm); page.merge_page(page2)rKcFtj|jSr@)rrrB) page2Contentrers r:r[z1PageObject.mergeTransformedPage..fs!F!Feii"rHN)rr4rdrerrr)r<rrers `` r:mergeTransformedPagezPageObject.mergeTransformedPageGsV* % 3 C  c> *''C137       rHr~cxtdddtj||}|j|||y)a2 mergeScaledPage is similar to merge_page, but the stream to be merged is scaled by applying a transformation matrix. :param PageObject page2: The page to be merged into this one. Should be an instance of :class:`PageObject`. :param float scale: The scaling factor :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z*page.mergeScaledPage(page2, scale, expand)zWpage2.add_transformation(Transformation().scale(scale)); page.merge_page(page2, expand)rKN)rrdr~rZ)r<rr~rr}s r:mergeScaledPagezPageObject.mergeScaledPagems>" % 8 e    # #E5 1 !!%V4rHrcvtdddtj|}|j|||y)aJ mergeRotatedPage is similar to merge_page, but the stream to be merged is rotated by applying a transformation matrix. :param PageObject page2: the page to be merged into this one. Should be an instance of :class:`PageObject`. :param float rotation: The angle of the rotation, in degrees :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z.page.mergeRotatedPage(page2, rotation, expand)z[page2.add_transformation(Transformation().rotate(rotation)); page.merge_page(page2, expand)rKN)rrdrrZ)r<rrrr}s r:mergeRotatedPagezPageObject.mergeRotatedPages<" % < i    $ $X . !!%V4rHrsrtcxtdddtj||}|j|||y)aq mergeTranslatedPage is similar to merge_page, but the stream to be merged is translated by applying a transformation matrix. :param PageObject page2: the page to be merged into this one. Should be an instance of :class:`PageObject`. :param float tx: The translation on X axis :param float ty: The translation on Y axis :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z/page.mergeTranslatedPage(page2, tx, ty, expand)z\page2.add_transformation(Transformation().translate(tx, ty)); page.merge_page(page2, expand)rKN)rrdrwrZ)r<rrsrtrr}s r:mergeTranslatedPagezPageObject.mergeTranslatedPages>$ % = j    ' 'B / !!%V4rHctdddtj| | j|j||}|j |||S)a mergeRotatedTranslatedPage is similar to merge_page, but the stream to be merged is rotated and translated by applying a transformation matrix. :param PageObject page2: the page to be merged into this one. Should be an instance of :class:`PageObject`. :param float tx: The translation on X axis :param float ty: The translation on Y axis :param float rotation: The angle of the rotation, in degrees :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z@page.mergeRotatedTranslatedPage(page2, rotation, tx, ty, expand)zmpage2.add_transformation(Transformation().rotate(rotation).translate(tx, ty)); page.merge_page(page2, expand)rK)rrdrwrrZ)r<rrrsrtrr}s r:mergeRotatedTranslatedPagez%PageObject.mergeRotatedTranslatedPages^0 % N {    ' 'bS 1 8 8 B L LRQS T((F;;rHctdddtj|j||}|j |||y)a mergeRotatedScaledPage is similar to merge_page, but the stream to be merged is rotated and scaled by applying a transformation matrix. :param PageObject page2: the page to be merged into this one. Should be an instance of :class:`PageObject`. :param float rotation: The angle of the rotation, in degrees :param float scale: The scaling factor :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z;page.mergeRotatedScaledPage(page2, rotation, scale, expand)hpage2.add_transformation(Transformation().rotate(rotation).scale(scale)); page.merge_page(page2, expand)rKN)rrdrr~rZ)r<rrr~rr}s r:mergeRotatedScaledPagez!PageObject.mergeRotatedScaledPagesI$ % I v    $ $X . 4 4UE B !!%V4rHctdddtj||j||}|j |||S)a mergeScaledTranslatedPage is similar to merge_page, but the stream to be merged is translated and scaled by applying a transformation matrix. :param PageObject page2: the page to be merged into this one. Should be an instance of :class:`PageObject`. :param float scale: The scaling factor :param float tx: The translation on X axis :param float ty: The translation on Y axis :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z`. :param float tx: The translation on X axis :param float ty: The translation on Y axis :param float rotation: The angle of the rotation, in degrees :param float scale: The scaling factor :param bool expand: Whether the page should be expanded to fit the dimensions of the page to be merged. .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. zFpage.mergeRotatedScaledTranslatedPage(page2, rotation, tx, ty, expand)rdrKN)rrdrr~rwrZ)r<rrr~rsrtrr}s r: mergeRotatedScaledTranslatedPagez+PageObject.mergeRotatedScaledTranslatedPagesW6 % T v    $ $X . 4 4UE B L LRQS T !!%V4rHc t|tr |j}|j}|]tj ||j |}tj||j }||ttj<|r3|jjj|jjj|jjj|jjj|jj j|jjj|jj j|jjjg}t#d|D}t%dddDcgc]"}|d||z|d||dzzz|dz$}}t%dddDcgc]"}|d||z|d||dzzz|d z$}}t'|t'|f}t)|t)|f} t'|d|dt'|d|df}t)|d| dt)|d| df} ||j_| |j_yycc}wcc}w) ab Apply a transformation matrix to the page. Args: ctm: A 6-element tuple containing the operands of the transformation matrix. Alternatively, a :py:class:`Transformation` object can be passed. See :doc:`/user/cropping-and-transforming`. Nc32K|]}t|ywr@rArBs r:rDz0PageObject.add_transformation..ZrErFrrLrkrrmrlrn)r4rdrerrrrBr r&rrrrrNrrPrOrQrrrrr) r<rercontentcornersrrSrTrUrVs r:rzPageObject.add_transformation6s c> *''C##%   ;;GTXXsSG --gtxx@G,3DBKK( )  ""--/ $$//1 ""--/ !!,,. ##..0 !!,,. ##..0 $$//1 G.#..Cq!QA#c!fwq1u~&==AFE q!QA#c!fwq1u~&==AFE USZ0Ie*c%j1JWQZ16GAJ RS 8UVIGAJ 1 .GAJ 1 .J (1DMM $(2DMM %? s 'K'Kc@tddd|j|y)z] .. deprecated:: 1.28.0 Use :meth:`add_transformation` instead. addTransformationrrKN)rrrhs r:rozPageObject.addTransformationos! %%8:NPWX $rHrxryc b|j|dd|ddf|jj|||_|jj|||_|jj|||_|j j|||_|j j|||_tj|vr|tj}t|tr|D]}|j}tj|vs&|tj}t|tsJtt|d|z|d<tt|d|z|d<tt|d|z|d<tt|d|z|d<tj |vr|tj }t|tr |dd}n|d}t#t|d|zt|d|zt|d|zt|d|zf} t|tr5| |t%tj t'dt%d<y| |t%tj t%d<yy)a\ Scale a page by the given factors by applying a transformation matrix to its content and updating the page size. This updates the mediabox, the cropbox, and the contents of the page. Args: sx: The scaling factor on horizontal axis. sy: The scaling factor on vertical axis. rrrkrlz/BBoxN)rcropboxr~artboxbleedboxr/rrr%r4r rCADARectr$rVPr)r&r() r<rxry annotations annotationannotation_obj rectangleviewportbbox scaled_bboxs r:r~zPageObject.scalezsX Q2q! 45||))"b1 kk''B/  ++B3 ||))"b1  ++B3 99 ryy/K+{3"-QJ%/%:%:%1$2388$< %i=+6uYq\7JR7O+PIaL+6uYq\7JR7O+PIaL+6uYq\7JR7O+PIaL+6uYq\7JR7O+PIaLQ 55D=BEE{H(K0{7+()$q'NR'$q'NR'$q'NR'$q'NR' K(K0 Z&' Q8w'@KZ&' 7(;<' rHfactorc(|j||y)z Scale a page by the given factor by applying a transformation matrix to its content and updating the page size. Args: factor: The scaling factor (for both X and Y axis). N)r~r<r~s r:scale_byzPageObject.scale_bys 66"rHcBtddd|j||y)zS .. deprecated:: 1.28.0 Use :meth:`scale_by` instead. scaleByrrKN)rr~rs r:rzPageObject.scaleBys %Y GD 66"rHc|t|jjz }|t|jjz }|j ||y)z Scale a page to the specified dimensions by applying a transformation matrix to its content and updating the page size. Args: width: The new width. height: The new height. N)rrrrr~)r<rrrxrys r:scale_tozPageObject.scale_tosDU4==../ / eDMM001 1 2rrHcBtddd|j||y)zS .. deprecated:: 1.28.0 Use :meth:`scale_to` instead. scaleTorrKN)rr)r<rrs r:rzPageObject.scaleTos %Y GD eV$rHc|j}|Qt|tst||j}|j |t t j<yy)a Compress the size of this page by joining all content streams and applying a FlateDecode filter. However, it is possible that this function will perform no action if content stream compression becomes "automatic". N)rr4r!rB flate_encoder&rr)r<rls r:compress_content_streamsz#PageObject.compress_content_streamssS##%  g}5':,3,@,@,BDBKK( ) rHc>tddd|jy)zc .. deprecated:: 1.28.0 Use :meth:`compress_content_streams` instead. compressContentStreamsrrKN)rrros r:rz!PageObject.compressContentStreamss" % $&@'  %%'rHcPd}t|dj|jdjD]m\}}|dk(r$|dDcgc]}t |t s|}}ng}||j ddzdj|z|jzdzz }o|d z } |tjd D]}||dzz }||tjd |jdzz } |tjd |d j}||dzz } ||tjd |d jj dzz } |Scc}w#t$rYTwxYw#t$rYwxYw#t$r |d z }Y|SwxYw)Nz /ContentsbytesTJrzutf-8  z ============================= /Fontz /Encodingz /ToUnicodezNo Font )r!rCrBrr4r6decodejoinrrr Exceptionget_datar)r<outoper}r9sfoenc_reprs r:_debug_for_extractzPageObject._debug_for_extracts$   ( ( *DHHg * QGCU{ #A=1*Q*IDP PC Q 22 2<<(1 rDy tBLL)'226??ADHH#BLL1':2># hj8d?*C R\\*73B7(" C 0 =>!!  ; C  saE0E0+AF:2E5->F+F5 F>FFF F FFFF%$F%)rri@r orientations. space_width content_keyvisitor_operand_beforevisitor_operand_after visitor_textc n !"d ddi |} ttj| vr/| dj} ttj| vr/t t | tj} d| vr(t t | dD]} t| ||| <diddf t|tr||jn|} t| ts t| |d} gd ggd !gd "d d d d d dttdttdttfddttdtfddtffd dtdtddf !"fd } | j D]\}}| |||!|dk(r| dg| d|nk|dk(r1| d|dg| d|dg| dg| d|ddn5|d k(r| d!|d g| d"|n|d#k(r|dD]}}t|ttfr | d|gt|ttt"t$fsDt't|k\s\t) dkDsk d$d%k7st| dd%gn|d&k(r~ z  !d' d$d(k7rd(z d(!d' | d)}||dd*d+k7r2|j-||d|||  z  !d'd n | ||||||! z  dk7r !d'S#t $rYywxYw#t$rYywxYw#t*$rYwxYw#t $rt/d,|dt0YwxYw#d wxYw)-a See extract_text for most arguments. Args: content_key: indicate the default key where to extract data None = the object; this allow to reuse the function on XObject default = "/Content" rFz/ParentrcharmapNotInitializedNr?rrrrrg@@rg(@rvr$r2c &|d|dz|d|dzz|d|dz|d|dzz|d|dz|d|dzz|d|dz|d|dzz|d|dz|d|dzz|dz|d|dz|d|dzz|dzgS)NrrrkrlrmrnrS)rvr$s r:multz&PageObject._extract_text..multds!qt adQqTk)!qt adQqTk)!qt adQqTk)!qt adQqTk)!qt adQqTk)AaD0!qt adQqTk)AaD0  rHc:|ddkDry|ddkry|ddkDryy) Nrlgư>rgưrrrrrS)rvs r:orientz(PageObject._extract_text..orientns/td{11rHcdz S)Ng@@rS) _space_widthsr:current_spacewidthz4PageObject._extract_text..current_spacewidthxs&( (rHoperatorrc d}|dk(rgd z "" ddy|dk(rz "" ddn|dk(rjfn|dk(r j\n|d k(rqz "" ddt|d t|d t|d t|dt|d t|dgn"|dk(rt|d dz n |dk(rdt|d zn|dk(rt|d n|dk(rNdk7rz "" dd |d }|d |d |d|d |d f t|d n|dk(rXd}t|d }t|d } d xx| d z| d zzz cc< dxx| d z| dzzz cc<n-|dk(rTd}t|d t|d t|d t|dt|d t|dg n|dk(rd} dxxzcc<n|dk(rd} }|}|vrt |d tr |d z nd}t |d trt|d n|d } t d tr | jd d}nFdj| D cgc]+} | d vrd | nt| fj-c} }dj|D cgc]} | d vrd | n| c} D]} t| } | dks&d| kr| d ksd!| kr| d"ksd#| kr| d$ks| tvr r| zn| zFd%| kr| d&ks&d'| kr| d(ksd)| kr| d*kst| kr+| tkr"sdz "" dd| zrdz "" dd| zny|rO }|}|d !d z } |d!dz } t!j"t%|d |dzt%|d |d zz}|z}|!|vry |d k(rq| d+|zkr+zd,d-k7rʼnd-zz ""d-z ddyt%| |d.zkrt%| |zd/zkDrxzd,d0k7rkd0z y|d1k(ro| d2|zkDr+zd,d-k7rKd-zz ""d-z ddyt%| |d.zkrt%| |zd/zkDrzd,d0k7rd0z y|d3k(rm| d2|zkDr*zd,d-k7rԉd-zz ""d-z ddyt%| |d.zkrt%| |zd/zkDrzd,d0k7r}d0z y|d4k(rq| d+|zkr*zd,d-k7r]d-zz ""d-z ddyt%| |d.zkr,t%| |zd/zkDrzd,d0k7rd0z yyyyyyyyyyyyyyyyyyy#t$rgdYcwxYw#t$r't d t d t dd|d zdfY1wxYw#t$rYwxYw#t$r | jd dk(rdndd}YwxYwcc} wcc} w#t$rYywxYw)5NFsBTrrlrsETqQscmrrrkrmrnsTzgY@TwrTLsTfz???TdTsTmT*Tj surrogatepassrz utf-16-be/:@i io i i!iiiiipigr+rg333333?rrg?rr)rpoprrrrr4r6r*rrrr7r.r,r-rsqrtabs)#rrcheck_crlf_space charMapTuplersrtrv orientationtttr9xxdelta_xdelta_ykrTLr char_scale cm_matrixcm_stackcmapcmapsr font_sizerrroutputrtl_dir space_scaletext tm_matrixtm_prevrs# r:process_operationz3PageObject._extract_text..process_operation|s &+ 5 : $+ y)T!WiPU"$+ y)T!WiPT!!!"#$ T! ?! !!"#$ U"$+ y)T!WiP hqk*hqk*hqk*hqk*hqk*hqk*   U""8A;/%7 U"!E(1+$66 U"8A;'U"2:dNF#/$T9ia)T#(!#5L#/?L%Q$Q  $Q D %hqk 2IU"#' 8A;'8A;'! Yq\ 1B14E EE ! Yq\ 1B14E EE U"#' (1+&(1+&(1+&(1+&(1+&(1+&  U"#' ! " U"#' I.$Qi ,.!(1+s3 +!# *(1+s;2(1+>!)! &d1gs3"$&II$(G_%"!#.0!"()34tAw,DGAJE1$KDVDVDX$X!"!A"$HIJ11QJ"%0A"%QB"$t$(BJ2:$*bLR6\$*bLR6\#%)A#A3:q4xq!'2",$*bLR6\$*bLR6\$2b$8R>=Q(/.2G$*dNF'3'?(4T9iQUVWQXZc(d+-D'(4x$+.3G$*dNF'3'?(4T9iQUVWQXZc(d+-D'+axK%0PI.$Qi A$+A$+IIc!A$1+.QqTAaD[1AABMl2N"a'"TAX- & r2d: &$+ 5#/#;$0(,t (1(1(,Q(1 %&(*L1s72 #G /A/Ca/G"/L L & r2c9 $ $+"S1W, & r2d: &$+ 5#/#;$0(,t (1(1(,Q(1 %&(*L1s72 #G /A/Ca/G"/L L & r2c9 $ $*"S1W, & r2d: &$+ 5#/#;$0(,t (1(1(,Q(1 %&(*L1s72 #G /A/Ca/G"/L L & r2c9 $ $+"TAX- & r2d: &$+ 5#/#;$0(,t (1(1(,Q(1 %&(*L1s72 #G /A/Ca/G"/L L & r2c9 $  :!M3 ;, :!M3 ; :!M3 ; :!M3 ; w!? >I?\ #3A#6L(+(+ + D!Z$-"$&II377i3GKY$3%""!"K~!s*Y/"ZZ6[:0[2[77[<=[<7[<=;[<96[<0:[<+6[<":[</ Z?Z,Z32Z36 [[%[/.[/< \\'rr"rrsTcrrksTDrrrr+rsDorlrz/XObjectz/Subtyperz" impossible to decode XFormObject )r&rrrCrr"rrr4r6r!rr rr5rrr(r$rr IndexErrorextract_xform_textrr)#r<rrBrrrrrrobjrresources_dictrrlrrrr}xobjrrrrrrrrrrrrrrrrrs# ` ` @@@@@@@@@@@@@@@@@r: _extract_textzPageObject._extract_textsy&    DR\\*$6I113R\\*$6""2D4FGN n $*N7,CD ?)![#>a ?        1;K1MK ++-SV g}5'g>"@ !?    #   DK DK DK  d5k c  )E )b b b $b b b H #*"4"4> P Hh%1&x9iP4!%,!%2T!!%(1+7!%(1+7!%,!%!"6U"!%8A;,8!%2U""1+  P~ $ 2:,2 y)T!Wi H Q   &  l ""!"$q'3'at9>!$q'3/!%a'*GQy(QRRt9>!$q'E3<8'+Aw '*GQy(QRRt9>!$q'E3<8&*1g '*GQy(QRRDGeS\2#Aw t9>!$q'E3<8&*1g '*GQy(QRR"?Qy IJJ  !3 MM]"  lC ((?L!!  HH   KK " !   rHxformc F|j||j||d|||S)z Extract text from an XObject. Args: space_width: force default space width (if not extracted from font (default 200) Returns: The extracted text N)rrB)r<rrrrrrs r:rzPageObject.extract_xform_textFs3$!!  HH    " !   rHc<tddd|jS)zW .. deprecated:: 1.28.0 Use :meth:`extract_text` instead. extractTextrrK)rr)r<rrs r:rzPageObject.extractTextcs %]NGL  ""rHc|j}t|tsJtt t|t j \}}||z }||fS)z Get the names of embedded fonts and unembedded fonts. :return: (Set of embedded fonts, set of unembedded fonts) )rCr4r"_get_fonts_walkrrr)r<rfontsembedded unembeddeds r: _get_fontszPageObject._get_fontsnsR oo#/00)$/?R\\AR*STxX% ##rHrSc4tddd|jS)V .. deprecated:: 1.28.0 Use :py:attr:`mediabox` instead. mediaBoxrrKrrros r:rzPageObject.mediaBox %ZWE}}rHc,tddd||_y)rrrrKNrrs r:rzPageObject.mediaBoxs %ZWE rHrc4tddd|jS)zU .. deprecated:: 1.28.0 Use :py:attr:`cropbox` instead. cropBoxrqrKrrqros r:rzPageObject.cropBox %Y 7C||rHc,tddd||_y)NrrqrKrrs r:rzPageObject.cropBox$Y 7C rHrc4tddd|jS)zV .. deprecated:: 1.28.0 Use :py:attr:`bleedbox` instead. bleedBoxrsrKrrsros r:rzPageObject.bleedBoxrrHc,tddd||_y)NrrsrKrrs r:rzPageObject.bleedBoxs$ZWE rHrc4tddd|jS)zU .. deprecated:: 1.28.0 Use :py:attr:`trimbox` instead. trimBoxr/rKrr/ros r:rzPageObject.trimBoxrrHc,tddd||_y)Nrr/rKrrs r:rzPageObject.trimBoxrrHrc4tddd|jS)zT .. deprecated:: 1.28.0 Use :py:attr:`artbox` instead. artBoxrrrKrrrros r:r zPageObject.artBoxs %XxA{{rHc,tddd||_y)Nr rrrKr rs r:r zPageObject.artBoxs$XxA rHc2d|vrytt|dS)N/Annots)rr ros r:rwzPageObject.annotationss D  T)_5 5rHc>| |td=y||td<y)z Set the annotations array of the page. Typically you don't want to set this value, but append to it. If you append to it, don't forget to add the object first to the writer and only add the indirect object. Nr rNrs r:rwzPageObject.annotationss% =Z *+*/DI& 'rHNNN)r2N)F)rrr2N)NNF))rrrrrNNN)rr)^rrrr__annotations__r rr%rir^rsetterrrrrrrr rrrr rrr5rrrrrrr"r rr6rr!rr rrrrboolrrrrr1rdrZr\r^r`rbrergrirror~rrrrrrrrrrrr#rrr rr`rrr)rrqrrsrr/rrrr r rw __classcell__)rs@r:rrNsX   ,07;15 5 ' (5%^45~. 5  5,'h~6''((>":(t(( )5))!-1.2* c]*UGT)**eWd*+*  **X!-1.2 @ c] @UGT)* @eWd*+ @  @ @ T   ,+#++__W%U +WWW DCL "c"l""S"\"#C#L###&6#BE# tCH~tCH~- .##$'+CH~A B$  $  $ NAF5!5*/59=5 54DI5!5-25<@5 54IN5!5',5275AE5 5@ <<<  <  <  < #AA B7373  73r %1 %  %3K3K53KT3Kj#u###e## e U t %U%E%d% C ($C$T):"%'[[QUPTLPK KKCHo K  K c] K!)3S#2F2L)M NK (#sC1Et1K(LMKxc3S(A4(GHIK K`4E"QUPTLP` ` `  ` CsCx01 `  ` !)3S#2F2L)M N`  (#sC1Et1K(LM` xc3S(A4(GHI`  ` J):"QUPTLP " CHo   !)3S#2F2L)M N  (#sC1Et1K(LM  xc3S(A4(GHI   </1 # #(+ #  # $E#c(CH"45 $*"++r:H /__o$)bkk^DG ^^_*+ BKK7PQH /__o$)j"++5NOG  ^^_( J 3L MF  ]]O6Xk266  0+!6 04 0 0rHrcdeZdZdegefdeegefddfdZdefdZdedefdZde efd Z y) _VirtualListlength_function get_functionr2Nc.||_||_d|_y)Nr+)rrcurrent)r<rrs r:riz_VirtualList.__init__s /( rHc"|jSr@)rros r:__len__z_VirtualList.__len__s##%%rHindexcVt|trBt|jt t }|j fdSt|ts tdt }|dkr||z}|dks||k\r tdj|S)Nc|Sr@rS)idxindicesr<s r:r[z*_VirtualList.__getitem__..sD4FrHz!sequence indices must be integersrzsequence index out of range) r4slicerr rrrr5rrr)r<rclslen_selfr s` @r: __getitem__z_VirtualList.__getitem__s eU #U]]3t956Gt*Cw(FG G%%?@ @t9 19u$E 19):; ;  ''rHc#LKtt|D] }|| ywr@)rr)r<rs r:__iter__z_VirtualList.__iter__ s's4y! Aq'M s"$) rrrrr5rrirr$rr&rSrHr:rrsh!"c'*uj01  && ( ( ((:.rHrrfntembc| t}| t}t|dsttfSd}d|vr"|jtt|dd|vr7|Dcgc] }||vs| c}r"|jtt|d|j D] }t tt||||"||fScc}w)a_ If there is a key called 'BaseFont', that is a font that is used in the document. If there is a key called 'FontName' and another key in the same dictionary object that is called 'FontFilex' (where x is null, 2, or 3), then that fontname is embedded. We create and add to two sets, fnt = fonts used and emb = fonts embedded. r)z /FontFilez /FontFile2z /FontFile3z /BaseFontz /FontName)sethasattraddrr6rrr")rr'r(fontkeysr9rs r:rr%s {e {e 3 uce|8Hc S#k*+,c ,!18A , GGDc+./ 0xxzD-s3x8#sCD 8O -s ) C3Crr)Lrrrdecimalrtypingrrrrrr r r r r r_cmaprr _protocolsr_utilsrrrrrrr constantsrrtrrrrrrerrorsrfiltersrgenericr r!r"r#r$r%r&r'r(r)r*r,r5rr-r.r6r;rGrJrrDrQrUrWr^r`rbrdrrrrSrHr:r7s<     4)=,+(+#    &($s)(#'"&,0'D S$ 'D S$ 'DCcD()'D 3T#Y  'DT  C 8C= _  0 00$,SM00Cou6L0MRV & &&!&'=!>& &Cst#ST SHSMh6 6!#6 6R:R:js0!s0l5F#"  #c(  #c(  3s8SX  rH