h1SrSSKrSSKrSSKrSSKJr SSKJr SSK J r SSK J r \Rr\R"\5r"SS\ R$5r"SS\ R$5rg) ) PdfTextPagePdfTextSearcherN) PdfiumError) PDFIUM_INFOc^\rSrSrSrU4Sjr\S5rSSjrSSjr SSjr Sr SS jr S r SS jrS rSS jrSrU=r$)rz Text page helper class. Attributes: raw (FPDF_TEXTPAGE): The underlying PDFium textpage handle. page (PdfPage): Reference to the page this textpage belongs to. cX>XlX l[TU] [R 5 gN)rawpagesuper__init__pdfium_cFPDFText_ClosePage)selfr r __class__s S/var/www/html/shao/venv/lib/python3.13/site-packages/pypdfium2/_helpers/textpage.pyrPdfTextPage.__init__s   445cUR$r )r rs rparentPdfTextPage.parent!s yyrcX:ag[R"X5nUS:XaURUS-X#S-U5$[R"X5nUS:XaURXS- X4S-5$XVX44$)Nr)r"FPDFText_GetTextIndexFromCharIndex_get_active_text_range)rc_startc_end l_passive r_passivet_startt_ends rr"PdfTextPage._get_active_text_range&s| ?==dL b=..wqy%1iX X;;DH B;..waVWKX Xy33rcX4S:Xa,U(d%[R"S5 URUS9$US:XaUR5U- nUR XU-S- 5nUS:XagUupgpX- nX(U --nUS-U- n S[ R s=:aS :aO OU S -n U S- n [R"U S -5n [R"U [R"[R55n [R"XX,5n X:d S U S U 35eU RS U S- S -RSUS9$)a- Warning: .. versionchanged:: 4.28 For various reasons, calling this method with default params now implicitly translates to :meth:`.get_text_bounded` (pass ``force_this=True`` to circumvent). Extract text from a given range. Parameters: index (int): Index of the first char to include. count (int): Number of chars to cover, relative to the internal char list. Defaults to -1 for all remaining chars after *index*. errors (str): Error handling when decoding the data (see :meth:`bytes.decode`). Returns: str: The text in the range in question, or an empty string if no text was found. Note: * The returned text's length does not have to match *count*, even if it will for most PDFs. This is because the underlying API may exclude/insert chars compared to the internal list, although rare in practice. This means, if the char at ``i`` is excluded, ``get_text_range(i, 2)[1]`` will raise an index error. Pdfium provides raw APIs ``FPDFText_GetTextIndexFromCharIndex()`` / ``FPDFText_GetCharIndexFromTextIndex()`` to translate between the two views and identify excluded/inserted chars. * In case of leading/trailing excluded characters, pypdfium2 modifies *index* and *count* accordingly to prevent pdfium from unexpectedly reading beyond ``range(index, index+count)``. rrz]get_text_range() call with default params will be implicitly redirected to get_text_bounded()errorsrrriizBuffer too small: z vs N utf-16-le)warningswarnget_text_bounded count_charsrrbuildctypescreate_string_buffercastPOINTERc_ushortrFPDFText_GetTextr decode)rindexcountr) force_this active_ranger#r$r!r"in_countbuffer buffer_ptr out_counts rget_text_rangePdfTextPage.get_text_range6sR2 >W $Z MMy z(((7 7 B;$$&.E225+a-H 1 0<,   Y&&7W$ +## *d * MHA ,,X\:[[)HI --d5M $T(:8*D &TT$zz*IaK?+22;v2NNrcURR5nUcUSnUcUSnUcUSnUcUSnXXCU4n[R"/UQSPSP76nUS::ag[R "US-5n [R "U [R"[R55n [R"/UQU PUP76 U RRSUS9$) a^ Extract text from given boundaries in PDF coordinates. If a boundary value is None, it defaults to the corresponding value of :meth:`.PdfPage.get_bbox`. Parameters: errors (str): Error treatment when decoding the data (see :meth:`bytes.decode`). Returns: str: The text on the page area in question, or an empty string if no text was found. Nrrr+r*r,r() r get_bboxrFPDFText_GetBoundedTextr2r3r4r5r6r r8) rleftbottomrighttopr)bboxargsn_charsr>r?s rr/PdfTextPage.get_text_boundedqsyy!!# <7D >!WF =GE ;q'CC/22BDB$BB a<,,Wq[9[[)HI ((D$D DGDzz  V < Returns: int: The number of characters on the text page. rzFailed to get character count.)rFPDFText_CountCharsr)rrMs rr0PdfTextPage.count_charss, ..t4 b=>? ?rcV[R"XU5nUS:Xa [S5eU$)z Parameters: index (int): Start character index. count (int): Character count to consider (defaults to -1 for all remaining). Returns: int: The number of text rectangles in the given character range. rzFailed to count rectangles.)rFPDFText_CountRectsr)rr9r:n_rectss r count_rectsPdfTextPage.count_rectss...tEB b=;< <rcD[R"XX#U5nUS:agU$)av Get the index of a character by position. Parameters: x (float): Horizontal position (in PDF canvas units). y (float): Vertical position. x_tol (float): Horizontal tolerance. y_tol (float): Vertical tolerance. Returns: int | None: The index of the character at or nearby the point (x, y). May be None if there is no character or an error occurred. rN)rFPDFText_GetCharIndexAtPos)rxyx_toly_tolr9s r get_indexPdfTextPage.get_indexs'33DQuM 19 rcU(a^[R"5n[R"XU5nURURUR UR 4upVpxOr[5[5[5[54upVpx[R"XXWXh5nURURURUR4upVpxU(d [S5eXVXx4$)a Get the bounding box of a single character. Parameters: index (int): Index of the character to work with, in the page's character array. loose (bool): Get a more comprehensive box covering the entire font bounds, as opposed to the default tight box specific to the one character. Returns: Float values for left, bottom, right and top in PDF canvas units. zFailed to get charbox.) rFS_RECTFFPDFText_GetLooseCharBoxrGrHrIrJc_doubleFPDFText_GetCharBoxvaluer) rr9looserectoklbrts r get_charboxPdfTextPage.get_charboxs $$&D224EBDKKTXXEJA!Q!XZXZGJA!--d1FB!''177AGG;JA!67 7Qzrc[5[5[5[54up#pE[R"XX%XC5nU(d [S5eURURURUR4$)a4 Get the bounding box of a text rectangle at the given index. Note that :meth:`.count_rects` must be called once with default parameters before subsequent :meth:`.get_rect` calls for this function to work (due to PDFium's API). Returns: Float values for left, bottom, right and top in PDF canvas units. zzFailed to get rectangle. (Make sure count_rects() was called with default params once before subsequent get_rect() calls.))rbrFPDFText_GetRectrrd)rr9rhrirjrkrgs rget_rectPdfTextPage.get_rectsiZXZC a  & &tA! ?[\ \!''17733rc[U5S:Xa [S5eSnU(aU[R-nU(aU[R-nU(aU[R -nUS-R S5n[R"U[R"[R55n[R"XXb5n [X5n URU 5 U $)a Locate text on the page. Parameters: text (str): The string to search for. index (int): Character index at which to start searching. match_case (bool): If True, the search will be case-specific (upper and lower letters treated as different characters). match_whole_word (bool): If True, substring occurrences will be ignored (e. g. `cat` would not match `category`). consecutive (bool): If False (the default), :meth:`.search` will skip past the current match to look for the next match. If True, parts of the previous match may be caught again (e. g. searching for `aa` in `aaaa` would match 3 rather than 2 times). Returns: PdfTextSearcher: A helper object to search text. rz#Text length must be greater than 0.r,)len ValueErrorrFPDF_MATCHCASEFPDF_MATCHWHOLEWORDFPDF_CONSECUTIVEencoder2r4r5r6FPDFText_FindStartr_add_kid) rtextr9 match_casematch_whole_word consecutiveflagsenc_text enc_text_ptr raw_searchersearchers rsearchPdfTextPage.searchs( t9>BC C  X,, ,E  X11 1E  X.. .E6M))+6{{8V^^FOO-LM 224uT "<6 hr)r r )rr)rrignoreF)NNNNrr')F)rFFF)__name__ __module__ __qualname____firstlineno____doc__rpropertyrrrAr/r0rUr]rlrpr__static_attributes__ __classcell__rs@rrrsV6  4 8Ov=@ &8 4 $$rrcN^\rSrSrSrU4Sjr\S5rSrSr Sr Sr U=r $) riz Text searcher helper class. Attributes: raw (FPDF_SCHHANDLE): The underlying PDFium searcher handle. textpage (PdfTextPage): Reference to the textpage this searcher belongs to. cX>XlX l[TU] [R 5 gr )r textpager rrFPDFText_FindClose)rr rrs rrPdfTextSearcher.__init__s   445rcUR$r )rrs rrPdfTextSearcher.parents }}rcU"U5nU(dg[R"U5n[R"U5nX44$r )rFPDFText_GetSchResultIndexFPDFText_GetSchCount)r find_funcrgr9r:s r_get_occurrencePdfTextSearcher._get_occurrence#s9 t_33D9--d3|rc@UR[R5$)z Returns: (int, int): Start character index and count of the next occurrence, or None if the last occurrence was passed. )rrFPDFText_FindNextrs rget_nextPdfTextSearcher.get_next+ ##H$>$>??rc@UR[R5$)z Returns: (int, int): Start character index and count of the previous occurrence (i. e. the one before the last valid occurrence), or None if the last occurrence was passed. )rrFPDFText_FindPrevrs rget_prevPdfTextSearcher.get_prev3rr)r r) rrrrrrrrrrrrrrs@rrrs86 @@@rr)__all__r2loggingr- pypdfium2.rawr rpypdfium2.internalinternalpdfium_ipypdfium2._helpers.miscrpypdfium2.versionrrb getLoggerrlogger AutoCloseablerrrrrsc -  %/) ??   8 $z8))zz)@x--)@r