mjvTddlmZddlZddlmZddlmZddlmZddl m Z m Z m Z ddl mZdd lmZdd lmZdd lmZdd lmZmZmZmZdd lmZddlmZmZmZm Z m!Z!m"Z"ddl#m$Z$m%Z%e r ddl&m'Z'ddl(m)Z)dZ*eGddZ+GddeZ,GddeZ-Gdde,Z.y)) annotationsN) dataclass)IntEnum)BytesIO) TYPE_CHECKINGAnycast)fill_from_encoding)CORE_FONT_METRICS)Font)logger_warning)AnnotationDictionaryAttributes BorderStylesFieldDictionaryAttributesPageAttributes) PdfReadError)DecodedStreamObjectDictionaryObjectIndirectObject NameObject NumberObjectRectangleObject)ByteStringObjectTextStringObject) PdfWriter) PageObject cPeZdZUdZdZded<dZded<ejZ ded <y ) BaseStreamConfigzBA container representing the basic layout of an appearance stream.)r!r!r!z3RectangleObject | tuple[float, float, float, float] rectangleint border_widthstr border_styleN) __name__ __module__ __qualname____doc__r"__annotations__r%rSOLIDr'S/root/.hermes/venv/lib/python3.12/site-packages/pypdf/generic/_appearance_stream.pyr r !s*LEYIBYL#$**L#*r/r c$eZdZdZdfd ZxZS)BaseStreamAppearancez^A class representing the very base of an appearance stream, that is, a rectangle and a border.ct||xs t|_t d|t d<t d|t d<t |jj |t d<y)z Takes the appearance stream layout as an argument. Args: layout: The basic layout parameters. z/XObject/Typez/Form/Subtype/BBoxN)super__init__r _layoutrrr")selflayout __class__s r0r8zBaseStreamAppearance.__init__,sf 3!1!3 $.z$:Z !'1'':Z #$$3DLL4J4J$KZ !r/)r;BaseStreamConfig | NonereturnNone)r(r)r*r+r8 __classcell__r<s@r0r2r2)sh L Lr/r2ceZdZdZdZdZdZy) TextAlignmentzODefines the alignment options for text within a form field's appearance stream.rr#r N)r(r)r*r+LEFTCENTERRIGHTr.r/r0rCrC:sY D F Er/rCc eZdZdZ d ddZddddej ddf ddZdd dddddddej ddf dfd Ze dd Z e d dd Z e d dd Z xZS)TextStreamAppearanceaH A class representing the appearance stream for a text-based form field. This class generates the content stream (the `ap_stream_data`) that dictates how text is rendered within a form field's bounding box. It handles properties like font, font size, color, multiline text, and text selection highlighting. c g} g} d} |j|zdz } |D]} | js| jd&| j|j}t |D]\}}|j ||zdz }| |z|r| ndz}||kDr4| r2| j| |jj| f|g} |} b| s||kDr| j||fg} d} | r| | z } | j|| |z } | s| j| |jj| fg} d} !|t| dz |z|zz}||kDr"||z }||k\r|j||||||||S| t|dfS)ap Takes a piece of text and scales it to field_width or field_height, given font_name and font_size. Wraps text where necessary. Args: font: The font to be used. font_size: The font size in points. leading_factor: The line distance. field_width: The width of the field in which to fit the text. field_height: The height of the field in which to fit the text. paragraphs: The text paragraphs to fit with the field. min_font_size: The minimum font size at which to scale the text. font_size_step: The amount by which to decrement font size per step while scaling. Returns: The text in the form of list of tuples, each tuple containing the length of a line and its contents, and the font_size for these lines and lengths. r)r!r#) space_widthstripappendsplit space_char enumerateget_text_widthjoinlen _scale_textround)r:font font_sizeleading_factor field_width field_height paragraphs min_font_sizefont_size_step wrapped_linescurrent_line_wordscurrent_line_widthrL paragraphwordsiword word_width test_widthestimated_total_height new_font_sizes r0rUz TextStreamAppearance._scale_textKs: (*$%&&2T9 # 'I??$$$Y/OODOO4E$U+ 54!006BTI /*R>RSe>f)gh*.&)3&+ [0H!((*d);<)+&)*&)*k9*&--d3&*4& 5 "$$&8$//:N:NOa:b%cd%'"%&"1 '4"+c-.@1.D-VYb-b!b !L 0%6M -''!" !"  eIq111r//Helvr!z0 gFNc |jj} t| tr t | } |j j d|j j dz dz } |jjdvrdnd} t|jj| zd}| jd|zz }| jd|zz }|j\}}d d}d!d}|d k(rd }|rd }|rFt}|jDcgc] }||| }}|j||| ||||\}}n|| z }|||}|j!|d z }||xsdz }t#tt%|||d}||z|fg}n| r}| r!t'|| kDrt)d t*|| g}t-|D]I\}}|| xs t'|ks|||}|j/|j!||zd z |fKnHg}|jD]3}|||}|j/|j!||zd z |f5|r0| j|z|j j d|zdz z } n%|||j j0|zd z z dz z} |d|d|}!dd|zd|d|d|d|!d j3}"d }#t-|D]}\}$\}%}|rV||dj5||vr<|"d| |$|z| zz dz d| jdz d|dzd|!d j3z }"d }&| r"| r | j| z }'|'|%z dz }(|$|'z|(z}&nT|t6j8k(r| j|dzz |%z }&n+|t6j:k(r| j|%z dz }&n|dz}&|&|#z })d }*|$d k(r| }*n | rd}*n| | z}*|"|)d|*dj3z }"|&}#|||}+t=d|+Dr8|"ddj5|+j?j3zdzz }"d|"ddj5|+zdzz }"|"dz }"|"Scc}w)"a Generates the raw bytes of the PDF appearance stream for a text field. This private method assembles the PDF content stream operators to draw the provided text within the specified rectangle. It handles text positioning, font application, color, and special formatting like selected text. Args: text: The text to be rendered in the form field. selection: An optional list of strings that should be highlighted as selected. font: The font to use. font_name: The name of the font resource to use (e.g., "/Helv"). font_size: The font size. If 0, it is automatically calculated based on whether the field is multiline or not. font_color: The color to apply to the font, represented as a PDF graphics state string (e.g., "0 g" for black). is_multiline: A boolean indicating if the text field is multiline. alignment: Text alignment, can be TextAlignment.LEFT, .RIGHT, or .CENTER. is_comb: Boolean that designates fixed-length fields, where every character fills one "cell", such as in a postcode. max_length: Used if is_comb is set. The maximum number of characters for a fixed- length field. Returns: A byte string containing the PDF content stream data. r#g@@>/B/Ir c8djfd|DS)NrKc3BK|]}j||ywN)get).0 character reverse_cmaps r0 zfTextStreamAppearance._generate_appearance_stream_data.._unicode_to_glyph_id..sXi<++IyAXs)rS)textrvs `r0_unicode_to_glyph_idzSTextStreamAppearance._generate_appearance_stream_data.._unicode_to_glyph_ids77XSWXX Xr/c |Dcgc]7}|j|t|dkrtt|fnd9c}Scc}w)N?)rsordbytes)glyphs encoding_cmapglyph_ids r0_glyph_id_to_byteszQTextStreamAppearance._generate_appearance_stream_data.._glyph_id_to_bytessM%&"%%S]S5H%X 01d& &&s.@s513q6Q;5s Tj (s) Tj s ET Q EMC Q )rxr&rvzdict[str, str]r>r&)rr&rzdict[str, bytes]r>z list[bytes]) r9r" isinstancetuplerfont_descriptorbboxr'maxr%heightwidth_get_typographic_mapsDEFAULT_FONT_SIZE_IN_MULTILINE splitlinesrUrRrVminrTrr(rQrNascentencoderSrCrFrEanyhex),r:rx selectionrW font_namerX font_color is_multiline alignmentis_combrr"rYfactormarginr[rZrvrryrr]rbglyph_paragraphslinesmax_vertical_sizertext_width_unscaledmax_horizontal_sizeindexcharliney_offsetdefault_appearance ap_stream current_x_pos line_number line_widthdesired_abs_x_start cell_widthcentering_offset_in_cell x_rel_offset y_rel_offset encoded_lines, r0 _generate_appearance_stream_dataz5TextStreamAppearance._generate_appearance_stream_datas_PLL** i '' 2I..33A69M9M9R9RST9UUY__ll//<?QT\\..7; ''!f*4 ooF 2 &*&@&@&B# m Y & >M$ : SWSbSbSd$FO(LA$ $$(#3#3" $!$ y%1>$A!-dLA&*&9&9&&AD&H#&15H5MA&N#!#c*;=P&QS`"acde - 96BC c$i*45$)E( [ tJ3#d)41$ EFLL$"5"5f"= "ID"PRX!YZ [ E) W-dLA d11&9IELfUV W  ''&043G3G3L3LQ3OR[3[^d3ddH,1E1E1L1Ly1X[_1_"_cd!deH ){!I;d:,Gq6zl!F81[M<.Q,-R 1 &(  ! /8/?1 G +K+*dT%9"''):Ll%[[[9%<~%MNQRRSST *+1Y]O<));(L#$La' " !*{^;  L><.>EEG GI0M-dMBL5 55TSXXl%;$@$@$B$I$I$KKiWW TCHH\$::YFF c1 Gd '' W$s Q-rKc t|||r|sd}td} td}t dit t td|d| jt|Dcic],\}}|| jvrt|| j|.c}}}| jd|jd<|j}|j||||||| | | |  }|jt|t!t#||t%d <t't%d t't%|t)|d |ii|t%d <y cc}}w)a( Initializes a TextStreamAppearance object. This constructor creates a new PDF stream object configured as an XObject of subtype Form. It uses the `_appearance_stream_data` method to generate the content for the stream. Args: layout: The basic layout parameters. text: The text to be rendered in the form field. selection: An optional list of strings that should be highlighted as selected. font: A Font object. Falls back to Type 1 Helvetica if not given. font_resource: An optional variable that represents a PDF font dictionary. Falls back to Type 1 Helvetica if not given. font_name: The name of the font resource, e.g., "/Helv". font_size: The font size. If 0, it's auto-calculated. font_color: The font color string. is_multiline: A boolean indicating if the text field is multiline. alignment: Text alignment, can be TextAlignment.LEFT, .RIGHT, or .CENTER. is_comb: Boolean that designates fixed-length fields, where every character fills one "cell", such as in a postcode. max_length: Used if is_comb is set. The maximum number of characters for a fixed- length field. rj Helveticacp1252r{Type1name character_mapencodingsub_typercharacter_widthsdefaultrrXrrrrr/Length/Fontindirect_reference /ResourcesN)r7r8r r r dictziprangerrQrchras_font_resourcerset_datarrrTrrgetattr)r:r;rxrrW font_resourcerrXrrrrrcore_font_metricswin_ansi_encoding_listcodevalueap_stream_datar<s r0r8zTextStreamAppearance.__init__HsP  =I 1+ > %7%A "  c%*.DEF 1 A A\e.]"MXTSX"3"D"DDI0AA%HH" D0A/Q/QR[/\D ! !) , 113M>>   !%!?   &~67&23~3F&GZ "#)9 w !19%w}>RTa'b3"; * Z %&3"s)1E&c tt|jd|jdt}|jdt}|j|d}|rt j |}n|j dtvrtdt|d}t|j d}t |j ditttdtdd |j|j }|j!|} | s|jj"r_|j$d k(rP |j't)|jj"j+}d }|j!|} | stdt|||fS#t,t.f$r} td t| Yd} ~ >d} ~ wwxYw)N/DRr/zEFont dictionary for %(font_name)s not found; defaulting to Helvetica.)rrz /Helveticar{rrrTrueTypez/PYPDF1z/Unable to use embedded font for encoding: %(e)s)rezText string '%(text)s' contains characters not supported by font encoding. This may result in text corruption. Consider calling writer.update_page_form_field_values with auto_regenerate=True.)rrx)r r get_inheritedrsr from_font_resource removeprefixr rr(rrrr rr can_encode font_filerfrom_truetype_font_filerget_data ImportErrorr) r annotation acro_formrxacro_form_resourcesacro_form_font_resourcesrrWr encodablers r0_find_annotation_font_resourcez3TextStreamAppearance._find_annotation_font_resources$(   $ $ e%5%78 $ $7#:#:7DTDV#W 044YE **=9D %%c*2CC[#' ) 1)2H2H2M N ++C0 c%*.@.JKL 1 A A!2!C!C DOOD) ##--$--:2Ml77@T@T@^@^@g@g@i8jkD )I $ 5Ik$$$\2l"#T]eijkklsAF99G$GG$c|jtdtj}||vr|j ||t|}n||}|rmt t|t jjtdtj}||vrt|d||t|<|S)z Unified helper to sync fonts from an AP stream to a target resource dictionary (e.g., AcroForm /DR). Will sync to page resources as well when page is added to the arguments. rr) setdefaultrr get_object_add_to_writerr r RESOURCESr)writerrrWtarget_resource_dictpage target_fontsfont_resource_referencepage_fonts_resources r0&_sync_appearance_stream_font_resourcesz;TextStreamAppearance._sync_appearance_stream_font_resourcess,66z'7JL\L^_jjl L (&*&9&99%' # '39&= # "&'7n>V>V9W"X"c"c7#%5%7#jl  33=D+-ACZ>#Jy$9:'&r/c  tt|tj} tddt | d| dz t | d| dz f} |j tj |jtj d} | s td} n| j} |jtjd} |jtjddk(ru| tjjzdk(rUd j|j tj g} |jd g}t#|t$s|g}n|jd d } g}| j'd d j'ddj'dd} t)j*d| Dcgc]}|s| }}|j-|j/ddz }t1|j-|j/ddz }|j3ddj|}|r|}n|}|dkDr|}|j5|||| \}}||k7r't| j'|||t7d<|j9||||j;t7dt=|r|nd}d}d}| tjj>zrd}|jd}d}| tjj@zrd}|jdtBjD}d}tFjH}d|vrFtt<|djd|}tt<|djd|}tK| ||}||| |||||||||| }tjL|vrtt<|tjLjd ijOD]g\}} |d!vr |d"k(rSd#| vr$t=| jt7d#<tQ|d$|| d#jt7|<c| ||<i|Scc}w)%aE Creates a TextStreamAppearance object from a text field annotation. This class method is a factory for creating a `TextStreamAppearance` instance by extracting all necessary information (bounding box, font, text content, etc.) from the PDF field and annotation dictionaries. It respects inheritance for properties like default appearance (`/DA`). Args: writer: The PdfWriter instance that we are creating text stream appearances for. page: The page that we are processing annotations for. flatten: Whether we flatten text annotations or not. If true, add new font resource to the page font resources. Otherwise, add them to the AcroForm resources. acro_form: The root AcroForm dictionary from the PDF catalog. field: The field dictionary object. annotation: The widget annotation dictionary object associated with the field. user_font_name: An optional user-provided font name to override the default. Defaults to an empty string. user_font_size: An optional user-provided font size to override the default. A value of -1 indicates no override. Returns: A new `TextStreamAppearance` instance configured for the given field. rr rlr#Nz/Helv 0 Tf 0 gz/Txz/Chrz/VrK\z\\(z\()z\)z\sTfrz/DArFTz/MaxLenz/Qz/BSz/Wz/S)r"r%r'rz/N>/Filterr6r4rr5rrr))r rrRectabsrDArsrrrFfFTFfBitsComborSOptrlistreplacererOpoprfloatremoverrrrrComb MultilinerCrDrr-r APitemsr)!clsrrflattenrfieldruser_font_nameuser_font_size _rectangler"r field_flagsrxrpropfont_properties da_font_namerXrrrWrrrrrr%r'r;new_appearance_streamkeyrs! r0from_text_annotationz)TextStreamAppearance.from_text_annotationsmL/:6T6Y6Y+Z[ #Q3z!}z!}/L+MsS]^_S`cmnocpSpOq$rs (55 * - - MM8;;T B "!12B!C !3!>!>!@ ii 9 < %G7>>DDDI99Z556O6S6SUWXYD $+Ii.&K 99T2&DI||D&)11#u=EEc5Q-/HHU> >G# 2J 299CC CLIIdM$6$67  #)) E> 0%,?CCD,WL 0%,?CCD,WL"IL_kl #     #!%! !  * , , :%z2P2S2S'TUYYZ^`bciik 7 UNN,&e+BRBT((*:g+>?IP/1EG^JE'N--/ 90EF27)#. 7%$]Ys RR)g?)rWr rXrrYrrZrr[rr\z list[str]r]rr^rr>z%tuple[list[tuple[float, str]], float])rxr&rlist[str] | NonerWr rr&rXrrr&rboolrrCrrr int | Noner>r~)r;r=rxr&rrrWz Font | Nonerz(DictionaryObject | IndirectObject | Nonerr&rXrrr&rrrrCrrrrr>r?) rr&rrrrrxr&r>ztuple[str, Font]rr) rrrr&rWr rrrzPageObject | Noner>r)rK)rrrrr rrrr rrrrr&rrr>rH)r(r)r*r+rUrCrDrr8 staticmethodrr classmethodrr@rAs@r0rHrHBs"!$J2J2J2 J2  J2  J2J2J2J2 /J2b!"#0#5#5!%oo$o o  o  ooo!ooo of+/&* BF "#0#5#5!%Q 'Q Q $ Q  Q @ Q Q Q Q Q !Q Q Q  Q fBB(B(B B  BBH #' ''''/ '  '  ''@! "Z%Z%Z% Z% $ Z%  Z%%Z%Z%Z% Z%Z%r/rH)/ __future__rr dataclassesrenumriortypingrrr _codecsr _codecs.core_font_metricsr _fontr _utilsr constantsrrrrerrorsrgenericrrrrrr generic._baserr pypdf._writerr_pagerrr r2rCrHr.r/r0r-s" !++(9#oo!?'"!# ++ +L.L"GZ %/Z %r/