;]e1ddlmZmZmZmZddlmZmZmZm Z m Z ddl m Z m Z ddlmZmZddlmZddlmZGdd Zd S) )ListOptionalTupleUnion) BooleanObject FloatObject NameObject NumberObjectTextStringObject) ArrayObjectDictionaryObject) DEFAULT_FITFit)RectangleObject) hex_to_rgbceZdZdZddlmZmZe d(dee e e e e e ffde de d ed ef d Ze d)de dee e e e e e ffde de de de de de de d efdZe d*de e e fde e e fdee e e e e e ffde de d ef dZe d+dee e e e e e ffdee d efdZe d+dee e e e e e ffdee d efd Zed!ee e e fd efd"Zedddefdee e e e e e ffd#eed$ee d%eed&ed ef d'ZdS),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 ZoomArgTypeFrrecttextopenflagsreturnctttdtdtdtdtdt|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)rr rr rr )rrrrtext_objs z/AnnotationBuilder.free_text..wsJJJ[^^JJJr%)rrupdater rr r ) rrr*r+r,r-r.r/r0font_str bg_color_strst free_texts r$r@zAnnotationBuilder.free_text>s> 4<<")))H T>>"+++H222y22DD DD \** 2 2B*1B111LL&*** $&& 7##Z%9%9:&& ;(?(?7##_T%:%:;'')9$)?)?5!!#3H#=#=5!!#3L#A#A4  +JJZ8H-I-IJJJ##    r%r3p1p2 title_barcttdtdtdtdtdt|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. 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. rrr z/Liner!z/Tz/Lrrz/LEN/ICg?r")rr rr r r )rArBrrrCline_objs r$linezAnnotationBuilder.line}sW.$7##Z%9%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}|r6tdt |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. rrr z/Squarer!c,g|]}t|Sr6r7r8s r$r;z/AnnotationBuilder.rectangle..EEEAQEEEr%rErr rr r)rrH square_objs r$ rectanglezAnnotationBuilder.rectangles&&7##Z%9%9:&& 9(=(=7##_T%:%:     ,7EEO)D)DEEE--Jz%(( )r%c <ttdtdtdtdtdt|i}|r6tdt |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. rrr z/Circler!c,g|]}t|Sr6r7r8s r$r;z-AnnotationBuilder.ellipse..rKr%rErL)rrH ellipse_objs r$ellipsezAnnotationBuilder.ellipses&'7##Z%9%9:&& 9(=(=7##_T%:%:     -8EEO)D)DEEE..K 5)) *r%verticescBt|dkrtd|dd|dd}}|dd|dd}}|D]E\}}t||}t||}t||}t||}Ft||||f}g}|D]I\}}|t ||t |Jt tdtdtdtdtdt|td td td t|i} | S) Nrz6A polygon needs at least 1 vertex with two coordinatesrrrr z/Polygonz /Verticesz/IT PolygonCloudr!) len ValueErrorminrappendr rr r ) rSx_miny_minx_maxy_maxxyr coord_listobjs r$polygonzAnnotationBuilder.polygons x==A  UVV V{1~x{1~u{1~x{1~u " "DAqqMMEqMMEqMMEqMMEEueU;<<  / /DAq   l1oo . . .   l1oo . . . .7##Z%9%9:&& :(>(>;''Z)@)@5!!:n#=#=7##_T%:%:     r%borderurltarget_page_indexfitc ddlm}|du}|du}|s|std|r|rtd|d||\d|ddD}t|d kr4t d |dD} || nt d gdz}ttd td tdtdtdt|tdt |i} |rsttdtdtd tdtdt|i| td<|rItt |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=c,g|]}t|Sr6r r8s r$r;z*AnnotationBuilder.link..Es<<.Gs+M+M+MaJqMM+M+M+Mr%rrrr z/Linkr!z/Borderz/Sz/URIz/Actionz/A)rerffit_argsz/Dest) typesrhrWrVr rYr rr rr fit_typern) rrcrdrerfrh is_external is_internal border_arr dash_patternlink_obj dest_deferreds r$linkzAnnotationBuilder.links>D ,+++++o 't3  ; Z   ; DDD0ADD   <<<<'>      )9t$$j&8&8w''I)>)>v&&(8(=(=**HZ%% &  :,)56G)H)H%cl33 # M-:HZ(( )r%)Fr)r&FFr'r(r(r))r3r3)N)__name__ __module__ __qualname____doc__rorr staticmethodrrrfloatstrboolintrrr@rGrrNrRrrbrr rrwr6r%r$rrs-,,,,,,, OU5%+E%FFG   \@ "$ (<<<OU5%+E%FFG<< <  <  <<<< <<<\<|  44 %, 4 %, 4OU5%+E%FFG4 4  4  444\4l*.OU5%+E%FFG!# \B*.OU5%+E%FFG!# \B$uUE\238H\4)-!+/ RROU5%+E%FFGR%Rc]R$C= R  R  RRR\RRRr%rN)typingrrrr_baserr r r r _data_structuresr r_fitrr _rectangler_utilsrrr6r%r$rs////////////<;;;;;;;""""""""''''''VVVVVVVVVVr%