ۡi#addlZddlmZddlmZddlmZmZmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZmZdd lmZmZmZmZmZdd lmZmZmZd Z eGddZ!GddeZ"GddeZ#Gdde"Z$y)N) dataclass)IntEnum)AnyOptionalUnioncast)fill_from_encoding)CORE_FONT_METRICS)Font)logger_warning)AnnotationDictionaryAttributes BorderStylesFieldDictionaryAttributes)DecodedStreamObjectDictionaryObject NameObject NumberObjectRectangleObject)ByteStringObjectTextStringObjectis_null_or_none cheZdZUdZdZeeeeeeeffe d<dZ e e d<e jZee d<y)BaseStreamConfigzBA container representing the basic layout of an appearance stream.)rrr rectangle border_width border_styleN)__name__ __module__ __qualname____doc__rrrtuplefloat__annotations__rintrSOLIDr strj/home/obispo/Crisostomo_bridge/mision_env/lib/python3.12/site-packages/pypdf/generic/_appearance_stream.pyrrsALK_Iu_eE5%,F&GGH_L#$**L#*r,rc4eZdZdZddeeddffd ZxZS)BaseStreamAppearancez^A class representing the very base of an appearance stream, that is, a rectangle and a border.Nlayoutreturnct||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)selfr0 __class__s r-r7zBaseStreamAppearance.__init__"sf 3!1!3 $.z$:Z !'1'':Z #$$3DLL4J4J$KZ !r,)N)r!r"r#r$rrr7 __classcell__r:s@r-r/r/s(h Lx(89 LT L Lr,r/ceZdZdZdZdZdZy) TextAlignmentzODefines the alignment options for text within a form field's appearance stream.rrr N)r!r"r#r$LEFTCENTERRIGHTr+r,r-r>r>0sY D F Er,r>ceZdZdZ d$dededededededed ed eeeeefeffd Z d d ddde jdd fdede eed fdede eeefdedededede dede ed efdZd dd d d ddde jdd f de edede eede ededededede dede ed d ffd Ze d%deded ed!ed"ed df d#ZxZS)&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. font font_sizeleading_factor field_width field_heighttext min_font_sizefont_size_stepr1c |} |jddjd} g} g} d} |j|zdz }| D]}|js| j d&|jd}t |D]\}}|j ||zdz }| |z|r|ndz}||kDr*| r(| j | dj| f|g} |} X| s||kDr| j ||fg} d} w| r| |z } | j || |z } | s| j | dj| fg} d} |t| dz |z|zz}||kDr"||z }||k\r|j|||||| ||S| t|dfS)a_ 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. text: The text 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) replacesplit space_widthstripappend enumerate text_widthjoinlen _scale_textround)r9rDrErFrGrHrIrJrK orig_text paragraphs wrapped_linescurrent_line_wordscurrent_line_widthrT paragraphwordsiword word_width test_widthestimated_total_height new_font_sizes r-r[z TextStreamAppearance._scale_textAs: \\$-33D9  (*$%&&2T9 # 'I??$$$Y/OOC(E$U+ 54!__T2Y>E /*Z)[\*.&)3&+ [0H!((*d);<)+&)*&)*k9*&--d3&*4& 5 "$$&8#((CU:V%WX%'"%&"1 '4"+c-.@1.D-VYb-b!b !L 0%6M -''!" !"  eIq111r,N/Helvrz0 gF selectionfont_glyph_byte_map font_name font_color is_multiline alignmentis_comb max_lengthc p|jj} |xsi}t| tr t | } |j j d|j j dz dz } |jjdvrdnd}t|jj|zd}| jd|zz }| jd|zz }|dk(rud}|rd }|r"t}|j||| ||||\}}n|| z }|j|d z }||xsdz }ttt!|||d}||z|fg}n| rn| r%t#|| kDrt%d |d | d t&t)|Dcgc]0\}}|| xs t#|kr|j||zd z |f2}}}nE|j+ddj-dDcgc]}|j||zd z |f}}|r0| j|z|j j d|zdz z }n%|||j j.|zd z z dz z}|d|d|}dd|zd|d|d|d|d j1}d}t)|D]\}\}}|r@||vr<|d|||z| zz dz d| jdz d|dzd|d j1z }d} | r"| r | j| z }!|!|z dz }"||!z|"z} nT| t2j4k(r| j|dzz |z } n+| t2j6k(r| j|z dz } n|dz} | |z }#d}$|dk(r|}$n | rd}$n| | z}$||#d|$dj1z }| }|D%cgc]#}%|j9|%|%j1d%}&}%t;d|&Dr8|ddj=|&j?j1zdzz }s|ddj=|&zdzz }|dz }|Scc}}wcc}wcc}%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_glyph_byte_map: An optional dictionary mapping characters to their byte representation for glyph encoding. 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. rg@@>/B/Ir rg@FrOzLength of text z exceeds maximum length (z) of field, input truncated.rMrNrQz Tf z q /Tx BMC q z re W BT z1 z re 0.5 0.5 0.5 rg s rz Td z utf-16-bec38K|]}t|dk\yw)r N)rZ).0cs r- zHTextStreamAppearance._generate_appearance_stream_data..*s513q6Q;5s Tj (s) Tj s ET Q EMC Q ) r8r isinstancer%rfont_descriptorbboxr maxrheightwidthDEFAULT_FONT_SIZE_IN_MULTILINEr[rXr\minrZr r!rWrRrSascentencoder>rAr@getanyrYhex)'r9rIrkrDrlrmrErnrorprqrrrrFfactormarginrHrGrJlinesmax_vertical_sizetext_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_offsetrz encoded_lines' r- _generate_appearance_stream_dataz5TextStreamAppearance._generate_appearance_stream_datas5VLL** 17R i '' 2I..33A69M9M9R9RST9UUY__ll//<?QT\\..7; ''!f*4 ooF 2  >M$ : #'#3#3" !$ y%1>$A!&*ood&;d&B#&15H5MA&N#!#c*;=P&QS`"acde - 94@A c$i*4%dV+DZLPlm"+4W%EZ=T3t94U% 1D8WEW,,tT288>@% 1D8@E@  ''&043G3G3L3LQ3OR[3[^d3ddH,1E1E1L1Ly1X[_1_"_cd!deH ){!I;d:,Gq6zl!F81[M<.Q,-R 1 &(  ! /8/?3 G +K+*dTY.[9%<~%MNQRRSST *+1Y]O<));(L#$La' " !*{^;  L><.>EEG GI0MLP)FG#''188K+@A)L)5 55TSXXl%;$@$@$B$I$I$KKiWW TCHH\$::YFF g3 Gh '' YW @~)s5P( P.(P3rPr0 font_resourcec t|||r4tt|j }t j |} ntd|dtd}ttdtdtdtdtdtdtd td td td i}td } d| jdz| jd<t d itttdtdd| | j} t!| j"t$rG| j&j)Dcic]!\}}||j+| j"#}}}n| j"j)Dcic]\}}|t-|f}}}| j"j)Dcic]\}}|t-|f}}}| j&j)D]\}}|j/||||<|j1||| |||||| | |  }|j3t5|t7t9||td<ttdtt|t;|d|ii|td<ycc}}wcc}}wcc}}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_resource: An optional variable that represents a PDF font dictionary. 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. zFont dictionary for z$ not found; defaulting to Helvetica.rjr4z/Type1z/Namer3/Fontz /BaseFontz /Helveticaz /Encodingz/WinAnsiEncoding Helveticar rQdefaultcp1252Type1)name character_mapencodingsub_typercharacter_widthsrmrErnrorprqrr/Lengthindirect_referencez /ResourcesN)r6r7rr get_objectr from_font_resourcer r!rr rdictzipranger r~rr*ritemsrbytesrrset_datarrrZgetattr)r9r0rIrkrrmrErnrorprqrrrDrkvrlfont_encoding_revkeyvalueap_stream_datar:s r-r7zTextStreamAppearance.__init__1sJ    !1=3K3K3MNM**=9D 1)<`ack lI,:& 8(<7#Z%87#Z%8;'L)A;'4F)G .M0 ^>^_b>c:cO , ,Y 7  c%*.@.JKL "1#2#C#C D dmmS )7;7I7I7O7O7Q#/3q!188DMM**# #?Cmm>Q>Q>S"Tda1eQDk>"T "T<@MM-B-B3-L#E* M>>    !%!?   &~67&23~3F&GZ "#)9 w !19%w}>RTa'b3"; * Z %&5##U Rs+&K2K)K acro_formfield annotationuser_font_nameuser_font_sizec tt|tj}tddt |d|dz t |d|dz f}|j tj |jtj d}|s td}n|j}tjd|D cgc]} | s|  } } | j| jddz } t| j| jddz } | jdd j!| } |r|} |dkDr|} tt"tt"|j d |jd t#j}|jd t#j}| |vrz| j%d t&vrctt(t*t*f|jd i}|jjd t#j}|j| d}t-|stt"|j}|jt.j0d}|jt.j2d dk(ru|t.j4j6zdk(rUdj!|j t.j8g}|jdg}t;|t<s|g}n|jdd}g}|j?ddj?ddj?dd}d}d}|t.j4j@zrd}|jd}d}|t.j4jBzrd}|jdtDjF}d}tHjJ}d|vrFtt"|djd|}tt"|djd|}tM|||}|||||| | | |||| }tjN|vrQtt"|tjNjd!ijQD]\}}|d"vs |||<|Scc} w)#a 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: 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 rtrNz/Helv 0 Tf 0 gz\sTfrQz/DRr/z/Txz/ChrMz/VrP\z\\(z\()z\)FTz/MaxLenz/Qz/BSz/Wz/S)rrr rz/N>/Filterr5r3rr4))rrrRectabs get_inheritedDArrrrerSpoprr&removerYr removeprefixr rrrrFfFTFfBitsComboOptr~listrRComb Multiliner>r?rr)rAPr)clsrrrrr _rectanglerrpropfont_propertiesrmrErndocument_resourcesdocument_font_resourcesr field_flagsrIrkrqrrrorprr r0new_appearance_streamrrs r-from_text_annotationz)TextStreamAppearance.from_text_annotations>/:6T6Y6Y+Z[ #Q3z!}z!}/L+MsS]^_S`cmnocpSpOq$rs (55 * - - MM8;;T B "!12B!C !3!>!>!@ -/HHU%G7>>DDDI99Z556O6S6SUWXYD $+Ii.&K 99T2&DI||D&)11#u=EEc5Q 299>> >G# 2J 299CC CLIIdM$6$67  #)) E> 0%,?CCD,WL 0%,?CCD,WL"IL_kl #    !%! !  * , , :%z2P2S2S'TUYYZ^`bciik 7 URR16)#.  7 %$wYs SS)g?)rP)r!r"r#r$r r&r*r%rr[r>r?rrrrboolr(rrrr7 classmethodrr;r<s@r-rCrC8s~"!$L2L2L2 L2  L2  L2L2L2L2 tE%*%&- .L2f;? "#0#5#5$(``cD)` ` &d3:&67 `  ````!``SM` `H.2)-48 "#0#5#5$(` )*` ` DI& `  01 `  ` ` ` ` !` ` SM`  ` D ! " O%#O% O%% O%  O%  O% O%O%r,rC)%r dataclassesrenumrtypingrrrr_codecsr _codecs.core_fontmetricsr _fontr _utilsr constantsrrrgenericrrrrr generic._baserrrrrr/r>rCr+r,r-rs !--(8#__PO!# ++ +L.L"Gk%/k%r,