o e'@snddlmZmZmZddlmZmZmZmZm Z m Z ddl m Z m Z ddlmZddlmZGdddZd S) )OptionalTupleUnion) BooleanObject FloatObject NameObject NullObject NumberObjectTextStringObject) ArrayObjectDictionaryObject)RectangleObject) hex_to_rgbc@sfeZdZdZddlmZmZe  d*dee e e e e e ffde de d ed ef d d Ze      d+de dee e e e e e ffde de de de de de de d efddZe  d,de e e fde e e fdee e e e e e ffde de d ef ddZed d d d!efdee e e e e e ffd"eed#ee d$eed%ed&e ed'fd efd(d)Zd S)-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 ZoomArgTypeFrrecttextopenflagsreturncCsTttdtdtdtdtdt|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 rrr rr )rrrrZtext_objrKD:\Projects\ConvertPro\env\Lib\site-packages\PyPDF2/generic/_annotations.pyrs       zAnnotationBuilder.text Helvetica14pt000000fffffffontbolditalic font_size font_color border_colorbackground_colorc Csd} |dur | d} |dur| d} | |d|} | d|} d} t|D] } | t| d} q&| d} t} | td td td td td t|tdt|tdt| tdt| tdtddt|Di| S)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:#Zrgrrrz /FreeTextrrz/DSz/DAz/CcSg|]}t|qSr)r.0nrrr nz/AnnotationBuilder.free_text..)rstrr updaterrr r ) rrr$r%r&r'r(r)r*Zfont_strZ bg_color_strst free_textrrrr6:s2        zAnnotationBuilder.free_textr,p1p2 title_barcCsttdtdtdtdtdt|tdt|tdtt|dt|d t|dt|d gtd ttd td gtd ttd td td 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/LENz/ICg?r)r rrr r r)r7r8rrr9Zline_objrrrlinets6         zAnnotationBuilder.lineNz/Fitborderurltarget_page_indexfitfit_args.c CsPddlm}|du}|du}|s|std|r$|r$td|d||durJdd|dd D} t|d krItd d|d D} | | ntd gd } ttd tdtdtdtdt |tdt| i} |rttdtdtd tdtdt |i| td<|rdd|D} tt|t|t| d} | | td<| S)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=cSr-rrr.rrrr1r2z*AnnotationBuilder.link..cSr-rrAr.rrrr1r2rrrrz/Linkrz/Borderz/Sz/URIz/Actionz/AcSs"g|] }|dur tnt|qS)N)r r )r/arrrr1s)r=r>r?z/Dest) typesr@ ValueErrorlenr appendr r rrr )rr;r<r=r>r?r@Z is_externalZ is_internalZ border_arrZ dash_patternZlink_objZ fit_arg_readyZ dest_deferredrrrlinksX 8           zAnnotationBuilder.link)Fr)r FFr!r"r"r#)r,r,)__name__ __module__ __qualname____doc__rErr staticmethodrrrfloatr3boolintr rr6r:tuplerr rIrrrrrs    9   3 rN)typingrrr_baserrrr r r Z_data_structuresr r Z _rectangler_utilsrrrrrrs