OAi8SrSSKJr SSKrSSKJrJr SSKJrJ r J r SSK J r SSK Jr SSKJr SS KJrJrJrJrJrJrJrJrJrJrJrJrJrJr SS K J!r!J"r" \RF"\$5r%"S S 5r&"S S5r'"SS\'5r("SS\'5r)"SS\'5r*"SS5r+"SS\'5r,"SS\'5r-"SS5r."SS\'5r/"SS \5r0"S!S"\05r1"S#S$\15r2S.S%jr3S.S&jr4S'r5\"S(S)55r6\ S/S*j5r7S0S+jr8S1S,jr9S2S-jr:g)3z+Support for working with interactive forms.) annotationsN)ABCabstractmethod) GeneratorMappingSequence)contextmanager) dataclass)Decimal)AcroForm AcroFormFieldArray Dictionary FormFieldFlagMatrixNameObjectOperatorPagePdf RectangleStringparse_content_stream)ContentStreamBuilder SimpleFontc\rSrSr%SrSrS\S'S\S'S\S 'S \S 'S \S 'SSS.SSjjjrSrSSjr SSjr SSjr Sr SSjr Srg)Form$aUtility class to make it easier to work with interactive forms. This is easier to use than the core {class}`pikepdf.AcroForm` implementation, but is higher-level, and abstracts over details in ways which do impose some limitations, such as failing for PDFs which have multiple fields with the same name. A non-exhaustive list of limitations: * No support for signatures * No support for password fields * No support for rich text fields * Multiselect choice fields are treated as single-select * Generating appearance streams imposes additional limitations (see {class}`pikepdf.form.DefaultAppearanceStreamGenerator` and {class}`pikepdf.form.ExtendedAppearanceStreamGenerator` for details.) Nz AppearanceStreamGenerator | Nonegenerate_appearancesboolignore_max_lengthr_pdfr _acroformzMapping[str, _FieldWrapper]_cacheF)r!cXlURUl0UlUb"U"URUR5UlX0lg)zInitialize the form.N)r"acroformr#r$rr!)selfpdfrr!s H/var/www/html/land-ocr/venv/lib/python3.13/site-packages/pikepdf/form.py__init__ Form.__init__Ds>   +(>tD4. v;?!A$HI Izz&)T**r,cHURU5 g![a gf=f)NTF)r=r8r0s r) __contains__Form.__contains__`s*    T "  s  !!c## [5nURRGHInURnX0R;a*X1;a%UR U5 X0RU4v MIX0R;a:UR (a)URURUR:XaMX0R;a[SU35eUR (adURRU5n[U5S:a[SU35eUR U5 X0RUSU54v GM$UR U5 X0RX#54v GML g7f)z6Yield (name, field) pairs for all fields in this form.r6r5rN) setr#r<fully_qualified_namer$addis_radio_buttonparent_fieldr:r7r9r;)r'seenfieldr1r<s r)items Form.itemsgs$u^^**E--D{{"t'7KK--- #))LLDKK$5$<$<<$"%EdV#LMM&&FFtLv;?&)I$'PQQJJvay$777JJu333=+sE0E2c#F# UR5H upUv M g7fr.)rK)r'r1items r)__iter__ Form.__iter__s**,JDJ's!cUR(a [X5nOUR(a [X5nOUR(a [ X5nOoUR (a [X5nORUR(a [X5nO5UR[R:Xa [X5nO [S5eX0RU'U$)NzUnknown field type)is_text TextField is_checkbox CheckboxFieldrFRadioButtonGroup is_pushbuttonPushbuttonField is_choice ChoiceField field_typerSigSignatureFieldr:r$)r'rJr1wrappeds r)r; Form._wraps ==,G   #D0G  " "&t3G  %d2G __!$.G    )$T1G34 4# Dr,)r#r$r"rr!r.)r(rrz&type[AppearanceStreamGenerator] | None)r1str)returnz$Generator[tuple[str, _FieldWrapper]])rJr r1r`)__name__ __module__ __qualname____firstlineno____doc__r__annotations__r*r2r=r@rKrOr;__static_attributes__r,r)rr$s">B:A I '' HL 3  3  3E 3-+!4Fr,rcd\rSrSrSrS SjrSr\S Sj5r\S Sj5r \S Sj5r Sr g ) _FieldWrapperzBase class for other field types. In addition to the methods and properties documented here, all fields expose the same properties and methods defined on `pikepdf.AcroFormField`. These are forwarded to the underlying field object. cXlX lgr.)_formrH)r'formrJs r)r*_FieldWrapper.__init__s   r,c.[URU5$r.)r/rHr0s r)r2_FieldWrapper.__getattr__st{{D))r,cb[URR[R-5$)zIs this a required field?)r rHflagsrrequiredr's r) is_required_FieldWrapper.is_required$DKK%% (>(>>??r,cb[URR[R-5$)zIs this a read-only field?)r rHrtr read_onlyrvs r) is_read_only_FieldWrapper.is_read_onlys$DKK%% (?(??@@r,cZURR[R-(+$)zGShould this field's value be included when exporting data from the PDF?)rHrtr no_exportrvs r)export_enabled_FieldWrapper.export_enableds";;$$}'>'>>>>r,)rHrnN)rorrJr rar ) rbrcrdrerfr*r2propertyrwr|rrhrir,r)rkrksQ*@@AA??r,rkc\rSrSrSr\SSj5r\SSj5r\SSj5r\SSj5r \SSj5r \SSj5r \SS j5r \SS j5r \SS j5r\SS j5r\R SS j5rSrg)rSz"Represents an editable text field.cb[URR[R-5$)zIs this a multiline text field? If True, text will be wrapped and newlines will be allowed. If False, text will not be wrapped and newlines are stripped. )r rHrtr tx_multilinervs r) is_multilineTextField.is_multiline$DKK%% (B(BBCCr,cb[URR[R-5$)zIs this a combed text field? If True, the field will be split into equal-length segments, based on ``max_length``, containing one character each. )r rHrtrtx_combrvs r) is_combedTextField.is_combeds$DKK%% (=(==>>r,cb[URR[R-5$)zIs this a rich text field? Rich text functionality is not currently implemented, but this flag is presented for your information. )r rHrtr tx_rich_textrvs r) is_rich_textTextField.is_rich_textrr,cb[URR[R-5$)z{Is this a password field? Password fields are not currently implemented, but this flag is presented for your information. )r rHrtr tx_passwordrvs r) is_passwordTextField.is_passwords$DKK%% (A(AABBr,cb[URR[R-5$)zIs this a file select field? File select fields are not currently implemented, but this flag is presented for your information. )r rHrtrtx_file_selectrvs r)is_file_selectTextField.is_file_selects$DKK%% (D(DDEEr,cZURR[R-(+$)z/Should spell-checking be enabled in this field?)rHrtrtx_do_not_spell_checkrvs r)spell_check_enabledTextField.spell_check_enableds";;$$}'J'JJJJr,cZURR[R-(+$)zCShould scrolling (horizontal or vertical) be allowed in this field?)rHrtrtx_do_not_scrollrvs r)scrolling_enabledTextField.scrolling_enableds";;$$}'E'EEEEr,c8URRS5$)z-The maximum length of the text in this field./MaxLen)rHget_inheritable_field_valuervs r) max_lengthTextField.max_lengths{{66yAAr,c.URR$)z2The default (placeholder) value of the text field.)rHdefault_value_as_stringrvs r) default_valueTextField.default_values{{222r,c.URR$)zThe value of the text field.)rHvalue_as_stringrvs r)valueTextField.values{{***r,cUR(dURSS5nURnURR(d,Ub)[ U5U:aUSUn[ RS5 URRXRRSL5 URRb0URRRUR5 gg)N z7Value is too long for text field and is being truncated) rreplacerrnr!r9logwarningrH set_valuer generate_text)r'rrs r)rr s  MM$+E__  ,,&E Z'+:&E KKQ R eZZ%D%D%LM :: * * 6 JJ + + 9 9$++ F 7r,riNr)ra int | None)rar`)rr`)rbrcrdrerfrrrrrrrrrrrsetterrhrir,r)rSrSs, DD??DDCCFFKKFFBB33++ \\GGr,rSc\rSrSrSr\S Sj5r\S Sj5r\S Sj5r\S Sj5r \ RSSj5r Sr g )rUizRepresents a checkbox field.c[SURRRRR 555$)zList the possible states for this checkbox. Typically this will be /Off plus one additional arbitrary value representing the on state. c38# UHn[U5v M g7fr.r.0keys r) 'CheckboxField.states..'sF*E3T#YY*E)tuplerHobjAPNkeysrvs r)statesCheckboxField.states s2F$++//*<*<*>*>*C*C*EFFFr,cURRRRR 5H$nU[ R :wdM[ U5s $ g)z@The underlying value associated with this checkbox's "on" state.N)rHrrrrrOffr0s r)on_valueCheckboxField.on_value)sAKKOO&&((--/DtxxDz!0r,c.URR$)z1The actual current stored value of this checkbox.rHrrvs r)rCheckboxField.value0{{   r,c.URR$)zIs this checkbox checked?)rH is_checkedrvs r)checkedCheckboxField.checked5s{{%%%r,cU(a[URRRRR 55nUR [R5 URR[UR555 gURR[R5 gr.) rCrHrrrrdiscardrrrpop)r'rrs r)rr:so ++--2245F NN488 $ KK ! !$vzz|"4 5 KK ! !$(( +r,riNrazSequence[Name]rarraz Name | Noner)rr ) rbrcrdrerfrrrrrrrhrir,r)rUrUsm& GG"" !!&& ^^,,r,rUc\rSrSrSr\S5r\S Sj5r\S Sj5r\SSj5r \ RSSj5r \SSj5r \ RSS j5r S r g )rViFz Represents a radio button group.cZURR[R-(+$)z.Ws5fUT%[[fr) rKidsrHrrCupdaterrrrrr)r'rkids r)rRadioButtonGroup.statesNsu 99DKKOO +;;??''C MM#&&((--/ *(txx 5f555r,c^[RTRR;ag[ U4Sj[ TRRR555$) A list of all available options.ric3@># UHup[TX!5v M g7fr.)RadioButtonOption)rindexrr's r)r+RadioButtonGroup.options..^s$ =  dC / /=)rrrHrr enumeratervs`r)optionsRadioButtonGroup.optionsYsI 99DKKOO + ' (<(<=   r,c.URR$)+The value of the currently selected option.rrvs r)rRadioButtonGroup.valuecrr,cU[R:XaUR(d [S5eURR cURR U5 gXRRlURRRHZn[URRR55nX;aXlM=SU;dME[RUlM\ g)Nz)To uncheck a radio button, check another.z/AS)rrr ValueErrorrHrGrrVrrCrrrAS)r'rrrs r)rrhs DHH T%8%8HI I ;;   % KK ! !% (!&KKOO {{++SVVXX]]_-?"Fc\!XXCF ,r,cURRnUbU[R:Xag[RURR ;ag[ URR R5H,up#XRR;dM [XU5s $ [RS5 g)zThe currently selected option.Nz9Radio button group value does not match any radio buttons) rHrrrrrrrrrrr)r'rrrs r)selectedRadioButtonGroup.selecteds !! =ETXX- 99DKKOO +#DKKOO$8$89JE (E::: OPr,cZURULa [S5eURUlg)Nz$Option does not belong to this group)_grouprrrr'options r)rrs% == $CD D__ r,)rNr)razSequence[RadioButtonOption]r)rr)razRadioButtonOption | None)rr) rbrcrdrerfrrrrrrrrhrir,r)rVrVFs* GG66  !! \\&&.  __%%r,rVc\rSrSr%SrS\S'S\S'SSjr\SSj5r\SS j5r S r \SS j5r \ RSS j5r S r g)riz9Represents a single radio button in a radio button group.rVrr _annot_dictc(XlX lX0lg)z-Create a new option for a radio button group.N)rr_index)r'group annot_dictrs r)r*RadioButtonOption.__init__s % r,cSURRRRR 55$)zList the possible states for this radio button. Typically this will be /Off plus one additional arbitrary value representing the on state. c38# UHn[U5v M g7fr.rrs r)r+RadioButtonOption.states..sA%@cS %@r)rHrrrrrvs r)rRadioButtonOption.statess-BT[[__%7%7%9%9%>%>%@AAr,cURRRR5H$nU[R :wdM[ U5s $ g)z>The underlying value associated with this button's "on" state.N)rrrrrrr0s r)rRadioButtonOption.on_values?$$''))..0DtxxDz!1r,c:URURlg)z!Mark this as the selected option.Nrrrrvs r)selectRadioButtonOption.selects MM r,cHURURR:H$)z)Is this is the currently selected option?rrvs r)rRadioButtonOption.checkeds}} 1 111r,cU(aURURlg[RURlgr.)rrrrr)r'rs r)rrs%  $ DKK  $DKK r,)rrrN)rrVrrrintrrr)rr )rbrcrdrerfrgr*rrrrrrrhrir,r)rrsqC  BB"" *22 ^^))r,rc\rSrSrSrSrg)rXizRepresents a pushbutton field. Pushbuttons retain no permanent state, so this class is merely a placeholder. It exposes no functionality. riN)rbrcrdrerfrhrir,r)rXrXsr,rXc\rSrSrSr\SSj5r\SSj5r\SSj5r\SSj5r \SSj5r \SSj5r \ RSS j5r \SS j5r \ RSS j5r S rg )rZizRepresents a choice field. Multiselect is not currently supported; multiselect fields will still only allow selecting a single value. cb[URR[R-5$)zIs this a multiselect field? Multiselect fields are currently treated as single-selection fields. True multiselect is not yet supported, but this flag is presented for your information. )r rHrtrch_multi_selectrvs r)is_multiselectChoiceField.is_multiselects$DKK%% (E(EEFFr,cb[URR[R-5$)z?Is this a combobox field? If false, this is instead a list box.)r rHrtrch_comborvs r) is_comboboxChoiceField.is_comboboxryr,cb[URR[R-5$)zDoes this field include an editable text box in addition to the dropdown? The field must be a comboxbox; this option is not valid for list boxes. )r rHrtrch_editrvs r) allow_editChoiceField.allow_edits$ DKK%% (=(==>>r,cZURR[R-(+$)zcShould spell-checking be enabled in this field? This is only valid for fields that allow editing. )rHrtrch_do_not_spell_checkrvs r)rChoiceField.spell_check_enableds" ;;$$}'J'JJJJr,c^[RTRR;ag[ U4Sj[ TRRRR 5555$)rric3@># UHup[TX!5v M g7fr.)ChoiceFieldOption)rroptr's r)r&ChoiceField.options..s$ F  dC / /Fr)rOptrHrrras_listrvs`r)rChoiceField.optionssR 884;;?? * ' (;(;(C(C(EF   r,cR[RURR;aj[ URRRR 55H/up[ XU5nURUR:XdM-Us $ [ XRS5$)z@The currently selected option, or None if no option is selected.N) rr-rHrrr.r* export_valuer)r'rr+s r)rChoiceField.selectedsw 88t{{ &' (;(;(C(C(EF '59##tzz1JG!zz488r,c>URULa [S5eURRURURR SL5 URR b0URR R UR5 gg)Nz$Option does not belong to this field)rHrrr1rnrgenerate_choicers r)rr2 s{ == $CD D    !@!@D!H  :: * * 6 JJ + + ; ;DKK H 7r,c^URRbURR$g)rN)rHrrrvs r)rChoiceField.values' ;;   (;;.. .r,cUR(dgSn[URRR5H%up4[ XU5nUR U:XdM#Sn O U(d [SU5eURRXRRSL5 URRb0URRRUR5 gg)NFTz)Not a valid option for this choice field:) r#rrHrr-r*r1rrrnrr4)r'rokayrr+s r)rr6$sD' (;(;< '59##u,D =  !LeTT eZZ%D%D%LM :: * * 6 JJ + + ; ;DKK H 7r,riNr)razSequence[ChoiceFieldOption])razChoiceFieldOption | None)rr*)ra str | None)rr9)rbrcrdrerfrrrr#rrrrrrhrir,r)rZrZs  G G@@??KK    99__ I I   \\IIr,rZc\rSrSrSrS Sjr\S5r\S5r\S Sj5r \S Sj5r Sr \S S j5r S r g )r*i7z.Represents a single option for a choice field.c(XlX lX0lg)z'Create a new option for a choice field.N)rH_optr)r'rJr+rs r)r*ChoiceFieldOption.__init__:s   r,cv[UR[5(aURS$UR$)zGThe value that will be displayed on-screen to the user in a PDF reader.r5 isinstancer<rrvs r) display_valueChoiceFieldOption.display_value@- dii ' '99Q< 99 r,cv[UR[5(aURS$UR$)z?The value that will be used when exporting data from this form.rr?rvs r)r1ChoiceFieldOption.export_valueHrCr,cURSL=(aK URURRRR[R S5:$)z{Is this option hidden? Hidden options are still settable via code, but are not shown to users in PDF reader applications. Nr)rrHrgetrTIrvs r) is_hiddenChoiceFieldOption.is_hiddenPsK{{$& 4;;9K9K9O9O9S9S GGQ: ,  r,cURSL$)zIs this option one of the field's preset options? If false, this is a manually entered value typed by the user in an editable choice field. N)rrvs r) is_presetChoiceFieldOption.is_preset[s{{$&&r,c$XRlg)z'Set this option as the selected option.N)rHrrvs r)rChoiceFieldOption.selectds # r,cHURRUR:H$)z&Is this the currently selected option?)rHrr1rvs r)rChoiceFieldOption.selectedhs{{  D$5$555r,)rHrr<N)rJrZr+zString | Arrayrrr)rbrcrdrerfr*rrAr1rIrLrrrhrir,r)r*r*7ss8   ''$66r,r*c>\rSrSrSrSS.SSjjrS SjrSrg) r]inzCRepresents a signature field. Signatures are not truly supported. N) expand_rectc VURRRUR5Sn[R UR ;aH[UR R 5RXRURU55 URRRHcnURRRU5H7nXS:XdM URXRURU55s s $ Me [S5e)a{Stamp an image over the top of a signature field. This is *not* true support for PDF signatures. Rather, it is merely a utility for adding an image to the PDF at the location of a signature field. This uses `pikepdf.Page.add_overlay` under the hood, see that method for additional usage information. If the bounding box of the signature field is smaller than the "visual" signature area in the PDF, you may use the ``expand_rect`` parameter to increase the dimensions of the rectangle when stamping. This may be any of the following types: * A number, which will be added equally to all sides of the box * A sequence of two numbers, which will be added on the X and Y axis, respectively * A sequence of four numbers, which will be added to the left, bottom, right, and top sides respectively Positive numbers will increase the size of the box, and negative numbers will decease it. rz-Could not find annotation for signature field)rnr#get_annotations_for_fieldrHrPrr add_overlay _expand_rectrectr"pagesget_widget_annotations_for_pager)r'overlayrS field_annotpageannots r) stamp_overlaySignatureField.stamp_overlaytsBjj**DDT[[QRST 66[__ $ "" # / /**;+;+;[I JJOO))D--MMdS'++!2!25::{!KT*HIIr,c jUcU$[U[[-[-5(aX"X"4n[ U5S:Xa/UQUQ7n[ UR [US5- UR[US5- UR[US5-UR[US5-5$)Nrr5) r@rfloatr r9rllxllyurxury)r'rY expand_bys r)rXSignatureField._expand_rects  K iuw!6 7 7"yDI y>Q 0)0i0I HHuYq\* * HHuYq\* * HHuYq\* * HHuYq\* *   r,ri)r\z Object | PagerSz>int | float | Decimal | Sequence[int | float | Decimal] | Nonerar)rYrrjzint | float | Decimal | None)rbrcrdrerfr`rXrhrir,r)r]r]ns7.J.J .J .J`  r,r]c`\rSrSr%SrS\S'S\S'S Sjr\S Sj5r\S S j5r S r g )AppearanceStreamGeneratorizAppearance stream generators are used to render forms. They are used by the `pikepdf.form.Form` class to optionally generate appearance streams as forms are filled. rr(r rocXlX lg)z+Initialize the appearance stream generator.N)r(ro)r'r(ros r)r*"AppearanceStreamGenerator.__init__s  r,cgz0Generate the appearance stream for a text field.Nrir'rJs r)r'AppearanceStreamGenerator.generate_textr,cgz2Generate the appearance stream for a choice field.Nrirrs r)r4)AppearanceStreamGenerator.generate_choicertr,)ror(N)r(rror rJr ) rbrcrdrerfrgr*rrr4rhrir,r)rmrmsB H N ??AAr,rmc,\rSrSrSrSSjrSSjrSrg) DefaultAppearanceStreamGeneratoriaIBasic appearance stream generator using QPDF's default algorithm. It is thus subject to all the same `limitations `_. Briefly summarized, these limitations are: * Cannot generate appearance streams using encodings other than ASCII, WinAnsi, or MacRoman * No support for multiline text * No support for auto-sized text * Does not respect quadding Using this class will produce the same results as the following code: .. code-block:: python form = Form(pdf, generate_appearances = None) ... pdf.generate_appearances() However, unlike the above, appearances will be generated on the fly as the form is filled out, rather than all at once at the end. You may extend this class to customize appearance streams or add support for features you need. cjURRU5HnURU5 M grqrorUgenerate_appearancer'rJr_s r)r.DefaultAppearanceStreamGenerator.generate_text*YY88?E  % %e ,@r,cjURRU5HnURU5 M grvr|r~s r)r40DefaultAppearanceStreamGenerator.generate_choicerr,riNrx)rbrcrdrerfrr4rhrir,r)rzrzs8- -r,rzc0^\rSrSrSrSU4SjjrSrU=r$)!ExtendedAppearanceStreamGeneratoria]Alternate appearance stream generator to address limitations of the default one. Improved features include: * Supports multiline text fields, with caveats: * Word wrap does not take scaling factors (other than font size) into account * Spacing operators not taken into consideration either * Quadding is still ignored * Due to limitations in Firefox's PDF viewer, the font and the line breaks will be incorrect when viewed in Firefox. PDFs filled by full-fat PDF readers, including Adobe Acrobat Reader, exhibit the same behavior when viewed in Firefox. * Supports combed text fields, with most of the same caveats as above Otherwise, this implementation has most of the same limitations as the default implementation. Unlike the default implementation, this is implemented in Python rather than C++, so will also be less performant. c4>UR[R-(a"[URUR U5 gUR[R -(a"[URUR U5 g[TU]%U5 grq) rtrr_text_appearance_multiliner(ror_text_appearance_combedsuperr)r'rJ __class__s r)r/ExtendedAppearanceStreamGenerator.generate_text s^ ;;33 3 &txxE B [[=00 0 #DHHdii ? G !% (r,rirx)rbrcrdrerfrrh __classcell__)rs@r)rrs,))r,rc [RU5nURU5GH nURR 5n[ UR 5nURcURRnUc URnO%URRXsR5nUR[R"5R!UR"[%UR&5U- 55 [)XbR*X55 SSS5 [-XWXS5 GM g!,(df  N!=fr.)_DaInfodecode_for_fieldrUrYto_bbox_text_stream_builderda text_matrixfontascent line_spacing convert_width font_sizeset_text_matrixridentity translatedrfr ri_layout_multiline_textr_apply_appearance_stream)r(rorJda_infor_bboxcs top_offsets r)rr%s&&u-G//6zz!!# !'** -""*%\\00 %!(!5!5J")!;!;"$5$5"J""OO%00'$(("3j"@ #2'<'J  ! +I 2 9D ww%)) !D) r,c\rSrSr%S\S'S\S'S\S'S\S 'S rS \S 'S rS \S 'S rS \S'S rS\S'\ SSj5r Sr g )rinbytesrrrrrr rNzDecimal | None char_spacing word_spacingrz Matrix | Nonerc >URn[R"5nURU5n[ U5n[ S5n[ S5nSnSn UH)n U R U:XaU nU R U:XdM'U n M+ Uc[SUR35eURupU S:XaURSS5nSn [R"XR5n U bU RSOSnU R=(d U nU"X-XSSX5$) aParse the default appearance, returning it and the font styling information. The default appearance is a value that is used to initialize the content stream for text fields. It must at minimum contain a `Tf` operator, which indicates the font family and size. TfTmNz6No Tf operator found in default appearance stream for rs0 Tfs11 Tf )default_appearancernew make_streamrroperatorr:rDoperandsrrloaddefault_resourcesleading)clsrJrtmp_pdf tmp_stream instructionstf_optm_optf_insttm_instinst font_familyrrmatrixrs r)r_DaInfo.decode_for_fieldys$ % %'')((, +J7  D}}%}}% ! ?H--.0  ")!1!1 > GX.BI{,C,CD(/(;!!!$||0y 2[T4VVr,ri)rJr rar) rbrcrdrergrrrr classmethodrrhrir,r)rrnsT I O#'L.'#'L.'#'L.'!%K%5W5Wr,rc#(# [5nUR[R5 UR 5 UR 5 UR U5 Uv UR5 UR5 UR5 g7f)auUtility to build text content streams for variable text fields. Example: .. code-block:: python with _text_stream_builder(da) as cs: # Make calls against cs, e.g.: cs.show_text(b'some text') ... # Now cs is complete. (Make sure you are outside the context manager; additional # operations are added once the context manager closes.) N) rbegin_marked_contentrTxpush begin_textextendend_textrend_marked_content)rcontent_builders r)rrss +,O((1  2 &&(sBBc*URnURnURSU5UR=(d S-nUR UR =(d U5 UR nURU5n[UR55HupUS:waUR5 [S5n /n U R5Hnn URX5n X-U -U:a7URSRU 55 UR5 U n U /n MVU R!U 5 XU -- n Mp U (dMURSRU 55 M g![a URSSS9nGNf=f)aLay out the given text, wrapping at the edges of the bounding box. This layout algorithm is incomplete and somewhat rudimentary, but should produce acceptable results for most common use cases. Known issues: * Does not respect field-defined alignment (quadding) and spacing. * The text may overflow out the bottom of the box. We don't try to prevent this currently, though a correct implementation would do so if scrolling was disabled. * Words which are longer than the box width may overflow out the right side. * Does not allow line breaks other than at ' ' or '\n' characters. * Only ASCII, WinAnsi, and MacRoman encodings are supported.  rasciirerrors N)rr text_widthrset_text_leadingrwidthencodeNotImplementedErrorr splitlinesmove_cursor_new_liner split show_textjoinappend)contenttextrrrrrrlinenoline line_width line_wordswordword_lens r)rrsg$ <Y? JJE6{{4  "$//"34  Q;  ( ( *QZ  JJLDt7H(83e;!!$))J"78,,.% "V !!$'X55 ! :   dii 3 4)5 6{{79{56s2E44FFcURnURnURn[U5U- nUR X5n /n Sn UHRn UR U 5n URU 5U - S- n U RX-5 U RU 5 U n MT UR"U 6 g![ a U R SSS9n Nmf=f)aDLay out text, spacing characters evenly according to comb size. This layout algorithm is incomplete and somewhat rudimentary, but should produce acceptable results for most common use cases. Known issues: * Does not respect field-defined alignment (quadding). * Only ASCII, WinAnsi, and MacRoman encodings are supported. rrrrrcN) rrrr convert_width_reverserrunscaled_char_widthrshow_text_with_kerning)rrrrrrrr comb_size comb_size_gsparts last_widthchar space_neededs r)rr s" <rs2"#88%! < !zzz??>ZG ZGz$,M$,RL%}L%^*)*)ZmjI-jIZ4646nB ]B JAA0%-'@%-P)(H)d@6@< *  @W@W @WF))<55 !55),557>55FO55p#+ !#+ #+#+  #+  #+L    (< IS r,