U c1@s~ddlmZmZmZmZddlmZmZmZm Z m Z ddl m Z m Z ddlmZmZddlmZddlmZGdd d Zd S) )ListOptionalTupleUnion) BooleanObject FloatObject NameObject NumberObjectTextStringObject) ArrayObjectDictionaryObject) DEFAULT_FITFit)RectangleObject) hex_to_rgbc @seZdZdZddlmZmZed ee e e e e e ffe e eedddZed!e ee e e e e e ffe e e e e e e ed ddZed"e e e fe e e fee e e e e e ffe e edddZed#ee e e e e e ffee edddZed$ee e e e e e ffee edddZeee e e fedddZedddefee e e e e e ffeeee eeeedddZdS)%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 ZoomArgTypeFr)recttextopenflagsreturncCsTttdtdtdtdtdt|tdt|tdt|tdt|i}|S) a^ Add text annotation. Args: rect: array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the clickable rectangular area text: The text that is added to the document open: flags: Returns: A dictionary object representing the annotation. /Type/Annot/Subtypez/Text/Rect /Contentsz/Openz/Flags)r r rr rr )rrrrZtext_objr >/tmp/pip-unpacked-wheel-u_n6aelj/pypdf/generic/_annotations.pyrs  zAnnotationBuilder.text Helvetica14pt000000ffffff) rrfontbolditalic font_size font_color border_colorbackground_colorrc Csd} |dkr| d} |dkr(| d} | |d|} | d|} d} t|D]} | | d} qT| d} t} | td td td td td t|tdt|tdt| tdt| tdtddt|Di| S)a Add text in a rectangle to a page. Args: text: Text to be added rect: array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the clickable rectangular area font: Name of the Font, e.g. 'Helvetica' bold: Print the text in bold italic: Print the text in italic font_size: How big the text will be, e.g. '14pt' font_color: Hex-string for the color, e.g. cdcdcd border_color: Hex-string for the border color, e.g. cdcdcd background_color: Hex-string for the background of the annotation, e.g. cdcdcd Returns: A dictionary object representing the annotation. zfont: Tzbold zitalic  z;text-align:left;color:#Zrgrrrz /FreeTextrrz/DSz/DAz/CcSsg|] }t|qSr r.0nr r r! wsz/AnnotationBuilder.free_text..)rr updater rr r ) rrr&r'r(r)r*r+r,Zfont_strZ bg_color_strst free_textr r r!r6>s@    zAnnotationBuilder.free_textr.)p1p2rr title_barrcCsttdtdtdtdtdt|tdt|tdtt|dt|d t|dt|d gtd ttd td gtd ttd td td gtdt|i}|S)a Draw a line on the PDF. Args: p1: First point p2: Second point rect: array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the clickable rectangular area text: Text to be displayed as the line annotation title_bar: Text to be displayed in the title bar of the annotation; by convention this is the name of the author Returns: A dictionary object representing the annotation. rrrz/Linerz/Tz/Lrrz/LEN/ICg?r)r r rr r r)r7r8rrr9Zline_objr r r!line}sF    zAnnotationBuilder.lineN)rinteriour_colorrcCsRttdtdtdtdtdt|i}|rNtddt|D|td<|S) a Draw a rectangle on the PDF. This method uses the /Square annotation type of the PDF format. Args: rect: array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the clickable rectangular area interiour_color: None or hex-string for the color, e.g. cdcdcd If None is used, the interiour is transparent. Returns: A dictionary object representing the annotation. rrrz/SquarercSsg|] }t|qSr r/r0r r r!r3sz/AnnotationBuilder.rectangle..r:r r rr r)rr<Z square_objr r r! rectangles zAnnotationBuilder.rectanglecCsRttdtdtdtdtdt|i}|rNtddt|D|td<|S) a Draw a rectangle on the PDF. This method uses the /Circle annotation type of the PDF format. Args: rect: array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the bounding box of the ellipse interiour_color: None or hex-string for the color, e.g. cdcdcd If None is used, the interiour is transparent. Returns: A dictionary object representing the annotation. rrrz/CirclercSsg|] }t|qSr r/r0r r r!r3sz-AnnotationBuilder.ellipse..r:r=)rr<Z ellipse_objr r r!ellipses zAnnotationBuilder.ellipse)verticesrc Cst|dkrtd|dd|dd}}|dd|dd}}|D]0\}}t||}t||}t||}t||}qLt||||f}g}|D]$\}}|t||t|qttdtdtdtdtdt|td td td t|i} | S) Nrz6A polygon needs at least 1 vertex with two coordinatesrrrrz/Polygonz /Verticesz/ITZ PolygonCloudr) len ValueErrorminrappendr r r r ) r@Zx_minZy_minZx_maxZy_maxxyrZ coord_listobjr r r!polygons8        zAnnotationBuilder.polygon)rborderurltarget_page_indexfitrc CsFddlm}|dk }|dk }|s,|s,td|rH|rHtd|d||dk rdd|dd D}t|d krtd d|d D} || ntd gd }ttd tdtdtdtdt |tdt|i} |rttdtdtd tdtdt |i| td<|rBtt|t|j |j 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. Args: rect: array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the clickable rectangular area 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 url: Link to a website (if you want to make an external link) target_page_index: index of the page to which the link should go (if you want to make an internal link) fit: Page fit or 'zoom' option. Returns: A dictionary object representing the annotation. 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=cSsg|] }t|qSr r r0r r r!r3Esz*AnnotationBuilder.link..cSsg|] }t|qSr rNr0r r r!r3Gsrrrrz/Linkrz/Borderz/Sz/URIz/Actionz/A)rKrLfit_argsz/Dest) typesrMrBrAr rDr r r rr Zfit_typerQ) rrIrJrKrLrMZ is_externalZ is_internalZ border_arrZ dash_patternZlink_objZ dest_deferredr r r!links^"     zAnnotationBuilder.link)Fr)r"FFr#r$r$r%)r.r.)N)N)__name__ __module__ __qualname____doc__rRrr staticmethodrrrfloatstrboolintr rr6r;rr>r?rrHrr rrSr r r r!rs  >  6!!rN)typingrrrr_baserrr r r Z_data_structuresr r Z_fitrrZ _rectangler_utilsrrr r r r!s