
    )i<Y                        S r SSKrSSKrSSKrSSKrSSKJr  SSKJ	r
  SSKJr  SSKJr  SSKJr  SSKJr  \R&                  r\R(                  " \5      r " S S\
R.                  5      rS	 r              SS
 jr " S S5      rg))PdfPagePdfColorScheme    N)PdfiumError)	PdfBitmap)PdfTextPage)	PdfObjectc                   4  ^  \ rS rSrSrU 4S jr\S 5       r\S 5       r	S r
S rS rS	 rS
 rS rS%S jrS rS%S jrS rS%S jrS rS%S jrS rS%S jrS rS rS rS rS rS rS&S jr\ RB                  4S jr"S SS!S\#RH                  SS"4S# jr%S$r&U =r'$ )'r      a@  
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                 z   > Xl         X l        X0l        [        TU ]  [
        R                  U R                  5        g N)rawpdfformenvsuper__init__r   _close_impl)selfr   r   r   	__class__s       W/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/pypdfium2/_helpers/page.pyr   PdfPage.__init__"   s+    ,,dll;    c                 j    U(       a  [         R                  " X5        [         R                  " U 5        g r   )pdfium_cFORM_OnBeforeClosePageFPDF_ClosePage)r   r   s     r   r   PdfPage._close_impl)   s!    ++C9$r   c                     U R                   $ r   )r   r   s    r   parentPdfPage.parent0   s     xxr   c                 .    [         R                  " U 5      $ )zH
Returns:
    float: Page width (horizontal size), in PDF canvas units.
)r   FPDF_GetPageWidthFr   s    r   	get_widthPdfPage.get_width6   s    
 **400r   c                 .    [         R                  " U 5      $ )zG
Returns:
    float: Page height (vertical size), in PDF canvas units.
)r   FPDF_GetPageHeightFr   s    r   
get_heightPdfPage.get_height=   s    
 ++D11r   c                 B    U R                  5       U R                  5       4$ )zJ
Returns:
    (float, float): Page width and height, in PDF canvas units.
)r#   r'   r   s    r   get_sizePdfPage.get_sizeD   s    
  $//"344r   c                 P    [         R                  [        R                  " U 5         $ )z7
