
    c?1i<Y                        d Z ddlZddlZddlZddlZddlmZ ddlm	Z
 ddlmZ ddlmZ ddlmZ ddlmZ ej&                  Z ej(                  e      Z G d de
j.                        Zd	 Z	 	 	 	 	 	 	 	 	 	 	 	 	 	 dd
Z G d d      Zy))PdfPagePdfColorScheme    N)PdfiumError)	PdfBitmap)PdfTextPage)	PdfObjectc                       e Zd ZdZ fdZed        Zed        Zd Z	d Z
d Zd Zd	 Zd
 Zd#dZd Zd#dZd Zd#dZd Zd#dZd Zd#dZd Zd Zd Zd Zd Zd Zd$dZej@                  fdZ!ddd de"jF                  dd!fd"Z$ xZ%S )%r   ah  
    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                  | j                         y N)rawpdfformenvsuper__init__r   _close_impl)selfr   r   r   	__class__s       a/home/www/therecruiter.miabetepe.com/venv/lib/python3.12/site-packages/pypdfium2/_helpers/page.pyr   zPdfPage.__init__"   s1    ,,dll;    c                 ^    |rt        j                  | |       t        j                  |        y r   )pdfium_cFORM_OnBeforeClosePageFPDF_ClosePage)r   r   s     r   r   zPdfPage._close_impl)   s#    ++C9$r   c                     | j                   S r   )r   r   s    r   parentzPdfPage.parent0   s     xxr   c                 ,    t        j                  |       S )z`
        Returns:
            float: Page width (horizontal size), in PDF canvas units.
        )r   FPDF_GetPageWidthFr   s    r   	get_widthzPdfPage.get_width6   s    
 **400r   c                 ,    t        j                  |       S )z_
        Returns:
            float: Page height (vertical size), in PDF canvas units.
        )r   FPDF_GetPageHeightFr   s    r   
get_heightzPdfPage.get_height=   s    
 ++D11r   c                 B    | j                         | j                         fS )zb
        Returns:
            (float, float): Page width and height, in PDF canvas units.
        )r   r"   r   s    r   get_sizezPdfPage.get_sizeD   s    
  $//"344r   c                 N    t         j                  t        j                  |          S )zO
        Returns:
            int: Clockwise page rotation in degrees.
        )pdfium_iRotationToDegreesr   FPDFPage_GetRotationr   s    r   get_rotationzPdfPage.get_rotationN   s     
 ))8+H+H+NPPr   c                 R    t        j                  | t        j                  |          y)z\
        Define the absolute, clockwise page rotation (0, 90, 180, or 270 degrees).
        N)r   FPDFPage_SetRotationr&   RotationToConst)r   rotations     r   set_rotationzPdfPage.set_rotationU   s     	%%dH,D,DX,NOr   c                     t               t               t               t               f\  }}}} || ||||      }|s|r |       S d S |j                  |j                  |j                  |j                  fS r   )c_floatvalue)	r   box_funcfallback_funcfallback_okleftbottomrighttopoks	            r   _get_boxzPdfPage._get_box\   sd    #*9giGI#M feSdD&%5'2MO==

