U cb @sUddlZddlZddlmZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZddlmZmZddlmZmZddlmZmZmZmZmZmZmZddlmZ 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<dZee=ee=e5dddZ?ee=ee=e5dddZ@ee=ee5eAfddddZBee=ee5eAfdddd ZCee=dd!d"d#ZDee=dd!d$d%ZEe=ee=eFd&d'd(ZGe=ee=eFd&d)d*ZHGd+d,d,ZIGd-d.d.e.ZJGd/d0d0ZKd5e.e e e=e e e=e e e=e e=fd1d2d3ZLdS)6N)Decimal) AnyCallableDictIterableIteratorListOptionalSetTupleUnioncast)build_char_mapunknown_char_map)PdfReaderProtocolPdfWriterProtocol)CompressedTransformationMatrixFileTransformationMatrixTypedeprecation_no_replacementdeprecation_with_replacementlogger_warningmatrix_multiply)AnnotationDictionaryAttributes)ImageAttributes)PageAttributes) Ressources)PageSizeNotDefinedError)_xobj_to_image) ArrayObject ContentStreamDictionaryObjectEncodedStreamObject FloatObjectIndirectObject NameObject NullObject NumberObjectRectangleObjectencode_pdfdocencodingCUSTOM_RTL_MINCUSTOM_RTL_MAXCUSTOM_RTL_SPECIAL_CHARScropbox)_min_maxspecialsreturncCsvt|tr|ant|tr"t|at|tr2|ant|trDt|at|tr^dd|Dant|trl|atttfS)a Change the Right-To-Left and special characters custom parameters. Args: _min: The new minimum value for the range of custom characters that will be written right to left. If set to `None`, the value will not be changed. If set to an integer or string, it will be converted to its ASCII code. The default value is -1, which sets no additional range to be converted. _max: The new maximum value for the range of custom characters that will be written right to left. If set to `None`, the value will not be changed. If set to an integer or string, it will be converted to its ASCII code. The default value is -1, which sets no additional range to be converted. specials: The new list of special characters to be inserted in the current insertion order. If set to `None`, the current value will not be changed. If set to a string, it will be converted to a list of ASCII codes. The default value is an empty list. Returns: A tuple containing the new values for `CUSTOM_RTL_MIN`, `CUSTOM_RTL_MAX`, and `CUSTOM_RTL_SPECIAL_CHARS`. cSsg|] }t|qS)ord.0xr4r4//tmp/pip-unpacked-wheel-u_n6aelj/pypdf/_page.py {sz"set_custom_rtl..) isinstanceintr,strr5r-r.list)r0r1r2r4r4r9set_custom_rtlTs      r?)selfnamedefaultsr3cCsn||}t|tr|S|dkr@|D]}||}|dk r$q@q$t|trV|j|}t|}t||||SN)getr;r)r%pdf get_object_set_rectangle)r@rArBretvaldr4r4r9_get_rectangles      rJcCstddt|||S)N getRectangle3.0.0)rrJ)r@rArBr4r4r9rKs rK)r@rAvaluer3cCst|}|||<dSrCr&r@rArMr4r4r9rGsrGcCstddt|||dS)N setRectanglerL)rrGrOr4r4r9rPs rP)r@rAr3cCs ||=dSrCr4r@rAr4r4r9_delete_rectanglesrRcCstdd||=dS)NdeleteRectanglerL)rrQr4r4r9rSs rS)rAfallbackr3cs&tfddfddfddS)Ncs t|SrC)rJr@rTrAr4r9z,_create_rectangle_accessor..cs t||SrC)rGr@rMrAr4r9rWrXcs t|SrC)rRrUrZr4r9rWrX)propertyrArTr4rVr9_create_rectangle_accessors    r]cCstddt||S)NcreateRectangleAccessorrL)rr]r\r4r4r9r^s r^c@seZdZdZdedddZeedddZe eed d d Z de e dd ddZ de e e e ddddZe ddddZedddZd eee e fee feeee e fee fdddZdS)!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 pypdf import Transformation >>> op = Transformation().scale(sx=2, sy=3).translate(tx=10, ty=20) >>> page.add_transformation(op) rrrrrrctmcCs ||_dSrCrar@rbr4r4r9__init__szTransformation.__init__r3cCs@|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)) rrrarUr4r4r9matrixszTransformation.matrix)rjr3cCs@|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) rrrfr4)rjr4r4r9compresss      zTransformation.compressr)txtyr3cCs<|j}t|d|d|d|d|d||d|fdS)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 rrrfrgrhrira)rbr_)r@rlrmmr4r4r9 translates zTransformation.translateNsxsyr3cCsx|dkr|dkrtd|dkr$|}|dkr0|}|dk s)r@rrtyppt1r4r4r9apply_on>s  88zTransformation.apply_on)r`)rr)NN)F)__name__ __module__ __qualname____doc__rrdr[rrj staticmethodrkrror rwr}r=rr r rboolrr4r4r4r9r_s,  r_cseZdZUdZded<dedeefee ee ddddZ e ee ddd Z e j ee dd d d Z edfd d Ze edddZededeefeeedfeeedfddddZedeeeeedfeeedfddddZe eedddZe edddZej eeefddddZddddZeddddZeddd d!Zeddd"d#Zeddd$d%Zde e e!e"e#e$e%e!fe$e%e!ffd'd(d)Z&ee'e$e!e!fedeefe'd*d+d,Z(ee!edeefe'd-d.d/Z)ee!edeefe*e'd0d1d2Z+ee'dd3d4Z,ee'dd5d6Z-dde"dd8d9d:Z.ddd;dd?d@Z1ddee0e!ge'fee*e"e"dd>dAdBZ2dee*ddCdDdEZ3ddee*e4fe"e"ddFdGdHZ5ddee*e4fe"ddIdJdKZ6ddee"e"ddLdMdNZ7ddee"ddOdPdQZ8ddee"e"ddRdSdTZ9ddee"ddUdVdWZ:ddeee"e"ddXdYdZZ;ddeee"dd[d\d]Zddeeee"ddddedfZ?ddeeeee"ddgdhdiZ@dee4e*fe"ddjdkdlZAe*ddmdndoZBeeddpdqdrZCeddsdtduZDeddsdvdwZEeeddxdydzZFeeddxd{d|ZGddd}d~ZHddddZIe%dddZJddeKjLdddfe!e!e#edfeee%ee0e!e!e!e!gdfee0e!e!e!e!gdfee0e!e!e!e!e!gdfe%d ddZMdddddddde!ee%ee%eee#edffeee0e!e!e!e!gdfee0e!e!e!e!gdfee0e!e!e!e!e!gdfe%d ddZNdeOe#edfeee0e!e!e!e!gdfee0e!e!e!e!gdfee0e!e!e!e!e!gdfe%dddZPde%e%e%dddZQe#eRe%eRe%fdddZSeTeKjUdZVe eWdddZXeXj eWdd ddZXeTdeKjUfZYe eWdddZZeZj eWdd ddZZeTddeKjUfZ[e eWdddZ\e\j eWdd ddZ\eTddeKjUfZ]e eWdddZ^e^j eWdd ddZ^eTddeKjUfZ_e eWdddZ`e`j eWdd ddZ`e eeadddZbebj eeadd ddZbZcS) 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 Z original_pageN)rEindirect_reference indirect_refr3cCsBt|||_|dk r8tdt|dk r4td|}||_dS)Nznindirect_ref is deprecated and will be removed in pypdf 4.0.0. Use indirect_reference instead of indirect_ref.z/Use indirect_reference instead of indirect_ref.)r"rdrEwarningswarnDeprecationWarningrtr)r@rErrr4r4r9rdfs zPageObject.__init__recCstdt|jS)Nzlindirect_ref is deprecated and will be removed in pypdf 4.0.0Use indirect_reference instead of indirect_ref.)rrrrrUr4r4r9r|s zPageObject.indirect_ref)rMr3cCs ||_dSrC)rrYr4r4r9rscst}|dt|7}|S)Ns%d)superhash_value_dataid)r@data __class__r4r9rs zPageObject.hash_value_datacCs|tjdS)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)rDPGZ USER_UNITrUr4r4r9 user_units zPageObject.user_unit)rEwidthheightr3cCst|}|ttjtd|ttjt|ttjt|dksV|dkr|dk rt |j dkr|j t |j d}|j j }|j j }nt|ttjtdd||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/PageNrr)r __setitem__r&rZTYPEZPARENTr' RESOURCESr"lenZpagesmediaboxrrrMEDIABOXr))rErrpageZlastpager4r4r9create_blank_pages zPageObject.create_blank_pagecCstdddt|||S)zX Use :meth:`create_blank_page` instead. .. deprecated:: 1.28.0 createBlankPagerrL)rrr)rErrr4r4r9rs zPageObject.createBlankPagecCsg}tj|tjkr|S|tjtj}|D]T}||tjdkr0t||\}}|dk r0|dd|}|t ||dq0|S)z Get a list of all images of the page. This requires pillow. You can install it via 'pip install pypdf[image]'. For the moment, this does NOT include inline images. They will be added in future. /ImageNr)rAr) RESXOBJECTrrrFIAZSUBTYPErappendr)r@Zimages_extractedZx_objectobj extensionZ byte_streamfilenamer4r4r9imagess zPageObject.imagescCs$|tjd}t|tr|S|S)z The VISUAL rotation of the page. This number has to be a multiple of 90 degrees: 0, 90, 180, or 270 are valid values. This property does not affect ``/Contents``. r)rDrROTATEr;r<rF)r@Z rotate_objr4r4r9rxszPageObject.rotation)rr3cCs*tt|dddd|ttj<dS)N-Zh)r(r<r&rr)r@rr4r4r9rxsc Cs*|j }d|_t|j}tt|j|jd t|j|j d  |}| |j }| |j }|t|d|d t|d|d }||ddD]}||krt||}| |j }| |j }tt|d|dt|d|dt|d|dt|d|df|t|<qdS)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. rrfrF)z /MediaBox/CropBox /BleedBox/TrimBox/ArtBoxN)rxr)rr_rorleftrbottomrr}r lower_left upper_rightminadd_transformationmaxr&)r@rmbtrsfrpt2brrr4r4r9transfer_rotation_to_contents4   ,    z'PageObject.transfer_rotation_to_content)angler3cCs0|ddkrtdt|j||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. Returns: The rotated PageObject rrz'Rotation angle must be a multiple of 90)rtr(rxr&rrr@rr4r4r9r}s zPageObject.rotatecCstddd||S)Nrotate_clockwiser}rLrr}rr4r4r9r.s zPageObject.rotate_clockwisecCstddd||S)zW Use :meth:`rotate_clockwise` instead. .. deprecated:: 1.28.0 rotateClockwiser}rLrrr4r4r9r2s zPageObject.rotateClockwisecCstddd|| S)zp Use :meth:`rotate_clockwise` with a negative argument instead. .. deprecated:: 1.28.0 rotateCounterClockwiser}rLrrr4r4r9r;s z!PageObject.rotateCounterClockwiseT)res1res2resourcenew_res1r3c sxz&t|jtst|jj}t|d}Wn ttfk rFd}d}YnXtttt fdfdd }|rt | |t  ntt ||tt | |t  i}D]} || \} } t| } | | kr| || <| s>|r0| || <z| j| <Wntk r,YnXn| | <t} | D]}|d|d<qVq|fS)N _add_objectF)base_keyr3csP|}|}d}|krH||kr0|dfS|d|}|d7}q|dfS)a Find a key that either doesn't already exist or has the same value (indicated by the bool) Args: base_key: An index is added to this to get the computed key Returns: A tuple (computed key, bool) where the boolean indicates if there is a resource of the given computed_key with the same value. rT-rF)raw_get)rrMZ computed_keyidxZnew_resZpage2resr4r9compute_unique_keyUs  z7PageObject._merge_resources..compute_unique_keyrr)r;rr%rurEhasattrAttributeErrorr=r rr"updaterDrFr keysr&rclonesorteditemsclear)r@rrrrrEZ is_pdf_writerrZ rename_reskeyZ unique_keyZ same_valueZnewnamelstelr4rr9_merge_resourcesDsL    zPageObject._merge_resources)streamrenamerEr3cCs|s|St||}|jD]\}}t|tr`tt|D]&}||}t|tr6|||||<q6qt|tr|D]&}||}t|trn|||||<qnqt dt |q|S)Nztype of operands is ) r! operationsr;r>rangerr&rDdictKeyErrortype)rrrEoperands _operatorirvr4r4r9_content_stream_renames      z!PageObject._content_stream_rename)contentsrEr3cCs0t||}|jdgdf|jgdf|S)NrqQ)r!rinsertr)rrErr4r4r9 _push_pop_gss zPageObject._push_pop_gs)rrErbr3c CsT|\}}}}}}t||}|jdt|t|t|t|t|t|gdg|S)zZ Add transformation matrix at the beginning of the given contents stream. rz cm)r!rrr$) rrErbarcrIefr4r4r9_add_transformation_matrixs  z%PageObject._add_transformation_matrixcCs tj|kr|tjSdSdS)z Access the page contents. Returns: The ``/Contents`` object, or ``None`` if it doesn't exist. ``/Contents`` is optional, as described in PDF Reference 7.7.3.3 N)rCONTENTSrFrUr4r4r9 get_contentss zPageObject.get_contentscCstddd|S)zS Use :meth:`get_contents` instead. .. deprecated:: 1.28.0 getContentsrrL)rrrUr4r4r9rs zPageObject.getContentsF)page2expandr3cCs|j||ddS)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@rrr4r4r9 merge_pageszPageObject.merge_page)rr3cCstddd||S)zQ Use :meth:`merge_page` instead. .. deprecated:: 1.28.0 mergePagerrL)rr)r@rr4r4r9rs zPageObject.mergePage)rpage2transformationrboverrr3c Csz6t|jtstt|jjdr4||||||WSWnttfk rNYnXt}i}zt t|t j  }Wnt k rt}YnXzt t|t j  } Wnt k rt} YnXt} ||fD]6} t j| kr| t j} t| tr| D]} | | qqtjtjtjtjtjtjtjfD]4}||| |\}}|r(||t|<||q(ttt|tjt  t| tjt |ttj<t}|!}|dk r|t"#||j|!}|dk rt$||j}t%|t&}|j'(dt)t*|j+|j,|j-|j.gdf|j'(dgdf|j'(dgdf|dk rT||}t"/|||j}t"#||j}|r||n |(d||r|0||t$||j|tt j1<||tt j <| |tt j<dS)NrrrerWrfn)2r;rr%rurrE_merge_page_writerrr"r rrrFrr ANNOTSrr EXT_G_STATEFONTr COLOR_SPACEPATTERNSHADING PROPERTIESrr&rrsetrDPROC_SETunionrrrr!getattrMERGE_CROP_BOXrrmapr$rrrrr_expand_mediaboxr)r@rrrbrrZ new_resourcesroriginal_resourcespage2resourcesZ new_annotsrannotsrefresnew newrenamenew_content_arrayoriginal_content page2contentrectr4r4r9rs                     zPageObject._merge_pagec Cst|jtst|jj}i}tt|tj }tt|tj } t j t j t j t jt jt jt jfD]@} | | krd| |krt|t| <||| | d\} } || qdt j| kr t j|krt|tt j<tt|t j} tt| t jD]}|| kr| |q| tj|krtj|kr4t|ttj<tt|tj }|dkrZt}nt|}tt|tjD]|}| }|j|dd}tt|d}||d|dfd}||d|d fd}tt|d|dt|d|dt|d|dt|d|df|td<d |krtt|d }ttt||d|dfdtt||d|d fdtt||d |d fdtt||d |dfd|td <z|j|td<||jWnt k rYnXqrt}|!}|dk r|t"#||j|!}|dk rt$||j}t%|t&}|j'(dt)t*|j+|j,|j-|j.gdf|j'(dgdf|j'(dgdf|dk r||}t"/|||j}t"#||j}|r||n |(d||r|0||tj1|kr|2t$d||ttj1<|3tj1}z&t|ts6t4|5|t$||Wn0t4k rz|2t$|||ttj1<YnXdS)NF)/Pz /StructParent)Z ignore_fieldsz/RectrrTrfrgz /QuadPointsrhrirrrr)6r;rr%rurEr r"rrrFrrrrrrrr r&rrr r rsortrr_rrrrtuplerrrrr!r rrrrr$rrrrrrrrrrZ_replace_object)r@rrrbrrrErrrr_rZarrr8rrrZaarrrrrrrrindr4r4r9rus                          zPageObject._merge_page_writer)rrbr3c st|jj|jj|jj|jjf}|jj|jj|jj|jj|jj|jj|jj|jjfdk rtddDtfddtdddD}tfddtdddD}nddd}ddd}t|t|f}t |t |f}t|d|dt|d|df}t |d|dt |d |df}||j_ ||j_ dS) Ncss|]}t|VqdSrCrr6r4r4r9 sz.PageObject._expand_mediabox..c3s:|]2}d|d|ddVqdS)rrfrrhNr4r7rZcorners2rbr4r9r$srrfc3s:|]2}d|d|ddVqdS)rrgriNr4r%r&r4r9r$srrg) rr as_numericrrighttopr rrrrr)r@rrbZcorners1new_xnew_y lowerleft upperrightr4r&r9rs@               $zPageObject._expand_mediabox)rrbrrr3cs0ttrj|fdd||dS)a merge_transformed_page is similar to merge_page, but a transformation matrix is applied to the merged stream. Args: page2: The page to be merged into this one. ctm: a 6-element tuple containing the operands of the transformation matrix over: set the page2 content over page1 if True(default) else under expand: Whether the page should be expanded to fit the dimensions of the page to be merged. cst|jttSrC)rrrEr r)Z page2Contentrbrr4r9rWCsz3PageObject.merge_transformed_page..N)r;r_rbr)r@rrbrrr4r/r9merge_transformed_page,s  z!PageObject.merge_transformed_page)rrbrr3cCstddd||||dS)zs deprecated deprecated:: 1.28.0 Use :meth:`merge_transformed_page` instead. z,page.mergeTransformedPage(page2, ctm,expand)z-page.merge_transformed_page(page2,ctm,expand)rLN)rr0)r@rrbrr4r4r9mergeTransformedPageKs zPageObject.mergeTransformedPage)rrwrrr3cCs"t||}|||||dS)a merge_scaled_page is similar to merge_page, but the stream to be merged is scaled by applying a transformation matrix. Args: page2: The page to be merged into this one. scale: The scaling factor over: set the page2 content over page1 if True(default) else under expand: Whether the page should be expanded to fit the dimensions of the page to be merged. N)r_rwr0)r@rrwrrrvr4r4r9merge_scaled_page_szPageObject.merge_scaled_page)rrwrr3cCstddd||||dS)zp deprecated .. deprecated:: 1.28.0 Use :meth:`merge_scaled_page` instead. z*page.mergeScaledPage(page2, scale, expand)z-page2.merge_scaled_page(page2, scale, expand)rLN)rr2)r@rrwrr4r4r9mergeScaledPageps zPageObject.mergeScaledPage)rrxrrr3cCs t|}|||||dS)a merge_rotated_page is similar to merge_page, but the stream to be merged is rotated by applying a transformation matrix. Args: page2: The page to be merged into this one. rotation: The angle of the rotation, in degrees over: set the page2 content over page1 if True(default) else under expand: Whether the page should be expanded to fit the dimensions of the page to be merged. N)r_r}r0)r@rrxrrrvr4r4r9merge_rotated_pages zPageObject.merge_rotated_page)rrxrr3cCstddd||||dS)z deprecated .. deprecated:: 1.28.0 Use :meth:`add_transformation` and :meth:`merge_page` instead. z.page.mergeRotatedPage(page2, rotation, expand)z.page2.mergeotatedPage(page2, rotation, expand)rLN)rr4)r@rrxrr4r4r9mergeRotatedPages zPageObject.mergeRotatedPage)rrlrmrrr3cCs"t||}|||||dS)a mergeTranslatedPage is similar to merge_page, but the stream to be merged is translated by applying a transformation matrix. Args: page2: the page to be merged into this one. tx: The translation on X axis ty: The translation on Y axis over: set the page2 content over page1 if True(default) else under expand: Whether the page should be expanded to fit the dimensions of the page to be merged. N)r_ror0)r@rrlrmrrrvr4r4r9merge_translated_pagesz PageObject.merge_translated_page)rrlrmrr3cCs tddd|||||dS)zt deprecated .. deprecated:: 1.28.0 Use :meth:`merge_translated_page` instead. z/page.mergeTranslatedPage(page2, tx, ty, expand)z\page2.add_transformation(Transformation().translate(tx, ty)); page.merge_page(page2, expand)rLN)rr6)r@rrlrmrr4r4r9mergeTranslatedPages zPageObject.mergeTranslatedPage)rrxrlrmrr3cCs:tdddt| | |||}||||S)za .. deprecated:: 1.28.0 Use :meth:`merge_transformed_page` instead. z@page.mergeRotatedTranslatedPage(page2, rotation, tx, ty, expand)z`page.merge_transformed_page(page2, Transformation().rotate(rotation).translate(tx, ty), expand);rL)rr_ror}r0)r@rrxrlrmrrvr4r4r9mergeRotatedTranslatedPages  z%PageObject.mergeRotatedTranslatedPage)rrxrwrr3cCs2tdddt|||}||||dS)zs obsolete .. deprecated:: 1.28.0 Use :meth:`merge_transformed_page` instead. z;page.mergeRotatedScaledPage(page2, rotation, scale, expand)zrpage.merge_transformed_page(page2, Transformation().rotate(rotation).scale(scale)); page.merge_page(page2, expand)rLN)rr_r}rwr1)r@rrxrwrrvr4r4r9mergeRotatedScaledPages z!PageObject.mergeRotatedScaledPage)rrwrlrmrr3cCs0tdddt||||}||||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)zhpage2.add_transformation(Transformation().rotate(rotation).scale(scale)); page.merge_page(page2, expand)rLN)rr_r}rwror1)r@rrxrwrlrmrrvr4r4r9 mergeRotatedScaledTranslatedPagesz+PageObject.mergeRotatedScaledTranslatedPage)rbrr3c slttrj|}|dk rLt||j}t||j}||tt j <|rh|j j |j j |j j |j j |j j |j j |j j |j j gtddDfddtdddD}fd dtdddD}t|t|f}t|t|f}td|dtd |d f}td|dtd |d f}||j _||j _dS) aa 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`. Ncss|]}t|VqdSrCr#r6r4r4r9r$asz0PageObject.add_transformation..cs8g|]0}d|d|ddqS)rrfrrhr4r%Zcornersrbr4r9r:bsz1PageObject.add_transformation..rr'rfcs8g|]0}d|d|ddqS)rrgrir4r%r<r4r9r:fsrrg)r;r_rbrrrrErr&rrrrr(rr*r)r rrrrr)r@rbrcontentr+r,r-r.r4r<r9r=s@              $zPageObject.add_transformation)rbr3cCstddd||dS)zY Use :meth:`add_transformation` instead. .. deprecated:: 1.28.0 addTransformationrrLN)rrrcr4r4r9r>vs zPageObject.addTransformationrpc Cs||dd|ddf|j|||_|j|||_|j|||_|j|||_|j|||_tj|kr|tj}t |t r|D]}| }t j |kr|t j }t |t rtt|d||d<tt|d||d<tt|d||d<tt|d||d<qtj|kr|tj}t |t rH|dd}n|d}tt|d|t|d|t|d|t|d|f} t |t r| |ttjtdtd<n| |ttjtd<dS)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. rrrfrgz/BBoxN)rr/rwartboxbleedboxtrimboxrrrr;r rFADAZRectr$rZVPr)r&r() r@rqrr annotations annotationZannotation_objZ rectangleZviewportZbboxZ scaled_bboxr4r4r9rwsH           zPageObject.scale)factorr3cCs|||dS)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)rwr@rEr4r4r9scale_byszPageObject.scale_bycCstddd|||dS)zO Use :meth:`scale_by` instead. .. deprecated:: 1.28.0 scaleByrGrLN)rrwrFr4r4r9rHs zPageObject.scaleBy)rrr3cCs0|t|jj}|t|jj}|||dS)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)rrrrrw)r@rrrqrrr4r4r9scale_tos zPageObject.scale_tocCstddd|||dS)zO Use :meth:`scale_to` instead. .. deprecated:: 1.28.0 scaleTorIrLN)rrI)r@rrr4r4r9rJs zPageObject.scaleTocCs<|}|dk r8t|ts&t||j}||ttj<dS)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)rr;r!rEZ flate_encoder&rr)r@r=r4r4r9compress_content_streamss   z#PageObject.compress_content_streamscCstddd|dS)z_ Use :meth:`compress_content_streams` instead. .. deprecated:: 1.28.0 compressContentStreamsrKrLN)rrKrUr4r4r9rLs z!PageObject.compressContentStreamsc Cs^d}t|d|jdjD]P\}}|dkr@dd|dD}ng}||dd d||d 7}q|d 7}z|tjd D]}||d 7}||tjd |d 7}z*|tjd |d }||d 7}Wnt k rYnXz*||tjd |d d 7}Wqt k r4YqXqWnt k rX|d7}YnX|S)Nz /ContentsbytesTJcSsg|]}t|tr|qSr4)r;r=r6r4r4r9r:s z1PageObject._debug_for_extract..rzutf-8  z ============================= /Fontz /Encodingz /ToUnicodezNo Font ) r!rFrErdecodejoinrrr Exceptionget_datar)r@outZopervsfoZenc_reprr4r4r9_debug_for_extractsF *   zPageObject._debug_for_extract)rri@.) rrE orientations space_width content_keyvisitor_operand_beforevisitor_operand_after visitor_textr3c sddd d iz4|} ttj| kr2| d} qtt| tj} Wntk rZYdSXd| krtt| dD]} t| ||| <qrdiddfz4t|t r||n|} t| t st | |d} Wnt k rYdSXd d d d d d ggd d d d d d gd d d d d d gd d d d d t t t t t t d dd t t tddd t dfdd tt dd fdd } | jD]\}}|dk r||||dkr| dg| d|n$|dkr:| d|dg| d|d g| dg| d|d!dn|d"krd| d#|d  g| d$|n|d%kr|dD]p}t|t tfr| d|gt|tt ttfrvtt |krvtdkrvd&d'krv| dd'gqvn(|d(kr 7 dk rd)z8 d&d*krR d*7 dk rRd*d)Wntk rjYnXzzd| d+}||dd,d-kr|||d ||| 7 dk rЈd)Wn*tk rtd.|dtYnXW5dXn | |||dk r|||q 7 dkr`dk r`d) S)/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" rMFz/ParentrRcharmapZNotInitializedNrN?g@@g(@)rnrr3c Ss|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|dgS)Nrrrfrgrhrir4)rnrr4r4r9multns&&z&PageObject._extract_text..mult)rnr3cSs8|ddkrdS|ddkr dS|ddkr0dSdSdS) Nrggư>rgưr[rrr\r4)rnr4r4r9orientxs   z(PageObject._extract_text..orientrecsdS)Ng@@r4r4) _space_widthr4r9current_spacewidthsz4PageObject._extract_text..current_spacewidth)operatorrr3c s d}|dkrHddddddg 7 dk r@dddS|dkr| 7 dk rtddnZ|dkrfn6|d krz\Wn$tk rddddddgYnXn|d krj 7 dk rdd t|d t|d t|d t|dt|dt|dgnl|dkrt|d dnN|dkrdt|d n0|dkrt|d n|dkrdkr 7 dk rddz4|d }|d |d |d|d |dfWn:tk rltd td tdd|d dfYnXzt|d Wntk rYnXn<|dkr d}t|d }t|d }d|d |d 7<d|d |d7<n|dkr^d}t|d t|d t|d t|dt|dt|dgnx|dkrd}d8<nV|dkrd} } |}| krt|d trʈ|d 7qd}t|d trt|d n|d } td trNz| d d}Wn4tk rJ| d dkr>dndd}YnXnd fdd| D}fd d|DD]T} t | d krt | } nd } | d!ksd"| kr| d#ksd$| kr| d%ksd&| kr| d'ks| t kr r| n| nd(| kr| d)ksRd*| kr*| d+ksRd,| kr>| d-ksRt| kr| tkr sd 7 dk rdd| n< rd 7 dk rdd| qxndS| r } |}|dd} |dd} tt|d |dt|d |d }|}|| krVdSz|d kr| d.|kr d/d0kr d07 dk rd0ddnDt| |d1krt| |d2kr d/d3krd37n|d4kr| d5|kr^ d/d0kr d07 dk rXd0ddnDt| |d1krt| |d2kr d/d3krd37nF|d6krJ| d5|kr d/d0krH d07 dk rd0ddnDt| |d1krt| |d2kr d/d3krd37n|d7kr| d.|kr d/d0kr d07 dk rd0ddnDt| |d1krt| |d2kr d/d3krd37Wntk rYnXdS)8NFsBTrerfrgrMsETqQscmrrrfrhrisTzgY@TwTLsTfz???TdTsTmT*Tj surrogatepassrdz utf-16-becs2g|]*}|dkr d|n t|fqS)r)rNrSr6cmapr4r9r: szGPageObject._extract_text..process_operation..cs(g|] }|dkr d|n|qS)rr4r6rtr4r9r:&s/:@i io i i!iiiiipigr+rQg333333?rPr[g?rr\)rpoprUrrrr;r=r*rSrTrr5r.r,r-rysqrtabs)rkrZcheck_crlf_spaceZ charMapTuplerlrmrnZ orientationtttr8ZxxZdelta_xZdelta_ykrZTLriZ char_scaleZ cm_matrixZcm_stackruZcmapsrjZ font_sizergrhr^outputZrtl_dirZ space_scaletextZ tm_matrixZtm_prevrcr4r9process_operations                        $(                   .                 z3PageObject._extract_text..process_operation'rqrr"rnrsTcrrfsTDrorprOr+rPsDorgrQz/XObjectz/Subtyperz" impossible to decode XFormObject )r&rrrFr r"rUrr;r=r!rrrr<rNrr(r$r|r IndexErrorextract_xform_textrr)r@rrEr^r_r`rarbrcZobjrZresources_dictrr=rrrkrvZxobjr4rr9 _extract_texts   :&                   zPageObject._extract_text)Tj_sepTJ_sepr^r_rarbrc) argsrrr^r_rarbrcr3c Gst|dkr>t|dtr|d}t|dkrZt|dtrH|d}ntd|dt|dkrt|dttfr|d}ntd|dt|dkrt|dttfr|d}ntd|dnnt|dttfr,|d}t|dkr>t|dttfr|d}ntd|dntd|d|dk sR|dk r^tdt t|trp|f}| ||j ||t j |||S) an Locate all text drawing commands, in the order they are provided in the content stream, and extract the text. This works well for some PDF files, but poorly for others, depending on the generator used. This will be refined in the future. Do not rely on the order of text coming out of this function, as it will change if this function is made more sophisticated. Arabic, Hebrew,... are extracted in the good order. If required an custom RTL range of characters can be defined; see function set_custom_rtl Additionally you can provide visitor-methods to get informed on all operands and all text-objects. For example in some PDF files this can be useful to parse tables. Args: Tj_sep: Deprecated. Kept for compatibility until pypdf 4.0.0 TJ_sep: Deprecated. Kept for compatibility until pypdf 4.0.0 orientations: list of orientations text_extraction will look for default = (0, 90, 180, 270) note: currently only 0(Up),90(turned Left), 180(upside Down), 270 (turned Right) space_width: force default space width if not extracted from font (default: 200) visitor_operand_before: function to be called before processing an operand. It has four arguments: operand, operand-arguments, current transformation matrix and text matrix. visitor_operand_after: function to be called after processing an operand. It has four arguments: operand, operand-arguments, current transformation matrix and text matrix. visitor_text: function to be called when extracting some text at some position. It has five arguments: text, current transformation matrix, text matrix, font-dictionary and font-size. The font-dictionary may be None in case of unknown fonts. If not None it may e.g. contain key "/BaseFont" with value "/Arial,Bold". Returns: The extracted text rrrfzInvalid positional parameter rgrhNzJparameters Tj_Sep, TJ_sep depreciated, and will be removed in pypdf 4.0.0.)rr;r= TypeErrorr r<rrrrrrErr) r@rrr^r_rarbrcrr4r4r9 extract_textsN5        zPageObject.extract_textrrr\r)xformr^r_rarbrcr3c Cs|||j||d|||S)a[ Extract text from an XObject. Args: xform: orientations: space_width: force default space width (if not extracted from font (default 200) visitor_operand_before: visitor_operand_after: visitor_text: Returns: The extracted text N)rrE)r@rr^r_rarbrcr4r4r9rPszPageObject.extract_xform_textrM)rrr3cCstddd|S)zS Use :meth:`extract_text` instead. .. deprecated:: 1.28.0 extractTextrrL)rr)r@rrr4r4r9rrs zPageObject.extractTextcCs>|}t|tstttt|tj\}}||}||fS)z Get the names of embedded fonts and unembedded fonts. Returns: A tuple (Set of embedded fonts, set of unembedded fonts) )rFr;r"ru_get_fonts_walkr rr)r@rZfontsZembeddedZ unembeddedr4r4r9 _get_fonts{s zPageObject._get_fontsr4cCstddd|jS)R Use :py:attr:`mediabox` instead. .. deprecated:: 1.28.0 mediaBoxrrLrrrUr4r4r9rs zPageObject.mediaBoxcCstddd||_dS)rrrrLNrrYr4r4r9rs rcCstddd|jS)zQ Use :py:attr:`cropbox` instead. .. deprecated:: 1.28.0 cropBoxr/rLrr/rUr4r4r9rs zPageObject.cropBoxcCstddd||_dS)Nrr/rLrrYr4r4r9rs rcCstddd|jS)zR Use :py:attr:`bleedbox` instead. .. deprecated:: 1.28.0 bleedBoxr@rLrr@rUr4r4r9rs zPageObject.bleedBoxcCstddd||_dS)Nrr@rLrrYr4r4r9rs rcCstddd|jS)zQ Use :py:attr:`trimbox` instead. .. deprecated:: 1.28.0 trimBoxrArLrrArUr4r4r9rs zPageObject.trimBoxcCstddd||_dS)NrrArLrrYr4r4r9rs rcCstddd|jS)zP Use :py:attr:`artbox` instead. .. deprecated:: 1.28.0 artBoxr?rLrr?rUr4r4r9rs zPageObject.artBoxcCstddd||_dS)Nrr?rLrrYr4r4r9rs cCsd|kr dStt|dSdS)N/Annots)r r rUr4r4r9rCszPageObject.annotationscCs$|dkr|td=n ||td<dS)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. NrrNrYr4r4r9rCs  )NNN)NNN)NNN)T)F)NNTF)NNTF)TF)F)TF)F)TF)F)TF)F)F)F)F)F)F)rr]NNN)rMrM)drrrr__annotations__r rrr r%rdr[rsetterrNrrrrrrrrrrr<rxrr}rrrr"rrr rr=rr!rrrrrrrrrrrrr_r0r1r2r3r4r5r6r7r8r9r:r;rr>rwrGrHrIrJrKrLrZrrrrr#rrr rr]rrr)rr/rr@rrArr?rr rC __classcell__r4r4rr9rTsj        ,    #  M         w  /  #           ( '  : 5     *  T g  "         rc@s`eZdZegefeegefddddZedddZeedd d Ze edd d Z dS) _VirtualListN)length_function get_functionr3cCs||_||_d|_dS)Nr+)rrcurrent)r@rrr4r4r9rd sz_VirtualList.__init__recCs|SrC)rrUr4r4r9__len__ sz_VirtualList.__len__)indexr3cst|tr:t|tt}|jfddSt|tsLtdt}|dkrd||}|dkst||kr|t d |S)Ncs |SrCr4)rindicesr@r4r9rW rXz*_VirtualList.__getitem__..z!sequence indices must be integersrzsequence index out of range) r;slicerrrrrr<rrr)r@rclsZlen_selfr4rr9 __getitem__ s  z_VirtualList.__getitem__ccs tt|D]}||Vq dSrC)rr)r@rr4r4r9__iter__* sz_VirtualList.__iter__) rrrrr<rrdrrrrr4r4r4r9r s   r)rfntembr3cs|dkrt}|dkrt}tds2ttfSd}dkrR|ttddkrfdd|Dr|ttdD]}ttt|||q||fS)a Get the set of all fonts and all embedded fonts. Args: obj: Page resources dictionary fnt: font emb: embedded fonts Returns: A tuple (fnt, emb) 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. Nr)z /FontFilez /FontFile2z /FontFile3z /BaseFontz /FontNamecsg|]}|kr|qSr4r4r6rr4r9r:P sz#_get_fonts_walk..)r raddr r=rrr")rrrZfontkeysrr4rr9r/ s   r)NNN)NN)Mryrdecimalrtypingrrrrrrr r r r r Z_cmaprrZ _protocolsrr_utilsrrrrrrr constantsrrBrrrrrrerrorsrfiltersrZgenericr r!r"r#r$r%r&r'r(r)r*r,r<rr-r.rr=r?rJrKrrGrPrRrSr[r]r^r_rrrr4r4r4r9s 4$      4     -     I#