+ f0iCYR t^RIt^RIt^RIt^RIt^RIHt^RIH t ^RI H t ^RI Ht^RIHt^RIHt]P&t]P(!]4t!RR] P.4tRtR R lt!R R4tR#) PdfPagePdfColorSchemeN) PdfiumError) PdfBitmap) PdfTextPage) PdfObjectc>aa]tRt^toRtV3Rlt]R4t]R4t Rt Rt Rt Rt R tR tR!R ltR tR!RltRtR!RltRtR!RltRtR!RltRtRtRtRtRtRtR"Rlt] PB3Rlt"^^R#R ]#PHRR3Rlt%R t&Vt'V;t(#)$ra@ Page helper class. Attributes: raw (FPDF_PAGE): The underlying PDFium page handle. pdf (PdfDocument): Reference to the document this page belongs to. formenv (PdfFormEnv | None): Formenv handle, if the parent pdf had an active formenv at the time of page retrieval. None otherwise. c|<WnW nW0n\SV`\ P VP4R#N)rawpdfformenvsuper__init__r _close_impl)selfr r r __class__s&&&&]/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/pypdfium2/_helpers/page.pyrPdfPage.__init__"s+  ,,dll;cnV'd\P!W4\P!V4R#r )pdfium_cFORM_OnBeforeClosePageFPDF_ClosePage)r r s&&rrPdfPage._close_impl)s!   + +C 9$rcVP#r )r rs&rparentPdfPage.parent0s xxrc .\P!V4#)zH Returns: float: Page width (horizontal size), in PDF canvas units. )rFPDF_GetPageWidthFrs&r get_widthPdfPage.get_width6s **400rc .\P!V4#)zG Returns: float: Page height (vertical size), in PDF canvas units. )rFPDF_GetPageHeightFrs&r get_heightPdfPage.get_height=s ++D11rc BVP4VP43#)zJ Returns: (float, float): Page width and height, in PDF canvas units. )r!r%rs&rget_sizePdfPage.get_sizeDs  $//"344rc X\P\P!V4,#)z7 Returns: int: Clockwise page rotation in degrees. )pdfium_iRotationToDegreesrFPDFPage_GetRotationrs&r get_rotationPdfPage.get_rotationNs ))8+H+H+NPPrc ^\P!V\PV,4R#)zL Define the absolute, clockwise page rotation (0, 90, 180, or 270 degrees). N)rFPDFPage_SetRotationr+RotationToConst)rrotations&&r set_rotationPdfPage.set_rotationUs %%dH,D,DX,NOrc\4\4\4\43wrErgV!WWVV4pV'gV'dV!4#R#VPVPVPVP3#r )c_floatvalue) rbox_func fallback_func fallback_okleftbottomrighttopoks &&&& r_get_boxPdfPage._get_box\s\#*9giGI#M e d& 5'2MO = = FLL%++syyAArTc FVP\PRV4#)a Returns: (float, float, float, float) | None: The page MediaBox in PDF canvas units, consisting of four coordinates (usually x0, y0, x1, y1). If MediaBox is not defined, returns ANSI A (0, 0, 612, 792) if ``fallback_ok=True``, None otherwise. .. admonition:: Known issue Due to quirks in PDFium, all ``get_*box()`` functions except :meth:`.get_bbox` do not inherit from parent nodes in the page tree (as of PDFium 5418). cR#))rErEidirFrr&PdfPage.get_mediabox..psDTr)rArFPDFPage_GetMediaBoxrr;s&&r get_mediaboxPdfPage.get_mediaboxes}}X::r?)rrectr@s& rget_bboxPdfPage.get_bboxsP   "  - -d 9@A A 4;; DHH==rc \P!V4pV'g \R4h\W4pVP V4V#)zA Returns: PdfTextPage: A new text page handle for this page. zFailed to load text page.)rFPDFText_LoadPagerr_add_kid)r raw_textpagetextpages& r get_textpagePdfPage.get_textpages>  11$7 9: :|2 hrc (VP'd \R4hVP'd&VPVPJd \R4h\P!W4VP 4WnVPVnR#)an Insert a pageobject into the page. The pageobject must not belong to a page yet. If it belongs to a PDF, the target page must be part of that PDF. Position and form are defined by the object's matrix. If it is the identity matrix, the object will appear as-is on the bottom left corner of the page. Parameters: pageobj (PdfObject): The pageobject to insert. zAThe pageobject you attempted to insert already belongs to a page.zBThe pageobject you attempted to insert belongs to a different PDF.N)page ValueErrorr rFPDFPage_InsertObject_detach_finalizer)rpageobjs&&r insert_objPdfPage.insert_objsg <<<`a a ;;;GKKtxx7ab b&&t5!!# hh rc VPVJd \R4hVP^8dBVPfQh\P !VPV4p^RuVnVnM&VPeQh\P !W4pV'g \R4hRVnVP4R#)a Remove a pageobject from the page. As of PDFium 5692, detached pageobjects may be only re-inserted into existing pages of the same document. If the pageobject is not re-inserted into a page, its ``close()`` method may be called. Note: If the object's :attr:`~.PdfObject.type` is :data:`FPDF_PAGEOBJ_TEXT`, any :class:`.PdfTextPage` handles to the page should be closed before removing the object. Parameters: pageobj (PdfObject): The pageobject to remove. z@The pageobject you attempted to remove is not part of this page.NzFailed to remove pageobject.) rrlevel containerrFPDFFormObj_RemoveObjectFPDFPage_RemoveObjectr_attach_finalizer)rrr@s&& r remove_objPdfPage.remove_objs <B<= = !!#rc X\P!V4pV'g \R4hR#)z Generate page content to apply additions, removals or modifications of pageobjects. If page content was changed, this function should be called once before saving the document or re-loading the page. z Failed to generate page content.N)rFPDFPage_GenerateContentr)rr@s& r gen_contentPdfPage.gen_contents(  . .t 4@A ArNc # L"V'd$\Pp\PpTpM"\Pp\PpTpV!V4pV^8d \ R4h\ V4Fp V!Wy4p V 'g \ R4h\WVPW4R7p V'dV PV9dV xV P\P8XgKtWB^, 8gKVPVVV V^,R7RjxL K R#L 5i)a Iterate through the pageobjects on this page. Parameters: filter (list[int] | None): An optional list of pageobject types to filter (:attr:`FPDF_PAGEOBJ_*`). Any objects whose type is not contained will be skipped. If None or empty, all objects will be provided, regardless of their type. max_depth (int): Maximum recursion depth to consider when descending into Form XObjects. Yields: :class:`.PdfObject`: A pageobject. z$Failed to get number of pageobjects.zFailed to get pageobject.)rr rr)filter max_depthformrN) rFPDFFormObj_CountObjectsFPDFFormObj_GetObjectFPDFPage_CountObjectsFPDFPage_GetObjectrrangerr typeFPDF_PAGEOBJ_FORM get_objects) rrrrr count_objects get_objectr n_objectsiraw_obj helper_objs &&&&& rrPdfPage.get_objects s $==M!77JF$::M!44JF!&) q=DE Ey!A +G!"=>>#7488taJZ__6  ("<"<<STAT++# )%!AI ,"sC"D$) D$8D$D" D$c VP'g \R4h\P!W4pV\P8Xd \ R4hV#)a+ Flatten form fields and annotations into page contents. Attention: * :meth:`~.PdfDocument.init_forms` must have been called on the parent pdf, before the page was retrieved, for this method to work. In other words, :attr:`.PdfPage.formenv` must be non-null. * Flattening may invalidate existing handles to the page, so you'll want to re-initialize these afterwards. Parameters: flag (int): PDFium flattening target (:attr:`FLAT_*`) Returns: int: PDFium flattening status (:attr:`FLATTEN_*`). :attr:`FLATTEN_FAIL` is handled internally. zHpage.flatten() requires previous pdf.init_forms() before page retrieval.z,Failed to flatten annotations / form fields.)r RuntimeErrorrFPDFPage_Flatten FLATTEN_FAILr)rflagrcs&& rflattenPdfPage.flatten>sH|||ij j  & &t 2 && &LM M rFc *\P!VP4V,4p \P!VP4V,4p VR 9dYrVU u.uFp \P!W,4NK! pp W^,, V^,, p W^,, V^,, p \;QJdRW34F 'gK RM RM!RW344'd \ R4h\ V3/VBwrppVe V'dV\P,pV!WWR7pVPV^^W4V^,)V^,)W\PV,3pVV.VOVN5pVf\P!V!M\P!^R7p\P!VRR4VPV4p\P !.VOVNVN5!pV\P"8XgQh\P$!V4V'd5VP&'d#\P(!VP&.VO5!\*P,!V4.VO5VnV#uup i) a  Rasterize the page to a :class:`.PdfBitmap`. Parameters: scale (float): A factor scaling the number of pixels per PDF canvas unit. This defines the resolution of the image. To convert a DPI value to a scale factor, multiply it by the size of 1 canvas unit in inches (usually 1/72in). [#user_unit]_ rotation (int): Additional rotation in degrees (0, 90, 180, or 270). crop (tuple[float, float, float, float]): Amount in PDF canvas units to cut off from page borders (left, bottom, right, top). Crop is applied after rotation. may_draw_forms (bool): If True, render form fields (provided the document has forms and :meth:`~.PdfDocument.init_forms` was called). bitmap_maker (typing.Callable): Callback function used to create the :class:`.PdfBitmap`. fill_color (tuple[int, int, int, int]): Color the bitmap will be filled with before rendering. This uses RGBA syntax regardless of the pixel format used, with values from 0 to 255. If the fill color is not opaque (i.e. has transparency), ``{BGR,RGB}A`` will be used. grayscale (bool): If True, render in grayscale mode. optimize_mode (None | str): Page rendering optimization mode (None, "lcd", "print"). draw_annots (bool): If True, render page annotations. no_smoothtext (bool): If True, disable text anti-aliasing. Overrides ``optimize_mode="lcd"``. no_smoothimage (bool): If True, disable image anti-aliasing. no_smoothpath (bool): If True, disable path anti-aliasing. force_halftone (bool): If True, always use halftone for image stretching. limit_image_cache (bool): If True, limit image cache size. rev_byteorder (bool): If True, render with reverse byte order, leading to ``RGB{A/x}`` output rather than ``BGR{A/x}``. Other pixel formats are not affected. prefer_bgrx (bool): If True, use 4-byte ``{BGR/RGB}x`` rather than 3-byte ``{BGR/RGB}`` (i.e. add an unused byte). Other pixel formats are not affected. maybe_alpha (bool): If True, use a pixel format with alpha channel (i.e. ``{BGR/RGB}A``) if page content has transparency. This is recommended for performance in these cases, but as page-dependent format selection can be unexpected, it is not enabled by default. force_bitmap_format (int | None): If given, override automatic pixel format selection and enforce use of the given format (one of the :attr:`FPDFBitmap_*` constants). In this case, you should not pass any other format selection options, except potentially *rev_byteorder*. extra_flags (int): Additional PDFium rendering flags. May be combined with bitwise OR (``|`` operator). color_scheme (PdfColorScheme | None): A custom pdfium color scheme. Note that this may flatten different colors into one, so the usability of this is limited. fill_to_stroke (bool): If a *color_scheme* is given, whether to only draw borders around fill areas using the `path_stroke` color, instead of filling with the `path_fill` color. Returns: PdfBitmap: Bitmap of the rendered page. .. admonition:: Format selection This is the format selection hierarchy used by :meth:`.render`, from lowest to highest priority: * default: ``BGR`` * ``prefer_bgrx=True``: ``BGRx`` * ``grayscale=True``: ``L`` * ``maybe_alpha=True``: ``BGRA`` if the page has transparency, else the format selected otherwise * ``fill_color[3] < 255``: ``BGRA`` (background color with transparency) * ``force_bitmap_format=...`` -> any supported by pdfium Additionally, ``rev_byteorder=True`` will swap ``BGR{A/x}`` to ``RGB{A/x}`` if applicable. .. [#user_unit] Since PDF 1.6, pages may define an additional user unit factor. In this case, 1 canvas unit is equivalent to ``user_unit * (1/72)`` inches. PDFium does not currently provide an API to get the user unit, so this is not taken into account. c3*"TF q^8xK R#5i)NrF).0ds& r !PdfPage.render..s.o1uosTFzCrop exceeds page dimensions)format rev_byteorder)versionNeedToPauseNowcR#)FrF)_s&rrG PdfPage.render..sUr)Zi)mathceilr!r%anyr_parse_renderoptsrFPDF_CONVERT_FILL_TO_STROKE fill_rectr+r2FPDF_RenderPageBitmap IFSDK_PAUSE set_callbackconvert*FPDF_RenderPageBitmapWithColorScheme_StartFPDF_RENDER_DONEFPDF_RenderPage_Closer FPDF_FFLDrawweakrefref _pos_args)rscaler3cropmay_draw_forms bitmap_maker color_schemefill_to_strokekwargs src_width src_heightcwidthheight cl_formatr fill_colorflagsbitmappos_args render_argspausefpdf_csstatuss&&&&&&&&, rrenderPdfPage.renderXsNYYt~~/589 YYt0589 y $.z,01Dq !'"D11g%Q/1g%Q/ 3.uo.333.uo. . .;< <6G6WPV6W3 *e  $. X99 9EeI[Q59!WHtAwh x?W?WX`?abt6h66    * *K 8((3E  ! !%)9? K"**=9GHHf+fW^f`efFX666 66  * *4 0 dlll  ! !$,, = =#KK-99 =2s$%J)r r r )T)NNrE)rErErErE))__name__ __module__ __qualname____firstlineno____doc__r staticmethodrpropertyrr!r%r(r.r4rArKrTrYr]rbrfrjrnrrrvr|rrrrrrFLAT_NORMALDISPLAYrr new_nativer__static_attributes____classdictcell__ __classcell__)r __classdict__s@@rrrs <%%  125QPB c8 [7 [8 Z7 Y6 > 0$BB.b$668!$//"JJrcV^,^8g%V'd-\P!V4'd\P#V'd\P#V'd\P#\P #))rFPDFPage_HasTransparencyFPDFBitmap_BGRAFPDFBitmap_GrayFPDFBitmap_BGRxFPDFBitmap_BGR)rr grayscale prefer_bgrx maybe_alphas&&&&&r_auto_bitmap_formatrsY!}s{x/P/PQU/V/V''' ''' '''&&&rcV f\WW+V 4pMT pV\P8XdRp TpV'dV\P,pV'dV\P,pV'dV\P ,pV'dV\P ,pV'dV\P,pV'dV\P,pV 'dV\P,pV 'dV\P,pV'd]VP4pVR8XdV\P,pM-VR8XdV\P,pM\RV 24hWVV3#)NFlcdprintzInvalid optimize_mode )rrrFPDF_GRAYSCALE FPDF_ANNOTFPDF_RENDER_NO_SMOOTHTEXTFPDF_RENDER_NO_SMOOTHIMAGEFPDF_RENDER_NO_SMOOTHPATHFPDF_RENDER_FORCEHALFTONEFPDF_RENDER_LIMITEDIMAGECACHEFPDF_REVERSE_BYTE_ORDERlower FPDF_LCD_TEXT FPDF_PRINTINGr)rrr optimize_mode draw_annots no_smoothtextno_smoothimage no_smoothpathforce_halftonelimit_image_cacherrrforce_bitmap_format extra_flagsrrs&&&&&&&&&&&&&&& rrrs1$"')R]^ ' H,,, E ((( $$$ 333 444 333 333 777 111%++- E ! X++ +E g % X++ +E5m_EF F Z 66rc6a]tRtRtoRtRtRtRtRtVt R#)ri+z Rendering color scheme. Each color shall be provided as a list of values for red, green, blue and alpha, ranging from 0 to 255. c*\WW4R7VnR#))path_fill_colorpath_stroke_colortext_fill_colortext_stroke_colorN)dictcolors)r path_fill path_stroke text_fill text_strokes&&&&&rrPdfColorScheme.__init__1s%%  rcL\V4P RVP R2#)z(**))rrr"rs&r__repr__PdfColorScheme.__repr__7s$t*%%&c$++a88rc  \P!4pVPP4F%wr4\ W#\ P !WA44K' V#)zD Returns: The color scheme as :class:`FPDF_COLORSCHEME` object. )rFPDF_COLORSCHEMEr"itemssetattrr+ color_tohex)rrrkeyr8s&& rrPdfColorScheme.convert:sE ++-++++-JC G("6"6u"L M.r)r"N) rrrrrrr*rrr)rs@rrr+s  9r)rr))r3r3r3FNTFFFFFFFFNrE)__all__rctypesloggingr pypdfium2.rawr rpypdfium2.internalinternalr+pypdfium2._helpers.miscrpypdfium2._helpers.bitmaprpypdfium2._helpers.textpagerpypdfium2._helpers.pageobjectsrr7 getLoggerrlogger AutoCloseablerrrrrFrrrAsm (  %//34 ..   8 $Mx%%M` '67rr