FLL%++syyAAr   Tc                 F    | j                  t        j                  d |      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).
        c                       y)N)r   r   id  i   r=   r   r   <lambda>z&PdfPage.get_mediabox.<locals>.<lambda>p       r   )r:   r   FPDFPage_GetMediaBoxr   r4   s     r   get_mediaboxzPdfPage.get_mediaboxe   s     }}X::<TVabbr   c                 6    t        j                  | ||||       y)zn
        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_mediaboxzPdfPage.set_mediaboxr        	%%dAq!Q7r   c                 X    | j                  t        j                  | j                  |      S )zc
        Returns:
            The page's CropBox (If not defined, falls back to MediaBox).
        )r:   r   FPDFPage_GetCropBoxrB   rA   s     r   get_cropboxzPdfPage.get_cropboxx   s#    
 }}X994;L;LkZZr   c                 6    t        j                  | ||||       y)z)
        Set the page's CropBox.
        N)r   FPDFPage_SetCropBoxrE   s        r   set_cropboxzPdfPage.set_cropbox        	$$T1aA6r   c                 X    | j                  t        j                  | j                  |      S )zc
        Returns:
            The page's BleedBox (If not defined, falls back to CropBox).
        )r:   r   FPDFPage_GetBleedBoxrN   rA   s     r   get_bleedboxzPdfPage.get_bleedbox   s#    
 }}X::D<L<LkZZr   c                 6    t        j                  | ||||       y)z*
        Set the page's BleedBox.
        N)r   FPDFPage_SetBleedBoxrE   s        r   set_bleedboxzPdfPage.set_bleedbox   rK   r   c                 X    | j                  t        j                  | j                  |      S )zb
        Returns:
            The page's TrimBox (If not defined, falls back to CropBox).
        )r:   r   FPDFPage_GetTrimBoxrN   rA   s     r   get_trimboxzPdfPage.get_trimbox   s#    
 }}X994;K;K[YYr   c                 6    t        j                  | ||||       y)z)
        Set the page's TrimBox.
        N)r   FPDFPage_SetTrimBoxrE   s        r   set_trimboxzPdfPage.set_trimbox   rR   r   c                 X    | j                  t        j                  | j                  |      S )za
        Returns:
            The page's ArtBox (If not defined, falls back to CropBox).
        )r:   r   FPDFPage_GetArtBoxrN   rA   s     r   
get_artboxzPdfPage.get_artbox   s#    
 }}X88$:J:JKXXr   c                 6    t        j                  | ||||       y)z(
        Set the page's ArtBox.
        N)r   FPDFPage_SetArtBoxrE   s        r   
set_artboxzPdfPage.set_artbox   s     	##D!Q15r   c                     t        j                         }t        j                  | |      }|st        d      |j                  |j
                  |j                  |j                  fS )zz
        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   r5   r6   r7   r8   )r   rectr9   s      r   get_bboxzPdfPage.get_bbox   sR    
   "--dD9@AA		4;;

DHH==r   c                     t        j                  |       }|st        d      t        ||       }| j	                  |       |S )zY
        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_textpagezPdfPage.get_textpage   s@    
  11$79::|T2hr   c                    |j                   rt        d      |j                  r#|j                  | j                  urt        d      t        j                  | |       |j                          | |_         | j                  |_        y)a  
        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_objzPdfPage.insert_obj   sg     <<`aa;;GKKtxx7abb&&tW5!!#hhr   c                 `   |j                   | urt        d      |j                  dkD  r>|j                  J t	        j
                  |j                  |      }d\  |_        |_        n$|j                  J t	        j                  | |      }|st        d      d|_         |j                          y)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.)	rq   rr   level	containerr   FPDFFormObj_RemoveObjectFPDFPage_RemoveObjectr   _attach_finalizer)r   ru   r9   s      r   
remove_objzPdfPage.remove_obj   s     <<t#_``==1$$0002273D3DgNB/6,GM7,$$,,,//g>B<==!!#r   c                 H    t        j                  |       }|st        d      y)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   r9   s     r   gen_contentzPdfPage.gen_content  s(     ..t4@AA r   Nr   c              #     K   |r#t         j                  }t         j                  }|}n"t         j                  }t         j                  }| } ||      }|dk  rt        d      t        |      D ]  }	 |||	      }
|
st        d      t        |
| | j                  ||      }|r|j                  |v r| |j                  t         j                  k(  se||dz
  k  sn| j                  ||||dz         E d{     y7 w)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.)rq   r   ry   rx      )filter	max_depthformrx   N)r   FPDFFormObj_CountObjectsFPDFFormObj_GetObjectFPDFPage_CountObjectsFPDFPage_GetObjectr   ranger   r   typeFPDF_PAGEOBJ_FORMget_objects)r   r   r   r   rx   count_objects
get_objectr   	n_objectsiraw_obj
helper_objs               r   r   zPdfPage.get_objects  s
      $==M!77JF$::M!44JF!&)	q=DEEy! 	A +G!"=>> #7488t[`aJZ__6  ("<"<<STAT++# )%!AI	 ,   	s   CD D D 6C>7D c                     | j                   st        d      t        j                  | |      }|t        j                  k(  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.
        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   flattenzPdfPage.flatten>  sH     ||ijj&&tT2&&&LMM	r   r   )r   r   r   r   Fc                 "   t        j                  | j                         |z        }	t        j                  | j                         |z        }
