hCddlmZmZmZmZmZddlmZddlm Z m Z m Z m Z m Z ddlmZmZddlmZmZddlmZdd lmZmZedZd eeeefd efd ZGd dZdS)) TYPE_CHECKINGListOptionalTupleUnion)AnnotationFlag) BooleanObject FloatObject NameObject NumberObjectTextStringObject) ArrayObjectDictionaryObject) DEFAULT_FITFit)RectangleObject) hex_to_rgblogger_warningverticesreturnc,|dd|dd}}|dd|dd}}|D]E\}}t||}t||}t||}t||}Ft||||f}|S)Nrr )minr)rx_miny_minx_maxy_maxxyrects V/var/www/html/Sam_Eipo/venv/lib/python3.11/site-packages/pypdf/generic/_annotations.py_get_bounding_rectangler#sA;q>8A;q>5EA;q>8A;q>5E1E1 E1 E1 E1  E5%7 8 8D KceZdZdZddlmZmZe d1dee e e e e e ffde de d ed ef d Ze d2de dee e e e e e ffde de de de de dee dee d efdZeeddddee e e e e e ffd edeede d ef dZe d3de e e fde e e fdee e e e e e ffde de d ef d Zed!ee e e fd efd"Ze d4dee e e e e e ffd#ee d efd$Zed%d&dee e e e e e ffd'ed(e d efd)Ze d4dee e e e e e ffd#ee d efd*Zed!ee e e fd efd+Zedddefdee e e e e e ffd,eed-ee d.eed/ed ef d0Z dS)5AnnotationBuildera@ 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. r)FitType ZoomArgTypeFrr!textopenflagsrctttdtdtdtdtdt|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 /Contents/Openz/Flags)rr rrr r)r!r)r*r+text_objs r"r)zAnnotationBuilder.text,s*$7##Z%9%9:&& 7(;(;7##_T%:%:;'')9$)?)?7##]4%8%88$$l5&9&9     r$ Helvetica14pt000000fffffffontbolditalic font_size font_color border_colorbackground_colorc d} |dur| d} |dur| d} | |d|} | d|} d} |rt|D] } | | d} | d} t} | td td td td td t |tdt |tdt | tdt | i|;ttdt di| td<|6tdt|D| td<| 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. Use ``None`` for no border. background_color: Hex-string for the background of the annotation, e.g. cdcdcd. Use ``None`` for transparent background. Returns: A dictionary object representing the annotation. zfont: Tzbold zitalic  z;text-align:left;color:#rgr-r.r/z /FreeTextr0r1z/DSz/DANz/Wrz/BSc,g|]}t|Sr .0ns r" z/AnnotationBuilder.free_text..sFFFAQFFFr$/C)rrupdater rrrr) r)r!r8r9r:r;r<r=r>font_strdefault_appearance_stringst free_texts r"rOzAnnotationBuilder.free_textMs@ 4<<")))H T>>"+++H222y22DD DD$&!  I .. P P/H,O",O,O,O))+D(H(H(H %$&& 7##Z%9%9:&& ;(?(?7##_T%:%:;'')9$)?)?5!!#3H#=#=5!!#34M#N#N    +;t$$l1oo,,Ij'' (  '*5FF4D)E)EFFF++Ij&& 'r$N)r+parentr*rPcttdtdtdtdtdt|tdt|tdt |i}|r> |j|td<n%#t $rtd tYnwxYw|S) a Add a popup to the document. Args: rect: Specifies the clickable rectangular area as `[xLL, yLL, xUR, yUR]` flags: 1 - invisible, 2 - hidden, 3 - print, 4 - no zoom, 5 - no rotate, 6 - no view, 7 - read only, 8 - locked, 9 - toggle no view, 10 - locked contents open: Whether the popup should be shown directly (default is False). parent: The contents of the popup. Create this via the AnnotationBuilder. Returns: A dictionary object representing the annotation. r-r.r/z/Popupr0r2z/Fz/Parentz0Unregistered Parent object : No Parent field set) rr rr rindirect_referenceAttributeErrorr__name__)r!r+rPr* popup_objs r"popupzAnnotationBuilder.popups4%7##Z%9%9:&& 8(<(<7##_T%:%:7##]4%8%84  ,u"5"5       393L *Y//00!   F  sB77CCrAp1p2 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. r-r.r/z/Liner0z/Tz/Lrr z/LEN/ICg?r1)rr rrrr )rWrXr!r)rYline_objs r"linezAnnotationBuilder.linesW.$7##Z%9%9:&& 7(;(;7##_T%:%:4  "29"="=4  +#BqE**#BqE**#BqE**#BqE** ##5!!;"4(("4(($$ 5!!;#C((#C((#C(($$;'')9$)?)?5   <r$rct|dkrtdg}|D]I\}}|t||t|Jt t dt dt dt dt dt |t dtt|i}|S) z Draw a polyline on the PDF. Args: vertices: Array specifying the vertices (x, y) coordinates of the poly-line. Returns: A dictionary object representing the annotation. r6A polygon needs at least 1 vertex with two coordinatesr-r.r/z /PolyLine /Verticesr0 len ValueErrorappendrrr rrr#)r coord_listrr polyline_objs r"polylinezAnnotationBuilder.polylines x==A  UVV V  / /DAq   l1oo . . .   l1oo . . . .'7##Z%9%9:&& ;(?(?;''Z)@)@7##_5LX5V5V%W%W    r$interiour_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. r-r.r/z/Squarer0c,g|]}t|SrDrErFs r"rIz/AnnotationBuilder.rectangle..5EEEAQEEEr$r[rr rrr)r!rh square_objs r" rectanglezAnnotationBuilder.rectangles&&7##Z%9%9:&& 9(=(=7##_T%:%:     ,7EEO)D)DEEE--Jz%(( )r$ff0000)highlight_color quad_pointsrpcPttdtdtdtdtdt|td|tdtdt |Di}|S) a Add a highlight annotation to the document. Args: rect: Array of four integers ``[xLL, yLL, xUR, yUR]`` specifying the highlighted area quad_points: An ArrayObject of 8 FloatObjects. Must match a word or a group of words, otherwise no highlight will be shown. highlight_color: The color used for the hightlight Returns: A dictionary object representing the annotation. r-r.r/z /Highlightr0z /QuadPointsrJc,g|]}t|SrDrErFs r"rIz/AnnotationBuilder.highlight..UsIII[^^IIIr$rl)r!rqrpobjs r" highlightzAnnotationBuilder.highlight:s(7##Z%9%9:&& <(@(@7##_T%:%:=));4  +IIZ-H-HIII##      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. r-r.r/z/Circler0c,g|]}t|SrDrErFs r"rIz-AnnotationBuilder.ellipse..xrkr$r[rl)r!rh ellipse_objs r"ellipsezAnnotationBuilder.ellipse[s&'7##Z%9%9:&& 9(=(=7##_T%:%:     -8EEO)D)DEEE..K 5)) *r$c6t|dkrtdg}|D]I\}}|t||t|Jt t dt dt dt dt dt |t dt d t d tt|i}|S) Nrr_r-r.r/z/Polygonr`z/IT PolygonCloudr0ra)rrerr rts r"polygonzAnnotationBuilder.polygon}s x==A  UVV V  / /DAq   l1oo . . .   l1oo . . . .7##Z%9%9:&& :(>(>;''Z)@)@5!!:n#=#=7##_5LX5V5V%W%W     r$borderurltarget_page_indexfitc trddlm}|du}|du}|s|std|r|rtd|d||\d|ddD}t |d kr4t d |dD} || ntd 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|SrDr rFs r"rIz*AnnotationBuilder.link..s<<.s+M+M+MaJqMM+M+M+Mr$rr-r.r/z/Linkr0z/Borderz/Sz/URIz/Actionz/A)rrfit_argsz/Dest)rtypesrrcrbrrdrrr rrfit_typer) r!r}r~rrr is_external is_internal border_arr dash_patternlink_obj dest_deferreds r"linkzAnnotationBuilder.linksFD  0 / / / / / /o 't3  ; Z   ; DDD0ADD   <<<<'>      )9t$$j&8&8w''I)>)>v&&(8(=(=**HZ%% &  :,)56G)H)H%cl33 # M-:HZ(( )r$)Fr)r4FFr5r6r6r7)rArA)N)!rT __module__ __qualname____doc__rr'r( staticmethodrrrfloatstrboolintrr)rrONO_FLAGSr rVr]rrgrnrruryr|rrrrDr$r"r&r&s-,,,,,,, OU5%+E%FFG   \@ "&.*2EEEOU5%+E%FFGEE E  E  EEsmE#3-E EEE\EN!)-1 ,,,OU5%+E%FFG,,)* ,  ,  ,,,\,\  44 %, 4 %, 4OU5%+E%FFG4 4  4  444\4luUE\*+ \8*.OU5%+E%FFG!# \B ( OU5%+E%FFG!   \@*.OU5%+E%FFG!# \B$uUE\238H\&)-!+/ SSOU5%+E%FFGS%Sc]S$C= S  S  SSS\SSSr$r&N)typingrrrrr constantsr _baser r r rr_data_structuresrr_fitrr _rectangler_utilsrrrrr#r&rDr$r"rs^>>>>>>>>>>>>>>&&&&&&<;;;;;;;""""""""''''''........ >!   d5+>&? O    FFFFFFFFFFr$