=XjQ'ddlmZmZmZddlmZmZmZmZm Z ddl m Z m Z ddl mZmZddlmZddlmZGdd Zy ) )OptionalTupleUnion) BooleanObject FloatObject NameObject NumberObjectTextStringObject) ArrayObjectDictionaryObject) DEFAULT_FITFit)RectangleObject) hex_to_rgbceZdZdZddlmZmZe ddee e e e e e ffde de dedef d Ze dde dee e e e e e ffd e d e d e d e de de de defdZe d de e e fde e e fdee e e e e e ffde de def dZe d!dee e e e e e ffdee defdZedddefdee e e e e e ffdeedee deededef dZy)"AnnotationBuildera> The AnnotationBuilder creates dictionaries representing PDF annotations. Those dictionaries can be modified before they are added to a PdfWriter instance via `writer.add_annotation`. See `adding PDF annotations <../user/adding-pdf-annotations.html>`_ for it's usage combined with PdfWriter. )FitType ZoomArgTyperecttextopenflagsreturnc ttdtdtdtdtdt|tdt|tdt |tdt |i}|S) z Add text annotation. :param Tuple[int, int, int, int] rect: or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]`` :param bool open: :param int flags: /Type/Annot/Subtypez/Text/Rect /Contentsz/Openz/Flags)r r rr rr )rrrrtext_objs a/var/www/html/content_generation/venv/lib/python3.12/site-packages/PyPDF2/generic/_annotations.pyrzAnnotationBuilder.textsu"$7#Z%9:& 7(;7#_T%:;')9$)?7#]4%88$l5&9    fontbolditalic font_size font_color border_colorbackground_colorc <d} |dur| dz} |dur| dz} | |zdz|z} | dz|z} d} t|D]} | t| zdz} | dz} t} | jt d t d t d t d t d t |t dt |t dt | t dt | t dtt|D cgc] } t| c} i| Scc} w)a Add text in a rectangle to a page. :param str text: Text to be added :param RectangleObject rect: or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]`` :param str font: Name of the Font, e.g. 'Helvetica' :param bool bold: Print the text in bold :param bool italic: Print the text in italic :param str font_size: How big the text will be, e.g. '14pt' :param str font_color: Hex-string for the color :param str border_color: Hex-string for the border color :param str background_color: Hex-string for the background of the annotation zfont: Tzbold zitalic  z;text-align:left;color:#rgrrrz /FreeTextr r!z/DSz/DAz/C) rstrr updater rr r r)rrr%r&r'r(r)r*r+font_str bg_color_strst free_textns r#r5zAnnotationBuilder.free_text:s24 4<')H T>)+Hd?S(9488:E \*B'#b'1C7L+#d* $& 7#Z%9:& ;(?7#_T%:;')9$)?5!#3H#=5!#3L#A4 +-78H-IJ-I[^-IJ#   Ks9D&p1p2 title_barc(ttdtdtdtdtdt|tdt|tdt t |dt |d t |dt |d gtd t td td gtd t t d t d t d gtdt|i}|S)a Draw a line on the PDF. :param Tuple[float, float] p1: First point :param Tuple[float, float] p2: Second point :param RectangleObject rect: or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]`` :param str text: Text to be displayed as the line annotation :param str title_bar: Text to be displayed in the title bar of the annotation; by convention this is the name of the author rrrz/Liner z/Tz/Lrrz/LEN/ICg?r!)r r rr r r)r7r8rrr9line_objs r#linezAnnotationBuilder.linets($7#Z%9:& 7(;7#_T%:4 "29"=4 +#BqE*#BqE*#BqE*#BqE* #5!;"4("4($ 5!;#C(#C(#C($;')9$)?5  <r$Ninteriour_colorc ttdtdtdtdtdt|i}|r7tt |Dcgc] }t |c}|td<|Scc}w)z Draw a rectangle on the PDF. :param RectangleObject rect: or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]`` rrrz/Squarer r;)r r rr rr)rr> square_objr6s r# rectanglezAnnotationBuilder.rectangles&7#Z%9:& 9(=7#_T%:   ,7)3O)DE)DAQ)DE-Jz%( )FsBborderurltarget_page_indexfitc Jddlm}|du}|du}|s |s td|r|rtd|d||`|ddDcgc] }t|} }t |dk(rFt |dDcgc] }t|c}} | j | ntd gdz} ttd td td td tdt|tdt | i} |rSttdtdtd tdtdt|i| td<|rCtt|t|j|jd} | | td<| Scc}wcc}w)a Add a link to the document. The link can either be an external link or an internal link. An external link requires the URL parameter. An internal link requires the target_page_index, fit, and fit args. :param RectangleObject rect: or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]`` :param border: if provided, an array describing border-drawing properties. See the PDF spec for details. No border will be drawn if this argument is omitted. - horizontal corner radius, - vertical corner radius, and - border width - Optionally: Dash :param str url: Link to a website (if you want to make an external link) :param int target_page_index: index of the page to which the link should go (if you want to make an internal link) :param Fit fit: Page fit or 'zoom' option. r)BorderArrayTypeNzHEither 'url' or 'target_page_index' have to be provided. Both were None.z=Either 'url' or 'target_page_index' have to be provided. url=z, target_page_index=rrrrz/Linkr z/Borderz/Sz/URIz/Actionz/A)rDrEfit_argsz/Dest) typesrG ValueErrorr lenr appendr r rr fit_typerJ) rrBrCrDrErG is_external is_internalr6 border_arr dash_patternlink_obj dest_deferreds r#linkzAnnotationBuilder.links@ ,o 't3 ;Z  ;OPSuThizh{|   17<A*Q-J<6{a*6!9+M9aJqM9+MN !!,/&q/*Q.J#7#Z%9:& 7(;7#_T%:9%{:'>    )9t$j&8w'I)>v&(8(=*HZ% & ,)56G)H%cll3 # M-:HZ( )C=+Ms F*F )Fr) HelveticaFF14pt000000rYffffff)r.r.)N)__name__ __module__ __qualname____doc__rKrr staticmethodrrrfloatr0boolintr rr5r=rrArr rrVr$r#rrse- OU5%+E%FFG   8 "$ (77OU5%+E%FFG77 7  7  7777 77r  1 %, 1 %, 1OU5%+E%FFG1 1  1  11f*.OU5%+E%FFG!# 4)-!+/ OOU5%+E%FFGO%Oc]O$C= O  O  OOr$rN)typingrrr_baserrr r r _data_structuresr r _fitrr _rectangler_utilsrrrcr$r#rjs/))<"'CCr$