+
    Švj»a ã                   óV  € ^ RI t ^ RIHtHtHt ^ RIHt ^ RIHtH	t	 ^ RI
Ht ^ RIHt ^ RIHt ^ RIHtHtHtHtHtHtHt ^R	IHt ^R
IHt ^RIHt ^RIHt ^RI H!t!H"t"H#t#H$t$H%t%H&t& ^RI'H(t(H)t)H*t*H+t+ ^RI'H,t- ^RI'H.t/ ^RI0H1t1H2t2 ^RI3H4t4H5t5H6t6H7t7H8t8H9t9H:t:H;t;H<t<H=t=H>t>H?t?H@t@  ^ RIAHBtB RtCRtFR R ltGR R ltHR R ltIR R ltJ ! R R 4      tK]	 ! R! R"4      4       tL ! R# R$]]L,          4      tM ! R% R&]64      tN ! R' R(]]N,          4      tOR) R* ltPR#   ]D d    ]EtBRtC Lwi ; i)+é    N)ÚIterableÚIteratorÚSequence)Údeepcopy)ÚasdictÚ	dataclass)ÚDecimal)ÚBytesIO)ÚPath)ÚAnyÚCallableÚLiteralÚOptionalÚUnionÚcastÚoverload)ÚFont)ÚPdfCommonDocProtocol)Ú_layout_mode)ÚTextExtraction)ÚCompressedTransformationMatrixÚTransformationMatrixTypeÚ_human_readable_bytesÚ	deprecateÚlogger_warningÚmatrix_multiply)Ú_INLINE_IMAGE_KEY_MAPPINGÚ_INLINE_IMAGE_VALUE_MAPPINGÚAnnotationDictionaryAttributesÚImageAttributes)ÚPageAttributes)Ú	Resources)ÚPageSizeNotDefinedErrorÚPdfReadError)ÚArrayObjectÚContentStreamÚDictionaryObjectÚEncodedStreamObjectÚFloatObjectÚIndirectObjectÚ
NameObjectÚ
NullObjectÚNumberObjectÚ	PdfObjectÚRectangleObjectÚStreamObjectÚis_null_or_none)ÚImageFTÚcropboxc                ó^   € V ^8„  d   QhR\         R\        R\        \        ,          R\        /# )é   ÚselfÚnameÚdefaultsÚreturn)r   Ústrr   r/   )Úformats   "ÚO/var/www/html/daimler-pipeline/venv/lib/python3.14/site-packages/pypdf/_page.pyÚ__annotate__r=   a   s,   € ÷ ñ œð ¤Cð ´8¼Cµ=ð Ä_ñ ó    c                 óø  € V P                  V4      p\        V\        4      '       d   V# \        V4      '       d!   V F  pV P                  V4      pVf   K   M	  \        V\        4      '       d   V P
                  P                  V4      p\        V\        4      '       dB   \        V4      ;p^8”  d0   \        R\        VVR7       \        \        VR,          4      4      pM\        V4      p\        WV4       V# )Nz0Expected four values, got %(length)d: %(retval)s)ÚsourceÚlengthÚretval:Né   N)ÚgetÚ
isinstancer/   r1   r*   ÚpdfÚ
get_objectr%   Úlenr   Ú__name__ÚtupleÚ_set_rectangle)r6   r7   r8   rB   ÚdrA   s   &&&   r<   Ú_get_rectanglerM   a   sÏ   € ØHLÏÉÐQUË€FÜ�&œ/×*Ò*ØˆÜ�v×ÒÛˆAØ—X‘X˜a“[ˆFØÔ!Ùñ ô �&œ.×)Ò)Ø—‘×$Ñ$ VÓ,ˆÜ�&œ+×&Ò&´c¸&³kÐ,A¨FÀQÔ+FÜØ>ÜØØõ		
ô !¤ v¨b¥zÓ!2Ó3‰ä  Ó(ˆÜ�4˜vÔ&Ø€Mr>   c                ób   € V ^8„  d   QhR\         R\        R\        \        \        3,          RR/# )r5   r6   r7   Úvaluer9   N)r   r:   r   r/   Úfloat)r;   s   "r<   r=   r=   z   s3   € ÷ #ñ #œð #¤Cð #´´oÄuÐ6LÕ0Mð #ÐRVñ #r>   c                 ó    € W \        V4      &   R # ©N©r+   )r6   r7   rO   s   &&&r<   rK   rK   z   s   € Ø"Œ�DÓ	Ór>   c                ó4   € V ^8„  d   QhR\         R\        RR/# )r5   r6   r7   r9   N)r   r:   )r;   s   "r<   r=   r=   ~   s!   € ÷ ñ œCð ¤sð ¨tñ r>   c                 ó
   € W R # rR   © ©r6   r7   s   &&r<   Ú_delete_rectanglerX   ~   s   € ØŠ
r>   c                óR   € V ^8„  d   QhR\         R\        \         ,          R\        /# )r5   r7   Úfallbackr9   )r:   r   Úproperty)r;   s   "r<   r=   r=   ‚   s%   € ÷ ñ ¤Sð ´H¼SµMð Ähñ r>   c                 ó:   a a€ \        VV 3R  lV 3R lV 3R l4      # )c                 ó   <€ \        V SS4      # rR   )rM   )r6   rZ   r7   s   &€€r<   Ú<lambda>Ú,_create_rectangle_accessor.<locals>.<lambda>„   s   ø€ ”^ D¨$°Ô9r>   c                 ó   <€ \        V SV4      # rR   )rK   )r6   rO   r7   s   &&€r<   r^   r_   …   s   ø€ œN¨4°°uÔ=r>   c                 ó   <€ \        V S4      # rR   )rX   rW   s   &€r<   r^   r_   †   s   ø€ Ô& t¨TÔ2r>   )r[   )r7   rZ   s   ffr<   Ú_create_rectangle_accessorrb   ‚   s   ù€ ÜÝ9Ü=Ü2óð r>   c                   ó<  a € ] tR t^Št o RtRV 3R lR llt]V 3R lR l4       t]V 3R lR l4       t	V 3R lR	 lt
V 3R
 lR ltRV 3R lR lltRV 3R lR lltV 3R lR ltV 3R lR lt]RV 3R lR ll4       t]RV 3R lR ll4       tRV 3R lR lltRtV tR# ) ÚTransformationuç  
Represent a 2D transformation.

The transformation between two coordinate systems is represented by a 3-by-3
transformation 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 PdfWriter, Transformation
    >>> page = PdfWriter().add_blank_page(800, 600)
    >>> op = Transformation().scale(sx=2, sy=3).translate(tx=10, ty=20)
    >>> page.add_transformation(op)

