)iCSrSSKrSSKrSSKJr SSKJr SSK J r SSK J r SSK Jr \R"\5r"SS\R$5rSr"S S 5rg) ) PdfBitmap PdfPosConvN) PdfiumError)Lazy) PDFIUM_INFOc^\rSrSrSrU4Sjr\S5r\S5r \ SSj5r \ SSj5r \ SSj5r \ SS j5rS rS rS r\ S 5rSrSrU=r$)ra Bitmap helper class. .. _PIL Modes: https://pillow.readthedocs.io/en/stable/handbook/concepts.html#concept-modes Warning: ``bitmap.close()``, which frees the buffer of foreign bitmaps, is not validated for safety. A bitmap must not be closed while other objects still depend on its buffer! Attributes: raw (FPDF_BITMAP): The underlying PDFium bitmap handle. buffer (~ctypes.c_ubyte): A ctypes array representation of the pixel data (each item is an unsigned byte, i. e. a number ranging from 0 to 255). width (int): Width of the bitmap (horizontal size). height (int): Height of the bitmap (vertical size). stride (int): Number of bytes per line in the bitmap buffer. Depending on how the bitmap was created, there may be a padding of unused bytes at the end of each line, so this value can be greater than ``width * n_channels``. format (int): PDFium bitmap format constant (:attr:`FPDFBitmap_*`) rev_byteorder (bool): Whether the bitmap is using reverse byte order. n_channels (int): Number of channels per pixel. mode (str): The bitmap format as string (see `PIL Modes`_). c ~>XlX lX0lX@lXPlX`lXpl[RUR Ul UR (a[RO[RUR Ul SUl [T U]=[ R"XRS9 g)N) needs_freeobj)rawbufferwidthheightstrideformat rev_byteorderpdfium_iBitmapTypeToNChannels n_channelsBitmapTypeToStrReverseBitmapTypeToStrmode _pos_argssuper__init__pdfium_cFPDFBitmap_Destroy) selfr rrrrrrr __class__s Y/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/pypdfium2/_helpers/bitmap.pyrPdfBitmap.__init__1s     *"88E/3/A/AH + +  $ $ ++  44Q\Q\]cgNrs r!parentPdfBitmap.parentFsr#c[R"U5nU(d [S5e[R"U[R "[R 55n[R"X1U-5$)Nz3Failed to get bitmap buffer (null pointer returned)) rFPDFBitmap_GetBufferrctypescastPOINTERc_ubyter get_buffer)r rr buffer_ptrs r! _get_bufferPdfBitmap._get_bufferTsS2237 ST T[[V^^FNN-KL "":f}==r#c [R"U5n[R"U5n[R"U5n[R"U5nUcSUR XU5pOSUpU"XXEXgX(5$)a Construct a :class:`.PdfBitmap` wrapper around a raw PDFium bitmap handle. Note: This method is primarily meant for bitmaps provided by pdfium (as in :meth:`.PdfImage.get_bitmap`). For bitmaps created by the caller, where the parameters are already known, it may be preferable to call the :class:`.PdfBitmap` constructor directly. Parameters: raw (FPDF_BITMAP): PDFium bitmap handle. rev_byteorder (bool): Whether the bitmap uses reverse byte order. ex_buffer (~ctypes.c_ubyte | None): If the bitmap was created from a buffer allocated by Python/ctypes, pass in the ctypes array to keep it referenced. TF)rFPDFBitmap_GetWidthFPDFBitmap_GetHeightFPDFBitmap_GetStrideFPDFBitmap_GetFormatr2) clsr r ex_bufferrrrrr rs r!from_rawPdfBitmap.from_raw]st",,S1..s3..s3..s3  !%ssF'K!& 3v}YYr#c [RUnUcX-nO XaU-:deUc[RXb--"5nO[ U5Xb-:de[ R "XX5U5nU"XXXcUSS9$)a Create a new bitmap using :func:`FPDFBitmap_CreateEx`, with a buffer allocated by Python/ctypes, or provided by the caller. * If buffer and stride are None, a packed buffer is created. * If a custom buffer is given but no stride, the buffer is assumed to be packed. * If a custom stride is given but no buffer, a stride-agnostic buffer is created. * If both custom buffer and stride are given, they are used as-is. Caller-provided buffer/stride are subject to a logical validation. Fr )rrr,r/lenrFPDFBitmap_CreateEx) r9rrrrrrbpcr s r! new_nativePdfBitmap.new_native{s,,V4 >[FS[( (( >nn8;Fv;&/1 11**5&&Q3v}Y^__r#c U(aU[RU-OSn[R"XUSU5nU(d[R"U5nUR XvU5nU"XxXXcUSS9$)a Create a new bitmap using :func:`FPDFBitmap_CreateEx`, with a buffer allocated by PDFium. There may be a padding of unused bytes at line end, unless *force_packed=True* is given. Note, the recommended default bitmap creation strategy is :meth:`.new_native`. rNTr>)rrrr@r7r2) r9rrrr force_packedrr rs r! new_foreignPdfBitmap.new_foreignsmDP77??UV**5&$O2237Ff53v}Y]^^r#c [R"XU5nUS-nURXVU5nU(a[RO[RnU"XWXXhUSS9$)a? Create a new bitmap using :func:`FPDFBitmap_Create`. The buffer is allocated by PDFium. PDFium docs specify that each line uses width * 4 bytes, with no gap between adjacent lines, i.e. the resulting buffer should be packed. Contrary to the other ``PdfBitmap.new_*()`` methods, this method does not take a format constant, but a *use_alpha* boolean. If True, the format will be :attr:`FPDFBitmap_BGRA`, :attr:`FPFBitmap_BGRx` otherwise. Other bitmap formats cannot be used with this method. Note, the recommended default bitmap creation strategy is :meth:`.new_native`. Tr>)rFPDFBitmap_Creater2FPDFBitmap_BGRAFPDFBitmap_BGRx) r9rr use_alpharr rrrs r!new_foreign_simplePdfBitmap.new_foreign_simplesX(( Bf5-6))H\`\g\gimisis[tNN[[;???Q;Nt{{DOOQ7UYU`U`bcTd #  r#c [RURn[RR UUR UR4URSURURS5nSUl U$)a Get a :mod:`PIL` image of the bitmap, using :func:`PIL.Image.frombuffer`. For ``RGBA``, ``RGBX`` and ``L`` bitmaps, PIL is supposed to share memory with the original buffer, so changes to the buffer should be reflected in the image, and vice versa. Otherwise, PIL will make a copy of the data. Returns: PIL.Image.Image: PIL image (representation or copy of the bitmap buffer). r r\F) rrrr PIL_Image frombufferrrrrrreadonly)r dest_modeimages r!to_pilPdfBitmap.to_pilsh33DKK@ ))  ZZ % KK  II KK   r#c&UR[R;a[RURnO([U5n[RURnUR up4UR X4USUR5S9$)a| Convert a :mod:`PIL` image to a PDFium bitmap. Due to the limited number of color formats and bit depths supported by :attr:`FPDF_BITMAP`, this may be a lossy operation. Bitmaps returned by this function should be treated as immutable. Parameters: pil_image (PIL.Image.Image): The image. Returns: PdfBitmap: PDFium bitmap (with a copy of the PIL image's data). F)rr)rrBitmapStrToConst_pil_convert_for_pdfiumBitmapStrReverseToConstsizerBtobytes)r9 pil_imagerwhs r!from_pilPdfBitmap.from_pilss" >>X66 6..y~~>F/ :I55innEF~~~~aF% HYHYH[~\\r#cU(dS5eUR(aURS"5ULa [S5e[XRSS5$)a Acquire a :class:`.PdfPosConv` object to translate between coordinates on the bitmap and the page it was rendered from. This method requires passing in the page explicitly, to avoid holding a strong reference, so that bitmap and page can be independently freed by finalizer. zPage must be non-nullrz.This bitmap does not belong to the given page.r\N)r RuntimeErrorr)rpages r! get_posconvPdfBitmap.get_posconv5sN,,,t~~!2!4D!@OP P$qr 233r#) rrrrrrr rrr)FN)FNN)FF)F)__name__ __module__ __qualname____firstlineno____doc__rpropertyr( staticmethodr2 classmethodr;rBrFrNrYrcrkrvr{__static_attributes__ __classcell__)r s@r!rrs>^*>>ZZ:``> _ _ __"B>:>]]6 4 4r#rcURS:XaURS5nOTURRS5(aO3SUR;aURS5nOURS5nURS:Xa7UR5upn[R R SX2U45nU$URS:Xa7UR5upp4[R R SX2X45nU$URS:Xa5UR5upp5[R R SX2X45nU$)N1LRGBARGBARGBX)rconvert startswithsplitrrfmerge)rsrgbaxs r!roroCs ~~%%c*  " "5 ) )  %%f- %%e, ~~//#aNN((q :   6 !__& aNN((!>  6 !__& aNN((!> r#c0\rSrSrSrSrSrSrSrSr g) ri]aG Pdf coordinate translator. Hint: You may want to use :meth:`.PdfBitmap.get_posconv` to obtain an instance of this class. Parameters: page (PdfPage): Handle to the page. pos_args (tuple[int*5]): pdfium canvas args (start_x, start_y, size_x, size_y, rotate), as in ``FPDF_RenderPageBitmap()`` etc. cXlX lgr%rzpos_args)rrzrs r!rPdfPosConv.__init__ms   r#c\[RSURSURS3$)N(z, ))rr}rzrr's r!__repr__PdfPosConv.__repr__qs*%%&a {"T]]O1EEr#c[R"5[R"5pC[R"UR/UR QUPUPUPUP76nU(d [ S5eURUR4$)z, Translate coordinates from bitmap to page. z(Failed to translate to page coordinates.)r,c_doublerFPDF_DeviceToPagerzrrvalue)rbitmap_xbitmap_ypage_xpage_yrXs r!to_pagePdfPosConv.to_pagetsn *FOO,=  ' ' fDMM f8 fX fW] f_e fHI I fll++r#c[R"5[R"5pC[R"UR/UR QUPUPUPUP76nU(d [ S5eURUR4$)z, Translate coordinates from page to bitmap. z*Failed to translate to bitmap coordinates.)r,c_intrFPDF_PageToDevicerzrrr)rrrrrrXs r! to_bitmapPdfPosConv.to_bitmap~sl$\\^V\\^(  ' ' fDMM f6 f6 fS[ f]e fJK K//r#rN) r}r~rrrrrrrrr&r#r!rr]s !F,0r#r)__all__r,logging pypdfium2.rawr rpypdfium2.internalinternalrpypdfium2._helpers.miscrpypdfium2._lazyrpypdfium2.versionr getLoggerr}logger AutoCloseablerrorr&r#r!rsU &  %/ )   8 $o4''o4d 4)0)0r#