|dv r|
|	}
}	|D cg c]  }t        j                  ||z         }}|	|d   z
  |d   z
  }|
|d   z
  |d   z
  }t	        d ||fD              rt        d      t        | fi |\  }}}}||r|t        j                  z  } |||||      }|j                  |dd||       |d    |d    |	|
t        j                  |   f}|| g||}|t        j                  |  nt        j                  d	      }t        j                  |d
d        |j                  |      }t        j                   g ||| }|t        j"                  k(  sJ t        j$                  |        |r,| j&                  r t        j(                  | j&                  g|  t+        j,                  |       g||_        |S c c}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* 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   &   K   | ]	  }|d k    yw)r   Nr=   ).0ds     r   	<genexpr>z!PdfPage.render.<locals>.<genexpr>  s     .q1u.s   zCrop exceeds page dimensions)formatrev_byteorder)versionNeedToPauseNowc                      y)NFr=   )_s    r   r>   z PdfPage.render.<locals>.<lambda>  r?   r   )mathceilr   r"   anyrr   _parse_renderoptsr   FPDF_CONVERT_FILL_TO_STROKE	fill_rectr&   r,   FPDF_RenderPageBitmapIFSDK_PAUSEset_callbackconvert*FPDF_RenderPageBitmapWithColorScheme_StartFPDF_RENDER_DONEFPDF_RenderPage_Closer   FPDF_FFLDrawweakrefref	_pos_args)r   scaler-   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   renderzPdfPage.renderX  s   N YYt~~/589	YYt0589
y $.	zI,01q		!E'"11d1g%Q/d1g%Q/.ufo..;<<6G6WPV6W3	=*e$.X999EeVI][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)T)N   Nr   )&__name__
__module____qualname____doc__r   staticmethodr   propertyr   r   r"   r$   r)   r.   r:   rB   rJ   rN   rQ   rU   rX   r[   r^   ra   rd   ri   ro   rv   r}   r   r   r   FLAT_NORMALDISPLAYr   r   
new_nativer   __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r   r   c                     |d   dk  s|r%t        j                  |       rt         j                  S |rt         j                  S |rt         j                  S t         j
                  S )Nr      )r   FPDFPage_HasTransparencyFPDFBitmap_BGRAFPDFBitmap_GrayFPDFBitmap_BGRxFPDFBitmap_BGR)rq   r   	grayscaleprefer_bgrxmaybe_alphas        r   _auto_bitmap_formatr     sV     !}s{x/P/PQU/V'''	'''	'''&&&r   c                 X   |t        | ||||      }n|}|t        j                  k(  rd}
|}|r|t        j                  z  }|r|t        j                  z  }|r|t        j
                  z  }|r|t        j                  z  }|r|t        j                  z  }|r|t        j                  z  }|	r|t        j                  z  }|
r|t        j                  z  }|rP|j                         }|dk(  r|t        j                  z  }n'|dk(  r|t        j                  z  }nt        d|       ||
||fS )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_PRINTINGrr   )rq   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     s7   $ "'j)[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 mZ66r   c                   "    e Zd ZdZd Zd Zd Zy)r   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                 ,    t        ||||      | _        y )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   zPdfColorScheme.__init__1  s    %%
r   c                 L    t        |       j                   d| j                   dS )Nz(**))r   r   r  r   s    r   __repr__zPdfColorScheme.__repr__7  s$    t*%%&c$++a88r   c           	          t        j                         }| j                  j                         D ]&  \  }}t	        ||t        j                  ||             ( |S )z\
        Returns:
            The color scheme as :class:`FPDF_COLORSCHEME` object.
        )r   FPDF_COLORSCHEMEr  itemssetattrr&   color_tohex)r   r   r   keyr1   s        r   r   zPdfColorScheme.convert:  sR    
 ++-++++- 	NJCGS("6"6um"LM	Nr   N)r   r   r   r   r   r
  r   r=   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   r0   	getLoggerr   loggerAutoCloseabler   r   r   r   r=   r   r   <module>r     s    (       % / / 3 4
..			8	$Mx%% M`
' *!"67r r   