c                ó$   <€ V ^8„  d   QhRS[ RR/# )r5   Úctmr9   N)r   )r;   Ú__classdict__s   "€r<   r=   ÚTransformation.__annotate__§   s   ø€ ÷ ñ Ñ:ð ÐTXñ r>   c                ó   € Wn         R # rR   ©rf   )r6   rf   s   &&r<   Ú__init__ÚTransformation.__init__§   s   € ØŽr>   c                ó    <€ V ^8„  d   QhRS[ /# ©r5   r9   )r   )r;   rg   s   "€r<   r=   rh   «   s   ø€ ÷ 

ñ 

Ñ0ñ 

r>   c                óê   € V P                   ^ ,          V P                   ^,          ^ 3V P                   ^,          V P                   ^,          ^ 3V P                   ^,          V P                   ^,          ^33# )zg
Return the transformation matrix as a tuple of tuples in the form:

((a, b, 0), (c, d, 0), (e, f, 1))
rj   ©r6   s   &r<   ÚmatrixÚTransformation.matrixª   s\   € ð �X‰X�a�[˜$Ÿ(™( 1�+ qÐ)Ø�X‰X�a�[˜$Ÿ(™( 1�+ qÐ)Ø�X‰X�a�[˜$Ÿ(™( 1�+ qÐ)ð
ð 	
r>   c                ó&   <€ V ^8„  d   QhRS[ RS[/# )r5   rq   r9   )r   r   )r;   rg   s   "€r<   r=   rh   ¸   s   ø€ ÷ 
ñ 
Ñ1ð 
Ñ6Tñ 
r>   c                óº   € V ^ ,          ^ ,          V ^ ,          ^,          V ^,          ^ ,          V ^,          ^,          V ^,          ^ ,          V ^,          ^,          3# )zá
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)

rV   )rq   s   &r<   ÚcompressÚTransformation.compress·   sP   € ð �1�I�a�LØ�1�I�a�LØ�1�I�a�LØ�1�I�a�LØ�1�I�a�LØ�1�I�a�Lð
ð 	
r>   c                ó    <€ V ^8„  d   QhRS[ /# rn   ©r:   )r;   rg   s   "€r<   r=   rh   Ì   s   ø€ ÷ 
ñ 
™ñ 
r>   c                ó  € V P                   ^ ,          R RV P                   ^,          R RV P                   ^,          R RV P                   ^,          R RV P                   ^,          R RV P                   ^,          R R2# )r   z.4fÚ z cmrj   rp   s   &r<   Ú_to_cmÚTransformation._to_cmÌ   sw   € ð �x‰x˜�{˜3Ð˜q §¡¨!¥¨SÐ 1°°4·8±8¸Aµ;¸sÐ2CÀ1Ø�x‰x˜�{˜3Ð˜q §¡¨!¥¨SÐ 1°°4·8±8¸Aµ;¸sÐ2CÀ3ðHð	
r>   c                ó"   <€ V ^8„  d   QhRRRR/# )r5   Úmrd   r9   rV   )r;   rg   s   "€r<   r=   rh   Ó   s   ø€ ÷ #ñ #Ð+ð #Ð0@ñ #r>   c                ó~   € \         P                  \        V P                  VP                  4      4      p\        V4      # )aã  
Apply one transformation to another.

Args:
    m: a Transformation to apply.

Returns:
    A new ``Transformation`` instance

Example:
    >>> from pypdf import PdfWriter, Transformation
    >>> height, width = 40, 50
    >>> page = PdfWriter().add_blank_page(800, 600)
    >>> op = Transformation((1, 0, 0, -1, 0, height)) # vertical mirror
    >>> op = Transformation().transform(Transformation((-1, 0, 0, 1, width, 0)))  # horizontal mirror
    >>> page.add_transformation(op)

)rd   ru   r   rq   )r6   r~   rf   s   && r<   Ú	transformÚTransformation.transformÓ   s.   € ô& ×%Ñ%¤o°d·k±kÀ1Ç8Á8Ó&LÓMˆÜ˜cÓ"Ð"r>   c                ó*   <€ V ^8„  d   QhRS[ RS[ RR/# )r5   ÚtxÚtyr9   rd   ©rP   )r;   rg   s   "€r<   r=   rh   é   s(   ø€ ÷ Rñ R™Eð R©5ð RÐ9Iñ Rr>   c           	     ó®   € V P                   p\        V^ ,          V^,          V^,          V^,          V^,          V,           V^,          V,           3R7      # )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

rj   )rf   rd   )r6   rƒ   r„   r~   s   &&& r<   Ú	translateÚTransformation.translateé   sE   € ð �H‰HˆÜ 1 Q¥4¨¨1­¨q°­t°Q°qµT¸1¸Q½4À"½9ÀaÈÅdÈRÅiÐ"PÔQÐQr>   Nc                óJ   <€ V ^8„  d   QhRS[ S[,          RS[ S[,          RR/# )r5   ÚsxÚsyr9   rd   )r   rP   )r;   rg   s   "€r<   r=   rh   ø   s-   ø€ ÷ #ñ #Ù™5•/ð#Ù.6±u­oð#à	ñ#r>   c                óÖ   € Vf   Vf   \        R4      hVf   TpVf   TpVf   Q hVf   Q hV^ ^ 3^ V^ 3R3p\        P                  \        V P                  V4      4      p\        V4      # )af  
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 specified©r   r   é   )Ú
ValueErrorrd   ru   r   rq   )r6   rŠ   r‹   Úoprf   s   &&&  r<   ÚscaleÚTransformation.scaleø   s   € ð" Š:˜"š*ÜÐ@ÓAÐAØŠ:ØˆBØŠ:ØˆBØŠ~Ðˆ~ØŠ~Ðˆ~Ø)+¨Q°¨
°Q¸¸A°JÀ	Ð'JˆÜ×%Ñ%¤o°d·k±kÀ2Ó&FÓGˆÜ˜cÓ"Ð"r>   c                ó$   <€ V ^8„  d   QhRS[ RR/# )r5   Úrotationr9   rd   r…   )r;   rg   s   "€r<   r=   rh     s   ø€ ÷ #ñ #™uð #Ð)9ñ #r>   c                óN  € \         P                  ! V4      p\         P                  ! V4      \         P                  ! V4      ^ 3\         P                  ! V4      ) \         P                  ! V4      ^ 3R3p\        P                  \        V P                  V4      4      p\	        V4      # )z¡
Rotate the contents of a page.

Args:
    rotation: The angle of rotation in degrees.

Returns:
    A new ``Transformation`` instance with the rotated matrix.

r�   )ÚmathÚradiansÚcosÚsinrd   ru   r   rq   )r6   r”   r�   rf   s   &&  r<   ÚrotateÚTransformation.rotate  s   € ô —<’< Ó)ˆä�XŠX�hÓ¤§¢¨(Ó!3°QÐ7Ü�hŠh�xÓ Ð ¤$§(¢(¨8Ó"4°aÐ8Øð(
ˆô
 ×%Ñ%¤o°d·k±kÀ2Ó&FÓGˆÜ˜cÓ"Ð"r>   c                ó    <€ V ^8„  d   QhRS[ /# rn   rx   )r;   rg   s   "€r<   r=   rh   )  s   ø€ ÷ 1ñ 1™#ñ 1r>   c                ó"   € R V P                    R2# )zTransformation(ctm=Ú)rj   rp   s   &r<   Ú__repr__ÚTransformation.__repr__)  s   € Ø$ T§X¡X J¨aÐ0Ð0r>   c                óL   <€ V ^8„  d   QhRS[ S[,          RS[RS[ S[,          /# ©r5   ÚptÚ	as_objectr9   )ÚlistrP   Úbool)r;   rg   s   "€r<   r=   rh   -  s*   ø€ ÷ ñ ™4¡�;ð ±4ð ÁDÉÅKñ r>   c                ó   € R # rR   rV   ©r6   r£   r¤   s   &&&r<   Úapply_onÚTransformation.apply_on,  ó   € ár>   c                óX   <€ V ^8„  d   QhRS[ S[S[3,          RS[RS[ S[S[3,          /# r¢   )rJ   rP   r¦   )r;   rg   s   "€r<   r=   rh   1  s7   ø€ ÷ ñ Ù™™u˜Õ%ðÙ26ðá	‰u‘eˆ|Õ	ñr>   c                ó   € R # rR   rV   r¨   s   &&&r<   r©   rª   0  s   € ñ 	r>   c          	      ó¤   <€ V ^8„  d   QhRS[ S[S[S[3,          S[S[,          3,          RS[RS[ S[S[S[3,          S[S[,          3,          /# r¢   )r   rJ   rP   r¥   r¦   )r;   rg   s   "€r<   r=   rh   6  sW   ø€ ÷ :ñ :á‘%™™u˜Õ%¡t©E¥{Ð2Õ3ð:ñ ð:ñ 
‰u‘U™E�\Õ"¡D©¥KÐ/Õ	0ñ	:r>   c                óL  € V'       d   \         M\        pV! \        V^ ,          4      V P                  ^ ,          ,          \        V^,          4      V P                  ^,          ,          ,           V P                  ^,          ,           4      V! \        V^ ,          4      V P                  ^,          ,          \        V^,          4      V P                  ^,          ,          ,           V P                  ^,          ,           4      3p\        V\        4      '       d   \	        V4      # T# )a&  
Apply the transformation matrix on the given point.

Args:
    pt: A tuple or list representing the point in the form (x, y).
    as_object: If True, return items as FloatObject, otherwise as plain floats.

Returns:
    A tuple or list representing the transformed point in the form (x', y')

)r)   rP   rf   rE   r¥   )r6   r£   r¤   ÚtypÚpt1s   &&&  r<   r©   rª   6  s»   € ÷  '�k¬Eˆá”�b˜•e“˜tŸx™x¨�{Õ*¬U°2°aµ5«\¸D¿H¹HÀQ½KÕ-GÕGÈ$Ï(É(ÐSTÍ+ÕUÓVÙ”�b˜•e“˜tŸx™x¨�{Õ*¬U°2°aµ5«\¸D¿H¹HÀQ½KÕ-GÕGÈ$Ï(É(ÐSTÍ+ÕUÓVð
ˆô ' r¬4×0Ò0Œt�C‹yÐ9°cÐ9r>   rj   ))rŽ   r   r   rŽ   r   r   )r   r   ©NN©F)rI   Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__rk   r[   rq   Ústaticmethodru   r{   r€   r‡   r‘   rš   rŸ   r   r©   Ú__static_attributes__Ú__classdictcell__©rg   s   @r<   rd   rd   Š   s»   ø‡ € ñ÷8ò ð ÷

ó ð

ð ÷
ó ð
÷(
ð 
÷#ð #÷,Rò R÷#ò #÷:#ð #÷(1ð 1ð ÷ñ ó ðð ÷ñ ó ð÷
:÷ :ð :r>   rd   c                   ó~   a € ] tR tRt o RtRt Rt Rt Rt V 3R lR lt	V 3R lR	 lt
V 3R
 lR ltV 3R ltRtV tR# )Ú	ImageFileiN  z·
Image within the PDF file. *This object is not designed to be built.*

This object should not be modified except using :func:`ImageFile.replace` to replace the image with a new one.
Ú r>   Nc                ó*   <€ V ^8„  d   QhRS[ RS[RR/# )r5   Ú	new_imageÚkwargsr9   N)r2   r   )r;   rg   s   "€r<   r=   ÚImageFile.__annotate__j  s"   ø€ ÷ 7ñ 7¡ð 7±#ð 7¸$ñ 7r>   c                óÞ  € \         '       d   \        R4      h^RIHp ^RIHpHp ^RIHp V P                  f   \        R4      h\        V P                  P                  R4      '       g   \        R4      h\        V\        4      '       g   \        R	4      h\        4       pVP                   ! VR
3/ VB  V! V4      pVP"                  ^ ,          P$                  ^ ,          p	V	P                  f   Q hV	P                  P'                  4       V P                  P                  P(                  V P                  P*                  ^,
          &   V P                  \-        WPP                  P'                  4       4      n	        V! \-        W@P                  P'                  4       4      VR7      w  r«pV
f   Q hV P.                  RV P.                  P1                  R4       V
,           V n        W°n        WÀn        R# )al  
Replace the image with a new PIL image.

Args:
    new_image (PIL.Image.Image): The new PIL image to replace the existing image.
    **kwargs: Additional keyword arguments to pass to `Image.save()`.

Raises:
    TypeError: If the image is inline or in a PdfReader.
    TypeError: If the image does not belong to a PdfWriter.
    TypeError: If `new_image` is not a PIL Image.

Note:
    This method replaces the existing image with a new image.
    It is not allowed for inline images or images within a PdfReader.
    The `kwargs` parameter allows passing additional parameters
    to `Image.save()`, such as quality.

z]pillow is required to do image extraction. It can be installed via 'pip install pypdf[image]')Ú	PdfReader)r'   r.   ©Ú_xobj_to_imageNzCannot update an inline image.Ú_id_translatedz4Cannot update an image not belonging to a PdfWriter.znew_image shall be a PIL ImageÚPDF)Úpillow_parametersÚ.)Úpil_not_importedÚImportErrorÚ_readerrÄ   Úgenericr'   r.   Úgeneric._image_xobjectrÆ   Úindirect_referenceÚ	TypeErrorÚhasattrrF   rE   r2   r
   ÚsaveÚpagesÚimagesrG   Ú_objectsÚidnumr   r7   ÚrfindÚdataÚimage)r6   rÀ   rÁ   rÄ   r'   r.   rÆ   ÚbÚreaderÚ
page_imageÚ	extensionÚbyte_streamÚimgs   &&,          r<   ÚreplaceÚImageFile.replacej  sœ  € ÷( ÓÜðEóð õ
 	'ß8Ý:à×"Ñ"Ò*ÜÐ<Ó=Ð=Ü�t×.Ñ.×2Ñ2Ð4D×EÒEÜÐRÓSÐSÜ˜)¤U×+Ò+ÜÐ<Ó=Ð=Ü‹IˆØ�Š�q˜%Ñ* 6Ò*Ù˜1“ˆØ—\‘\ !•_×+Ñ+¨AÕ.ˆ
Ø×,Ñ,Ò8Ð8Ð8à×)Ñ)×4Ñ4Ó6ð 	×Ñ×#Ñ#×,Ñ,¨T×-DÑ-D×-JÑ-JÈQÕ-NÑOð
  $×6Ñ6ô 	Ø×.Ñ.×9Ñ9Ó;ó	
ä
á&4ÜÐ!×#:Ñ#:×#EÑ#EÓ#GÓHØ$ô'
Ñ#ˆ	 ð Ò$Ð$Ð$Ø—I‘IÐ4 §	¡	§¡°Ó 4Ð5¸	ÕAˆŒ	ØŒ	ØŽ
r>   c                ó    <€ V ^8„  d   QhRS[ /# rn   rx   )r;   rg   s   "€r<   r=   rÂ   £  s   ø€ ÷ mñ m™ñ mr>   c           	     óŒ   € V P                   P                   R V P                   R\        \	        V P
                  4      4       R2# )z(name=z, data: rž   )Ú	__class__rI   r7   r   rH   rÙ   rp   s   &r<   Ú__str__ÚImageFile.__str__£  s?   € Ø—.‘.×)Ñ)Ð*¨&°·±°¸8ÔDYÔZ]Ð^b×^gÑ^gÓZhÓDiÐCjÐjkÐlÐlr>   c                ó    <€ V ^8„  d   QhRS[ /# rn   rx   )r;   rg   s   "€r<   r=   rÂ   ¦  s   ø€ ÷ Cñ C™#ñ Cr>   c                ód   € V P                  4       R R R\        V P                  4       R2,           # )Nz, hash: rž   éÿÿÿÿ)ræ   ÚhashrÙ   rp   s   &r<   rŸ   ÚImageFile.__repr__¦  s,   € Ø�|‰|‹~˜c˜rÐ" x´°T·Y±Y³Ð/@ÀÐ%BÕBÐBr>   c                ój   <€ V ^8„  d   Qh/ S[ ;R&   S[;R&   S[S[,          ;R&   S[S[,          ;R&   # )r5   r7   rÙ   rÚ   rÐ   )r:   Úbytesr   r2   r*   )r;   rg   s   "€r<   r=   rÂ   N  sA   ø‡ ‚ ñ �Nñ ñ Ññ ñ$ ‘E�?Ñ!ñ% ñ. !¡Õ0Ñ7ò/ r>   )rÙ   rÚ   r7   )rI   r´   rµ   r¶   r·   r7   rÙ   rÚ   rÐ   rá   ræ   rŸ   Ú__annotate_func__r¹   rº   r»   s   @r<   r½   r½   N  sf   ø‡ € ñð €Dðð €Dðð "€Eðð 48Ðð÷7ð 7÷rmð m÷Cð C÷q ƒ r>   r½   c                   óÚ   a € ] tR tRt o RtV 3R lR ltV 3R lR ltV 3R lR ltV 3R	 lR
 lt]	V 3R lR l4       t
]	V 3R lR l4       t
V 3R lR lt
V 3R lR ltV 3R lR ltRtV tR# )ÚVirtualListImagesiª  zº
Provides access to images referenced within a page.
Only one copy will be returned if the usage is used on the same page multiple times.
See :func:`PageObject.images` for more details.
c          	      óÆ   <€ V ^8„  d   QhRS[ . S[S[S[S[S[,          3,          ,          3,          RS[ S[S[S[S[,          S[S[,          3,          .S[3,          RR/# )r5   Úids_functionÚget_functionr9   N)r   r¥   r   r:   rJ   r½   )r;   rg   s   "€r<   r=   ÚVirtualListImages.__annotate__±  sf   ø€ ÷ ñ á˜r¡4©©c±4¹µ9¨nÕ(=Õ#>Ð>Õ?ðñ ¡¡c©4±­9±e¹CµjÐ&@Õ AÐBÁIÐMÕNðð 
ñ	r>   c                ó,   € Wn         W n        RV n        R# ©rŽ   Nrê   )ró   rô   Úcurrent)r6   ró   rô   s   &&&r<   rk   ÚVirtualListImages.__init__±  s   € ð
 )ÔØ(ÔØˆŽr>   c                ó    <€ V ^8„  d   QhRS[ /# rn   ©Úint)r;   rg   s   "€r<   r=   rõ   º  s   ø€ ÷ (ñ (™ñ (r>   c                ó4   € \        V P                  4       4      # rR   )rH   ró   rp   s   &r<   Ú__len__ÚVirtualListImages.__len__º  s   € Ü�4×$Ñ$Ó&Ó'Ð'r>   c                óV   <€ V ^8„  d   QhRS[ S[S[S[ S[,          3,          ,          /# rn   )r¥   r   r:   )r;   rg   s   "€r<   r=   rõ   ½  s&   ø€ ÷ #ñ #‘d™5¡¡d©3¥i Õ0Õ1ñ #r>   c                ó"   € V P                  4       # rR   ©ró   rp   s   &r<   ÚkeysÚVirtualListImages.keys½  s   € Ø× Ñ Ó"Ð"r>   c                ól   <€ V ^8„  d   QhRS[ S[S[S[S[ S[,          3,          S[3,          ,          /# rn   )r¥   rJ   r   r:   r½   )r;   rg   s   "€r<   r=   rõ   À  s0   ø€ ÷ ;ñ ;‘t™E¡%©©T±#­Y¨Õ"7¹Ð"BÕCÕDñ ;r>   c                óZ   € V P                  4        Uu. uF  qW,          3NK  	  up# u upi rR   r  )r6   Úxs   & r<   ÚitemsÚVirtualListImages.itemsÀ  s)   € Ø&*×&7Ñ&7Ô&9Ó:Ñ&9 �D•G“Ñ&9Ñ:Ð:ùÒ:s   “(c                óP   <€ V ^8„  d   QhRS[ S[S[S[S[,          3,          RS[/# ©r5   Úindexr9   )r   rü   r:   r¥   r½   )r;   rg   s   "€r<   r=   rõ   Ä  s+   ø€ ÷ ñ ¡¡s©C±±cµÐ':Õ!;ð Á	ñ r>   c                ó   € R # rR   rV   ©r6   r  s   &&r<   Ú__getitem__ÚVirtualListImages.__getitem__Ã  r«   r>   c                ó6   <€ V ^8„  d   QhRS[ RS[S[,          /# r  )Úslicer   r½   )r;   rg   s   "€r<   r=   rõ   È  s    ø€ ÷ ñ ¡ð ©8±IÕ+>ñ r>   c                ó   € R # rR   rV   r  s   &&r<   r  r  Ç  r«   r>   c                óŽ   <€ V ^8„  d   QhRS[ S[S[S[S[S[,          S[S[,          3,          RS[ S[S[S[,          3,          /# r  )r   rü   r  r:   r¥   rJ   r½   r   )r;   rg   s   "€r<   r=   rõ   Ë  sD   ø€ ÷ -ñ -Ù™3¡¡s©D±­I±u¹SµzÐAÕBð-á	‰y™(¡9Õ-Ð-Õ	.ñ-r>   c                óT  a€ V P                  4       o\        V\        4      '       d]   \        VP	                  \        V 4      4      !  pV Uu. uF  pSV,          NK  	  upo\        V 4      pV! V3R  lV P                  4      # \        V\        \        \        34      '       d   V P                  V4      # \        V\        4      '       g   \        R4      h\        S4      pV^ 8  d	   W,          p^ Tu;8:  d   V8  g   M \        R4      hV P                  SV,          4      # u upi )c                  ó   <€ S # rR   rV   )Úlsts   €r<   r^   Ú/VirtualListImages.__getitem__.<locals>.<lambda>Ó  s   ø€ ¡r>   zInvalid sequence indices typeúSequence index out of range)ró   rE   r  ÚrangeÚindicesrH   Útyperô   r:   r¥   rJ   rü   rÑ   Ú
IndexError)r6   r  r  r  ÚclsÚlen_selfr  s   &&    @r<   r  r  Ë  sö   ø€ ð ×ÑÓ!ˆÜ�eœU×#Ò#Ü˜UŸ]™]¬3¨t«9Ó5Ñ6ˆGÙ#*Ó+¡7˜a�3�q—6�6¡7Ñ+ˆCÜ�t“*ˆCÙœ d×&7Ñ&7Ó8Ð8Ü�eœc¤4¬Ð/×0Ò0Ø×$Ñ$ UÓ+Ð+Ü˜%¤×%Ò%ÜÐ;Ó<Ð<Ü�s“8ˆØ�1Œ9àÕˆEØ�UÖ%˜XÖ%ÜÐ:Ó;Ð;Ø× Ñ   U¥Ó,Ð,ùò ,s   ÁD%c                ó0   <€ V ^8„  d   QhRS[ S[,          /# rn   )r   r½   )r;   rg   s   "€r<   r=   rõ   à  s   ø€ ÷ ñ ™(¡9Õ-ñ r>   c              #  óX   "  € \        \        V 4      4       F  pW,          x € K  	  R # 5irR   ©r  rH   ©r6   Úis   & r<   Ú__iter__ÚVirtualListImages.__iter__à  ó   é € Ü”s˜4“yÖ!ˆAØ•'ŒMó "ùó   ‚(*c                ó    <€ V ^8„  d   QhRS[ /# rn   rx   )r;   rg   s   "€r<   r=   rõ   ä  ó   ø€ ÷ #ñ #™ñ #r>   c                óœ   € \        V P                  4       4       UUu. uF  w  rR V RV 2NK  	  pppRRP                  V4       R2# u uppi )ÚImage_Ú=Ú[ú, Ú])Ú	enumerateró   Újoin)r6   r$  ÚnÚps   &   r<   ræ   ÚVirtualListImages.__str__ä  sR   € Ü*3°D×4EÑ4EÓ4GÔ*HÔIÑ*H¡$ !ˆv�a�S˜˜!˜ÓÑ*HˆÑIØ�4—9‘9˜Q“<�. Ð"Ð"ùó Js   �A)rø   rô   ró   N)rI   r´   rµ   r¶   r·   rk   rþ   r  r  r   r  r%  ræ   r¹   rº   r»   s   @r<   rñ   rñ   ª  sx   ø‡ € ñ÷ð ÷(ð (÷#ð #÷;ð ;ð ÷ó ðð ÷ó ð÷-ð -÷*ð ÷#ö #r>   rñ   c                   ó$  a a€ ] tR tRt oRtRhV3R lR lltV3R lR ltV3R lV 3R	 llt]V3R
 lR l4       t	]
RiV3R lR ll4       tRiV3R lR lltRjV3R lR llt]V3R lR l4       tV3R lR ltV3R lR lt]V3R lR l4       t]P$                  V3R lR l4       tV3R lR ltV3R lR ltRkV3R  lR! llt]
V3R" lR# l4       t]
V3R$ lR% l4       tV3R& lR' ltV3R( lR) ltV3R* lR+ ltRlV3R, lR- lltRmV3R. lR/ lltRmV3R0 lR1 lltV3R2 lR3 ltRnV3R4 lR5 lltRnV3R6 lR7 llt RnV3R8 lR9 llt!RnV3R: lR; llt"RoV3R< lR= llt#V3R> lR? lt$V3R@ lRA lt%V3RB lRC lt&RpV3RD lRE llt']V3RF lRG l4       t(V3RH lRI lt)RqRJ]*PV                  RRR3V3RK lRL llt,V3RM lRN lt-RrV3RO lRP llt.RQRqRRRJRSRRTRRURRVRW/V3RX lRY llt/RsV3RZ lR[ llt0V3R\ lR] lt1]2! ]*Pf                  Rt4      t4 ]2! R^]*Pf                  34      t5 ]2! R_R^]*Pf                  34      t6 ]2! R`R^]*Pf                  34      t7 ]2! RaR^]*Pf                  34      t8 ]V3Rb lRc l4       t9]9P$                  V3Rd lRe l4       t9V3Rf lt:Rgt;Vt<V ;t=# )uÚ
PageObjectié  a÷  
PageObject represents a single page within a PDF file.

Typically these objects will be created by accessing the
:attr:`pages<pypdf.PdfReader.pages>` property of the
:class:`PdfReader<pypdf.PdfReader>` class, but it is
also possible to create an empty page with the
:meth:`create_blank_page()<pypdf._page.PageObject.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

Nc                óJ   <€ V ^8„  d   QhRS[ S[,          RS[ S[,          RR/# )r5   rF   rÐ   r9   N)r   r   r*   )r;   rg   s   "€r<   r=   ÚPageObject.__annotate__ü  s9   ø€ ÷ Sñ SáÑ*Õ+ðSñ %¡^Õ4ðSð 
ñ	Sr>   c                óø   € \         P                  ! V 4       Wn        R V n        W n        \        V4      '       g9   Vf   Q R4       hV P                  \        \         VP                  4       4      4       / V n	        R # )NÚmypy)
r'   rk   rF   Úinline_imagesrÐ   r1   Úupdater   rG   Ú_font_width_maps)r6   rF   rÐ   s   &&&r<   rk   ÚPageObject.__init__ü  sh   € ô
 	×!Ò! $Ô'ØŒØ=AˆÔØ"4ÔÜÐ1×2Ò2Ø%Ò1Ð9°6Ó9Ð1Ø�K‰KœÔ-Ð/A×/LÑ/LÓ/NÓOÔPØPRˆÖr>   c                ó    <€ V ^8„  d   QhRS[ /# rn   rû   )r;   rg   s   "€r<   r=   r9  
  s   ø€ ÷ 
ñ 
™#ñ 
r>   c                óº   € \        \        \        ;QJ d'    . R V P                  4        4       F  NK  	  534      # ! R V P                  4        4       4      34      # )z¦
Used to detect modified object.

Note: this function is overloaded to return the same results
as a DictionaryObject.

Returns:
    Hash considering type and value.

c              3   óH   "  € T F  w  rWP                  4       3x € K  	  R # 5irR   )Úhash_bin)Ú.0ÚkÚvs   &  r<   Ú	<genexpr>Ú&PageObject.hash_bin.<locals>.<genexpr>  s   é € Ð%QÁL¹D¸A q¯*©*«,Õ&7ÃLùs   ‚ ")rë   r'   rJ   r  rp   s   &r<   rC  ÚPageObject.hash_bin
  sL   € ô ÜŸuœuÑ%QÀDÇJÁJÄLÓ%QŸuÐSó
ð 	
Ø$Ñ%QÀDÇJÁJÄLÓ%QÓRÐSó
ð 	
r>   c                ó    <€ V ^8„  d   QhRS[ /# rn   )rî   )r;   rg   s   "€r<   r=   r9    s   ø€ ÷ ñ ¡ñ r>   c                óf   <€ \         SV `  4       pV\        V 4       P                  4       ,          pV# rR   )ÚsuperÚhash_value_dataÚidÚencode)r6   rÙ   rå   s   & €r<   rM  ÚPageObject.hash_value_data  s.   ø€ Ü‰wÑ&Ó(ˆØ”2�d“8�*×$Ñ$Ó&Õ&ˆØˆr>   c                ó    <€ V ^8„  d   QhRS[ /# rn   r…   )r;   rg   s   "€r<   r=   r9    s   ø€ ÷ 6ñ 6™5ñ 6r>   c                ó^   € \        \        V P                  \        P                  ^4      4      # )zÙ
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   rP   rD   ÚPGÚ	USER_UNITrp   s   &r<   Ú	user_unitÚPageObject.user_unit  s    € ô ”E˜4Ÿ8™8¤B§L¡L°!Ó4Ó5Ð5r>   c          	      óp   <€ V ^8„  d   QhRS[ S[,          RS[S[S[R3,          RS[S[S[R3,          RR/# )r5   rF   ÚwidthNÚheightr9   r7  )r   r   r   rP   r	   )r;   rg   s   "€r<   r=   r9  *  sO   ø€ ÷ +ñ +ÙÑ*Õ+ð+á‘U™G TÐ)Õ*ð+ñ ‘e™W dÐ*Õ+ð+ð 
ñ	+r>   c           	     óº  € \        V 4      pVP                  \        \        P                  4      \        R4      4       VP                  \        \        P
                  4      \        4       4       VP                  \        \        P                  4      \        4       4       Ve   Vf   V eu   \        V P                  4      ^ 8”  d[   V P                  \        V P                  4      ^,
          ,          pVP                  P                  pVP                  P                  pM\        hVP                  \        \        P                  4      \!        ^ ^ W34      4       V# )aË  
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 is within.
    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/Page)r7  Ú__setitem__r+   rS  ÚTYPEÚPARENTr,   Ú	RESOURCESr'   rH   rÔ   ÚmediaboxrX  rY  r#   ÚMEDIABOXr/   )rF   rX  rY  ÚpageÚlastpages   &&&  r<   Úcreate_blank_pageÚPageObject.create_blank_page)  sô   € ô6 ˜#‹ˆð 	×Ñœ¤B§G¡GÓ,¬j¸Ó.AÔBØ×Ñœ¤B§I¡IÓ.´
³Ô=Ø×Ñœ¤B§L¡LÓ1Ô3CÓ3EÔFØŠ=˜FšNØŠ¤3 s§y¡y£>°AÔ#5ØŸ9™9¤S¨¯©£^°aÕ%7Õ8�Ø ×)Ñ)×/Ñ/�Ø!×*Ñ*×1Ñ1‘ä-Ð-Ø×ÑÜ”r—{‘{Ó#¤_°a¸¸EÐ5JÓ%Kô	
ð ˆr>   c                ó¸   <€ V ^8„  d   QhRS[ S[,          RS[ S[S[,          ,          RS[ S[S[,          ,          RS[S[S[S[S[,          3,          ,          /# )r5   ÚobjÚancestÚ
call_stackr9   )r   r'   r¥   r:   r   r   )r;   rg   s   "€r<   r=   r9  W  s]   ø€ ÷ $ñ $áÑ&Õ'ð$ñ ™™c�Õ#ð$ñ ™T¡#�YÕ'ð	$ñ
 
‰e‘C™™c��NÕ#Õ	$ñ$r>   c                óð  € Vf   . p\        VRR 4      pWC9   d   . # VP                  V4       V P                  f   V P                  4       V n        Vf   T pVf   . p. p\        P
                  V9  gL   \        V\        P
                  ,          ;p4      '       g$   \        P                  \        \        V4      9  d4   V P                  f   . # \        V P                  P                  4       4      # V\        P                  ,          P                  4       pV F˜  p\        Wx,          \        4      '       g   K!  Wx,          \         P"                  ,          R8X  d*   TP                  \%        V4      ^ 8X  d   TM. VOVN4       Kl  VP'                  V P)                  Wx,          . VOVNV4      4       Kš  	  V P                  f   Q hVP'                  \        V P                  P                  4       4      4       V# )NrÐ   ú/Image)ÚgetattrÚappendr<  Ú_get_inline_imagesrS  r^  r1   ÚRESÚXOBJECTr   r'   r¥   r  rG   rE   r0   r    ÚSUBTYPErH   ÚextendÚ_get_ids_image)	r6   rf  rg  rh  Ú_ir  Ú	resourcesÚx_objectÚos	   &&&&     r<   rr  ÚPageObject._get_ids_imageW  s—  € ð ÒØˆJÜ�SÐ.°Ó5ˆØÔØˆIØ×Ñ˜"ÔØ×ÑÒ%Ø!%×!8Ñ!8Ó!:ˆDÔØŠ;ØˆCØŠ>ØˆFØ+-ˆä—‘ CÔ'Ü¨S´·±Õ->Ð > 	×?Ò?Ü—‘¤4Ô(8¸)Ó#DÔDà×+Ñ+Ò3�2ÐX¼¸d×>PÑ>P×>UÑ>UÓ>WÓ9XÐXàœSŸ[™[Õ)×4Ñ4Ó6ˆÛˆAÜ˜h�k¬<×8Ò8ÙØ�{œ?×2Ñ2Õ3°xÔ?Ø—
‘
¤ F£¨qÔ 0™1°l¸°lÀ°lÖCà—
‘
˜4×.Ñ.¨x­{¸L¸f¸LÀa¸LÈ*ÓUÖVñ ð ×!Ñ!Ò-Ð-Ð-Ø�
‰
”4˜×*Ñ*×/Ñ/Ó1Ó2Ô3Øˆ
r>   c                óv   <€ V ^8„  d   QhRS[ S[S[S[,          S[S[,          3,          RS[S[,          RS[/# )r5   rN  rf  r9   )r   r:   r¥   rJ   r   r'   r½   )r;   rg   s   "€r<   r=   r9  }  sH   ø€ ÷ *Jñ *Já‘#‘t™C•y¡%©¥*Ð,Õ-ð*Jñ Ñ&Õ'ð*Jñ 
ñ	*Jr>   c           	     ó,  € Vf   \        \        V 4      p\        V\        4      '       d   \	        V4      p\        V\        4      '       d   \        V4      ^8X  d
   V^ ,          pR p \        \        \        \        V\        P                  ,          4      \        P                  ,          4      p\        V\        4      '       dÐ   V^ ,          R8X  d^   VR	,          R8X  dP   V P                  f   V P                  4       V n        V P                  f   \        R4      hV P                  V,          # Vf   Q h^RIHp V! \        \        W1,          4      4      pVR,          w  rx\!        VR,           V 2VV^,          W1,          P"                  R7      # Vf   Q hVR,          p	V P%                  V	\        \        W1^ ,          ,          4      4      #   \         d8   pT^ ,          R8X  d   TR	,          R8X  g   \        RT R24      Th R p?EL^R p?ii ; i)
NÚ~zCannot access image object z without XObject resourceszNo inline image can be foundrÅ   :Nr5   N:rŽ   NN©r7   rÙ   rÚ   rÐ   rê   )r   r'   rE   rJ   r¥   rH   rS  r^  rn  ro  ÚKeyErrorr:   r<  rm  rÏ   rÆ   r½   rÐ   Ú
_get_image)
r6   rN  rf  ÚxobjsÚexcrÆ   ÚimgdrÞ   rß   Úidss
   &&&       r<   r}  ÚPageObject._get_image}  sÉ  € ð
 Š;ÜÔ'¨Ó.ˆCÜ�bœ%× Ò Ü�b“ˆBÜ�bœ$×Ò¤C¨£G¨q¤LØ�A•ˆBØ,0ˆð	ÜÜ ¤$Ô'7¸¼R¿\¹\Õ9JÓ"KÌCÏKÉKÕ"XóˆEô �bœ#×ÒØ�!�u˜Œ|  2¥¨#¤Ø×%Ñ%Ò-Ø)-×)@Ñ)@Ó)B�DÔ&Ø×%Ñ%Ò-Ü"Ð#AÓBÐBØ×)Ñ)¨"Õ-Ð-àÒ$Ð$Ð$Ý>Ù!¤$Ô'7¸½Ó"CÓDˆDØ%)¨"¥XÑ"ˆIÜØ˜2��x 	˜{Ð+Ø Ø˜1•gØ#(¥9×#?Ñ#?ô	ð ð Ò Ð Ð Ø��fˆØ�‰˜s¤DÔ)9¸5ÀAÅ½<Ó$HÓIÐIøô5 ô 	Ø�q•E˜S”L R¨¥V¨s¤]ÜØ1°"°Ð5OÐPóàðõ &3ûð	ús   Á(AG ÇHÇ,HÈHc                ó    <€ V ^8„  d   QhRS[ /# rn   )rñ   )r;   rg   s   "€r<   r=   r9  ª  s   ø€ ÷ %Gñ %GÑ)ñ %Gr>   c                óB   € \        V P                  V P                  4      # )a€  
Read-only property emulating a list of images on a page.

Get a list of all images on the page. The key can be:
- A string (for the top object)
- A tuple (for images within XObject forms)
- An integer

Examples:
    * `reader.pages[0].images[0]`        # return first image
    * `reader.pages[0].images['/I0']`    # return image '/I0'
    * `reader.pages[0].images['/TP1','/Image1']` # return image '/Image1' within '/TP1' XObject form
    * `for img in reader.pages[0].images:` # loops through all objects

images.keys() and images.items() can be used.

The ImageFile has the following properties:

    * `.name` : name of the object
    * `.data` : bytes of the object
    * `.image` : PIL Image Object
    * `.indirect_reference` : object reference

and the following methods:
    `.replace(new_image: PIL.Image.Image, **kwargs)` :
        replace the image in the pdf with the new image
        applying the saving parameters indicated (such as quality)

Example usage:

    reader.pages[0].images[0].replace(Image.open("new_image.jpg"), quality=20)

Inline images are extracted and named ~0~, ~1~, ..., with the
indirect_reference set to None.

)rñ   rr  r}  rp   s   &r<   rÕ   ÚPageObject.images©  s   € ôL ! ×!4Ñ!4°d·o±oÓFÐFr>   c                ó,   <€ V ^8„  d   QhRS[ RS[RS[/# )r5   rE  rF  r9   )r:   r.   )r;   rg   s   "€r<   r=   r9  Ñ  s"   ø€ ÷ ñ ©sð ±yð ÁYñ r>   c                ó^  €  \        \        \        \        V4      ,          4      pV#   \        \
        3 dt    \        T\         4      '       dZ    \        \        T R,          4      R,          p\        \        T4      T,          p T#   \
         d    \        RT RT 24      hi ; i T# i ; i)z%Translate values used in inline imageú
/Resourcesz/ColorSpacezCannot find resource entry z for )	r+   r   r   r:   rÑ   r|  rE   r'   r$   )r6   rE  rF  Úress   &&& r<   Ú_translate_value_inline_imageÚ(PageObject._translate_value_inline_imageÑ  s¸   € ð
	RÜÔ6´t¼CÀ³|ÕDÓEˆAð ˆøô œ8Ð$ô 	RÜ˜!œZ×(Ò(ðRÜÔ/°°lÕ1CÓDÀ]ÕS�CÜÔ-¨sÓ3°AÕ6‘Að ˆøô  ô RÜ&Ð)DÀQÀCÀuÈQÈCÐ'PÓQÐQðRúð )ð ˆð	Rús!   ‚$( ¨'B,Á5BÂB%Â%B,Â+B,c                ó6   <€ V ^8„  d   QhRS[ S[S[3,          /# rn   )Údictr:   r½   )r;   rg   s   "€r<   r=   r9  à  s   ø€ ÷ ,ñ ,¡D©©i¨Õ$8ñ ,r>   c                óZ  € V P                  4       p\        V4      '       d   / # . pVf   Q R4       hVP                   FG  w  r4VR8X  d&   VP                  RVR,          RVR,          /4       K1  VR9   g   K:  \	        V: R24      h	  / p\        V4       EF  w  rgRVR,          R\        VR,          4      /pVR,          P                  4        F�  w  ršV	R9   d   K  \        V
\        4      '       d+   \        V
 Uu. uF  q°P                  W›4      NK  	  up4      p
MV P                  Wš4      p
\        \        V	,          4      p	W˜9  g   K}  W¨V	&   Kƒ  	  \        P                  ! V4      VR	&   ^R
IHp V! VR	,          4      w  rÞp\%        RV RV 2VVRR7      VRV R2&   EK  	  V# u upi )z8Load inline images. Entries will be identified as `~1~`.Nr;  s   INLINE IMAGEÚsettingsÚ__streamdata__rÙ   zM operator met whereas not expected, please share use case with pypdf dev teamú/LengthÚobjectrÅ   rz  r{  )s   BIs   EIs   ID>   ú/Lr‘  )Úget_contentsr1   Ú
operationsrl  r$   r1  rH   r  rE   r¥   r%   rŠ  r+   r   r(   Úinitialize_from_dictionaryrÏ   rÆ   r½   )r6   ÚcontentÚ	imgs_dataÚparamÚopeÚfilesÚnumÚiiÚinitrE  rF  r  rÆ   rÞ   rß   rà   s   &               r<   rm  ÚPageObject._get_inline_imagesà  sÇ  € à×#Ñ#Ó%ˆÜ˜7×#Ò#ØˆIØˆ	ØÒ"Ð* FÓ*Ð"Ø!×,Ô,‰JˆEØ�oÔ%Ø× Ñ Ø  zÕ!2Ð4DÀeÈFÅmÐTöð Ð-Ö-Ü"Ø‘gð @ð @óð ñ -ð ˆÜ  ×+‰GˆCà  "Ð%5Õ"6Øœ3˜rÐ"2Õ3Ó4ðˆDð ˜:�×,Ñ,Ö.‘�ØÐ)Ô)ÙÜ˜a¤×&Ò&Ü#ÙKLÓMÉ1Àa×;Ñ;¸AÖAÉ1ÑMó‘Að ×:Ñ:¸1Ó@�AÜÔ8¸Õ;Ó<�Ø–=Ø˜“Gñ /ô /×IÒIÈ$ÓOˆBˆx‰LÝ>Ù*8¸¸H½Ó*FÑ'ˆI CÜ )Ø˜˜˜Q˜y˜kÐ*Ø ØØ#'ô	!ˆE�A�c�U˜!�*Ôñ) ,ð4 ˆùò! Ns   Ã<F(c                ó    <€ V ^8„  d   QhRS[ /# rn   rû   )r;   rg   s   "€r<   r=   r9    s   ø€ ÷ Vñ V™#ñ Vr>   c                ó’   € V P                  \        P                  ^ 4      p\        V\        4      '       d   V# VP                  4       # )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``.
)rD   rS  ÚROTATErE   rü   rG   )r6   Ú
rotate_objs   & r<   r”   ÚPageObject.rotation  s8   € ð —X‘XœbŸi™i¨Ó+ˆ
Ü'¨
´C×8Ò8ˆzÐU¸j×>SÑ>SÓ>UÐUr>   c                ó$   <€ V ^8„  d   QhRS[ RR/# )r5   Úrr9   Nr…   )r;   rg   s   "€r<   r=   r9    s   ø€ ÷ Wñ W™%ð W Dñ Wr>   c                óš   € \        \        V4      ^-,           ^Z,          ^Z,          R,          4      V \        \        P                  4      &   R# )é-   éh  N)r-   rü   r+   rS  r¢  )r6   r¦  s   &&r<   r”   r¤    s2   € ä&2´c¸!³f¸rµkÀbÕ5HÈBÕ4NÐRUÕ3UÓ&VˆŒZœŸ	™	Ó"Ó#r>   c                ó   <€ V ^8„  d   QhRR/# )r5   r9   NrV   )r;   rg   s   "€r<   r=   r9    s   ø€ ÷ !ñ !¨dñ !r>   c                ó  € V P                   ) p^ V n         \        V P                  4      p\        4       P	                  \        VP                  VP                  ^,          ,           4      ) \        VP                  VP                  ^,          ,           4      ) 4      P                  V4      pVP                  VP                  4      pVP                  VP                  4      pVP	                  \        V^ ,          V^ ,          4      ) \        V^,          V^,          4      ) 4      pV P                  VR4       R FÍ  pW`9   g   K  \        W,          4      pVP                  VP                  4      pVP                  VP                  4      p\        \        V^ ,          V^ ,          4      \        V^,          V^,          4      \!        V^ ,          V^ ,          4      \!        V^,          V^,          4      34      V \#        V4      &   KÏ  	  R# )zŒ
Apply the rotation of the page to the content and the media/crop/...
boxes.

It is recommended to apply this function before page merging.
FN)z	/MediaBoxú/CropBoxú	/BleedBoxú/TrimBoxú/ArtBox)r”   r/   r_  rd   r‡   rP   ÚleftrX  ÚbottomrY  rš   r©   Ú
lower_leftÚupper_rightÚminÚadd_transformationÚmaxr+   )r6   r¦  ÚmbÚtrsfr±   Úpt2rÛ   Úrrs   &       r<   Útransfer_rotation_to_contentÚ'PageObject.transfer_rotation_to_content  s…  € ð �]‰]ˆNˆØˆŒÜ˜TŸ]™]Ó+ˆäÓß‰YÜ�r—w‘w §¡¨A¥Õ-Ó.Ð.´°r·y±yÀ2Ç9Á9ÈqÅ=Õ7PÓ1QÐ0Qó÷ ‰V�A‹Yð 	ð �m‰m˜BŸM™MÓ*ˆØ�m‰m˜BŸN™NÓ+ˆØ�~‰~œs 3 q¥6¨3¨q­6Ó2Ð2´S¸¸Q½ÀÀQÅÓ5HÐ4HÓIˆØ×Ñ  eÔ,ÛNˆAØŽyÜ$ T¥WÓ-�Ø—m‘m B§M¡MÓ2�Ø—m‘m B§N¡NÓ3�Ü&5ä˜C �F C¨¥FÓ+Ü˜C �F C¨¥FÓ+Ü˜C �F C¨¥FÓ+Ü˜C �F C¨¥FÓ+ð	ó'�”Z “]Ó#ó Or>   c                ó$   <€ V ^8„  d   QhRS[ RR/# )r5   Úangler9   r7  rû   )r;   rg   s   "€r<   r=   r9  @  s   ø€ ÷ ñ ™Cð  Lñ r>   c                ó¤   € V^Z,          ^ 8w  d   \        R4      h\        V P                  V,           4      V \        \        P
                  4      &   V # )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

z'Rotation angle must be a multiple of 90)r�   r-   r”   r+   rS  r¢  )r6   r¾  s   &&r<   rš   ÚPageObject.rotate@  sA   € ð �2�:˜Œ?ÜÐFÓGÐGÜ&2°4·=±=À5Õ3HÓ&IˆŒZœŸ	™	Ó"Ñ#Øˆr>   c                óz   <€ V ^8„  d   QhRS[ RS[ RS[RS[RS[S[S[S[3,          S[S[S[3,          3,          /# )r5   Úres1Úres2ÚresourceÚnew_res1r9   )r'   r   r¦   rJ   r�  r:   )r;   rg   s   "€r<   r=   r9  P  s^   ø€ ÷ O#ñ O#áðO#ñ ðO#ñ ð	O#ñ
 ðO#ñ 
‰t‘C™�H�~™t¡C© H�~Ð-Õ	.ñO#r>   c                óÎ  aa€  \        V P                  \        4      '       g   Q hV P                  P                  p\	        VR 4      pR VV3R llpV'       dC   \        4       oSP                  VP                  V\        4       4      P                  4       4       M\        \        W,          4      o\        \        VP                  V\        4       4      P                  4       4      o/ pS FÆ  p	V! V	4      w  r«\        V
4      pWš8w  d   WÈV	&   V'       gX   V'       d<   SP                  V	4      P                  V4      SV&    SV,          P                  SV&   MSP                  V	4      SV&   \        SP!                  4       4      pSP#                  4        V F  pV^,          SV^ ,          &   K  	  KÈ  	  SV3#   \
        \        3 d	    RpRp ELŠi ; i  \         d     Lvi ; i)Ú_add_objectNFc                óR   € V ^8„  d   QhR\         R\        \         \        3,          /# )r5   Úbase_keyr9   )r:   rJ   r¦   )r;   s   "r<   r=   Ú1PageObject._merge_resources.<locals>.__annotate__a  s#   € ÷ 	'ñ 	'¬ð 	'´´s¼D°yÕ1Añ 	'r>   c                óœ   <€ SP                  V 4      pT p^ pVS9   d-   SP                  V4      V8X  d   VR3# V  RV 2pV^,          pK3  VR3# )a9  
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.

TÚ-F)Úraw_get)rÉ  rO   Úcomputed_keyÚidxÚnew_resÚpage2ress   &   €€r<   Úcompute_unique_keyÚ7PageObject._merge_resources.<locals>.compute_unique_keya  sk   ø€ ð ×$Ñ$ XÓ.ˆEð $ˆLØˆCØ 'Ô)Ø—?‘? <Ó0°EÔ9ð (¨Ð-Ð-Ø"* ¨1¨S¨EÐ2�Ø�q•’Ø Ð&Ð&r>   )rE   rÐ   r*   rF   rÒ   ÚAssertionErrorÚAttributeErrorr'   r=  rD   rG   r   r+   rÍ  ÚcloneÚsortedr  Úclear)r6   rÂ  rÃ  rÄ  rÅ  rF   Úis_pdf_writerrÒ  Ú
rename_resÚkeyÚ
unique_keyÚ
same_valueÚnewnamer  ÚelrÐ  rÑ  s   &&&&&          @@r<   Ú_merge_resourcesÚPageObject._merge_resourcesP  sµ  ù€ ð	"Ü˜d×5Ñ5´~×FÒFÐFÐFØ×)Ñ)×-Ñ-ˆCÜ#Ø�]óˆM÷	'ñ 	'÷B Ü&Ó(ˆGØ�N‰N˜4Ÿ8™8 HÔ.>Ó.@ÓA×LÑLÓNÕOäÔ+¨T­^Ó<ˆGÜÜ˜dŸh™h xÔ1AÓ1CÓD×OÑOÓQó
ˆð ˆ
ÛˆCÙ%7¸Ó%<Ñ"ˆJÜ  Ó,ˆGØÔ à")˜3‘çß Ø'/×'7Ñ'7¸Ó'<×'BÑ'BÀ3Ó'G�G˜GÑ$ðØ+2°7Õ+;×+NÑ+N˜ Ò(ð (0×'7Ñ'7¸Ó'<�G˜GÑ$Ü˜Ÿ™›Ó)ˆCØ�M‰MŒOÛ�Ø!# A¥�˜˜1�“ó ñ% ð( ˜
Ð"Ð"øôE ¤Ð/ô 	"ØˆCØ!‹Mð	"ûôt *ô Ùðús(   „F: ¤$F: ÅGÆ:GÇGÇG$Ç#G$c                óX   <€ V ^8„  d   QhRS[ RS[S[S[3,          RS[S[,          RS[ /# )r5   ÚstreamÚrenamerF   r9   )r&   r�  r   r   r   )r;   rg   s   "€r<   r=   r9  ¢  s?   ø€ ÷ ñ Ùðá‘S™#�X•ðñ Ñ*Õ+ðñ 
ñ	r>   c                óê  € V'       g   V # \        W4      p V P                   FÍ  w  r4\        V\        4      '       dB   \	        V4       F0  w  rV\        V\
        4      '       g   K  VP                  Wf4      W5&   K2  	  K\  \        V\        4      '       dG   VP                  4        F0  w  rV\        V\
        4      '       g   K  VP                  Wf4      W5&   K2  	  K¸  \        R \        V4       24      h	  V # )zType of operands is )r&   r•  rE   r¥   r1  r+   rD   r�  r  r|  r  )rã  rä  rF   ÚoperandsÚ	_operatorr$  r�   s   &&&    r<   Ú_content_stream_renameÚ!PageObject._content_stream_rename¡  sÄ   € ÷ ØˆMÜ˜vÓ+ˆØ#)×#4Ô#4ÑˆHÜ˜(¤D×)Ò)Ü& xÖ0‘E�AÜ! "¤j×1Ô1Ø&,§j¡j°Ó&8˜›ó 1ô ˜H¤d×+Ò+Ø%Ÿ^™^Ö-‘E�AÜ! "¤j×1Ô1Ø&,§j¡j°Ó&8˜›ó .ô Ð!5´d¸8³nÐ5EÐFÓGÐGñ $5ð ˆr>   c                óB   <€ V ^8„  d   QhRS[ RS[S[,          RS[RS[/# )r5   ÚcontentsrF   rf   r9   )r   r   r   r   r&   )r;   rg   s   "€r<   r=   r9  ¸  s7   ø€ ÷ ñ ÙðáÑ*Õ+ðñ ,ðñ 
ñ	r>   c           	     ó”   € \        W4      pVP                  P                  ^ V Uu. uF  p\        V4      NK  	  upR34       V# u upi )zHAdd transformation matrix at the beginning of the given contents stream.s   cm)r&   r•  Úinsertr)   )rë  rF   rf   Úcontent_streamr  s   &&&  r<   Ú_add_transformation_matrixÚ%PageObject._add_transformation_matrix·  sP   € ô ' xÓ5ˆØ×!Ñ!×(Ñ(Øá),Ó-© A”˜Q–©Ñ-Øðô	
ð Ðùò	 .s   ¦A
c                ó0   <€ V ^8„  d   QhRS[ S[,          /# rn   )r   rî   )r;   rg   s   "€r<   r=   r9  È  s   ø€ ÷ ñ ©±­ñ r>   c                ó  € \         P                  V 9   dr   V \         P                  ,          P                  4       p\        V\        4      '       d   RP                  R V 4       4      # \        \        V4      P                  4       # R# )zw
Return the page contents as bytes.

Returns:
    The ``/Contents`` object as bytes, or ``None`` if it doesn't exist.

r>   c              3   ó\   "  € T F"  qP                  4       P                  4       x € K$  	  R # 5irR   )rG   Úget_data©rD  r  s   & r<   rG  Ú4PageObject._get_contents_as_bytes.<locals>.<genexpr>Ó  s    é € ÐGÁ3¸a§¡£× 7Ñ 7× 9Ð 9Ã3ùs   ‚*,N)	rS  ÚCONTENTSrG   rE   r¥   r2  r   r(   rô  )r6   rf  s   & r<   Ú_get_contents_as_bytesÚ!PageObject._get_contents_as_bytesÈ  sc   € ô �;‰;˜$ÔØ”r—{‘{Õ#×.Ñ.Ó0ˆCÜ˜#œt×$Ò$Ø—x‘xÑGÁ3ÓGÓGÐGÜÔ+¨SÓ1×:Ñ:Ó<Ð<Ùr>   c                ó0   <€ V ^8„  d   QhRS[ S[,          /# rn   )r   r&   )r;   rg   s   "€r<   r=   r9  ×  s   ø€ ÷ ñ ™h¡}Õ5ñ r>   c                ó*  € \         P                  V 9   dk    \        \        V P                  4      P
                  pV \         P                  ,          p\        V4      '       d   R# VP                  4       p\        W14      # R#   \         d    Rp LVi ; i)uµ   
Access the page contents.

Returns:
    The ``/Contents`` object, or ``None`` if it does not exist.
    ``/Contents`` is optional, as described in Â§7.7.3.3 of the PDF Reference.

N)
rS  r÷  r   r*   rÐ   rF   rÕ  r1   rG   r&   )r6   rF   rf  Úresolved_objects   &   r<   r”  ÚPageObject.get_contents×  s{   € ô �;‰;˜$ÔðÜœ>¨4×+BÑ+BÓC×GÑG�ð ”r—{‘{Õ#ˆCÜ˜s×#Ò#ÙØ!Ÿn™nÓ.ˆOÜ  Ó6Ð6Ùøô "ô Ø’ðús   —$B ÂBÂBc                ó@   <€ V ^8„  d   QhRS[ RS[S[S[3,          RR/# )r5   r—  Nr9   )r   r&   r(   r%   )r;   rg   s   "€r<   r=   r9  ì  s,   ø€ ÷ ="ñ ="Ù˜T¡=Ñ2EÁ{ÐRÕSð="à	ñ="r>   c                óð  a€ \        V R4      '       d   V P                  f   W\        \        P                  4      &   R# ^ RIHp \        V P                  P                  V4      '       g   \        R4       V P                  P                  o\        V P                  \        P                  R4      \        4      '       dU   \        \        V \        P                  ,          4      pV F)  p SP                  VP                  \        4       R7       K+  	  \        V\        4      '       d   \        V3R lV 4       4      p\!        V4      '       d‰   \        P                  V 9  d   R# V \        P                  ,          P                  f   Q hSP                  V \        P                  ,          P                  \        4       R7       V \        P                   M¬\        V P                  \        P                  R4      R4      '       g.    SP#                  V4      V \        \        P                  4      &   MOVf   Q R4       hV \        P                  ,          P                  Vn         SP                  VP                  VR7       RV n        R#   \         d     EKµ  i ; i  \$         d    Y\        \        P                  4      &    LDi ; i  \$         d    Y\        \        P                  4      &    Lpi ; i)zŠ
Replace the page contents with the new content and nullify old objects
Args:
    content: new content; if None delete the content field.
rÐ   N)Ú	PdfWritera   Calling `PageObject.replace_contents()` for pages not assigned to a writer is deprecated and will be removed in pypdf 7.0.0. Attach the page to the writer first or use `PdfWriter(clone_from=...)` directly. The existing approach has proved being unreliable.)rÐ   rf  c              3   óF   <"  € T F  pSP                  V4      x € K  	  R # 5irR   )rÇ  )rD  rf  Úwriters   & €r<   rG  Ú.PageObject.replace_contents.<locals>.<genexpr>  s   øé € Ð!MÁW¸c &×"4Ñ"4°S×"9Ð"9ÃWùs   ƒ!r;  )rÒ   rÐ   r+   rS  r÷  Úpypdf._writerr   rE   rF   r   rD   r%   r   Ú_replace_objectr,   r�   r1   rÇ  rÕ  r<  )r6   r—  r   Úcontent_arrayÚ	referencer  s   &&   @r<   Úreplace_contentsÚPageObject.replace_contentsì  sF  ø€ ô �tÐ1×2Ò2°d×6MÑ6MÒ6Uà,3”œBŸK™KÓ(Ñ)Ùå+Ü˜$×1Ñ1×5Ñ5°y×AÒAÜðkôð ×(Ñ(×,Ñ,ˆÜ�d—h‘hœrŸ{™{¨DÓ1´;×?Ò?Ü ¤¨d´2·;±;Õ.?Ó@ˆMÛ*�	ðØ×*Ñ*¸i×>ZÑ>ZÔ`jÓ`lÐ*Ömñ +ô �gœ{×+Ò+Ü!Ô!MÁWÓ!MÓMˆGä˜7×#Ò#Ü�{‰{ $Ô&ÙØœŸ™Õ$×7Ñ7ÒCÐCÐCØ×"Ñ"°d¼2¿;¹;Õ6G×6ZÑ6ZÔ`jÓ`lÐ"ÔmØ”R—[‘[Ñ!Ü˜Ÿ™¤"§+¡+¨tÓ4Ð6J×KÒKð8Ø06×0BÑ0BÀ7Ó0K�”Z¤§¡Ó,Ò-ð Ò&Ð.¨Ó.Ð&Ø)-Ü—‘õ*ç Ñ ð Ô&ð8Ø×&Ñ&¸'×:TÑ:TÐZaÐ&Ôbð "ˆÖøôE "ô ãðûô  "ô 8ð 18”Z¤§¡Ó,Ó-ð	8ûô "ô 8ð 18”Z¤§¡Ó,Ó-ð	8ús6   Ã+%JÈ	+J  É'K ÊJÊJÊ &K	ËK	Ë&K5Ë4K5c                ó.   <€ V ^8„  d   QhRRRS[ RS[ RR/# )r5   Úpage2r7  ÚexpandÚoverr9   N)r¦   )r;   rg   s   "€r<   r=   r9  +  s-   ø€ ÷ :ñ :Ø!ð:Ù+/ð:Ù?Cð:à	ñ:r>   c                ó,   € V P                  WVR7       R# )aŒ  
Merge the content streams of two pages into one.

Resource references (e.g. 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<PageObject>`.
    over: set the page2 content over page1 if True (default) else under
    expand: If True, the current page dimensions will be
        expanded to accommodate the dimensions of the page to be merged.

)r  r  N)Ú_merge_page)r6   r  r  r  s   &&&&r<   Ú
merge_pageÚPageObject.merge_page+  s   € ð( 	×Ñ˜°&ÐÖ9r>   c                ór   <€ V ^8„  d   QhRRRS[ S[S[.S[3,          ,          RS[ S[,          RS[RS[RR/# )	r5   r  r7  Úpage2_transformationrf   r  r  r9   N©r   r   r   r&   r   r¦   )r;   rg   s   "€r<   r=   r9  A  sf   ø€ ÷ hñ hàðhñ '¡x±°±}Ð0DÕ'EÕFðhñ Ñ4Õ5ð	hñ
 ðhñ ðhð 
ñhr>   c                ó`	  €  \        V P                  \        4      '       g   Q h\        V P                  P                  R 4      '       d   V P                  WW4V4      #  \        4       p/ p\        \        V P                  \        P                  \        4       4      P                  4       4      p\        \        VP                  \        P                  \        4       4      P                  4       4      p	\        4       p
W3 FZ  p\        P                  V9   g   K  V\        P                  ,          p\        V\        4      '       g   KI  V
P!                  V4       K\  	  W \#        \        P                  4      &   \$        P&                  \$        P(                  \$        P*                  \$        P,                  \$        P.                  \$        P0                  \$        P2                  3 F?  pV P5                  W‰V4      w  rïV'       g   K!  Wæ\#        V4      &   VP7                  V4       KA  	  \        \9        \;        VP                  \$        P<                  \        4       4      P                  4       4      P?                  \;        V	P                  \$        P<                  \        4       4      P                  4       4      4      4      4      V\#        \$        P<                  4      &   \        4       pV PA                  4       pVe"   VPC                  4        VPE                  V4       VPA                  4       pVEe   \G        V\H        4      pVPJ                  PM                  ^ \O        \P        VPR                  VPT                  VPV                  VPX                  .4      R34       VPJ                  PM                  ^. R34       VPJ                  PM                  ^. R34       Ve	   V! V4      p\Z        P]                  VWpP                  4      pVPC                  4        V'       d   VPE                  V4       MVPM                  ^ V4       V'       d   V P_                  W4       V Pa                  \c        VV P                  4      4       W`\#        \        P                  4      &   R#   \        \        3 d     ELNi ; i)rÇ  Nó   reó   Wó   n)2rE   rÐ   r*   rÒ   rF   Ú_merge_page_writerrÔ  rÕ  r'   r   rD   rS  r^  rG   r%   ÚANNOTSrq  r+   rn  ÚEXT_G_STATEÚCOLOR_SPACEÚPATTERNÚSHADINGro  ÚFONTÚ
PROPERTIESrà  r=  r×  ÚsetÚPROC_SETÚunionr”  Úisolate_graphics_staterl  rk  ÚMERGE_CROP_BOXr•  rí  Úmapr)   r°  r±  rX  rY  r7  rè  Ú_expand_mediaboxr  r&   )r6   r  r  rf   r  r  Únew_resourcesrä  Úoriginal_resourcesÚpage2_resourcesÚ
new_annotsra  Úannotsr‰  ÚnewÚnew_resource_nameÚnew_content_arrayÚoriginal_contentÚpage2_contentÚrects   &&&&&&              r<   r  ÚPageObject._merge_pageA  s•  € ð	Ü˜d×5Ñ5´~×FÒFÐFÐFÜ�t×.Ñ.×2Ñ2°M×BÒBØ×.Ñ.Ø°¸Fóð ð Cô )Ó*ˆØ!#ˆÜ!Ô"2°D·H±H¼R¿\¹\ÔK[ÓK]Ó4^×4iÑ4iÓ4kÓlÐÜÔ/°·±¼2¿<¹<ÔIYÓI[Ó1\×1gÑ1gÓ1iÓjˆÜ “]ˆ
à“MˆDÜ�y‰y˜DÖ ØœbŸi™i��Ü˜f¤k×2Ô2Ø×%Ñ% fÖ-ñ	 "ð
 '1ŒZœŸ	™	Ó"Ñ#ô �O‰OÜ�O‰OÜ�K‰KÜ�K‰KÜ�K‰KÜ�H‰HÜ�N‰Nó
ˆCð &*×%:Ñ%:Ø"°Só&Ñ"ˆC÷ ‰sØ14œj¨›oÑ.Ø—‘Ð/Ö0ñ
ô" 3>ÜÜØ&×*Ñ*¬3¯<©<¼»ÓG×RÑRÓTóç‘%Ü˜×+Ñ+¬C¯L©L¼+»-ÓH×SÑSÓUÓVóóó3
ˆ”j¤§¡Ó.Ñ/ô (›MÐØ×,Ñ,Ó.ÐØÒ'Ø×3Ñ3Ô5Ø×$Ñ$Ð%5Ô6à×*Ñ*Ó,ˆØÓ$Ü˜5¤.Ó1ˆDØ×$Ñ$×+Ñ+ØäÜ#à ŸI™IØ ŸK™KØ ŸJ™JØ ŸK™Kð	óð ðôð ×$Ñ$×+Ñ+¨A°°D¨zÔ:Ø×$Ñ$×+Ñ+¨A°°D¨zÔ:Ø#Ò/Ù 4°]Ó C�Ü&×=Ñ=Ø˜v§x¡xóˆMð ×0Ñ0Ô2ßØ!×(Ñ(¨Õ7à!×(Ñ(¨¨MÔ:÷ Ø×!Ñ! %Ô-à×ÑœmÐ,=¸t¿x¹xÓHÔIØ)6ŒZœŸ™Ó%Ñ&áøôo ¤Ð/ô 	Úð	ús   ‚AR ÒR-Ò,R-c                ór   <€ V ^8„  d   QhRRRS[ S[S[.S[3,          ,          RS[ S[,          RS[RS[RR/# )	r5   r  r7  Úpage2transformationrf   r  r  r9   Nr  )r;   rg   s   "€r<   r=   r9  «  sf   ø€ ÷ H1ñ H1àðH1ñ &¡h±¨u±mÐ/CÕ&DÕEðH1ñ Ñ4Õ5ð	H1ñ
 ðH1ñ ðH1ð 
ñH1r>   c                óh  € \        V P                  \        4      '       g   Q hV P                  P                  p\        P
                  V 9  d%   \        4       V \        \        P
                  4      &   \        \        V \        P
                  ,          P                  4       4      p\        P
                  V9  d   \        4       pM3\        \        V\        P
                  ,          P                  4       4      p/ p	\        P                  \        P                  \        P                  \        P                  \        P                  \        P                   \        P"                  3 FM  p
W¨9   g   K  W§9  d   \        4       V\        V
4      &   V P%                  WxV
R 4      w  r¼V	P'                  V4       KO  	  \        P(                  V9   d´   \        P(                  V9  d%   \+        4       V\        \        P(                  4      &   \        \*        V\        P(                  ,          4      p\        \*        V\        P(                  ,          4       F  pWí9  g   K  VP-                  V4       K  	  VP/                  4        \1        VP3                  \        P4                  R4      4      '       EgÖ   \        P4                  V 9  d%   \+        4       V \        \        P4                  4      &   \        \*        V \        P4                  ,          P                  4       4      pVf   \7        4       pM\7        V4      p\        \*        \9        V\        P4                  ,          4      4       EF  pVP                  4       pVP;                  VRRR7      p\        \*        VR,          4      pVP=                  V^ ,          V^,          3R4      pVP=                  V^,          V^,          3R4      p\+        \?        V^ ,          V^ ,          4      \?        V^,          V^,          4      \A        V^ ,          V^ ,          4      \A        V^,          V^,          4      34      V\        R4      &   RV9   dÄ   \        \*        VR,          4      p\+        VP=                  V^ ,          V^,          3R4      VP=                  V^,          V^,          3R4      ,           VP=                  V^,          V^,          3R4      ,           VP=                  V^,          V^,          3R4      ,           4      V\        R4      &    VP                  VR,          \        R4      &    V P                  V\        R4      &   VP-                  VP                  4       EK  	  \+        4       pV PG                  4       pVe"   VPI                  4        VP-                  V4       VPG                  4       pVEe   \K        V\L        4      pVPN                  PQ                  ^ \S        \T        VPV                  VPX                  VPZ                  VP\                  .4      R	34       VPN                  PQ                  ^. R
34       VPN                  PQ                  ^. R34       Ve	   V! V4      p\^        Pa                  VW�P                  4      pVPI                  4        V'       d   VP-                  V4       MVPQ                  ^ V4       V'       d   V Pc                  W4       V Pe                  V4       R#   \B         d     ELÓi ; i  \D         d     EKÎ  i ; i)FNú/Pú/ParentT)Úignore_fieldsÚforce_duplicatez/Rectz/QuadPointsz/Popupr  r  r  )r7  z/StructParentr8  )3rE   rÐ   r*   rF   rS  r^  r'   r+   r   rG   rn  r  r  r  r  ro  r  r   rà  r=  r"  r%   rl  Úsortr1   rD   r  rd   r   rÖ  r©   r´  r¶  r|  rÕ  r”  r$  rk  r%  r•  rí  r&  r)   r°  r±  rX  rY  r7  rè  r'  r  )r6   r  r5  rf   r  r  rF   r)  Úpage2resourcesrä  r‰  Ú_Ú	newrenameÚarrr  r,  r¸  ÚaÚaar¦  r±   r¹  Úqr/  r0  Úpage2contentr2  s   &&&&&&                     r<   r  ÚPageObject._merge_page_writer«  s  € ô ˜$×1Ñ1´>×BÒBÐBÐBØ×%Ñ%×)Ñ)ˆä�<‰<˜tÔ#Ü-=Ó-?ˆD”œBŸL™LÓ)Ñ*Ü!Ô"2°D¼¿¹Õ4F×4QÑ4QÓ4SÓTÐÜ�<‰<˜uÔ$Ü-Ó/‰Nä!Ô"2°E¼"¿,¹,Õ4G×4RÑ4RÓ4TÓUˆNàˆä�O‰OÜ�O‰OÜ�K‰KÜ�K‰KÜ�K‰KÜ�H‰HÜ�N‰Nó
ˆCð Ö$ØÔ0Ü:JÓ:LÐ&¤z°#£Ñ7Ø#×4Ñ4Ø&¸¸Uó ‘�ð —‘˜iÖ(ñ
ô" �<‰<˜>Ô)Ü�|‰|Ð#5Ô5Ü?J»}Ð"¤:¬c¯l©lÓ#;Ñ<Ü”{Ð$6´s·|±|Õ$DÓEˆCÜœ+ ~´c·l±lÕ'CÖD�Ø–<Ø—J‘J˜q–Mñ Eð �H‰HŒJä˜uŸy™y¬¯©°DÓ9×:Ó:Ü�y‰y Ô$Ü.9«m�”Z¤§	¡	Ó*Ñ+Üœ+ t¬B¯I©I¥×'AÑ'AÓ'CÓDˆFØŠ{Ü%Ó'‘ä% cÓ*�ô œ+¤x°´b·i±iÕ0@Ó'A×B�Ø—L‘L“N�Ø—W‘WØØ"DØ$(ð ó �ô
 œ a¨¥jÓ1�Ø—m‘m Q q¥T¨1¨Q­4 L°$Ó7�Ø—m‘m Q q¥T¨1¨Q­4 L°$Ó7�Ü*5ä˜C �F C¨¥FÓ+Ü˜C �F C¨¥FÓ+Ü˜C �F C¨¥FÓ+Ü˜C �F C¨¥FÓ+ð	ó+�”:˜gÓ&Ñ'ð ! AÔ%Üœ[¨!¨MÕ*:Ó;�AÜ4?ØŸ™ q¨¥t¨Q¨q­T l°DÓ9ØŸ-™-¨¨1­¨q°­t¨°dÓ;õ<àŸ-™-¨¨1­¨q°­t¨°dÓ;õ<ð Ÿ-™-¨¨1­¨q°­t¨°dÓ;õ<ó5�B”z -Ó0Ñ1ðØ:<×:OÑ:O�B�x•L¤¨IÓ!6Ñ7ðØ+/×+BÑ+B�B”z $Ó'Ñ(Ø—M‘M "×"7Ñ"7×8ñA CôH (›MÐØ×,Ñ,Ó.ÐØÒ'Ø×3Ñ3Ô5Ø×$Ñ$Ð%5Ô6à×)Ñ)Ó+ˆØÓ#Ü˜5¤.Ó1ˆDØ×#Ñ#×*Ñ*ØäÜ#à ŸI™IØ ŸK™KØ ŸJ™JØ ŸK™Kð	óð ðôð ×#Ñ#×*Ñ*¨1¨r°4¨jÔ9Ø×#Ñ#×*Ñ*¨1¨r°4¨jÔ9Ø"Ò.Ù2°<Ó@�Ü%×<Ñ<Ø˜f§h¡hóˆLð ×/Ñ/Ô1ßØ!×(Ñ(¨Õ6à!×(Ñ(¨¨LÔ9÷ Ø×!Ñ! %Ô-à×ÑÐ/Ö0øôc  ô Úðûô
 &ô Ûðús$   Ô+\Õ3\!Ü\Ü\Ü!\1Ü0\1c                ó8   <€ V ^8„  d   QhRRRS[ S[,          RR/# )r5   r  r7  rf   r9   N)r   r   )r;   rg   s   "€r<   r=   r9  5  s+   ø€ ÷ )/ñ )/Ø!ð)/Ù(0Ñ1OÕ(Pð)/à	ñ)/r>   c           	     óp  aa€ V P                   P                  P                  4       V P                   P                  P                  4       V P                   P                  P                  4       V P                   P
                  P                  4       3pVP                   P                  P                  4       VP                   P                  P                  4       VP                   P                  P                  4       VP                   P
                  P                  4       VP                   P                  P                  4       VP                   P
                  P                  4       VP                   P                  P                  4       VP                   P                  P                  4       3oSeÂ   \        ;QJ d    . R S 4       F  NK  	  5M! R S 4       4      o\        ;QJ d#    . VV3R l\        ^ ^^4       4       F  NK  	  5M! VV3R l\        ^ ^^4       4       4      p\        ;QJ d#    . VV3R l\        ^ ^^4       4       F  NK  	  5M! VV3R l\        ^ ^^4       4       4      pMSR,          pSR,          p\        V4      \        V4      3p\        V4      \        V4      3p\        V^ ,          V^ ,          4      \        V^,          V^,          4      3p\        V^,          V^ ,          4      \        V^,          V^,          4      3pW`P                   n
        WpP                   n        R # )Nc              3   ó8   "  € T F  p\        V4      x € K  	  R # 5irR   r…   rõ  s   & r<   rG  Ú.PageObject._expand_mediabox.<locals>.<genexpr>I  ó   é € Ð.©# Qœ˜aŸ˜«#ùó   ‚c              3   ó´   <"  € T FM  pS^ ,          SV,          ,          S^,          SV^,           ,          ,          ,           S^,          ,           x € KO  	  R# 5i)r   NrV   ©rD  r$  Úcorners2rf   s   & €€r<   rG  rH  J  óG   øé € ð á'�Að �A•˜ !�Õ$ s¨1¥v°¸¸Q½µÕ'?Õ?À#ÀaÅ&×HÒHÛ'ùó   ƒAAc              3   ó´   <"  € T FM  pS^,          SV,          ,          S^,          SV^,           ,          ,          ,           S^,          ,           x € KO  	  R# 5i)rŽ   NrV   rL  s   & €€r<   rG  rH  N  rN  rO  :r   é   r5   :rŽ   rQ  r5   )r_  r°  Ú
as_numericr±  ÚrightÚtoprJ   r  r´  r¶  r²  r³  )	r6   r  rf   Úcorners1Únew_xÚnew_yÚ	lowerleftÚ
upperrightrM  s	   &&f     @r<   r'  ÚPageObject._expand_mediabox5  sZ  ù€ ð �M‰M×Ñ×)Ñ)Ó+Ø�M‰M× Ñ ×+Ñ+Ó-Ø�M‰M×Ñ×*Ñ*Ó,Ø�M‰M×Ñ×(Ñ(Ó*ð	
ˆð �N‰N×Ñ×*Ñ*Ó,Ø�N‰N×!Ñ!×,Ñ,Ó.Ø�N‰N×Ñ×*Ñ*Ó,Ø�N‰N×Ñ×)Ñ)Ó+Ø�N‰N× Ñ ×+Ñ+Ó-Ø�N‰N×Ñ×)Ñ)Ó+Ø�N‰N× Ñ ×+Ñ+Ó-Ø�N‰N×!Ñ!×,Ñ,Ó.ð	
ˆð Š?ß”%Ñ.©#Ó.—%‘%Ñ.©#Ó.Ó.ˆCß”Eõ ä˜q ! Qœó—E‘Eõ ä˜q ! Qœóó ˆE÷ ”Eõ ä˜q ! Qœó—E‘Eõ ä˜q ! Qœóó ‰Eð
 ˜U•OˆEØ˜U•OˆEÜ˜“Z¤ U£Ð,ˆ	Ü˜%“j¤# e£*Ð-ˆ
Ü˜ !� i°¥lÓ3´S¸À!½ÀiÐPQÅlÓ5SÐTˆ	ä�˜•˜Z¨�]Ó+Ü�˜•˜Z¨�]Ó+ð
ˆ
ð
 $-�‰Ô Ø$.�‰Ö!r>   c          
      óJ   <€ V ^8„  d   QhRRRS[ S[S[3,          RS[RS[RR/# )r5   r  r7  rf   r  r  r9   N)r   r   rd   r¦   )r;   rg   s   "€r<   r=   r9  `  sH   ø€ ÷ 
ñ 
àð
ñ Ñ1±>ÐAÕBð
ñ ð	
ñ
 ð
ð 
ñ
r>   c                ó‚   aa€ \        S\        4      '       d   SP                  oV P                  SVV3R lSVV4       R# )aª  
Similar to :meth:`~pypdf._page.PageObject.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.

c                 óF   <€ \         P                  V SP                  S4      # rR   )r7  rï  rF   )r1  rf   r  s   &€€r<   r^   Ú3PageObject.merge_transformed_page.<locals>.<lambda>x  s   ø€ ¤*×"GÑ"GØ˜uŸy™y¨#ô#r>   N)rE   rd   rf   r  )r6   r  rf   r  r  s   &ff&&r<   Úmerge_transformed_pageÚ!PageObject.merge_transformed_page`  s<   ù€ ô( �cœ>×*Ò*Ø—'‘'ˆCØ×ÑØõð ØØö	
r>   c          
      ó4   <€ V ^8„  d   QhRRRS[ RS[RS[RR/# )r5   r  r7  r‘   r  r  r9   N©rP   r¦   )r;   rg   s   "€r<   r=   r9  €  s5   ø€ ÷ =ñ =Ø!ð=Ù*/ð=Ù7;ð=ÙLPð=à	ñ=r>   c                ó\   € \        4       P                  W"4      pV P                  WW44       R# )a}  
Similar to :meth:`~pypdf._page.PageObject.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)rd   r‘   r_  )r6   r  r‘   r  r  r�   s   &&&&& r<   Úmerge_scaled_pageÚPageObject.merge_scaled_page€  s'   € ô Ó×#Ñ# EÓ1ˆØ×#Ñ# E¨tÖ<r>   c          
      ó4   <€ V ^8„  d   QhRRRS[ RS[RS[RR/# )r5   r  r7  r”   r  r  r9   Nrb  )r;   rg   s   "€r<   r=   r9  ’  s=   ø€ ÷ =ñ =àð=ñ ð=ñ ð	=ñ
 ð=ð 
ñ=r>   c                ó\   € \        4       P                  V4      pV P                  WW44       R# )a”  
Similar to :meth:`~pypdf._page.PageObject.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)rd   rš   r_  )r6   r  r”   r  r  r�   s   &&&&& r<   Úmerge_rotated_pageÚPageObject.merge_rotated_page’  s'   € ô& Ó×$Ñ$ XÓ.ˆØ×#Ñ# E¨tÖ<r>   c                ó:   <€ V ^8„  d   QhRRRS[ RS[ RS[RS[RR/# )	r5   r  r7  rƒ   r„   r  r  r9   Nrb  )r;   rg   s   "€r<   r=   r9  ¨  sG   ø€ ÷ =ñ =àð=ñ ð=ñ ð	=ñ
 ð=ñ ð=ð 
ñ=r>   c                ó\   € \        4       P                  W#4      pV P                  WWE4       R# )a¥  
Similar to :meth:`~pypdf._page.PageObject.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)rd   r‡   r_  )r6   r  rƒ   r„   r  r  r�   s   &&&&&& r<   Úmerge_translated_pageÚ PageObject.merge_translated_page¨  s'   € ô* Ó×'Ñ'¨Ó/ˆØ×#Ñ# E¨tÖ<r>   c                ó@   <€ V ^8„  d   QhRS[ S[S[3,          RS[RR/# )r5   rf   r  r9   N)r   rd   r   r¦   )r;   rg   s   "€r<   r=   r9  À  s9   ø€ ÷ 0Añ 0Aá‘>Ñ#AÐAÕBð0Añ ð0Að 
ñ	0Ar>   c           	     ó¾  € \        V\        4      '       d   VP                  pV P                  4       pVeB   \        P                  W0P                  V4      pVP                  4        V P                  V4       V'       EdS   V P                  P                  P                  4       V P                  P                  P                  4       V P                  P                  P                  4       V P                  P                  P                  4       V P                  P                  P                  4       V P                  P                  P                  4       V P                  P                  P                  4       V P                  P                  P                  4       .p\        ;QJ d    . R V 4       F  NK  	  5M! R V 4       4      p\!        ^ ^^4       Uu. uFI  pV^ ,          WE,          ,          V^,          WE^,           ,          ,          ,           V^,          ,           NKK  	  pp\!        ^ ^^4       Uu. uFI  pV^,          WE,          ,          V^,          WE^,           ,          ,          ,           V^,          ,           NKK  	  pp\#        V4      \#        V4      3V P                  n        \'        V4      \'        V4      3V P                  n        R# R# u upi u upi )a"  
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<pypdf.Transformation>`
        object can be passed.

See :doc:`/user/cropping-and-transforming`.

Nc              3   ó8   "  € T F  p\        V4      x € K  	  R # 5irR   r…   rõ  s   & r<   rG  Ú0PageObject.add_transformation.<locals>.<genexpr>å  rI  rJ  )rE   rd   rf   r”  r7  rï  rF   r$  r  r_  r°  rR  r±  rT  rS  rJ   r  r´  r²  r¶  r³  )r6   rf   r  r—  Úcornersr$  rV  rW  s   &&&     r<   rµ  ÚPageObject.add_transformationÀ  s'  € ô" �cœ>×*Ò*Ø—'‘'ˆCØ×#Ñ#Ó%ˆØÒÜ ×;Ñ;¸GÇXÁXÈsÓSˆGØ×*Ñ*Ô,Ø×!Ñ! 'Ô*çˆ6à—‘×"Ñ"×-Ñ-Ó/Ø—‘×$Ñ$×/Ñ/Ó1Ø—‘×"Ñ"×-Ñ-Ó/Ø—‘×!Ñ!×,Ñ,Ó.Ø—‘×#Ñ#×.Ñ.Ó0Ø—‘×!Ñ!×,Ñ,Ó.Ø—‘×#Ñ#×.Ñ.Ó0Ø—‘×$Ñ$×/Ñ/Ó1ð	ˆG÷ ”%Ñ.©#Ó.—%‘%Ñ.©#Ó.Ó.ˆCô ˜q ! Qœóá'�Að �A•˜�Õ# c¨!¥f¨w¸1µu­~Õ&=Õ=ÀÀAÅ×FÐFÙ'ð ð ô ˜q ! Qœóá'�Að �A•˜�Õ# c¨!¥f¨w¸1µu­~Õ&=Õ=ÀÀAÅ×FÐFÙ'ð ð ô
 ),¨E«
´C¸³JÐ'?ˆD�M‰MÔ$Ü),¨U«´S¸³ZÐ(@ˆD�M‰MÖ%ñ/ ùòùòs   ÇAKÈ6AKc                ó*   <€ V ^8„  d   QhRS[ RS[ RR/# )r5   rŠ   r‹   r9   Nr…   )r;   rg   s   "€r<   r=   r9  ò  s'   ø€ ÷ 4Kñ 4K™ð 4K¡5ð 4K¨Tñ 4Kr>   c           	     ór  € V P                  V^ ^ V^ ^ 34       V P                  P                  W4      V n        V P                  P                  W4      V n        V P                  P                  W4      V n        V P
                  P                  W4      V n        V P                  P                  W4      V n        \        P                  V 9   Ed!   V \        P                  ,          p\        V\        4      '       dô   V Fí  pVP                  4       p\        P                  V9   g   K*  V\        P                  ,          p\        V\        4      '       g   KY  \        \        V^ ,          4      V,          4      V^ &   \        \        V^,          4      V,          4      V^&   \        \        V^,          4      V,          4      V^&   \        \        V^,          4      V,          4      V^&   Kï  	  \        P                   V 9   Ed4   V \        P                   ,          p\        V\        4      '       d   V^ ,          R,          pM	VR,          p\#        \        V^ ,          4      V,          \        V^,          4      V,          \        V^,          4      V,          \        V^,          4      V,          34      p	\        V\        4      '       d?   V	V \%        \        P                   4      ,          \'        ^ 4      ,          \%        R4      &   R# W�\%        \        P                   4      ,          \%        R4      &   R# R# )a8  
Scale a page by the given factors by applying a transformation matrix
to its content and updating the page size.

This updates the various page boundaries (bleedbox, trimbox, etc.)
and the contents of the page.

Args:
    sx: The scaling factor on horizontal axis.
    sy: The scaling factor on vertical axis.

z/BBoxN)rµ  Úbleedboxr‘   ÚtrimboxÚartboxr3   r_  rS  r  rE   r%   rG   r   ÚRectr)   rP   ÚVPr/   r+   r-   )
r6   rŠ   r‹   ÚannotationsÚ
annotationÚannotation_objÚ	rectangleÚviewportÚbboxÚscaled_bboxs
   &&&       r<   r‘   ÚPageObject.scaleò  sV  € ð 	×Ñ  Q¨¨2¨q°!Ð 4Ô5ØŸ™×+Ñ+¨BÓ3ˆŒØ—|‘|×)Ñ)¨"Ó1ˆŒØ—k‘k×'Ñ'¨Ó/ˆŒØ—|‘|×)Ñ)¨"Ó1ˆŒØŸ™×+Ñ+¨BÓ3ˆŒä�9‰9˜ÕØœrŸy™y�/ˆKÜ˜+¤{×3Ò3Û"-�JØ%/×%:Ñ%:Ó%<�NÜ5×:Ñ:¸nÖLØ$2Ô3Q×3VÑ3VÕ$W˜	Ü% i´×=Ô=Ü+6´u¸YÀq½\Ó7JÈRÕ7OÓ+P˜I a™LÜ+6´u¸YÀq½\Ó7JÈRÕ7OÓ+P˜I a™LÜ+6´u¸YÀq½\Ó7JÈRÕ7OÓ+P˜I a™LÜ+6´u¸YÀq½\Ó7JÈRÕ7OÓ+P˜I a›Lñ #.ô �5‰5�D�=ØœBŸE™E•{ˆHÜ˜(¤K×0Ò0Ø •{ 7Õ+‘à Õ(�Ü)ä˜$˜q�'“N RÕ'Ü˜$˜q�'“N RÕ'Ü˜$˜q�'“N RÕ'Ü˜$˜q�'“N RÕ'ð	óˆKô ˜(¤K×0Ò0ð  ð ”Z¤§¡Ó&Õ'¬°Q«Õ8Ü˜wÓ'óð @K”Z¤§¡Ó&Õ'¬
°7Ó(;Ó<ñ' r>   c                ó$   <€ V ^8„  d   QhRS[ RR/# )r5   Úfactorr9   Nr…   )r;   rg   s   "€r<   r=   r9  (  s   ø€ ÷ 	#ñ 	#™uð 	#¨ñ 	#r>   c                ó(   € V P                  W4       R# )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‘   )r6   r„  s   &&r<   Úscale_byÚPageObject.scale_by(  s   € ð 	�
‰
�6Ö"r>   c                ó*   <€ V ^8„  d   QhRS[ RS[ RR/# )r5   rX  rY  r9   Nr…   )r;   rg   s   "€r<   r=   r9  3  s"   ø€ ÷ ñ ™eð ©Uð °tñ r>   c                óÀ   € V\        V P                  P                  4      ,          pV\        V P                  P                  4      ,          pV P	                  W44       R# )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)rP   r_  rX  rY  r‘   )r6   rX  rY  rŠ   r‹   s   &&&  r<   Úscale_toÚPageObject.scale_to3  sB   € ð ”U˜4Ÿ=™=×.Ñ.Ó/Õ/ˆØ”e˜DŸM™M×0Ñ0Ó1Õ1ˆØ�
‰
�2Ör>   c                ó$   <€ V ^8„  d   QhRS[ RR/# )r5   Úlevelr9   Nrû   )r;   rg   s   "€r<   r=   r9  A  s   ø€ ÷ Iñ I©cð I¸4ñ Ir>   c                ó–  € V P                  4       pVeS   VP                  V4      p VVP                  P                  P                  VP                  P
                  ^,
          &   R# R#   \         dU    T P                  e;   \        T P                  P                  R4      '       d   T P                  T4        R# \        R4      hi ; i)zØ
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".
NrÇ  z Page must be part of a PdfWriter)
r”  Úflate_encoderÐ   rF   rÖ   r×   rÕ  rÒ   r  r�   )r6   r�  r—  Úcontent_objs   &&  r<   Úcompress_content_streamsÚ#PageObject.compress_content_streamsA  sÀ   € ð ×#Ñ#Ó%ˆØÒØ!×.Ñ.¨uÓ5ˆKð
Ið  ð ×*Ñ*×.Ñ.×7Ñ7Ø×.Ñ.×4Ñ4°qÕ8óñ øô "ô IØ×*Ñ*Ò6¼7Ø×+Ñ+×/Ñ/°÷<ò <ð ×)Ñ)¨+×6ä$Ð%GÓHÐHðIús   §>A) Á)ACÂ<Cc                ó0   <€ V ^8„  d   QhRS[ S[,          /# rn   )r   rü   )r;   rg   s   "€r<   r=   r9  Y  s   ø€ ÷ ñ ™X¡c�]ñ r>   c                ó¼   € V P                   f   R#  V P                   P                  P                  p\        VP	                  V 4      4      #   \
         d     R# i ; i)zŽ
Read-only property which returns the page number within the PDF file.

Returns:
    Page number; None if the page is not attached to a PDF.

N)rÐ   rF   rÔ   rü   r  r�   )r6   r  s   & r<   Úpage_numberÚPageObject.page_numberX  sT   € ð ×"Ñ"Ò*Ùð	Ø×)Ñ)×-Ñ-×3Ñ3ˆCÜ�s—y‘y “Ó'Ð'øÜô 	Úð	ús   ’9A ÁAÁAc                ó    <€ V ^8„  d   QhRS[ /# rn   rx   )r;   rg   s   "€r<   r=   r9  i  s   ø€ ÷ $ñ $¡Cñ $r>   c                ób  € R p\        V R,          P                  4       V P                  R4      P                   F�  w  r#VR8X  d2   V^ ,           Uu. uF  p\	        V\
        4      '       g   K  VNK  	  ppM. pWP                  R4      R,           R P                  V4      ,           VP                  4       ,           R,           ,          pK‘  	  VR,          p V \        P                  ,          R,           Fó  pWR,           ,          pW\        P                  ,          R,          V,          P                  4       R,           ,          p V \        P                  ,          R,          V,          R	,          P                  4       pWR,           ,          p VV \        P                  ,          R,          V,          R
,          P                  4       P                  4       R,           ,          pKõ  	  V# u upi   \         d     Loi ; i  \         d     EK  i ; i  \         d    TR,          p T# i ; i)r¾   ú	/Contentsrî   ó   TJúutf-8rz   Ú
z
=============================
ú/Fontz	/Encodingz
/ToUnicodezNo Font
)r&   rG   rF   r•  rE   r:   Údecoder2  rŸ   rS  r^  Ú	Exceptionrô  r|  )r6   Úoutrš  r�   r  ÚsÚfoÚenc_reprs   &       r<   Ú_debug_for_extractÚPageObject._debug_for_extracti  s×  € ØˆÜ$Ø�Õ×(Ñ(Ó*¨D¯H©H°gó
ç
‰*ò‰GˆCð �UŒ{Ø # A¦Ó=¡˜1¬*°Q¼×*<—Q�Q¡�Ð=�à�Ø—9‘9˜WÓ%¨Õ+¨b¯g©g°a«jÕ8¸3¿<¹<»>ÕIÈDÕPÕPŠCñð 	Ð2Õ2ˆð	Øœ2Ÿ<™<Õ(¨×1Ð1�Ø˜D•yÕ �ØœBŸL™LÕ)¨'Õ2°2Õ6×?Ñ?ÓAÀDÕHÕH�ðØ#¤B§L¡LÕ1°'Õ:¸2Õ>Ø#õ ç‘h“jð ð  d�?Õ*�Cð
ØØœRŸ\™\Õ*¨7Õ3°BÕ7Ø(õ÷ "™›ß™›Øõõ’Cñ 2ð0 ˆ
ùò= >øô !ô Ùðûô !ô Ûðûô ô 	Ø�;Õ‰CØˆ
ð	úsc   ÁG-Á-G-ÃA0H ÅA	G2ÆAHÇ'H Ç2H Ç=H Ç?H È H ÈHÈH ÈHÈH ÈH.È-H.ç      i@c                ó  <€ V ^8„  d   QhRS[ RS[ RS[S[R3,          RS[RS[S[,          RS[S[S[ S[ S[ S[ .R3,          ,          R	S[S[S[ S[ S[ S[ .R3,          ,          R
S[S[S[ S[ S[ S[ S[ .R3,          ,          RS[/	# )r5   rf  rF   Úorientations.Úspace_widthÚcontent_keyÚvisitor_operand_beforeNÚvisitor_operand_afterÚvisitor_textr9   )r   rJ   rü   rP   r   r:   r   )r;   rg   s   "€r<   r=   r9  �  sÆ   ø€ ÷ c ñ c áðc ñ ðc ñ ™C ˜H•oð	c ñ
 ðc ñ ™c•]ðc ñ !)©±3¹¹SÁ#Ð2FÈÐ2LÕ)MÕ Nðc ñ  (©±#±s¹CÁÐ1EÀtÐ1KÕ(LÕMðc ñ ™x©©c±3¹¹SÐ(AÀ4Ð(GÕHÕIðc ñ 
ñc r>   c	           	     ót  € \        4       p	/ p
/ p Tp\        \        P                  4      V9  d   VR,          P	                  4       pK7  \        \        V\        P                  ,          4      p\        T4      '       g§   RT9   d    \        \        TR,          4      ;p'       d�   T Fz  p \        \        Yï,          P	                  4       4      pTY¯&   \        P                  ! T4      Y¿&   Y¿,          P                  P                  R^ 4      ^ 8X  d   YKT,          n        Kz  K|  	   \!        T\"        4      '       d   Y,          P	                  4       MTp\!        T\$        4      '       g   \%        TTR4      pT	P)                  Y8Y«4       TP*                   EFÌ  w  ppTe    T! TTT	P,                  T	P.                  4       TR8X  d'   T	P1                  R. 4       T	P1                  R	T4       EMOTR
8X  db   T	P1                  RT^ ,          .4       T	P1                  RT^,          .4       T	P1                  R. 4       T	P1                  R	TR,          4       EMçTR8X  dá   T	P2                  R,          pT'       dÄ   T^ ,           F¶  p\!        T\"        \4        34      '       d   T	P1                  R	T.4       \!        T\6        \8        \:        \<        34      '       g   KZ  \?        \9        T4      4      T8¼  g   Ku  T	P@                  '       g   K‰  T	P@                  R,          R8w  g   K£  T	P1                  R	R.4       K¸  	  EM TR8X  d0   T	P1                  RT^,          ) .4       T	P1                  RT4       EMÊTR8X  Ed±   T	;PB                  T	P@                  ,          un!        Te?   T! T	P@                  T	PD                  T	PF                  T	PH                  T	PJ                  4        T	PB                  R,          R8w  dR   T	;PB                  R,          un!        Te5   T! RT	PD                  T	PF                  T	PH                  T	PJ                  4        TR,          pTT^ ,          ,          R,          R8w  dv   T PO                  TT^ ,          ,          TTTTT4      pT	;PB                  T,          un!        Te5   T! TT	PD                  T	PF                  T	PH                  T	PJ                  4       RT	n         T	P,                  PU                  4       T	n"        T	P.                  PU                  4       T	n#        MT	P1                  TT4       Tf   EK­  T! TTT	P,                  T	P.                  4       EKÏ  	  T	;PB                  T	P@                  ,          un!        T	P@                  R8w  dC   Te?   T! T	P@                  T	PD                  T	PF                  T	PH                  T	PJ                  4       T	PB                  #   \         d     R# i ; i  \        \        3 d     EKh  i ; i  \        \&        3 d     R# i ; i  \L         d     ELñi ; i  \         d&   p\Q        R\R        T^ ,          TR7        Rp?EL…Rp?ii ; i  RT	n         T	P,                  PU                  4       T	n"        T	P.                  PU                  4       T	n#        i ; i)zÕ
See extract_text for most arguments.

Args:
    content_key: indicate the default key where to extract data
        None = the object; this allows reusing the function on an XObject
        default = "/Content"

r8  r¾   r�  rz   rî   Nó   's   T*s   Tjó   "s   Tws   Tc:r5   NNrš  gffffffî?s   TDs   TLs   Tds   Dorœ  ú/XObjectú/Subtyperj  z;Impossible to decode XFormObject %(operand)s: %(exception)s)r@   ÚoperandÚ	exceptionrê   )+r   r+   rS  r^  rG   r   r'   rŸ  r1   r   Úfrom_font_resourceÚcharacter_widthsrD   r©  rÕ  rÑ   rE   r:   r&   r|  Úinitialize_extractionr•  Ú	cm_matrixÚ	tm_matrixÚprocess_operationÚ_space_widthrî   rü   rP   r-   r)   ÚabsÚtextÚoutputÚmemo_cmÚmemo_tmÚfont_resourceÚ	font_sizer  Úextract_xform_textr   rI   Úcopy)r6   rf  rF   r¨  r©  rª  r«  r¬  r­  Ú	extractorÚfont_resourcesÚfontsÚobjrÚresources_dictÚfont_resources_dictrÁ  Úfont_resource_objectr—  ræ  ÚoperatorÚ_confirm_space_widthr�   Úxobjr½  r´  s   &&&&&&&&&                r<   Ú_extract_textÚPageObject._extract_text�  sÀ  € ô( #Ó$ˆ	Ø68ˆØ!#ˆð	ØˆDÜœRŸ\™\Ó*°$Ô6à˜I•×1Ñ1Ó3’ô "Ô"2°D¼¿¹Õ4FÓGˆNô   ×/Ò/Ø˜>Ô)Ü(,Ô-=¸~ÈgÕ?VÓ(WÐWÐ$ÖWã!4�ðÜ+/Ô0@ÐBUÕBd×BoÑBoÓBqÓ+rÐ(Ø4H�NÑ1Ü+/×+BÒ+BÐCWÓ+X�EÑ(àÕ+×<Ñ<×@Ñ@ÀÀaÓHÈAÔMØ;F˜mÕ,Ö8ñ Nñ "5ð	ä1;¸KÌ×1MÒ1M�Õ ×+Ñ+Ô-ÐSVð ô ˜g¤}×5Ò5Ü'¨°°gÓ>�ð 	×'Ñ'¨ÀNÔZà")×"4Õ"4ÑˆH�hØ%Ò1Ù& x°¸9×;NÑ;NÐPY×PcÑPcÔdà˜4ÔØ×+Ñ+¨E°2Ô6Ø×+Ñ+¨E°8Ö<Ø˜TÔ!Ø×+Ñ+¨E°H¸QµK°=ÔAØ×+Ñ+¨E°H¸QµK°=ÔAØ×+Ñ+¨E°2Ô6Ø×+Ñ+¨E°8¸Bµ<Ö@Ø˜UÔ"à'0×'=Ñ'=ÀÕ'DÐ$ßØ& qŸk˜k˜Ü% b¬3´¨,×7Ò7Ø%×7Ñ7¸À¸tÔDÜ% b¬3´´|Ä[Ð*Q×RÔRÜ¤ b£	›NÐ.BÖBØ )§§¢Ø )§¡¨rÕ 2°cÖ 9à%×7Ñ7¸À¸uÖEñ *ùð ˜UÔ"Ø×+Ñ+¨E°X¸aµ[°L°>ÔBØ×+Ñ+¨E°8Ö<Ø˜UÕ"Ø× Ò  I§N¡NÕ2Õ ØÒ+Ù Ø!Ÿ™Ø!×)Ñ)Ø!×)Ñ)Ø!×/Ñ/Ø!×+Ñ+ôðØ ×'Ñ'¨Õ+¨tÔ3Ø!×(Ò(¨DÕ0Õ(Ø'Ò3Ù(Ø $Ø )× 1Ñ 1Ø )× 1Ñ 1Ø )× 7Ñ 7Ø )× 3Ñ 3ôðCØ)¨*Õ5�DØ˜H Q�KÕ(¨Õ4¸Ô@Ø#×6Ñ6Ø  ¨!¥Õ-Ø(Ø'Ø2Ø1Ø(ó ˜ð "×(Ò(¨DÕ0Õ(Ø'Ò3Ù(Ø $Ø )× 1Ñ 1Ø )× 1Ñ 1Ø )× 7Ñ 7Ø )× 3Ñ 3ôð &(�I”NØ(1×(;Ñ(;×(@Ñ(@Ó(B�IÔ%Ø(1×(;Ñ(;×(@Ñ(@Ó(B�IÕ%à×+Ñ+¨H°hÔ?Ø$Õ0Ù% h°¸)×:MÑ:MÈy×ObÑOb×cñk #5ðl 	×Ò˜IŸN™NÕ*ÕØ�>‰>˜RÔ LÒ$<ÙØ—‘Ø×!Ñ!Ø×!Ñ!Ø×'Ñ'Ø×#Ñ#ôð ×ÑÐøôG ô 	ò ð	ûô$ '¬	Ð2ô Ûðûô ¤Ð)ô 	Úð	ûôt "ô Úðûô, !ô Ü"ØUÜ'Ø (¨¥Ø"+÷	ó ûðûð &(�I”NØ(1×(;Ñ(;×(@Ñ(@Ó(B�IÔ%Ø(1×(;Ñ(;×(@Ñ(@Ó(B�IÕ%úsw   �AW( Â+A4W:Ä&AX ÏA)X+Ñ	BX=×(W7×6W7×:XØXØX(Ø'X(Ø+X:Ø9X:Ø=Y-ÙY(Ù"Y0Ù(Y-Ù-Y0Ù0AZ7c                ó6   <€ V ^8„  d   QhRS[ S[S[3,          /# rn   )r�  r:   r   )r;   rg   s   "€r<   r=   r9  4  s   ø€ ÷ ñ ¡D©©d¨¥Oñ r>   c                ó^  € T p/ pVe~    V\         P                  ,          pRV9   dE   V P                  e7   VR,           F)  p\        P
                  ! VR,          V,          4      W$&   K+  	   VR,          P                  4       pK�  V#   \         d    / p Lvi ; i  \         d    Rp K¦  i ; i)zˆ
Get fonts formatted for "layout" mode text extraction.

Returns:
    Dict[str, Font]: dictionary of Font instances keyed by font name

Nr�  r8  )rS  r^  r|  rF   r   rµ  rG   )r6   rÈ  rÇ  rÉ  Ú	font_names   &    r<   Ú_layout_mode_fontsÚPageObject._layout_mode_fonts4  s³   € ð ˆØ!#ˆØÒð$Ø&*¬2¯<©<Õ&8�ð ˜.Ô(¨T¯X©XÒ-AØ!/°×!8Ð!8�IÜ'+×'>Ò'>¸~ÈgÕ?VÐW`Õ?aÓ'b�EÓ$ñ "9ðØ˜I•×1Ñ1Ó3’ð ˆøô ô $Ø!#’ð$ûô ô Ø“ðús#   ŠB Á-B ÂBÂBÂB,Â+B,c                óN   <€ V ^8„  d   QhRS[ RS[RS[ RS[S[,          RS[RS[/# )r5   Úspace_verticallyÚscale_weightÚstrip_rotatedÚ
debug_pathÚfont_height_weightr9   )r¦   rP   r   r   r:   )r;   rg   s   "€r<   r=   r9  N  sS   ø€ ÷ 9jñ 9jáð9jñ ð9jñ ð	9jñ
 ™T•Nð9jñ "ð9jñ 
ñ9jr>   c                óî  € V P                  4       pV'       d<   ^ RIpVP                  R4      P                  VP	                  V^\
        R7      R4       \        \        V R,          P                  4       V P                  R4      P                  4      p\        P                  ! W†W44      p	V	'       g   R# \        P                  ! W”4      p
\        P                  ! W’4      p\        P                  ! W«W4      # )a¡  
Get text preserving fidelity to source PDF text layout.

Args:
    space_vertically: include blank lines inferred from y distance + font
        height. Defaults to True.
    scale_weight: multiplier for string length when calculating weighted
        average character width. Defaults to 1.25.
    strip_rotated: Removes text that is rotated w.r.t. to the page from
        layout mode output. Defaults to True.
    debug_path (Path | None): if supplied, must target a directory.
        creates the following files with debug information for layout mode
        functions if supplied:
          - fonts.json: output of self._layout_mode_fonts
          - tjs.json: individual text render ops with corresponding transform matrices
          - bts.json: text render ops left justified and grouped by BT/ET operators
          - bt_groups.json: BT/ET operations grouped by rendered y-coord (aka lines)
        Defaults to None.
    font_height_weight: multiplier for font height when calculating
        blank lines. Defaults to 1.

Returns:
    str: multiline string containing page text in a fixed width format that
        closely adheres to the rendered layout in the source pdf.

Nz
fonts.json)ÚindentÚdefaultr›  r™  rî   r¾   )rÔ  ÚjsonÚjoinpathÚ
write_textÚdumpsr   Úiterr&   rG   rF   r•  r   Útext_show_operationsÚy_coordinate_groupsÚfixed_char_widthÚfixed_width_page)r6   r×  rØ  rÙ  rÚ  rÛ  rÇ  rß  ÚopsÚ	bt_groupsÚ	ty_groupsÚ
char_widths   &&&&&&      r<   Ú_layout_mode_textÚPageObject._layout_mode_textN  sÊ   € ðD ×'Ñ'Ó)ˆßÛà×Ñ Ó-×8Ñ8Ø—
‘
˜5¨´F�
Ó;Øôô
 Ü˜$˜{Õ+×6Ñ6Ó8¸$¿(¹(ÀGÓL×WÑWó
ˆô !×5Ò5Ø˜ó
ˆ	÷ Ùä ×4Ò4°YÓKˆ	ä!×2Ò2°9ÓKˆ
ä×,Ò,¨YÐDTÓiÐir>   r¨  r©  r«  r¬  r­  Úextraction_modeÚplainc                ó"  <€ V ^8„  d   QhRS[ RS[S[S[S[R3,          3,          RS[RS[S[S[ S[ S[ S[ .R3,          ,          RS[S[S[ S[ S[ S[ .R3,          ,          RS[S[S[ S[ S[ S[ S[ .R3,          ,          R	S[R,          R
S[ RS[/	# )r5   Úargsr¨  .r©  r«  Nr¬  r­  rî  rÁ   r9   ©rï  Úlayout)	r   r   rü   rJ   rP   r   r   r   r:   )r;   rg   s   "€r<   r=   r9  ‰  sÒ   ø€ ÷ G
ñ G
áðG
ñ ™C¡¡s¨C x¥Ð0Õ1ðG
ñ ð	G
ñ
 !)©±3¹¹SÁ#Ð2FÈÐ2LÕ)MÕ NðG
ñ  (©±#±s¹CÁÐ1EÀtÐ1KÕ(LÕMðG
ñ ™x©©c±3¹¹SÐ(AÀ4Ð(GÕHÕIðG
ñ !Ð!2Õ3ðG
ñ ðG
ñ 
ñG
r>   c          
     óÎ  € VR9  d   \        RV R24      hVR8X  dš   R F.  p	\        4       V	,          '       g   K  \        R\        V	R7       K0  	  V P	                  VP                  RR4      VP                  RR	4      VP                  R
R4      VP                  R4      VP                  R^4      R7      # \        V4      ^8¼  EdW   \        V^ ,          \        4      '       d¦   \        V4      ^8¼  dC   \        V^,          \        \        34      '       d   V^,          pM\        RV^,           24      h\        V4      ^8¼  dC   \        V^,          \        \        34      '       d   V^,          pMª\        RV^,           24      hM”\        V^ ,          \        \        34      '       d]   V^ ,          p\        V4      ^8¼  dC   \        V^,          \        \        34      '       d   V^,          pM+\        RV^,           24      hM\        RV^ ,           24      h\        V\        4      '       d   V3pV P                  V V P                  VV\        P                   VVV4      # )aB  
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 and Hebrew are extracted in the correct order.
If required a custom RTL range of characters can be defined;
see function set_custom_rtl.

Additionally you can provide visitor methods to get informed on all
operations and all text objects.
For example in some PDF files this can be useful to parse tables.

Args:
    orientations: list of orientations extract_text will look for
        default = (0, 90, 180, 270)
        note: currently only 0 (up),90 (turned left), 180 (upside down),
        270 (turned right)
        Silently ignored in "layout" mode.
    space_width: force default space width
        if not extracted from font (default: 200)
        Silently ignored in "layout" mode.
    visitor_operand_before: function to be called before processing an operation.
        It has four arguments: operator, operand-arguments,
        current transformation matrix and text matrix.
        Ignored with a warning in "layout" mode.
    visitor_operand_after: function to be called after processing an operation.
        It has four arguments: operator, operand-arguments,
        current transformation matrix and text matrix.
        Ignored with a warning in "layout" mode.
    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".
        Ignored with a warning in "layout" mode.
    extraction_mode (Literal["plain", "layout"]): "plain" for legacy functionality,
        "layout" for experimental layout mode functionality.
        NOTE: orientations, space_width, and visitor_* parameters are NOT respected
        in "layout" mode.

kwargs:
    layout_mode_space_vertically (bool): include blank lines inferred from
        y distance + font height. Defaults to True.
    layout_mode_scale_weight (float): multiplier for string length when calculating
        weighted average character width. Defaults to 1.25.
    layout_mode_strip_rotated (bool): layout mode does not support rotated text.
        Set to False to include rotated text anyway. If rotated text is discovered,
        layout will be degraded and a warning will result. Defaults to True.
    layout_mode_debug_path (Path | None): if supplied, must target a directory.
        creates the following files with debug information for layout mode
        functions if supplied:

          - fonts.json: output of self._layout_mode_fonts
          - tjs.json: individual text render ops with corresponding transform matrices
          - bts.json: text render ops left justified and grouped by BT/ET operators
          - bt_groups.json: BT/ET operations grouped by rendered y-coord (aka lines)
    layout_mode_font_height_weight (float): multiplier for font height when calculating
        blank lines. Defaults to 1.

Returns:
    The extracted text

ró  zInvalid text extraction mode 'Ú'z.Argument %(visitor)s is ignored in layout mode)r@   ÚvisitorÚlayout_mode_space_verticallyTÚlayout_mode_scale_weightç      ô?Úlayout_mode_strip_rotatedÚlayout_mode_debug_pathÚlayout_mode_font_height_weight)r×  rØ  rÙ  rÚ  rÛ  zInvalid positional parameter rò  )r«  r¬  r­  )r�   Úlocalsr   rI   rì  rD   rH   rE   r:   rJ   rü   rÑ   rP   rÏ  rF   rS  r÷  )
r6   r¨  r©  r«  r¬  r­  rî  rñ  rÁ   rö  s
   &$$$$$$*, r<   Úextract_textÚPageObject.extract_text‰  s$  € ð` Ð"5Ô5ÜÐ=¸oÐ=NÈaÐPÓQÐQØ˜hÔ&ó�ô
 “8˜G×$Ö$Ü"ØHÜ'Ø '÷ñð ×)Ñ)Ø!'§¡Ð,JÈDÓ!QØ#ŸZ™ZÐ(BÀDÓIØ$Ÿj™jÐ)DÀdÓKØ!Ÿ:™:Ð&>Ó?Ø#)§:¡:Ð.NÐPQÓ#Rð *ó ð ô ˆt‹9˜�>Ü˜$˜q�'¤3×'Ò'Ü�t“9 ”>Ü! $ q¥'¬E´3¨<×8Ò8Ø'+¨A¥w™ä'Ð*GÈÈQÍÀyÐ(QÓRÐRÜ�t“9 ”>Ü! $ q¥'¬E´3¨<×8Ò8Ø&*¨1¥g™ä'Ð*GÈÈQÍÀyÐ(QÓRÐRð	 "ô
 ˜D �G¤e¬S \×2Ò2Ø# A�w�Ü�t“9 ”>Ü! $ q¥'¬E´3¨<×8Ò8Ø&*¨1¥g™ä'Ð*GÈÈQÍÀyÐ(QÓRÐRð	 "ô  Ð"?ÀÀQÅ¸yÐ IÓJÐJä�l¤C×(Ò(Ø(˜?ˆLà×!Ñ!ØØ�H‰HØØÜ�K‰KØ"Ø!Øó	
ð 		
r>   c                óò   <€ V ^8„  d   QhRS[ RS[S[R3,          RS[RS[S[S[S[S[S[.R3,          ,          RS[S[S[S[S[S[.R3,          ,          RS[S[S[S[S[S[S[.R3,          ,          R	S[/# )
r5   Úxformr¨  .r©  r«  Nr¬  r­  r9   )r(   rJ   rü   rP   r   r   r   r:   )r;   rg   s   "€r<   r=   r9    s£   ø€ ÷ !
ñ !
á"ð!
ñ ™C ˜H•oð!
ñ ð	!
ñ
 !)©±3¹¹SÁ#Ð2FÈÐ2LÕ)MÕ Nð!
ñ  (©±#±s¹CÁÐ1EÀtÐ1KÕ(LÕMð!
ñ ™x©©c±3¹¹SÐ(AÀ4Ð(GÕHÕIð!
ñ 
ñ!
r>   c           
     óF   € V P                  VV P                  VVRVVV4      # )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)rÏ  rF   )r6   r  r¨  r©  r«  r¬  r­  s   &&&&&&&r<   rÃ  ÚPageObject.extract_xform_text  s3   € ð0 ×!Ñ!ØØ�H‰HØØØØ"Ø!Øó	
ð 		
r>   c                óV   <€ V ^8„  d   QhRS[ S[S[,          S[S[,          3,          /# rn   )rJ   r!  r:   )r;   rg   s   "€r<   r=   r9  5  s&   ø€ ÷ $ñ $™E¡#¡c¥(©C±­HÐ"4Õ5ñ $r>   c                ó¬   € V P                  4       p\        V\        4      '       g   Q h\        4       p\        4       p\	        WV4      w  r#W#,
          pW43# )z
Get the names of embedded fonts and unembedded fonts.

Returns:
    A tuple (set of embedded fonts, set of unembedded fonts)

)rG   rE   r'   r!  Ú_get_fonts_walk)r6   rf  rÇ  ÚembeddedÚ
unembeddeds   &    r<   Ú
_get_fontsÚPageObject._get_fonts5  sQ   € ð �o‰oÓˆÜ˜#Ô/×0Ò0Ð0Ð0Ü›%ˆÜ ›UˆÜ)¨#°hÓ?‰ˆØÕ%ˆ
ØÐ#Ð#r>   r¬  r­  r®  r¯  c                ó0   <€ V ^8„  d   QhRS[ S[,          /# rn   ©r   r%   )r;   rg   s   "€r<   r=   r9  f  s   ø€ ÷ 2ñ 2™X¡kÕ2ñ 2r>   c                óB   € R V 9  d   R# \        \        V R ,          4      # )ú/AnnotsN)r   r%   rp   s   &r<   r{  ÚPageObject.annotationse  s   € à˜DÔ ÙÜ”K  i¥Ó1Ð1r>   c                ó4   <€ V ^8„  d   QhRS[ S[,          RR/# )r5   rO   r9   Nr  )r;   rg   s   "€r<   r=   r9  l  s    ø€ ÷ 0ñ 0¡©+Õ!6ð 0¸4ñ 0r>   c                óV   € Vf   RV 9  d   R# V \        R4       R# W\        R4      &   R# )zÎ
Set the annotations array of the page.

Typically you do not want to set this value, but append to it.
If you append to it, remember to add the object first to the writer
and only add the indirect object.
Nr  rS   )r6   rO   s   &&r<   r{  r  k  s.   € ð Š=Ø Ô$ÙØ”Z 	Ó*Ò+à*/”˜IÓ&Ó'r>   c                ó$   <€ V ^8„  d   Qh/ R;R&   # )r5   r7  Úoriginal_pagerV   )r;   rg   s   "€r<   r=   r9  é  s   ø‡ ‚ ð"  Ñò# r>   )
r>  rx  rv  r3   rÐ   r<  r_  rF   r”   rw  r²   )NNNrR   )T)FT)NNTF)TFr³   )rê   )r   éZ   é´   é  )Trù  TNrŽ   ))r   r  r  r©  r¦  NNNrV   )>rI   r´   rµ   r¶   r·   rk   rC  rM  r[   rU  r¸   rc  rr  r}  rÕ   rŠ  rm  r”   Úsetterr»  rš   rà  rè  rï  rø  r”  r  r  r  r  r'  r_  rd  rh  rl  rµ  r‘   r†  rŠ  r‘  r•  r¤  rS  r÷  rÏ  rÔ  rì  rþ  rÃ  r	  rb   r`  r_  r3   rv  rw  rx  r{  rï   r¹   rº   Ú__classcell__)rå   rg   s   @@r<   r7  r7  é  sH  ù‡ € ñ÷$Sò S÷
ð 
÷ó ð
 ÷6ó ð6ð ÷+ñ +ó ð+÷Z$ò $÷L*Jò *JðX ÷%Gó ð%G÷Nð ÷,ð ,ð\ ÷Vó ðVð ‡_�_÷Wó ðW÷!ð !÷Fð ÷ O#ò O#ðb ÷ó ðð* ÷ó ð÷ ð ÷ð ÷*="ð ="÷~:ò :÷,hò h÷TH1ò H1÷T)/ð )/÷V
ò 
÷@=ò =÷$=ò =÷,=ò =÷00Aò 0A÷d4Kð 4K÷l	#ð 	#÷ð ÷Iò Ið. ÷ó ð÷ $ð $ðT ):Ø"Ø%'§[¡[ØQUØPTØLP÷c ò c ÷Jð ÷49jò 9jðvG
ð 5FðG
ð #ð	G
ð
 RVðG
ð QUðG
ð MQðG
ð 7>÷G
ò G
÷R!
ò !
÷F$ð $ñ  *¨"¯+©+°rÓ:€Hð>ñ )¨°b·k±k°^ÓD€Gð	ñ *¨+¸
ÀBÇKÁKÐ7PÓQ€HðGñ )¨°jÀ"Ç+Á+Ð5NÓO€Gðñ (¨	°JÀÇÁÐ3LÓM€Fð2ð ÷2ó ð2ð
 ×Ñ÷0ó ð0÷G4 … r>   r7  c                   óÄ   a € ] tR tRt o V 3R lR ltV 3R lR lt]V 3R lR l4       t]V 3R lR	 l4       tV 3R
 lR ltV 3R lR ltV 3R lR lt	V 3R lR lt
RtV tR# )Ú_VirtualListi|  c                óV   <€ V ^8„  d   QhRS[ . S[3,          RS[ S[.S[3,          RR/# )r5   Úlength_functionrô   r9   N)r   rü   r7  )r;   rg   s   "€r<   r=   Ú_VirtualList.__annotate__}  s>   ø€ ÷ ñ á! "¡c 'Õ*ðñ ¡˜u¡jÐ0Õ1ðð 
ñ	r>   c                ó,   € Wn         W n        RV n        R# r÷   )r  rô   rø   )r6   r  rô   s   &&&r<   rk   Ú_VirtualList.__init__}  s   € ð
  /ÔØ(ÔØˆŽr>   c                ó    <€ V ^8„  d   QhRS[ /# rn   rû   )r;   rg   s   "€r<   r=   r  †  s   ø€ ÷ &ñ &™ñ &r>   c                ó"   € V P                  4       # rR   )r  rp   s   &r<   rþ   Ú_VirtualList.__len__†  s   € Ø×#Ñ#Ó%Ð%r>   c                ó&   <€ V ^8„  d   QhRS[ RS[/# r  )rü   r7  )r;   rg   s   "€r<   r=   r  Š  s   ø€ ÷ ñ ¡ð ©ñ r>   c                ó   € R # rR   rV   r  s   &&r<   r  Ú_VirtualList.__getitem__‰  r«   r>   c                ó6   <€ V ^8„  d   QhRS[ RS[S[,          /# r  )r  r   r7  )r;   rg   s   "€r<   r=   r  Ž  s    ø€ ÷ ñ ¡ð ©8±JÕ+?ñ r>   c                ó   € R # rR   rV   r  s   &&r<   r  r%  �  r«   r>   c                ób   <€ V ^8„  d   QhRS[ S[S[3,          RS[ S[S[S[,          3,          /# r  )r   rü   r  r7  r   )r;   rg   s   "€r<   r=   r  ‘  s5   ø€ ÷ (ñ (Ù™3¡˜:Õ&ð(á	‰z™8¡JÕ/Ð/Õ	0ñ(r>   c                óŠ  a a€ \        V\        4      '       dE   \        VP                  \	        S 4      4      !  o\        S 4      pV! SP                  VV 3R  l4      # \        V\        4      '       g   \        R4      h\	        S 4      pV^ 8  d	   W,          p^ Tu;8:  d   V8  g   M \        R4      hS P                  V4      # )c                 ó$   <€ SSV ,          ,          # rR   rV   )rÏ  r  r6   s   &€€r<   r^   Ú*_VirtualList.__getitem__.<locals>.<lambda>—  s   ø€ °D¸À½Ö4Fr>   z!Sequence indices must be integersr  )rE   r  r  r  rH   r  rþ   rü   rÑ   r  rô   )r6   r  r  r  r  s   f&  @r<   r  r%  ‘  sŸ   ù€ ô �eœU×#Ò#Ü˜UŸ]™]¬3¨t«9Ó5Ñ6ˆGÜ�t“*ˆCÙ�w—‘Õ(FÓGÐGÜ˜%¤×%Ò%ÜÐ?Ó@Ð@Ü�t“9ˆØ�1Œ9àÕˆEØ�UÖ%˜XÖ%ÜÐ:Ó;Ð;Ø× Ñ  Ó'Ð'r>   c                ó:   <€ V ^8„  d   QhRS[ S[S[3,          RR/# )r5   r  r9   N)r   rü   r  )r;   rg   s   "€r<   r=   r  ¢  s$   ø€ ÷ -ñ -¡¡s©E zÕ!2ð -°tñ -r>   c           	     ó’  € \        V\        4      '       dX   \        \        VP	                  \        V 4      4      !  4      pVP                  4        VP                  4        V F  pW K  	  R # \        V\        4      '       g   \        R4      h\        V 4      pV^ 8  d	   W,          p^ Tu;8:  d   V8  g   M \        R4      hW,          P                  pVf   Q h\        \        VP                  4       4      P                  RR 4      pRpVeþ   \        \        VP                  4       4      p \        \         VR,          4      P#                  V4      p\        \         VR,          4      V Rp Vf   Q hVP$                  P&                  V RV9   d4   \+        \        \        VR,          4      ^,
          4      V\-        R4      &   \        \        \         VR,          4      4      ^ 8X  d   VP                  pVP                  RR 4      pEK  R #   \(         d     L�i ; i  \.         d    T'       d   \1        RT 24      h R # i ; i)	NzIndex must be integerszIndex out of ranger8  Tz/KidsFz/CountzPage not found in page tree: )rE   r  r¥   r  r  rH   r;  Úreverserü   rÑ   r  rÐ   r   r'   rG   rD   r%   r  rF   Úflattened_pagesrŸ  r-   r+   r�   r$   )	r6   r  r¦  r4  r  ÚindÚparentÚfirstr$  s	   &&       r<   Ú__delitem__Ú_VirtualList.__delitem__¢  sù  € Ü�eœU×#Ò#Ü”U˜EŸM™M¬#¨d«)Ó4Ñ5Ó6ˆAà�F‰FŒHØ�I‰IŒKÛ�Ø’Gñ áÜ˜%¤×%Ò%ÜÐ4Ó5Ð5Ü�t“9ˆØ�1Œ9àÕˆEØ�UÖ%˜XÖ%ÜÐ1Ó2Ð2Ø�k×,Ñ,ˆØŠÐˆÜ&*Ô+;¸S¿^¹^Ó=MÓ&N×&RÑ&RØ�tó'
ˆð ˆØÒ ÜÔ*¨F×,=Ñ,=Ó,?Ó@ˆFðÜœ f¨W¥oÓ6×<Ñ<¸SÓA�Üœ f¨W¥oÓ6°qÐ9Ø�ðØš?Ð*˜?ØŸ™×/Ñ/°Ð6ð ˜vÔ%Ü3?ÜœS &¨Õ"2Ó3°aÕ7ó4�Fœ: hÓ/Ñ0ô ”tœK¨°­Ó9Ó:¸aÔ?à ×3Ñ3�CØŸ™ I¨tÓ4“ñ% !øô !ô Ùðûô ô ßÜ&Ð)FÀsÀeÐ'LÓMÐMÚðúsD   Ä0A H! Å1H Å5H ÆA=H! ÈHÈH! ÈHÈH! È!IÈ4IÉIc                ó0   <€ V ^8„  d   QhRS[ S[,          /# rn   )r   r7  )r;   rg   s   "€r<   r=   r  Ñ  s   ø€ ÷ ñ ™(¡:Õ.ñ r>   c              #  óX   "  € \        \        V 4      4       F  pW,          x € K  	  R # 5irR   r"  r#  s   & r<   r%  Ú_VirtualList.__iter__Ñ  r'  r(  c                ó    <€ V ^8„  d   QhRS[ /# rn   rx   )r;   rg   s   "€r<   r=   r  Õ  r*  r>   c                óŽ   € \        V P                  4       4       Uu. uF	  pR V R2NK  	  ppRRP                  V4       R2# u upi )zPageObject(rž   r.  r/  r0  )r  r  r2  )r6   r$  r4  s   &  r<   ræ   Ú_VirtualList.__str__Õ  sL   € Ü).¨t×/CÑ/CÓ/EÔ)FÓGÑ)F Aˆ{˜1˜#˜QÓÑ)FˆÐGØ�4—9‘9˜Q“<�. Ð"Ð"ùò Hs   œA)rø   rô   r  N)rI   r´   rµ   r¶   rk   rþ   r   r  r3  r%  ræ   r¹   rº   r»   s   @r<   r  r  |  sj   ø‡ € ÷ð ÷&ð &ð ÷ó ðð ÷ó ð÷(ð (÷"-ð -÷^ð ÷#ö #r>   r  c                óÂ   € V ^8„  d   QhR\         R\        \        ,          R\        \        ,          R\        \        \        ,          \        \        ,          3,          /# )r5   rf  ÚfntÚembr9   )r'   r!  r:   rJ   )r;   s   "r<   r=   r=   Ú  sP   € ÷ bñ bÜ	ðbä	ŒS�ðbô 
ŒS�ðbô Œ3Œs�8”Sœ•XÐÕñ	br>   c           
     ó  aaa€ RoR VVV3R llpRV 9   dX   R\        \        V R,          4      9   d<   \        \        \        \        V R,          4      R,          4       F  pV! V4       K  	  RV 9   dì   R\        \        V R,          4      9   dJ   \        \        \        \        V R,          4      R,          4      P                  4        F  pV! V4       K  	  R\        \        V R,          4      9   dk   \        \        \        \        V R,          4      R,          4      P                  4        F,  p\        \        \        VP	                  4       4      SS4       K.  	  RV 9   dH   \        \
        V R,          4       F,  p\        \        \        VP	                  4       4      SS4       K.  	  RV 9   dÊ   \        \        \        \        V R,          4      R	,          4      P                  R
4      R8X  d<   \        \        \        \        \        V R,          4      R	,          4      SS4       SS3# \        \        \        \        V R,          4      R	,          4       F  p\        \        \        V4      SS4       K   	  SS3# )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.

c                ó(   € V ^8„  d   QhR\         RR/# )r5   Úfr9   N)r'   )r;   s   "r<   r=   Ú%_get_fonts_walk.<locals>.__annotate__ô  s   € ÷ &>ñ &>Ô(ð &>¨Tñ &>r>   c           	      ó.  <a € \        \        S P                  4       4      o R S 9   d'   SP                  \        \        S R ,          4      4       RS 9   gÎ   RS 9   dA   \
        ;QJ d    V 3R lS 4       F  '       g   K   RM	  RM! V 3R lS 4       4      '       g‡   RS 9   d­   R\        \        \        \        S R,          4      ^ ,          P                  4       4      9   dl   \
        ;QJ d    V 3R lS 4       F  '       g   K   RM	  RM! V 3R lS 4       4      '       d*    SP                  \        \        S R ,          4      4       R# R# R# R#   \         d9    SP                  R\        \        S R	,          4      ,           R
,           4        R# i ; i)z	/BaseFontz
/CharProcsú/FontDescriptorc              3   óV   <"  € T F  q\        \        SR ,          4      9   x € K   	  R# 5i)rC  N)r   r'   ©rD  r  r@  s   & €r<   rG  Ú8_get_fonts_walk.<locals>.process_font.<locals>.<genexpr>þ  s%   øé € ð ÙOWÈ!œÔ.°Ð2CÕ0DÓEÖEËxùs   ƒ&)TFú/DescendantFontsc              3   óÈ   <"  € T FW  pV\        \        \        \        \        \        SR ,          4      ^ ,          P                  4       4      R,          4      9   x € KY  	  R# 5i)rG  rC  N)r   r'   r%   rG   rE  s   & €r<   rG  rF  		  s_   øé € ð 
ñ &˜ð ÜÜ(ÜÜ,Ü ¤¨aÐ0BÕ.CÓDÀQÕG×RÑRÓTóð ,õ-óöó &ùs   ƒAA"Ú(r²  rž   N)r   r'   rG   Úaddr:   Úanyr%   r|  )r@  r=  r<  Úfontkeyss   f€€€r<   Úprocess_fontÚ%_get_fonts_walk.<locals>.process_fontô  sC  ù€ äÔ! 1§<¡<£>Ó2ˆØ˜!ÔØ�G‰G”Dœ˜a �nÓ-Ô.ð ˜QÔà! QÔ&ß“Cô ÙOWó—C—C’Cô ÙOWó÷ ò ð
 # aÔ'Ø%ÜÜ$Üœ aÐ(:Õ&;Ó<¸QÕ?×JÑJÓLóô÷
 “Cô 
ñ &ó
—C—C’Cô 
ñ &ó
÷ 
ò 
ð>Ø—‘œœS ! K¥.Ó1Ö2ñ
ññ (øô, ô >Ø—‘˜œd¤3¨¨*­Ó6Õ6¸Õ<×=ð>ús   Ä#&E Å?FÆFz/DRr�  rˆ  r±  r  z/APz/Nz/Type)z	/FontFilez
/FontFile2z
/FontFile3)r   r'   Úvaluesr  rG   r%   rD   )rf  r<  r=  rM  r@  r  r@  rL  s   &ff    @r<   r  r  Ú  s  ú€ ð0 9€H÷&>ò &>ðP �„|˜¤4Ô(8¸#¸e½*Ó#EÔEÜÔ&¬Ô-=¸sÀ5½zÓ(JÈ7Õ(SÖTˆAÙ˜ŽOñ Uà�sÔØ”dÔ+¨S°Õ->Ó?Ô?ÜÜ ¤$Ô'7¸¸\Õ9JÓ"KÈGÕ"Tóç‰f‹hò�ñ ˜Q–ñð œÔ.°°LÕ0AÓBÔBÜÜ ¤$Ô'7¸¸\Õ9JÓ"KÈJÕ"Wóç‰f‹hò�ô  ¤Ô%5°q·|±|³~Ó FÈÈSÖQñð �CÔÜ”k 3 y¥>Ö2ˆAÜœDÔ!1°1·<±<³>ÓBÀCÈÖMñ 3à�„|äÔ!¤4Ô(8¸#¸e½*Ó#EÀdÕ#KÓL×PÑPØóð ôô
 ÜÔ%¤tÔ,<¸cÀ%½jÓ'IÈ$Õ'OÓPØØôð �ˆ8€Oô Ô*¬DÔ1AÀ3ÀuÅ:Ó,NÈtÕ,TÖU�Ü¤Ô%5°qÓ 9¸3ÀÖDñ Và�ˆ8€Or>   )Qr–   Úcollections.abcr   r   r   rÄ  r   Údataclassesr   r   Údecimalr	   Úior
   Úpathlibr   Útypingr   r   r   r   r   r   r   Ú_fontr   Ú
_protocolsr   Ú_text_extractionr   Ú _text_extraction._text_extractorr   Ú_utilsr   r   r   r   r   r   Ú	constantsr   r   r   r    r!   rS  r"   rn  Úerrorsr#   r$   rÎ   r%   r&   r'   r(   r)   r*   r+   r,   r-   r.   r/   r0   r1   Ú	PIL.Imager2   rË   rÌ   r’  r%  rM   rK   rX   rb   rd   r½   rñ   r7  r  r  rV   r>   r<   Ú<module>r^     s#  ðó< ß 8Ñ 8Ý ß )Ý Ý Ý ÷÷ ñ õ Ý ,õõ =÷÷ ÷ó õ ,Ý 'ß 9÷÷ ÷ õ ð ÝàÐð
 €õõ2#õõ÷A:ñ A:ðH ÷XCð XCó ðXCôv<#˜ Õ+ô <#ô~P0Ð!ô P0ôf4[#�8˜JÕ'ô [#÷|bøðAD ô Ø€EØÒðús   Â(D ÄD(Ä'D(