Kh; dZdZdZddlmZmZmZmZmZddl m Z m Z ddl m Z dd lmZmZmZmZmZmZmZmZmZmZdd lmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'm(Z(dd l)m*Z*ddl m+Z+m,Z,m-Z-m.Z.m/Z/ddl0m1Z1de dedfdZ2 dde dede3ee3ee4e3ffdedfdZ5 ddee3e6fdede3ee3ee4e3ffdeeeffdZ7e%j8Z9GddZ:gdZ;dS)zHImplementation of generic PDF objects (dictionary, number, string, ...).zMathieu Fenniakzbiziqe@mathieu.fenniak.net)DictListOptionalTupleUnion) StreamTypedeprecate_with_replacement)OutlineFontFlag) BooleanObjectByteStringObject FloatObjectIndirectObject NameObject NullObject NumberObject PdfObjectTextStringObjectencode_pdfdocencoding) ArrayObject ContentStreamDecodedStreamObject DestinationDictionaryObjectEncodedStreamObjectField StreamObject TreeObject read_object)Fit)Bookmark OutlineItemRectangleObject)create_string_objectdecode_pdfdocencoding hex_to_rgbread_hex_string_from_streamread_string_from_stream)ViewerPreferencesstreamreturn)rrcBtdddt|S)z,Deprecated, use read_hex_string_from_stream.readHexStringFromStreamr)4.0.0)r r))r,s ^/var/www/html/services/rag-service/venv/lib/python3.11/site-packages/pypdf/generic/__init__.pyr/r/Is.!#@' 'v . ..Nforced_encodingcDtdddt||S)z(Deprecated, use read_string_from_stream.readStringFromStreamr*r0)r r*)r,r3s r1r5r5Ss0  97 #6? ; ;;r2stringcDtdddt||S)z%Deprecated, use create_string_object.createStringObjectr&r0)r r&)r6r3s r1r8r8^s( 35KWUUU  8 88r2ceZdZdZddlmZe d3deeee e e e ffde de d e d e f d Ze d4de deeee e e e ffde de de de de dee dee d e fdZedddddeeee e e e ffd e dee de d e f dZe d5dee e fdee e fdeeee e e e ffde dee d e f d Zed!eee e fd e fd"Ze d6deeee e e e ffd#ee d e fd$Zed%d&deeee e e e ffd'ed(e d e fd)Ze d6deeee e e e ffd#ee d e fd*Zed!eee e fd e fd+Zd,d-lmZedddefdeeee e e e ffd.eed/ee d0ee d1ed e f d2ZdS)7AnnotationBuilderz The AnnotationBuilder is deprecated. Instead, use the annotation classes in pypdf.annotations. See `adding PDF annotations <../user/adding-pdf-annotations.html>`_ for it's usage combined with PdfWriter. rr$Frrecttextopenflagsr-cNtdddddlm}|||||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. zAnnotationBuilder.textzpypdf.annotations.Textr0r)Text)r;r<r=r>)r annotationsr@)r;r<r=r>r@s r1r<zAnnotationBuilder.textvsK( # $&>    '&&&&&tDt5AAAAr2 Helvetica14pt000000fffffffontbolditalic font_size font_color border_colorbackground_colorc Xtdddddlm} | ||||||||| 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. zAnnotationBuilder.free_textzpypdf.annotations.FreeTextr0r)FreeText) r<r;rFrGrHrIrJrLrK)r rArN) r<r;rFrGrHrIrJrKrLrNs r1 free_textzAnnotationBuilder.free_textsg@ # )+G    +*****x!-%    r2N)r>parentr=rPc^tdddddlm}||||}||_|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. zAnnotationBuilder.popupzpypdf.annotations.Popupr0r)Popup)r;r=rP)r rArRr>)r;r>rPr=rRpopups r1rSzAnnotationBuilder.popupsT4 # %'@'    ('''''4d6:::  r2p1p2 title_barcPtdddddlm}||||||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. zAnnotationBuilder.linezpypdf.annotations.Liner0r)Line)rUrVr;r<rW)r rArY)rUrVr;r<rWrYs r1linezAnnotationBuilder.linesM. # $&>    '&&&&&trbt$)LLLLr2verticescHtdddddlm}||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. zAnnotationBuilder.polylinezpypdf.annotations.PolyLiner0r)PolyLiner[)r rAr])r[r]s r1polylinezAnnotationBuilder.polylinesE # (*F    +*****x****r2interiour_colorcJtdddddlm}|||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. zAnnotationBuilder.rectanglezpypdf.annotations.Rectangler0r) Rectangler;r`)r rArb)r;r`rbs r1 rectanglezAnnotationBuilder.rectanglesG& # )+H'    ,+++++ydODDDDr2ff0000)highlight_color quad_pointsrfcLtdddddlm}||||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. zAnnotationBuilder.highlightzpypdf.annotations.Highlightr0r) Highlight)r;rgrf)r rAri)r;rgrfris r1 highlightzAnnotationBuilder.highlight2sR( # )+H'    ,+++++y;    r2cJtdddddlm}|||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. zAnnotationBuilder.ellipsezpypdf.annotations.Ellipser0r)Ellipserc)r rArl)r;r`rls r1ellipsezAnnotationBuilder.ellipseOsG& # ')Dg    *)))))wD/BBBBr2cHtdddddlm}||S)NzAnnotationBuilder.polygonzpypdf.annotations.Polygonr0r)Polygonr^)r rAro)r[ros r1polygonzAnnotationBuilder.polygonisC" ')Dg    *)))))w))))r2r ) DEFAULT_FITborderurltarget_page_indexfitcPtdddddlm}||||||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. zAnnotationBuilder.linkzpypdf.annotations.Linkr0r)Link)r;rrrsrtru)r rArw)r;rrrsrtrurws r1linkzAnnotationBuilder.linkts[D # $&>    '&&&&&t/     r2)Fr)rBFFrCrDrDrE)rTNN)__name__ __module__ __qualname____doc__generic._rectangler% staticmethodrrfloatstrboolintrr<rrOrSrZrr_rdrrjrmrp_fitrqr!rxr2r1r:r:js544444 BBOU5%+E%FFGBBB B  BBB\B4 "&.*2. . . OU5%+E%FFG. .  .  .  . . sm. #3-.  . . . \. `-1 !!!OU5%+E%FFG!!)* !  !  !!!\!F #' MM %, M %, MOU5%+E%FFGM M C= M  MMM\M:+uUE\*++ +++\+&*.EEOU5%+E%FFGE!#E EEE\E2 (    OU5%+E%FFG !       \ 8*.CCOU5%+E%FFGC!#C CCC\C2*$uUE\23*8H***\*"!!!!!)-!+/ , , OU5%+E%FFG, %, c], $C= ,  ,  , , , \, , , r2r:)!r rrrrrrrrr:r!PAGE_FITrrrrrrrr%rrr+r#r r"r r&rr'r(r)r*ry)rs78ON  /55555555555555;;;;;;;;''''''                                                ++++++++''''''+*****/ / 12////DH<< <4d3ic3h?@< 12<<<<DH99 #u* 94d3ic3h?@9 - -.9999 3799w w w w w w w w t * * * r2