Returns:
    int: Clockwise page rotation in degrees.
)pdfium_iRotationToDegreesr   FPDFPage_GetRotationr   s    r   get_rotationPdfPage.get_rotationN   s     
 ))8+H+H+NPPr   c                 T    [         R                  " U [        R                  U   5        g)zL
Define the absolute, clockwise page rotation (0, 90, 180, or 270 degrees).
N)r   FPDFPage_SetRotationr-   RotationToConst)r   rotations     r   set_rotationPdfPage.set_rotationU   s     	%%dH,D,DX,NOr   c                     [        5       [        5       [        5       [        5       4u  pEpgU" XXVU5      nU(       d  U(       a  U" 5       $ S $ UR                  UR                  UR                  UR                  4$ r   )c_floatvalue)	r   box_funcfallback_funcfallback_okleftbottomrighttopoks	            r   _get_boxPdfPage._get_box\   s\    #*9giGI#M ed&5'2MO==

FLL%++syyAAr   Tc                 F    U R                  [        R                  S U5      $ )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).
c                      g)N)r   r   id  i   rG   r   r   <lambda>&PdfPage.get_mediabox.<locals>.<lambda>p   s    DTr   )rC   r   FPDFPage_GetMediaBoxr   r=   s     r   get_mediaboxPdfPage.get_mediaboxe   s     }}X::<TVabbr   c                 4    [         R                  " XX#U5        g)z^
Set the page's MediaBox by passing four :class:`float` coordinates (usually x0, y0, x1, y1).
N)r   FPDFPage_SetMediaBoxr   lbrts        r   set_mediaboxPdfPage.set_mediaboxr        	%%dqQ7r   c                 X    U R                  [        R                  U R                  U5      $ )zK
Returns:
    The page's CropBox (If not defined, falls back to MediaBox).
)rC   r   FPDFPage_GetCropBoxrL   rK   s     r   get_cropboxPdfPage.get_cropboxx   s#    
 }}X994;L;LkZZr   c                 4    [         R                  " XX#U5        g)z
Set the page's CropBox.
N)r   FPDFPage_SetCropBoxrP   s        r   set_cropboxPdfPage.set_cropbox        	$$TaA6r   c                 X    U R                  [        R                  U R                  U5      $ )zK
Returns:
    The page's BleedBox (If not defined, falls back to CropBox).
)rC   r   FPDFPage_GetBleedBoxrZ   rK   s     r   get_bleedboxPdfPage.get_bleedbox   s#    
 }}X::D<L<LkZZr   c                 4    [         R                  " XX#U5        g)z
Set the page's BleedBox.
N)r   FPDFPage_SetBleedBoxrP   s        r   set_bleedboxPdfPage.set_bleedbox   rW   r   c                 X    U R                  [        R                  U R                  U5      $ )zJ
Returns:
    The page's TrimBox (If not defined, falls back to CropBox).
)rC   r   FPDFPage_GetTrimBoxrZ   rK   s     r   get_trimboxPdfPage.get_trimbox   s#    
 }}X994;K;K[YYr   c                 4    [         R                  " XX#U5        g)z
Set the page's TrimBox.
N)r   FPDFPage_SetTrimBoxrP   s        r   set_trimboxPdfPage.set_trimbox   r`   r   c                 X    U R                  [        R                  U R                  U5      $ )zI
Returns:
    The page's ArtBox (If not defined, falls back to CropBox).
)rC   r   FPDFPage_GetArtBoxrZ   rK   s     r   
get_artboxPdfPage.get_artbox   s#    
 }}X88$:J:JKXXr   c                 4    [         R                  " XX#U5        g)z
Set the page's ArtBox.
N)r   FPDFPage_SetArtBoxrP   s        r   
set_artboxPdfPage.set_artbox   s     	##DQ15r   c                     [         R                  " 5       n[         R                  " X5      nU(       d  [        S5      eUR                  UR
                  UR                  UR                  4$ )zb
Returns:
    The bounding box of the page (the intersection between its media box and crop box).
z Failed to get page bounding box.)r   FS_RECTFFPDF_GetPageBoundingBoxr   r>   r?   r@   rA   )r   rectrB   s      r   get_bboxPdfPage.get_bbox   sP    
   "--d9@AA		4;;

DHH==r   c                     [         R                  " U 5      nU(       d  [        S5      e[        X5      nU R	                  U5        U$ )zA
Returns:
    PdfTextPage: A new text page handle for this page.
zFailed to load text page.)r   FPDFText_LoadPager   r   _add_kid)r   raw_textpagetextpages      r   get_textpagePdfPage.get_textpage   s>    
  11$79::|2hr   c                     UR                   (       a  [        S5      eUR                  (       a$  UR                  U R                  La  [        S5      e[        R                  " X5        UR                  5         Xl         U R                  Ul        g)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   r   FPDFPage_InsertObject_detach_finalizer)r   pageobjs     r   
insert_objPdfPage.insert_obj   sc     <<`aa;;GKKtxx7abb&&t5!!#hhr   c                 t   UR                   U La  [        S5      eUR                  S:  a@  UR                  c   e[        R
                  " UR                  U5      nSu  Ul        Ul        O%UR                  b   e[        R                  " X5      nU(       d  [        S5      eSUl         UR                  5         g)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.r   N)r   NzFailed to remove pageobject.)	r   r   level	containerr   FPDFFormObj_RemoveObjectFPDFPage_RemoveObjectr   _attach_finalizer)r   r   rB   s      r   
