+ vjXub^RIHt^RIt^RIHt^RIHt^RIHt^RI H t H t H t ^RI Ht^RIHt^R IHt^R IHt^R IHtHtHtHt^R IHt^R IHtHtHtH t H!t!H"t"^RI#H$t$H%t%] 'd ^RI&H't'^RI(H)t)^ t*]!RR44t+!RR]4t,!RR]4t-!RR],4t.R#)) annotationsN) dataclass)IntEnum)BytesIO) TYPE_CHECKINGAnycast)fill_from_encoding)CORE_FONT_METRICS)Font)logger_warning)AnnotationDictionaryAttributes BorderStylesFieldDictionaryAttributesPageAttributes) PdfReadError)DecodedStreamObjectDictionaryObjectIndirectObject NameObject NumberObjectRectangleObject)ByteStringObjectTextStringObject) PdfWriter) PageObjectcZ]tRt^!t$RtR tR]R&^tR]R&]Pt R]R&Rt R #) BaseStreamConfigzBA container representing the basic layout of an appearance stream.z3RectangleObject | tuple[float, float, float, float] rectangleint border_widthstr border_styleN)r%r%r%) __name__ __module__ __qualname____firstlineno____doc__r__annotations__r!rSOLIDr#__static_attributes__r$d/var/www/html/daimler-pipeline/venv/lib/python3.14/site-packages/pypdf/generic/_appearance_stream.pyrr!s*LEYIBYL#$**L#*r.rc2a]tRt^)tRtRV3RlltRtV;t#)BaseStreamAppearancez^A class representing the very base of an appearance stream, that is, a rectangle and a border.c V^8dQhRRRR/#)layoutBaseStreamConfig | NonereturnNoner$)formats"r/ __annotate__!BaseStreamAppearance.__annotate__,s L L6 L4 Lr.c <\SV`4T;'g \4Vn\ R4V\ R4&\ R4V\ R4&\ VPP 4V\ R4&R#)zd Takes the appearance stream layout as an argument. Args: layout: The basic layout parameters. z/XObject/Typez/Form/Subtype/BBoxN)super__init__r_layoutrrr)selfr4 __class__s&&r/r@BaseStreamAppearance.__init__,si 33!1!3 $.z$:Z !'1'':Z #$$3DLL4J4J$KZ !r.)rA)r&r'r(r)r*r@r- __classcell__rCs@r/r1r1)sh L Lr.r1c&]tRt^:tRt^t^t^tRtR#) TextAlignmentzODefines the alignment options for text within a form field's appearance stream.r$N) r&r'r(r)r*LEFTCENTERRIGHTr-r$r.r/rHrH:sY D F Er.rHc a]tRt^BtRtRRRlltRRRRR]PRR3R R lltRR RRRRRRR]PRR3 R V3R lllt ] RRl4t ] RRRll4t ] RRRll4tRtV;t#)TextStreamAppearancea4 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<V^8dQhRRRRRRRRRRRR R RR RR R / #)r3fontr font_sizefloatleading_factor field_width field_heighttextr" min_font_sizefont_size_stepr6z%tuple[list[tuple[float, str]], float]r$)r8s"r/r9!TextStreamAppearance.__annotate__KsoL2L2L2L2 L2  L2  L2L2L2L2 /L2r.c  Tp VPRR4PR4p .p .p ^p VPV,R, pV EFGpVP4'gV P R4K-VPR4p\ V4FwppVP V4V,R, pV V,V'dTM^,pVV8d2V 'd*V P V RPV 434V.p Tp KwV 'g!VV8dV P VV34.p ^p KV 'd W, p V P V4V V, p K V 'gEK!V P V RPV 434.p ^p EKJ V\V 4^, V,V,,pVV8d(W(, pVV8dVPVVVVVV VV4#V \V^43#)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%) replacesplit space_widthstripappend enumerate text_widthjoinlen _scale_textround)rBrOrPrRrSrTrUrVrW orig_text paragraphs wrapped_linescurrent_line_wordscurrent_line_widthra paragraphwordsiword word_width test_widthestimated_total_height new_font_sizes&&&&&&&&& r/rh TextStreamAppearance._scale_textKs: \\$-33D9  (*$%&&2T9 #I??$$$$Y/OOC(E$U+4!__T2Y>E /*Z)[\*.&)3&+ [0H!((*d);<)+&)*&)*9*&--d3&*4&, "!$$&8#((CU:V%WX%'"%&"1$4"+c-.@1.D-VYb-b!b !L 0%6M -''!" !"  eIq111r.N/Helvr%z0 gFcHV^8dQhRRRRRRRRR RR R R RR RRRRRRRRR/ #)r3rUr" selectionlist[str] | NonerOr font_glyph_byte_mapzdict[str, bytes] | None font_namerPrQ font_color is_multilinebool alignmentrHis_comb max_length int | Noner6bytesr$)r8s"r/r9rXseee$e e 5 e  eeee!eee er.c  N VPPp T;'g/p\V \4'd \ V 4p VP P ^,VP P ^,, R, p VPPR9d^M^p\VPPV,^4pV P^V,, pV P^V,, pV^8XdRpV'dRpV'd#\pVPVVV VVVV4wppEM>VV , pVPV4R, pTT;'g^, p\\\!VV4V4^4pVV,V3.pMV 'dV 'd$\#V4V 8d\%R\&VV R7\)V4UUu.uFCwppTT ;'g \#V48gK"VPV4V,R, V3NKE pppMOVP+RR4P-R4Uu.uF$pVPV4V,R, V3NK& ppV'dEV PV,VP P ^,V,R, , pM9VVVP P.V,R, , ^, ,pV R V R V 2pR ^V, R V R V R V R V R2 P14p^p\)V4EFEwpwppV'd`VV9dYVR VVV,V ,, ^, R V P^, R V^, RV R2 P14, p^p V 'd=V 'd5V PV , p!V!V, ^, p"VV!,V",p MpV \2P48Xd#V PV^,, V, p M9V \2P68XdV PV, ^, p M V^,p V V, p#^p$V^8XdTp$MV 'dRp$M V)V ,p$VV# R V$ R2P14, pT pVU%u.uF$p%VP9V%V%P1R44NK& p&p%\:;QJdRV&4F 'gK RM RM !RV&44'dFVRRP=V&4P?4P14,R,, pEKVRRP=V&4,R,, pEKH VR, pV#uuppiuupiuup%i)aL 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. g@@g@Fr\zZLength of text %(text)s exceeds maximum length (%(max_length)d) of field, input truncated.)sourcerUrrZr[r]z Tf z q /Tx BMC q z re W BT z1 z re 0.5 0.5 0.5 rg s r%z Td z utf-16-bec3>"TFp\V4^8xK R#5i)r3N)rg).0cs& r/ HTextStreamAppearance._generate_appearance_stream_data..9s5 13q6Q; sT Tj (s) Tj s ET Q EMC Q >/B/I) rAr isinstancetuplerfont_descriptorbboxr#maxr!heightwidthDEFAULT_FONT_SIZE_IN_MULTILINErhreriminrgr r&rdr_r`ascentencoderHrKrJgetanyrfhex)'rBrUrzrOr|r}rPr~rrrrrrRfactormarginrTrSrVlinesmax_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_offsetr encoded_lines'&&&&&&&&&&&& r/ _generate_appearance_stream_data5TextStreamAppearance._generate_appearance_stream_datasVVLL** 177R i ' '' 2I..33A69M9M9R9RST9UUY__ll//<?QT\\..7; ''!f*4 ooF 2  >M$ : #'#3#3" !$ y%1>$A!&*ood&;d&B#&15H5M5MA&N#!#c*;=P&QS`"acde - 94@A c$i*45$)"+4W"1+%EZ=T=T3t94U% 1D8"1 WE,,tT288>@?$% 1D8? @  ''&043G3G3L3LQ3OR[3[^d3ddH,1E1E1L1Ly1X[_1_"_cd!deH ){!I;d:,Gq6zl!F81[M<.Q,-R 1 &(  ! /8/? +K+*dTY.[9%<~%MNQRRSST *+1Y]O<));(L#$La' " !*{^;  L><.>EEG GI0MLP)KOa#''188K+@A4 )s5 5sss5 555TSXXl%;$@$@$B$I$I$KKiWW TCHH\$::YFF g0@h '' YW @~)s#V5 V%V*V6*V"r^cLV^8dQhRRRRRRRRR R R RR R RRRRRRRRRRRR/ #)r3r4r5rUr"rzr{rOz Font | None font_resourcez(DictionaryObject | IndirectObject | Noner}rPrQr~rrrrHrrrr6r7r$)r8s"r/r9rX@sW W 'W W $ W  W @ W W W W W !W W W  W r.c  <\SV`V4V'd V'gjRp\R,p \R/\ \ \ R4\R444RV PV PR7pVP4p/p\VP\4'd`VPPR R4VPP!4F$wppVP#VP4VV&K& MVPP!4UUu/uFwppV\%V34bK pppVPP!4UUu/uFwppV\%V34bK pppVPP!4FwppVP'VV4VV&K VP)VVVVVVVV V V V R7 pVP+\-V44\/\1V44V\3R 4&\5\3R 4\5\3V4\7VR V4/4/4V\3R 4&R#uuppiuuppi)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. rx Helveticacp1252Type1name character_mapencodingsub_typercharacter_widthsNr}rPr~rrrr/Length/Fontindirect_reference /Resources)r?r@r r dictzipranger rras_font_resourcerrr"rpopitemsrrrrset_datarrrgrrgetattr)rBr4rUrzrOrr}rPr~rrrrcore_font_metricsr|kvfont_encoding_revkeyvalueap_stream_datarCs&&&&&&&&&&&&& r/r@TextStreamAppearance.__init__@s%P  =I 1+ >   c%*.@.JKL 1 A A!2!C!C D!113M02 dmmS ) )    " "2t ,**0021)*$--)@#A&3?Cmm>Q>Q>S"T>Sda1eQDk>>S "T<@MM-B-B3-L#E*9>>    !%!?   &~67&23~3F&GZ "#)9 w !19%w}>RTa'b3"; * Z %&-#U Rs (I!Ic ,V^8dQhRRRRRRRRRR/#) r3r}r" annotationr acro_formrUr6ztuple[str, Font]r$)r8s"r/r9rXsABBB(B(B B  Br.c  \\VPRVPR\4444pVPR\44pVPVR4pV'd\P !V4pMVP R4\9d\R\VR7Rp\VP R4,p\ VP R4/\\\R4\R444R VPVPR 7pVP!V4p V 'gVPP"'dbVP$R 8XdQVP'\)VPP"P+444pR pVP!V4p V 'g\R\VR7W3# \,\.3dp \R \T R7Rp ? LERp ? ii;i)/DRrN/zEFont dictionary for %(font_name)s not found; defaulting to Helvetica.)rr}z /HelveticarrrrTrueTypez/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.)rrU)r r get_inheritedrr from_font_resource removeprefixr r r&rrrr rr can_encode font_filerfrom_truetype_font_filerget_data ImportErrorr) r}rrrUacro_form_resourcesacro_form_font_resourcesrrOr encodablers &&&& r/_find_annotation_font_resource3TextStreamAppearance._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]eijkkls.AGH+HHc 0V^8dQhRRRRRRRRR R R R /#) r3writerrr}r"rOr target_resource_dictrpagezPageObject | Noner6rr$)r8s"r/r9rXsD'''''/ '  '  'r.c VP\R4\44P4pW9dVP VV\V44pMWQ,pV'dt\ \V\ P,4P\R4\44P4pW9d\VRV4V\V4&V#)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)rr}rOrr target_fontsfont_resource_referencepage_fonts_resources&&&&& r/&_sync_appearance_stream_font_resources;TextStreamAppearance._sync_appearance_stream_font_resourcess,66z'7JL\L^_jjl  (&*&9&99%' # '3&= # "&'7n>V>V9W"X"c"c7#%5%7#jl 3=D+-ACZ>#Jy$9:'&r.c<V^8dQhRRRRRRRRR RR RR R R RRR/ #)r3rrrrflattenrrrfieldruser_font_namer"user_font_sizerQr6rMr$)r8s"r/r9rXsoZ%Z%Z%Z% Z% $ Z%  Z%%Z%Z%Z% Z%r.c   \\V\P,4p \^^\ V ^,V ^,, 4\ V ^,V ^,, 434p VP \P VP\P R44p V 'g \R4p MV P4p VP\P^4p VP\PR4R8XdV \PP,^8Xd\RPVP \P .44p VPR.4p\#V\$4'gV.pMVPRR4p .pV P'RR 4P'R R 4P'R R 4p \(P*!RV 4Uu.uFq'gK VNK ppVP-VP/R4^, 4p\1VP-VP/R4^, 44pVP3R4RPV4pV'dTpMTpV^8dTpVP5VWdV 4wppVV8wd(\V P'VV44V\7R4&TP9TTTVP;\7R4\=44V'dTMR4pRpRpV \PP>,'dRpVPR4pRpV \PP@,'dRpVPR\BPD4p^p\FPHpRV9dO\\<VR,4PRV4p\\<VR,4PRV4p\KV VVR7pV!VV VVVVVVVVVVR7 p\PLV9d\\<V\PL,4PR/4PO4Fvwpp VR 9dKVR8Xd\RV 9d%\=4V P4\7R4&\QVRV4V R,P4\7V4&KqV VV&Kx V#uupi)!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: 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. Nz/Helv 0 Tf 0 gz/Txz/ChrZz/Vr^\z\\(z\()z\)z\sTfr]z/DArFTz/MaxLenz/Qz/BSz/Wz/S)rr!r#rz/Nrrr>r>r</Filterrr=))r rrRectabsrDArrrrFfFTFfBitsComborfOptrlistr_rer`rrrQremoverrrrrComb MultilinerHrIrr,rAPrr)!clsrrrrrrrr _rectanglerr field_flagsrUrzpropfont_properties da_font_namerPr~r}rOrrrrrr!r#r4new_appearance_streamrrs!&&&&&&&&& r/from_text_annotation)TextStreamAppearance.from_text_annotationsxL/: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 C CLIIdM$6$67  #)) E> 0%,?CCD,WL 0%,?CCD,WL"IL_kl #     #!%! !  * , , :%z2P2S2S'TUYYZ^`bciikUNN,&e+BRBT((*:g+>?IP/1EG^JE'N--/ 90EF27)#.l%$]Ys 8 TTr$)g?)N)r^r)r&r'r(r)r*rhrHrIrr@ staticmethodrr classmethodrr-rErFs@r/rMrMBsL2f8< "#0#5#5!%eR+/&* BF "#0#5#5!%W W rBBH''@Z%Z%r.rM)/ __future__rr dataclassesrenumriortypingrrr _codecsr _codecs.core_font_metricsr _fontr _utilsr constantsrrrrerrorsrgenericrrrrrr generic._baserr pypdf._writerr_pagerrrr1rHrMr$r.r/r/s" !++(9#oo!?'"!# ++ +L.L"GX %/X %r.