WwgLz@dZddlZddlZddlmZddlmZddlmZddlm Z m Z m Z ddl Z ddl Z ddlmZddlmZdd lmZmZmZdd lmZmZmZdd lmZdd lmZdd lmZddl m!Z!m"Z"ddl#m$Z$m%Z%m&Z&ddl'm(Z(m)Z)gdZ*GddZ+dejXfdZ-edGddeZ.edGdde.Z/edGdde.Z0GddejbZ2d Z3 edGd!d"e0Z4Gd#d$ejXZ5Gd%d&e5Z6Gd'd(e5Z7Gd)d*e7Z8d+e9d,e9d-e0d.e:d/e:d0e:f d1Z; d9d+e9d,e9d-e0d.e:d/e:d0e:f d2Z< d9d+e9d,e9d-e4d.e:d/e:d0e:d3e9fd4Z=ej|ej~d5d56d78Z@y):a  Utilities for stamping PDF files. Here 'stamping' loosely refers to adding small overlays (QR codes, text boxes, etc.) on top of already existing content in PDF files. The code in this module is also used by the :mod:`.sign` module to render signature appearances. N)hexlify) dataclass)datetime)ListOptionalTuple)ConfigurableMixin)ConfigurationError)contentgenericlayout)IndirectObjectpdf_name pdf_string)IncrementalPdfFileWriter) LayoutError)rd)PdfFancyQRImagePdfStreamQRImage)DEFAULT_BOX_LAYOUTTextBox TextBoxStyle)BasePdfFileWriterinit_xobject_dictionary) AnnotAppearancesBaseStampStyleTextStampStyle QRStampStyleStaticStampStyle QRPosition BaseStamp TextStampQRStampStaticContentStamptext_stamp_file qr_stamp_fileSTAMP_ART_CONTENTceZdZdZ d dej deej deej fdZdejfdZ y) rup Convenience abstraction to set up an appearance dictionary for a PDF annotation. Annotations can have three appearance streams, which can be roughly characterised as follows: * *normal*: the only required one, and the default one; * *rollover*: used when mousing over the annotation; * *down*: used when clicking the annotation. These are given as references to form XObjects. .. note:: This class only covers the simple case of an appearance dictionary for an annotation with only one appearance state. See § 12.5.5 in ISO 32000-1 for further information. Nnormalrolloverdownc.||_||_||_yN)r)r*r+)selfr)r*r+s D/var/www/horilla/myenv/lib/python3.12/site-packages/pyhanko/stamp.py__init__zAnnotAppearances.__init__Fs     returnctjtd|ji}|j|j|td<|j |j |td<|S)a Convert the :class:`.AnnotationAppearances` instance to a PDF dictionary. :return: A :class:`~.pdf_utils.generic.DictionaryObject` that can be plugged into the ``/AP`` entry of an annotation dictionary. z/Nz/Rz/D)r DictionaryObjectrr)r*r+)r.ress r/ as_pdf_objectzAnnotAppearances.as_pdf_objectPs^&& 'DE == $"&--C  99 "&))C  r1NN) __name__ __module__ __qualname____doc__r rrr0r4r6r1r/rr1s^.6:15 &&7112w--. w77r1rr2ct|ts td|dk(rtS|j drt j |Sddlm}ddl m }|j|}||dS)Nz)Background specification must be a string __stamp__z.pdfr)Image)PdfImage)writer) isinstancestrr r'endswithr ImportedPdfPagePILr?pyhanko.pdf_utils.imagesr@open)bg_specr?r@imgs r/_get_background_contentrKbsh gs # !LMM+    & !&&w//5jj!D))r1T)frozencpeZdZUdZdZeed< dZee jed< e je jje jje jj!dZe jed< d Zeed < efd Zd ed e j.deddfdZxZS)rz& Base class for stamp styles.  border_widthN background)x_aligny_alignmarginsbackground_layoutg333333?background_opacityctt||d} |d}|t||d<yy#t$rYwxYw)a This implementation of :meth:`process_entries` processes the :attr:`background` configuration value. This can either be a path to an image file, in which case it will be turned into an instance of :class:`~.pdf_utils.images.PdfImage`, or the special value ``__stamp__``, which is an alias for :const:`~pyhanko.stamp.STAMP_ART_CONTENT`. NrP)superprocess_entriesKeyErrorrK)cls config_dictrI __class__s r/rYzBaseStampStyle.process_entriessV  , !,/G  (?(HK %    s + 77rAbox text_paramsr2r!ctr-NotImplementedErrorr.rAr^r_s r/ create_stampzBaseStampStyle.create_stamps "!r1)r8r9r:r;rOint__annotations__rPrr PdfContentr SimpleBoxLayoutRule AxisAlignment ALIGN_MIDMarginsuniformrUrVfloat classmethodrYrBoxConstraintsdictrd __classcell__r]s@r/rrvsL#04J++,3 5OF4N4N$$..$$..&&q)5v11 !$# II&"!" " "" "  "r1rcfeZdZUdZdZeed< e d d dZde de jde dd fd Z y )rza Stamp style that does not include any custom parts; it only renders the background. g?rVr2c Ftddtj||i|S)a Create a :class:`StaticStampStyle` from a page from an external PDF document. This is a convenience wrapper around :class:`~content.ImportedPdfContent`. The remaining keyword arguments are passed to :class:`StaticStampStyle`'s init method. :param file_name: File name of the external PDF document. :param page_ix: Page index to import. The default is ``0``, i.e. the first page. rP)page_ixr<)rr rE)r[ file_namerukwargss r/ from_pdf_filezStaticStampStyle.from_pdf_files."  ..y'J   r1rAr^r_r$ct|||S)N)rAstyler^)r$rcs r/rdzStaticStampStyle.create_stamps "tEEr1N)r)r2r)r8r9r:r;rVrmrfrnrxrr rorprdr<r1r/rrsn !$#  !   *F!F " "F F  Fr1rceZdZUdZeZeed< dZee jed< dZ e ed< dZ e ed< d ed e jd ed d fdZy)rz Style for text-based stamps. Roughly speaking, this stamp type renders some predefined (but parametrised) piece of text inside a text box, and possibly applies a background to it. text_box_styleNinner_content_layoutz%(ts)s stamp_textz%Y-%m-%d %H:%M:%S %Ztimestamp_formatrAr^r_r2r"c t||||S)N)rArzr^r_)r"rcs r/rdzTextStampStyle.create_stamp s 3K  r1)r8r9r:r;rr|rfr}rr rhr~rCrrrorprdr<r1r/rrs$0>NL1BF(6#=#=>EJ3c2 !  " "     r1rceZdZdZej ej jej jZ ej ej jej jZ ej ej jej jZ ej ej jej jZ edZeddZy)r z[ QR positioning constants, with the corresponding default content layout rule. )rRrS)rSrRcF|tjtjfvSr-)r LEFT_OF_TEXT RIGHT_OF_TEXTr.s r/horizontal_flowzQRPosition.horizontal_flow,s //1I1IJJJr1c tjtjtjtjd|j S#t $rtd|dwxYw)a Convert from a configuration string. :param config_str: A string: 'left', 'right', 'top', 'bottom' :return: An :class:`.QRPosition` value. :raise ConfigurationError: on unexpected string inputs. leftrighttopbottom'zW' is not a valid QR position setting; valid values are 'left', 'right', 'top', 'bottom')r rr ABOVE_TEXT BELOW_TEXTlowerrZr )r[ config_strs r/ from_configzQRPosition.from_config0sw "//#11!,,$//   " "  $J< >?  s AAA+N)r2r )r8r9r:r;r rhri ALIGN_MINrjr ALIGN_MAXrrrpropertyrrnrr<r1r/r r s .6--$$..$$..L/F..$$..$$..M,++$$..$$..J,++$$..$$..J KKr1r g?ceZdZUdZdZeed< dZeed< dZ e eed< e jZ e ed< dZe ej ed < efd Zd ed ej*d eddfdZxZS)rz Style for text-based stamps together with a QR code. This is exactly the same as a text stamp, except that the text box is rendered with a QR code to the left of it. rNinnsepz@Digital version available at this url: %(url)s Timestamp: %(ts)sr~N qr_inner_size qr_positionqr_inner_contentc~t|| |d}tj||d<y#t$rYywxYw)Nr)rXrYr rrZ)r[r\qr_posr]s r/rYzQRStampStyle.process_entriessF  ,  /F)3)?)?)GK &   s 0 <<rAr^r_r2r#c |jd}t |||||S#t$rtjdwxYw)Nurlz7Using a QR stamp style requires a 'url' text parameter.)rzrr_r^)poprZr rr#)r.rAr^r_rs r/rdzQRStampStyle.create_stampsV //%(C  $C[c   $$I  s #A)r8r9r:r;rrerfr~rCrrr rrrr rgrnrYrr rorprdrqrrs@r/rrRsFCO   $(M8C=')55K56:hw1129 !  " "     r1rceZdZ ddedeej ffd ZdZdZ dZ de jfdZ d ed ed efd Zdefd ZxZS)r!rAr^cRt|||||_d|_d|_y)N)r^rAF)rXr0rz_resources_ready _stamp_refr.rArzr^r]s r/r0zBaseStamp.__init__s- S0 %48r1c d|jj}|j|j|j }|j }|j rR|jrF|jjj|j |j|j}nM|jjj}tjdd|j|j }t#j$|jj&}|j)t*j,j.t1dt#j2t1d|t1d|id|j5|fz}|j7|j8|S)N)x_scaley_scalex_posy_posz /BackgroundGSz/CAz/cacategorynamevaluesq /BackgroundGS gs %s %s Q)rzrP set_writerrArenderr^ width_definedheight_definedrUfitwidthheightrTr Positioningrrr FloatObjectrV set_resourcer ResourceType EXT_G_STATErr4as_cmimport_resources resources)r.bg bg_contentbg_box positioningrTopacitycommands r/_render_backgroundzBaseStamp._render_backgroundsL ZZ " " dkk"YY[    F$9$9**66::&,, K jj22::G ,,1GLLK %%djj&C&CD ))55/***%'8E?GD  0     3   bll+r1ctr-rars r/_render_inner_contentzBaseStamp._render_inner_contents!!r1cdg}|j}|jjr|j|j |r|j ||j }|jj}|r+|jd||j|jfz|jddj|S)Nqs%g w 0 0 %g %g re SQ ) rrzrPappendrextendr^rOrrjoin)r.command_stream inner_contentbboxrOs r/rzBaseStamp.renders224 ::  ! !$"9"9"; <   ! !- 0xxzz..   ! !&, DKK)PP  d#yy((r1r2c|j}|4|j}|j}|j|x|_}|S)a Register the stamp with the writer coupled to this instance, and cache the returned reference. This works by calling :meth:`.PdfContent.as_form_xobject`. :return: An indirect reference to the form XObject containing the stamp. )r_ensure_writeras_form_xobject add_object)r. stamp_refwr form_xobjs r/registerzBaseStamp.registersGOO  $$B,,.I*,-- *B BDOir1 dest_pagexyc 4|j}dttjjz}dt |t ||fz}t j|}t jtdt jt|jd|ii}|j} | J| j|| j||} |jj|jj f} | | fS)a[ Apply a stamp to a particular page in the PDF writer attached to this :class:`.BaseStamp` instance. :param dest_page: Index of the page to which the stamp is to be applied (starting at `0`). :param x: Horizontal position of the stamp's lower left corner on the page. :param y: Vertical position of the stamp's lower left corner on the page. :return: A reference to the affected page object, together with a ``(width, height)`` tuple describing the dimensions of the stamp. s/Stampsq 1 0 0 1 %g %g cm %s Do Q) stream_dataz/XObjectascii)rruuiduuid4bytesrr StreamObjectr4rdecoderAadd_stream_to_pagerr^rr) r.rrrr resource_name stamp_paintstamp_wrapper_streamrrpage_refdimss r/applyzBaseStamp.applys MMO !GDJJL,>,>$?? 3 qE qE 7  '33 L,,$g&>&>m227;! >  > " " >r1r$cjeZdZdZ d dedeejffd ZdZ dZ dZ dZ d Z xZS) r"zf Class that renders a text stamp as specified by an instance of :class:`.TextStampStyle`. rAr^cFt||||||_d|_y)Nr)rXr0r_text_box)r.rArzr_r^r]s r/r0zTextStamp.__init__Js( Sf=&+/ r1ctjtj}d|j |j j iS)aQ Compute values for the default string interpolation parameters to be applied to the template string specified in the stamp style. This method does not take into account the ``text_params`` init parameter yet. :return: A dictionary containing the parameters and their values. )tzts)rnowtzlocal get_localzonestrftimerzr)r.rs r/get_default_text_paramsz!TextStamp.get_default_text_paramsVs=\\W224 5 "++djj99:  r1ct|jj|j|jdx|_}|j }|j|j|j |jj|z}||_ |jS#t$r!}td|jddd}~wwxYw)N)rArr^zStamp text parameter 'rz ' is missing)rrzr|rArrrr_updater~rZrargsr r)r.tb _text_paramstextes r/ _text_layoutzTextStamp._text_layoutes$ JJ % %;;nn     335    '    0 0 1 P::((<7D yy{  P 6qvvaykNO O Ps7B'' C0C  Cc|j}|jj}|g|j|jffSr-)rrr^rr)r. text_commandsinn_boxs r/_inner_layout_natural_sizez$TextStamp._inner_layout_natural_sizezs9))+ --## ???r1c>|jjxstSr-)rzr}rrs r/_inner_content_layout_rulez$TextStamp._inner_content_layout_ruleszz..D2DDr1cdg}|j\}\}}|j}|j}|j|||}|j |j |j ||j d|S)Nrr)rr r^rrrr)r.r inn_commands inn_width inn_height inner_layoutr inn_positions r/rzTextStamp._render_inner_contents  + + -   668 xx$''iD l0023l+d#r1r7)r8r9r:r;rrr ror0rrrr rrqrrs@r/r"r"DsM/3 0! 0 f++ , 0  *@Er1r"c eZdZ d dedededeejffd Z dZ de e e e eeffffd Zd Zfd Zfd ZxZS) r#rArrzr^cHt|||||||_d|_y)N)r_r^)rXr0r_qr_size)r.rArrzr_r^r]s r/r0zQRStamp.__init__s) KSI r1cv|j}|j |jS|jjSr-)rzr}rr)r.rzs r/r z"QRStamp._inner_content_layout_rules7   % % 1-- -  &&&r1r2ct|\}\}}|j\}}|jtj j td||j}|j}|j}|j |j} np|jrI|jr=tt|j |t|j"|} | d|zz } nt%t't(|z} | |z } | d|zz} |j*j,r| |z} t| |}nt| |} | |z}|j*j.}t1j2|j4|j6t0j8j;|t0j<j>}t1j@| |}|jC|| | }d|jD| z|jF| z|jH|jJfz}|j*tLjNk(rt1j8| ddd}n|j*tLjPk(rt1j8| ddd}nP|j*tLjRk(rt1j8| ddd }nt1j8| ddd }t1j2|j4jT|j6jT|t0j<j>}|jC|||}|d |jWg}|jY||j[d || |ffS) Nz/QRr)rRrSrTinner_content_scalingsq %g 0 0 %g %g %g cm /QR Do Qrr)rrrr)rrrr)rrrrrr).rXr _qr_xobjectrr rXOBJECTrrzr^rrrrminmaxrrreroundDEFAULT_QR_SCALErrrr rhrRrSrkrl InnerScaling NO_SCALINGrorrrrrr rrrflippedrrr)r.r text_width text_heightqr_refnatural_qr_sizerz stamp_boxrqr_sizemin_dimqr_innunits_scale qr_paddedr r default_layoutqr_layout_rule inner_box qr_inn_posdraw_qr_command tb_marginstb_layout_rule text_inn_poscommandsr]s r/rz"QRStamp._inner_layout_natural_sizesG G . 0   #'"2"2"4 ))11%   HH     *))G  $ $)A)AI$$k2IOOZ0GF *G% 0? BCDG#o5a&j(     , ,!J.IY 4JIz2I"[0J5:5F5F5L5L 33"**"**NN**62#)"5"5"@"@  )))Z@ #'' 7GD ;   !2 2   !2 2       >      7 7 7aQqJ  *":": :aQqJ  *"7"7 7 qJ QQqJ 33#**22"**22"("5"5"@"@  &)))ZM #T<+=+=+?@ &)Z000r1c|jjdu}|rtjjntjj }tj |}|j|j|j|r7|jt|j|jj}n|jt}|j}|jd|j zz|j"z}t%|||}|j'|j(j+||fS)N)error_correction) image_factoryversion center_image)r4r)rzrqrcode constantsERROR_CORRECT_HERROR_CORRECT_MQRCodeadd_datarmake make_imagerr5rrender_command_stream modules_countborderbox_sizercompressrAr)r.is_fancyerr_corrqrrJr bbox_sizeqr_xobjs r/rzQRStamp._qr_xobjects ::..d:    , ,!!11  ]]H 5 DHH  --- !ZZ88 C --.>-?C224%%BII 5D ).)YO{{%%g. 99r1cBt|}|j|d<|S)Nr)rXrr)r.tpr]s r/rzQRStamp.get_default_text_params8s" W , .HH5  r1cHt ||||\}\}}||||z||zf}tjt dt dt dt dt dtj t ttj|t dtjt dt dt dt|jii}|j} | j|| j||||ffS) Nz/Typez/Annotz/Subtypez/Linkz/Rectz/Az/Sz/URI)rXrr r4r ArrayObjectlistmaprrrrAregister_annotationr) r.rrrrwh link_rect link_annotrr]s r/rz QRStamp.apply=s 7=Aq9&1a1q5!a%( --!8H#5$hw&7!7#6#6W00)<=$ 8 8 (8 (*TXX*>!  [[ xz)BC!Qr1r7)r8r9r:rrCrrr ror0r rrrrerrrrrqrrs@r/r#r#s /3 !    f++ , 'l1E$u+uS#X2N,Ol1\:4   r1r# input_name output_namerzrrrc t|d5}t|d} |d| |d|} | j|||t|d5} | j| ddddddy#1swYxYw#1swYyxYw)NrbF)strict)rArzwbr<)rHrrwrite) rTrUrz stamp_classrrr stamp_kwargsfinpdf_outstampouts r/ _stamp_fileraTs j$ 3*3u=H7%H<H Iq!$ +t $  MM#       s#8A4A(A4(A1 -A44A=c 2t|||t||||y)a5 Add a text stamp to a file. :param input_name: Path to the input file. :param output_name: Path to the output file. :param style: Text stamp style to use. :param dest_page: Index of the page to which the stamp is to be applied (starting at `0`). :param x: Horizontal position of the stamp's lower left corner on the page. :param y: Vertical position of the stamp's lower left corner on the page. :param text_params: Additional parameters for text template interpolation. )r_N)rar")rTrUrzrrrr_s r/r%r%gs$6    r1rc 4t|||t||||| y)aj Add a QR stamp to a file. :param input_name: Path to the input file. :param output_name: Path to the output file. :param style: QR stamp style to use. :param dest_page: Index of the page to which the stamp is to be applied (starting at `0`). :param x: Horizontal position of the stamp's lower left corner on the page. :param y: Vertical position of the stamp's lower left corner on the page. :param url: URL for the QR code to point to. :param text_params: Additional parameters for text template interpolation. )rr_N)rar#)rTrUrzrrrrr_s r/r&r&s'>    r1d)rrs q 1 0 0 -1 0 100 cm 0.603922 0.345098 0.54902 rg 3.699 65.215 m 3.699 65.215 2.375 57.277 7.668 51.984 c 12.957 46.695 27.512 49.34 39.418 41.402 c 39.418 41.402 31.48 40.078 32.801 33.465 c 34.125 26.852 39.418 28.172 39.418 24.203 c 39.418 20.234 30.156 17.59 30.156 14.945 c 30.156 12.297 28.465 1.715 50 1.715 c 71.535 1.715 69.844 12.297 69.844 14.945 c 69.844 17.59 60.582 20.234 60.582 24.203 c 60.582 28.172 65.875 26.852 67.199 33.465 c 68.52 40.078 60.582 41.402 60.582 41.402 c 72.488 49.34 87.043 46.695 92.332 51.984 c 97.625 57.277 96.301 65.215 96.301 65.215 c h f 3.801 68.734 92.398 7.391 re f 3.801 79.512 92.398 7.391 re f 3.801 90.289 92.398 7.391 re f Q )r^datar-)Ar;enumrbinasciir dataclassesrrtypingrrrr7rpyhanko.config.apir pyhanko.config.errorsr pyhanko.pdf_utilsr r r pyhanko.pdf_utils.genericrrr$pyhanko.pdf_utils.incremental_writerrpyhanko.pdf_utils.layoutrpyhanko.pdf_utils.miscrpyhanko.pdf_utils.qrrrpyhanko.pdf_utils.textrrrpyhanko.pdf_utils.writerrr__all__rrgrKrrrEnumr rrr!r$r"r#rCrerar%r& RawContentror'r<r1r/rwsX !(( 0466JJI0%BLLO "..b*(:(:*( $="&="="@ $(F~(F(FV $. ^. . b11h $E >E E PS2""S2l&T Tnv iv r      4$$$ $ $  $  $^))) ) )  )  ) )X'G&&C4 &r1