:Qg*tddlmZmZmZddlmZmZmZmZm Z m Z ddl m Z m Z ddlmZddlmZGddZy ) )OptionalTupleUnion) BooleanObject FloatObject NameObject NullObject NumberObjectTextStringObject) ArrayObjectDictionaryObject)RectangleObject) hex_to_rgbceZdZdZddlmZmZe d!dee e e e e e ffde de dedef d Ze d"de 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 defdZeddddefdee e e e e e ffdeedee deedede edfdefd Zy)%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)rr rr rr )rrrrtext_objs X/var/www/html/answerous/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 /FreeTextrr z/DSz/DAz/C) rstrrupdater rr r r)rrr$r%r&r'r(r)r*font_str bg_color_strst free_textns r"r4zAnnotationBuilder.free_text:s14 4<')H T>)+Hd?S(9488:E \* 8B'#b'1C7L 8#d* $& 7#Z%9:& ;(?7#_T%:;')9$)?5!#3H#=5!#3L#A4 +-78H-IJ[^J#   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/Linerz/Tz/Lrrz/LEN/ICg?r )rr rr r r)r6r7rrr8line_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/Squarerr:)rr rr rr)rr= square_objr5s r" rectanglezAnnotationBuilder.rectangles~&7#Z%9:& 9(=7#_T%:   ,7)3O)DEAQE-Jz%( )FsBz/Fitborderurltarget_page_indexfitfit_args.c ddlm}|du}|du}|s |s td|r|rtd|d||`|ddD cgc] } t| } } t |dk(rFt |dD cgc] } t| c} } | j | ntd gdz} ttd td td td tdt|tdt | i} |rSttdtdtd tdtdt|i| td<|r\|D cgc]} | tn t| }} tt|t|t |d}|| td<| Scc} wcc} 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 str fit: Page fit or 'zoom' option (see below). Additional arguments may need to be supplied. Passing ``None`` will be read as a null value for that coordinate. :param Tuple[int, ...] fit_args: Parameters for the fit argument. .. list-table:: Valid ``fit`` arguments (see Table 8.2 of the PDF 1.7 reference for details) :widths: 50 200 * - /Fit - No additional arguments * - /XYZ - [left] [top] [zoomFactor] * - /FitH - [top] * - /FitV - [left] * - /FitR - [left] [bottom] [right] [top] * - /FitB - No additional arguments * - /FitBH - [top] * - /FitBV - [left] 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/Linkrz/Borderz/Sz/URIz/Actionz/A)rCrDrEz/Dest) typesrG ValueErrorr lenr appendr rrr r )rrArBrCrDrErG is_external is_internalr5 border_arr dash_patternlink_obja fit_arg_ready dest_deferreds r"linkzAnnotationBuilder.linksp ,o 't3 ;Z  ;OPSuThizh{|   17    )9t$j&8w'I)>v&(8(=*HZ% & HPCD |A>M-)56G)H%c? +M :M-:HZ( )I=+M,sF4*F9F>)Fr) HelveticaFF14pt000000rYffffff)r-r-)N)__name__ __module__ __qualname____doc__rJrr staticmethodrrrfloatr/boolintrrr4r<rr@tupler rVr#r"rrs- OU5%+E%FFG   8 "$ (77OU5%+E%FFG77 7  7  7777 77r  1 %, 1 %, 1OU5%+E%FFG1 1  1  11f*.OU5%+E%FFG!# 4)-!+/,1G jOU5%+E%FFGj%jc]j$C= j  j  S() j jjr#rN)typingrrr_baserrr r r r _data_structuresr r _rectangler_utilsrrrdr#r"rjs,))<'^^r#