o Zh?N@sdZddlZddlZddlZddlmZddlmZ ddl m Z ddl m Z ddlmZddlmZejZeeZGddde jZd d Z   dddZGdddZdS))PdfPagePdfColorSchemeN) PdfiumError) PdfBitmap) PdfTextPage) PdfObjectcseZdZdZfddZeddZeddZdd Z d d Z d d Z ddZ ddZ ddZd?ddZddZd?ddZddZd?ddZdd Zd?d!d"Zd#d$Zd?d%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd@d6d7Zej fd8d9Z!d:d5d;de"j#d3dZ$Z%S)Arz Page helper class. Attributes: raw (FPDF_PAGE): The underlying PDFium page handle. pdf (PdfDocument): Reference to the document this page belongs to. cs,||||_|_|_ttj|jdSN)rawpdfformenvsuper__init__r _close_impl)selfr r r  __class__N/var/www/html/lang_env/lib/python3.10/site-packages/pypdfium2/_helpers/page.pyr szPdfPage.__init__cCs|rt||t|dSr)pdfium_cZFORM_OnBeforeClosePageZFPDF_ClosePage)r r rrrr"s zPdfPage._close_implcCs|jSr)r rrrrparent)szPdfPage.parentcC t|S)z` Returns: float: Page width (horizontal size), in PDF canvas units. )rZFPDF_GetPageWidthFrrrr get_width/ zPdfPage.get_widthcCr)z_ Returns: float: Page height (vertical size), in PDF canvas units. )rZFPDF_GetPageHeightFrrrr get_height6rzPdfPage.get_heightcCs||fS)zb Returns: (float, float): Page width and height, in PDF canvas units. )rrrrrrget_size=zPdfPage.get_sizecCstjt|S)zO Returns: int: Clockwise page rotation in degrees. )pdfium_iZRotationToDegreesrZFPDFPage_GetRotationrrrr get_rotationGrzPdfPage.get_rotationcCst|tj|dS)z\ Define the absolute, clockwise page rotation (0, 90, 180, or 270 degrees). N)rZFPDFPage_SetRotationrRotationToConst)rrotationrrr set_rotationNzPdfPage.set_rotationc CsRttttf\}}}}||||||}|s|r|SdS|j|j|j|jfSr)c_floatvalue) rZbox_funcZ fallback_func fallback_okleftbottomrighttopokrrr_get_boxUs zPdfPage._get_boxTcCs|tjdd|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. Note: Due to quirks in PDFium's public API, all ``get_*box()`` functions except :meth:`.get_bbox` do not inherit from parent nodes in the page tree (as of PDFium 5418). cSdS)N)rridirrrrriz&PdfPage.get_mediabox..)r+rZFPDFPage_GetMediaBoxrr%rrr get_mediabox^s zPdfPage.get_mediaboxcCt|||||dS)zn Set the page's MediaBox by passing four :class:`float` coordinates (usually x0, y0, x1, y1). N)rZFPDFPage_SetMediaBoxrlbrtrrr set_mediaboxkr"zPdfPage.set_mediaboxcC|tj|j|S)zc Returns: The page's CropBox (If not defined, falls back to MediaBox). )r+rZFPDFPage_GetCropBoxr0r/rrr get_cropboxqzPdfPage.get_cropboxcCr1)z) Set the page's CropBox. N)rZFPDFPage_SetCropBoxr2rrr set_cropboxxr"zPdfPage.set_cropboxcCr8)zc Returns: The page's BleedBox (If not defined, falls back to CropBox). )r+rZFPDFPage_GetBleedBoxr9r/rrr get_bleedbox~r:zPdfPage.get_bleedboxcCr1)z* Set the page's BleedBox. N)rZFPDFPage_SetBleedBoxr2rrr set_bleedboxr"zPdfPage.set_bleedboxcCr8)zb Returns: The page's TrimBox (If not defined, falls back to CropBox). )r+rZFPDFPage_GetTrimBoxr9r/rrr get_trimboxr:zPdfPage.get_trimboxcCr1)z) Set the page's TrimBox. N)rZFPDFPage_SetTrimBoxr2rrr set_trimboxr"zPdfPage.set_trimboxcCr8)za Returns: The page's ArtBox (If not defined, falls back to CropBox). )r+rZFPDFPage_GetArtBoxr9r/rrr get_artboxr:zPdfPage.get_artboxcCr1)z( Set the page's ArtBox. N)rZFPDFPage_SetArtBoxr2rrr set_artboxr"zPdfPage.set_artboxcCs4t}t||}|std|j|j|j|jfS)zz Returns: The bounding box of the page (the intersection between its media box and crop box). z Failed to get page bounding box.)rZFS_RECTFZFPDF_GetPageBoundingBoxrr&r'r(r))rrectr*rrrget_bboxs  zPdfPage.get_bboxcCs.t|}|s tdt||}|||S)zY Returns: PdfTextPage: A new text page handle for this page. zFailed to load text page.)rZFPDFText_LoadPagerr_add_kid)rZ raw_textpageZtextpagerrr get_textpages   zPdfPage.get_textpagecCsN|jrtd|jr|j|jurtdt|||||_|j|_dS)a Insert a page object into the page. The page object must not belong to a page yet. If it belongs to a PDF, this page must be part of the 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 page object 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 rZFPDFPage_InsertObjectZ_detach_finalizer)rpageobjrrr insert_objs   zPdfPage.insert_objcCs<|j|ur tdt||}|stdd|_|dS)ab Remove a page object from the page. As of PDFium 5692, detached page objects may be only re-inserted into existing pages of the same document. If the page object is not re-inserted into a page, its ``close()`` method may be called. Parameters: pageobj (PdfObject): The page object to remove. zAThe page object you attempted to remove is not part of this page.zFailed to remove pageobject.N)rFrGrZFPDFPage_RemoveObjectrZ_attach_finalizer)rrHr*rrr remove_objs   zPdfPage.remove_objcCst|}|s tddS)z Generate page content to apply additions, removals or modifications of page objects. 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)rZFPDFPage_GenerateContentr)rr*rrr gen_contents zPdfPage.gen_contentNrc cs|r tj}tj}|}ntj}tj}|}||}|dkr tdt|D]A} ||| } | dur3tdt| ||j|d} | | |rH| j |vrK| V| j tj kre||dkre|j ||| |ddEdHq$dS)a? Iterate through the page objects on this page. Parameters: filter (list[int] | None): An optional list of page object 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 page object. rz%Failed to get number of page objects.NzFailed to get page object.)rFr level)filter max_depthformrM) rZFPDFFormObj_CountObjectsZFPDFFormObj_GetObjectZFPDFPage_CountObjectsZFPDFPage_GetObjectrrangerr rDtypeZFPDF_PAGEOBJ_FORM get_objects) rrOrPrQrMZ count_objectsZ get_objectrZ n_objectsiZraw_objZ helper_objrrrrTs8    zPdfPage.get_objectscCs"t||}|tjkrtd|S)a3 Attempt to flatten annotations and form fields into the page contents. Parameters: flag (int): PDFium flattening target (:attr:`FLAT_*`) Returns: int: PDFium flattening status (:attr:`FLATTEN_*`). :attr:`FLATTEN_FAIL` is handled internally. z,Failed to flatten annotations / form fields.)rZFPDFPage_FlattenZ FLATTEN_FAILr)rflagrcrrr_flatten-s zPdfPage._flattenrN)rrrrFc st|} t|} |dvr| | } } fdd|D}| |d|d} | |d|d} tdd | | fDrGtd tdi|\} }}}|d ur]|r]|tjO}|| | | |d }| dd| | ||||d |d | | t j ||f}|d urtj |n,tj dd }t |ddd||}tjg|||R}|tjksJt||r|jrtj|jg|R|S)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`. color_scheme (PdfColorScheme | None): An optional, custom rendering color scheme. fill_to_stroke (bool): If True and rendering with custom color scheme, fill paths will be stroked. fill_color (tuple[int, int, int, int]): Color the bitmap will be filled with before rendering (RGBA values from 0 to 255). 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 instead of ``BGR(A/X)``. Other pixel formats are not affected. prefer_bgrx (bool): If True, prefer four-channel over three-channel pixel formats, even if the alpha byte is unused. Other pixel formats are not affected. 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). extra_flags (int): Additional PDFium rendering flags. May be combined with bitwise OR (``|`` operator). Returns: PdfBitmap: Bitmap of the rendered page. .. [#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 currently does not have an API to get the user unit, so this is not taken into account. )Zicsg|] }t|qSr)mathceil).0cscalerr sz"PdfPage.render..rrLrNcss|]}|dkVqdS)rNNr)r\drrr sz!PdfPage.render..zCrop exceeds page dimensionsN)format rev_byteorder)versionZNeedToPauseNowcSr,)NFr)_rrrr-r.z PdfPage.render..r)rZr[rranyrG_parse_renderoptsrZFPDF_CONVERT_FILL_TO_STROKEZ fill_rectrrZFPDF_RenderPageBitmapZ IFSDK_PAUSEZ set_callbackconvertZ*FPDF_RenderPageBitmapWithColorScheme_StartZFPDF_RENDER_DONEZFPDF_RenderPage_Closer Z FPDF_FFLDraw)rr_r cropZmay_draw_formsZ bitmap_makerZ color_schemeZfill_to_strokekwargsZ src_widthZ src_heightwidthheight cl_formatre fill_colorflagsZbitmapZ render_argspausefpdf_csstatusrr^rrenderBs4U   &     zPdfPage.render)T)NrLNr)&__name__ __module__ __qualname____doc__r staticmethodrpropertyrrrrrr!r+r0r7r9r;r<r=r>r?r@rArCrErIrJrKrTrZFLAT_NORMALDISPLAYrXrZ new_nativeru __classcell__rrrrrsL           4rcCs,|ddkr tjS|rtjS|rtjStjS)Nra)rZFPDFBitmap_BGRAFPDFBitmap_GrayZFPDFBitmap_BGRxZFPDFBitmap_BGR)rp grayscale prefer_bgrxrrr_auto_bitmap_formats rr}r}r}r}FTc Cs| dur t||| } n| } | tjkrd} | }|r|tjO}|r$|tjO}|r+|tjO}|r2|tjO}|r9|tjO}|r@|tjO}|rG|tj O}| rN|tj O}|ro| }|dkr^|tj O}n|dkrh|tj O}ntd|| | ||fS)NFZlcdprintzInvalid optimize_mode )rrr~ZFPDF_GRAYSCALEZ FPDF_ANNOTZFPDF_RENDER_NO_SMOOTHTEXTZFPDF_RENDER_NO_SMOOTHIMAGEZFPDF_RENDER_NO_SMOOTHPATHZFPDF_RENDER_FORCEHALFTONEZFPDF_RENDER_LIMITEDIMAGECACHEZFPDF_REVERSE_BYTE_ORDERlowerZ FPDF_LCD_TEXTZ FPDF_PRINTINGrG)rprZ optimize_modeZ draw_annotsZ no_smoothtextZno_smoothimageZ no_smoothpathZforce_halftoneZlimit_image_cachererZforce_bitmap_format extra_flagsrorqrrrris<            ric@s eZdZdZddZddZdS)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. cCst||||d|_dS)N)Zpath_fill_colorZpath_stroke_colorZtext_fill_colorZtext_stroke_color)dictcolors)rZ path_fillZ path_strokeZ text_fillZ text_strokerrrr s zPdfColorScheme.__init__cCs4t}|jD]\}}t||t||q |S)z\ Returns: The color scheme as :class:`FPDF_COLORSCHEME` object. )rZFPDF_COLORSCHEMEritemssetattrrZ color_tohex)rrerskeyr$rrrrj szPdfColorScheme.convertN)rvrwrxryr rjrrrrrs r) rFNTFFFFFFFNr)__all__rZctypesloggingZ pypdfium2.rawr rZpypdfium2.internalZinternalrZpypdfium2._helpers.miscrZpypdfium2._helpers.bitmaprZpypdfium2._helpers.textpagerZpypdfium2._helpers.pageobjectsrr# getLoggerrvloggerZ AutoCloseablerrrirrrrrs@       , 7