j[ dZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddl mZddlmZddlmZddlmZej*Zej,eZGdd e j2Zd Z dd ZGd d Zy))PdfPagePdfColorSchemeN) PdfiumError) PdfBitmap) PdfTextPage) PdfObject) PDFIUM_INFOceZdZdZfdZedZedZdZ dZ dZ dZ d Z d Zd#d Zd Zd#dZdZd#dZdZd#dZdZd#dZdZdZdZdZdZdZd$dZej@fdZ!ddd d e"jFdd!fd"Z$xZ%S)%rah 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||_||_||_t|t j |jyN)rawpdfformenvsuper__init__r _close_impl)selfr rr __class__s X/root/aria/tools/markitdown-venv/lib/python3.12/site-packages/pypdfium2/_helpers/page.pyrzPdfPage.__init__#s1  ,,dll;c^|rtj||tj|yr )pdfium_cFORM_OnBeforeClosePageFPDF_ClosePage)r rs rrzPdfPage._close_impl*s#   + +C 9$rcJ|j |jS|jSr )rrrs rparentzPdfPage.parent1s  <</txxAT\\Arc,tj|S)z` Returns: float: Page width (horizontal size), in PDF canvas units. )rFPDF_GetPageWidthFrs r get_widthzPdfPage.get_width7s **400rc,tj|S)z_ Returns: float: Page height (vertical size), in PDF canvas units. )rFPDF_GetPageHeightFrs r get_heightzPdfPage.get_height>s ++D11rcB|j|jfS)zb Returns: (float, float): Page width and height, in PDF canvas units. )r r#rs rget_sizezPdfPage.get_sizeEs  $//"344rcrtj|}|dk(r tdtj|S)zO Returns: int: Clockwise page rotation in degrees. zFailed to get page rotation.)rFPDFPage_GetRotationrpdfium_iRotationToDegrees)r raw_rotations r get_rotationzPdfPage.get_rotationOs9  44T: 2 <= =)),77rcRtj|tj|y)z\ Define the absolute, clockwise page rotation (0, 90, 180, or 270 degrees). N)rFPDFPage_SetRotationr)RotationToConst)rrotations r set_rotationzPdfPage.set_rotationYs %%dH,D,DX,NOrcttttf\}}}}||||||}|s |r|SdS|j|j|j|jfSr )c_floatvalue) rbox_func fallback_func fallback_okleftbottomrighttopoks r_get_boxzPdfPage._get_box`sd#*9giGI#M feS dD&% 5'2MO = = FLL%++syyAArTcF|jtjd|S)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). cy)N)rridir@rrz&PdfPage.get_mediabox..tr)r=rFPDFPage_GetMediaBoxrr7s r get_mediaboxzPdfPage.get_mediaboxis}}X::|jJt j |j|}d\|_|_n$|jJt j ||}|s tdd|_|jy)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.rN)rNzFailed to remove pageobject.) rtrulevel containerrFPDFFormObj_RemoveObjectFPDFPage_RemoveObjectr_attach_finalizerrys r remove_objzPdfPage.remove_objs <B<= = !!#rcHtj|}|s tdy)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_contentzPdfPage.gen_contents(  . .t 4@A ArNrc #>K|r#tj}tj}|}n=tj}tj}|}|r|j |ur t d||} | dkr tdt| D]} ||| } | s tdt| ||j|||} |r| j|vr| | jtjk(sf||dz kso|j||| |dz|Ed{y7w) 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. textpage (PdfTextPage | None): Text page to pass through to any :class:`.PdfTextObj` instances. Yields: :class:`.PdfObject`: A pageobject. z0The given textpage does not belong to this page.rz$Failed to get number of pageobjects.zFailed to get pageobject.)rtrr~r}rq)filter max_depthformr}rqN)rFPDFFormObj_CountObjectsFPDFFormObj_GetObjectFPDFPage_CountObjectsFPDFPage_GetObjectrtrurrangerrtypeFPDF_PAGEOBJ_FORM get_objects) rrrrr}rq count_objects get_objectr n_objectsiraw_obj helper_objs rrzPdfPage.get_objectss*$ $==M!77JF$::M!44JFHMM5 !STT!&) q=DE Ey! A +G!"=>>#7488t[`kstJZ__6  ("<"<<STAT++# )%!AI' , sC+D.D7DDDc|js tdtj||}|tjk(r t d|S)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. zFpage.flatten() requires prior pdf.init_forms(), before page retrieval.z,Failed to flatten annotations / form fields.)r RuntimeErrorrFPDFPage_Flatten FLATTEN_FAILr)rflagrcs rflattenzPdfPage.flattenIsH||gh h  & &tT 2 && &LM M rr)rrrrFc tj|j|z} tj|j|z} |dvr| | } } |D cgc]} tj| |z}} | |dz |dz } | |dz |dz } t d| | fDr t dt |fi|\}}}}||r|tjz}|| | ||}|j|dd| | |d |d | | tj|f}||g||}|tj|ntjd }tj|d d |j|}tj g|||}|tj"k(sJtj$||r,|j&r tj(|j&g|t+j,||f|_|Scc} w) 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. )Zirrc3&K|] }|dk yw)rNr@).0ds r z!PdfPage.render..s.q1u.szCrop exceeds page dimensions)format rev_byteorder)versionNeedToPauseNowcy)NFr@)_s rrAz PdfPage.render..rBr)mathceilr r#anyru_parse_renderoptsrFPDF_CONVERT_FILL_TO_STROKE fill_rectr)r/FPDF_RenderPageBitmap IFSDK_PAUSE set_callbackconvert*FPDF_RenderPageBitmapWithColorScheme_StartFPDF_RENDER_DONEFPDF_RenderPage_Closer FPDF_FFLDrawweakrefref _render_args)rscaler0cropmay_draw_forms bitmap_maker color_schemefill_to_strokekwargs src_width src_heightcwidthheight cl_formatr fill_colorflagsbitmappos_args render_argspausefpdf_csstatuss rrenderzPdfPage.rendercsNYYt~~/589 YYt0589 y $. zI,01q !E'"11d1g%Q/d1g%Q/ .ufo. .;< <6G6WPV6W3 =*e  $. X99 9EeVI][Q5&9!WHtAwh :x?W?WX`?abt6h66    * *K 8((3E  ! !%)9? K"**=9GHHf+fW^f`efFX666 66  * *4 0 dll  ! !$,, = =&{{40(; =2sH )T)NNrN)&__name__ __module__ __qualname____doc__r staticmethodrpropertyrr r#r%r,r1r=rErMrQrTrXr[r^rardrgrlrrr{rrrrFLAT_NORMALDISPLAYrr new_nativer __classcell__)rs@rrrs <%% BB 1258PB c8 [7 [8 Z7 Y6 > 4$BB3l$668!$//"Jrrc|ddks|r%tj|rtjS|rtjS|rtjStj S)Nr)rFPDFPage_HasTransparencyFPDFBitmap_BGRAFPDFBitmap_GrayFPDFBitmap_BGRxFPDFBitmap_BGR)rtr grayscale prefer_bgrx maybe_alphas r_auto_bitmap_formatrsV!}s{x/P/PQU/V''' ''' '''&&&rcX| t|||| | }n| }|tjk(rd} |}|r|tjz}|r|tjz}|r|tj z}|r|tj z}|r|tjz}|r|tjz}| r|tjz}| r|tjz}|rP|j}|dk(r|tjz}n'|dk(r|tjz}ntd||| ||fS)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_PRINTINGru)rtrr optimize_mode draw_annots no_smoothtextno_smoothimage no_smoothpathforce_halftonelimit_image_cacherrrforce_bitmap_format extra_flagsrrs rrrs7$"'j)[R]^ ' H,,, E ((( $$$ 333 444 333 333 777 111%++- E ! X++ +E g % X++ +E5m_EF F mZ 66rc"eZdZdZdZdZdZy)rz 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,t|||||_y)N)path_fill_colorpath_stroke_colortext_fill_colortext_stroke_color)dictcolors)r path_fill path_stroke text_fill text_strokes rrzPdfColorScheme.__init__<s%%  rcLt|jd|jdS)Nz(**))rrrrs r__repr__zPdfColorScheme.__repr__Bs$t*%%&c$++a88rc tj}|jjD]&\}}t ||t j ||(|S)z\ Returns: The color scheme as :class:`FPDF_COLORSCHEME` object. )rFPDF_COLORSCHEMEritemssetattrr) color_tohex)rrrkeyr4s rrzPdfColorScheme.convertEsR ++-++++- NJC GS("6"6um"L M NrN)rrrrrrrr@rrrr6s  9rr))rrrrFNTFFFFFFFFNr)__all__rctypesloggingr pypdfium2.rawr rpypdfium2.internalinternalr)pypdfium2._helpers.miscrpypdfium2._helpers.bitmaprpypdfium2._helpers.textpagerpypdfium2._helpers.pageobjectsrpypdfium2.versionr r3 getLoggerrlogger AutoCloseablerrrrr@rrr$s (  %//34) ..   8 $Wx%%Wt '*!"67rr