remove_objPdfPage.remove_obj   s     <<t#_``==1$$0002273D3DgNB/6,GM7,$$,,,//>B<==!!#r   c                 T    [         R                  " U 5      nU(       d  [        S5      eg)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)r   FPDFPage_GenerateContentr   )r   rB   s     r   gen_contentPdfPage.gen_content  s(     ..t4@AA r   Nr   c           	   #      #    U(       a#  [         R                  n[         R                  nUnO"[         R                  n[         R                  nU nU" U5      nUS:  a  [        S5      e[        U5       H  n	U" Xy5      n
U
(       d  [        S5      e[        XU R                  X4S9nU(       a  UR                  U;   a  Uv   UR                  [         R                  :X  d  Mm  XBS-
  :  d  Mw  U R                  UUUUS-   S9 Sh  vN   M     g N	7f)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.
r   z$Failed to get number of pageobjects.zFailed to get pageobject.)r   r   r   r      )filter	max_depthformr   N)r   FPDFFormObj_CountObjectsFPDFFormObj_GetObjectFPDFPage_CountObjectsFPDFPage_GetObjectr   ranger   r   typeFPDF_PAGEOBJ_FORMget_objects)r   r   r   r   r   count_objects
get_objectr   	n_objectsiraw_obj
helper_objs               r   r   PdfPage.get_objects  s       $==M!77JF$::M!44JF!&)	q=DEEy!A +G!"=>> #7488taJZ__6  ("<"<<STAT++# )%!AI	 ,    "s   CD D*DD
Dc                     U R                   (       d  [        S5      e[        R                  " X5      nU[        R                  :X  a  [        S5      eU$ )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   RuntimeErrorr   FPDFPage_FlattenFLATTEN_FAILr   )r   flagrcs      r   flattenPdfPage.flatten>  sF     ||ijj&&t2&&&LMM	r   r   )r   r   r   r   Fc                 L   [         R                  " U R                  5       U-  5      n	[         R                  " U R                  5       U-  5      n
US;   a  XpU Vs/ s H  n[         R                  " X-  5      PM     nnXS   -
  US   -
  nXS   -
  US   -
  n[	        S X4 5       5      (       a  [        S5      e[        U 40 UD6u  pnnUb  U(       a  U[        R                  -  nU" XXS9nUR                  USSX5        US   * US   * X[        R                  U   4nUU /UQUP7nUc  [        R                  " U6   O[        R                  " SS	9n[        R                  " US
S 5        UR                  U5      n[        R                   " / UQUPUP76 nU[        R"                  :X  d   e[        R$                  " U 5        U(       a2  U R&                  (       a!  [        R(                  " U R&                  /UQ76   [*        R,                  " U 5      /UQ7Ul        U$ s  snf )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* 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.
)Z   i  r      r      c              3   *   #    U  H	  oS :  v   M     g7f)r   NrG   ).0ds     r   	<genexpr>!PdfPage.render.<locals>.<genexpr>  s     .o1uos   zCrop exceeds page dimensions)formatrev_byteorder)versionNeedToPauseNowc                     g)NFrG   )_s    r   rH    PdfPage.render.<locals>.<lambda>  s    Ur   )mathceilr#   r'   anyr   _parse_renderoptsr   FPDF_CONVERT_FILL_TO_STROKE	fill_rectr-   r4   FPDF_RenderPageBitmapIFSDK_PAUSEset_callbackconvert*FPDF_RenderPageBitmapWithColorScheme_StartFPDF_RENDER_DONEFPDF_RenderPage_Closer   FPDF_FFLDrawweakrefref	_pos_args)r   scaler5   cropmay_draw_formsbitmap_makercolor_schemefill_to_strokekwargs	src_width
src_heightcwidthheight	cl_formatr   
fill_colorflagsbitmappos_argsrender_argspausefpdf_csstatuss                           r   renderPdfPage.renderX  s   N YYt~~/589	YYt0589
y $.z,01Dq		!'"D11g%Q/1g%Q/.uo...;<<6G6WPV6W3	*e$.X999EeI[Q59!WHtAwh	x?W?WX`?abt6h66**K8((3E!!%)9?K"**=9GHHf+fW^f`efFX66666**40dll!!$,,==#KK-99= 2s   "H!)r   r   r   )T)N   Nr   )(__name__
__module____qualname____firstlineno____doc__r   staticmethodr   propertyr   r#   r'   r*   r0   r6   rC   rL   rU   rZ   r^   rc   rg   rk   ro   rs   rw   r}   r   r   r   r   r   r   FLAT_NORMALDISPLAYr   r   
new_nativer   __static_attributes____classcell__)r   s   @r   r   r      s    
< % %  
125QPBc8[7[8Z7Y6	>
0$BB.b $66 8 !$//"J Jr   r   c                     US   S:  d"  U(       a+  [         R                  " U 5      (       a  [         R                  $ U(       a  [         R                  $ U(       a  [         R                  $ [         R
                  $ )Nr      )r   FPDFPage_HasTransparencyFPDFBitmap_BGRAFPDFBitmap_GrayFPDFBitmap_BGRxFPDFBitmap_BGR)r   r   	grayscaleprefer_bgrxmaybe_alphas        r   _auto_bitmap_formatr    sY     !}s{x/P/PQU/V/V'''	'''	'''&&&r   c                    Uc  [        XX+U5      nOUnU[        R                  :X  a  Sn
UnU(       a  U[        R                  -  nU(       a  U[        R                  -  nU(       a  U[        R
                  -  nU(       a  U[        R                  -  nU(       a  U[        R                  -  nU(       a  U[        R                  -  nU	(       a  U[        R                  -  nU
(       a  U[        R                  -  nU(       aR  UR                  5       nUS:X  a  U[        R                  -  nO(US:X  a  U[        R                  -  nO[        SU 35      eXUU4$ )NFlcdprintzInvalid optimize_mode )r  r   r   FPDF_GRAYSCALE
FPDF_ANNOTFPDF_RENDER_NO_SMOOTHTEXTFPDF_RENDER_NO_SMOOTHIMAGEFPDF_RENDER_NO_SMOOTHPATHFPDF_RENDER_FORCEHALFTONEFPDF_RENDER_LIMITEDIMAGECACHEFPDF_REVERSE_BYTE_ORDERlowerFPDF_LCD_TEXTFPDF_PRINTINGr   )r   r   r  optimize_modedraw_annotsno_smoothtextno_smoothimageno_smoothpathforce_halftonelimit_image_cacher   r  r  force_bitmap_formatextra_flagsr   r   s                    r   r   r     s1   $ "')R]^	'	H,,,E((($$$333444333333777111%++-E!X+++Eg%X+++E5m_EFF Z66r   c                   *    \ rS rSrSrS rS rS rSrg)r   i+  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                 "    [        XX4S9U l        g )N)path_fill_colorpath_stroke_colortext_fill_colortext_stroke_color)dictcolors)r   	path_fillpath_stroke	text_filltext_strokes        r   r   PdfColorScheme.__init__1  s    %%
r   c                 L    [        U 5      R                   SU R                   S3$ )Nz(**))r   r   r#  r   s    r   __repr__PdfColorScheme.__repr__7  s$    t*%%&c$++a88r   c           	          [         R                  " 5       nU R                  R                  5        H%  u  p4[	        X#[
        R                  " XA5      5        M'     U$ )zD
Returns:
    The color scheme as :class:`FPDF_COLORSCHEME` object.
)r   FPDF_COLORSCHEMEr#  itemssetattrr-   color_tohex)r   r   r   keyr:   s        r   r   PdfColorScheme.convert:  sE    
 ++-++++-JCG("6"6u"LM .r   )r#  N)	r   r   r   r   r   r   r+  r   r   rG   r   r   r   r   +  s    

9r   r   ))r   r   r   r   FNTFFFFFFFFNr   )__all__r   ctypesloggingr   pypdfium2.rawr   r   pypdfium2.internalinternalr-   pypdfium2._helpers.miscr   pypdfium2._helpers.bitmapr   pypdfium2._helpers.textpager   pypdfium2._helpers.pageobjectsr   r9   	getLoggerr   loggerAutoCloseabler   r  r   r   rG   r   r   <module>rA     s    (       % / / 3 4
..			8	$Mx%% M`
' *!"67r r   