h SrSSKJr SSKJrJrJrJrJrJ r J r J r SSK r SSK r SSKrSSKJrJr SSKJrJrJrJrJrJr SSKJrJrJrJrJrJrJ r SSK!J"r"J#r#J$r$ SS K%J&r&J'r'J(r( \(aSS K)J*r*J+r+J,r, SS K-J.r. SS K/J0r0 S r1"SS5r2SGSjr3SHSjr4SISjr5SJSjr6Sr7SKSLSjjr8SJSjr9SMSNSjjr:SOSPSjjr;SJSjrSTSjr?SUSjr@\RS\R4S\R8S \R6S!\RS"\RS#0rDS$rES%rFSVS&jrG"S'S(\ 5rH"S)S*5rI"S+S,\J5rK"S-S.5rL"S/S05rM"S1S2\ R5rO"S3S45rP\ R"S55rR\ R"S65rS\R4\R8\R6\R\RS7.rT"S8S95rUSWS:jrVSXS;jrWSYSZS<jjrXSYS[S=jjrYS\S]S>jjrZS^S?jr[S@q\S_SAjr]S`SBjr^SaSbSCjjr_\ 4ScSDjjr`\a"SE5rbSdSFjrcg)ezL Tools in this module should be as independent of DXF entities as possible! ) annotations)IterableIterator TYPE_CHECKINGUnionOptionalCallable NamedTupleAnyN) validatorconst)TextEntityAlignment TextHAlignMTextParagraphAlignmentMTextLineAlignment MTextStrokeMAP_MTEXT_ALIGN_TO_FLAGS)LEFTCENTERRIGHTBASELINEMIDDLETOP MAX_STR_LEN)Vec3Vec2UVec)rgb2intRGBint2rgb)TextMText DXFEntity)Tagsfontsc"\rSrSrSrSSjrSSjr\SSj5r\SSj5r SSjr SSS jjr SSS jjr SS jr \\"SSS5S SS S4SSjj5rSrg)TextLine4aHelper class which represents a single line text entity (e.g. :class:`~ezdxf.entities.Text`). Args: text: content string font: ezdxf font definition like :class:`~ezdxf.fonts.fonts.MonospaceFont` or :class:`~ezdxf.fonts.fonts.TrueTypeFont` cXX lURU5UlSUlSUlg)N?)_font text_width _text_width _stretch_x _stretch_y)selftextfonts B/var/www/html/env/lib/python3.13/site-packages/ezdxf/tools/text.py__init__TextLine.__init__?s& "&//$"7!$!$c[U[5(deSnSnU[R[R4;aBX2- RnUR S:a$X`R - nU[R:XaUnX@lXPlg)zSet stretch factors for FIT and ALIGNED alignments to fit the text between `p1` and `p2`, only the distance between these points is important. Other given `alignment` values are ignore. r,g& .>N) isinstancerFITALIGNED magnituder/r0r1)r2 alignmentp1p2sxsydefined_lengths r5stretchTextLine.stretchEs )%89999 ,002E2M2MN N%'W$7$7N$&#&6&66 3 ; ;;Br8c4URUR-$)z)Returns the final (stretched) text width.)r/r0r2s r5widthTextLine.widthWs$//11r8c\URRRUR-$)z*Returns the final (stretched) text height.)r- measurements total_heightr1rGs r5heightTextLine.height\s#zz&&33dooEEr8c`URRRUR5$)z%Returns the scaled font measurements.)r-rKscaler1rGs r5font_measurementsTextLine.font_measurementsas!zz&&,,T__==r8rrTcUR5n[SUR5[URUR5/nUR X#U5n[ R XqXU5$)aBReturns the left and the right baseline vertex of the text line. Args: insert: insertion location halign: horizontal alignment left=0, center=1, right=2 valign: vertical alignment baseline=0, bottom=1, middle=2, top=3 angle: text rotation in radians scale: scale in x- and y-axis as 2-tuple of float r)rQrbaselinerH _shift_vectorr) transform_2d) r2inserthalignvalignanglerPfmverticesshifts r5baseline_verticesTextLine.baseline_verticesesd$ # # % BKK R[[ ) ""626$$XuUKKr8cHUR5n[SUR5[URUR5[URUR5[SUR5/nUR X#U5n [ RXXXV5$)aReturns the corner vertices of the text line in the order bottom left, bottom right, top right, top left. Args: insert: insertion location halign: horizontal alignment left=0, center=1, right=2 valign: vertical alignment baseline=0, bottom=1, middle=2, top=3 angle: text rotation in radians scale: scale in x- and y-axis as 2-tuple of float oblique: shear angle (slanting) in x-direction in radians r)rQrbottomrHcap_toprWr)rX) r2rYrZr[r\rPobliquer]r^r_s r5corner_verticesTextLine.corner_verticess* # # % BII  RYY ' RZZ ( BJJ    ""626$$XuUTTr8cD[URU5[X254$N)_shift_xrH_shift_y)r2rZr[r]s r5rWTextLine._shift_vectors F+Xb-AAAr8)rrcr^^^ ^ ^ [R"U5nU(a"[R"U5m U 4SjU5n[U5m T (a U 4SjU5nUumm TS:wdT S:wa UU 4SjU5nT(a U4SjU5n[ U5nUVs/sHoqU-PM sn$s snf)ayTransform any vertices from the text line located at the base location at (0, 0) and alignment LEFT. Args: vertices: iterable of vertices insert: insertion location shift: (shift-x, shift-y) as 2-tuple of float rotation: text rotation in radians scale: (scale-x, scale-y) as 2-tuple of float oblique: shear angle (slanting) in x-direction in radians c3># UH5n[URURT--UR5v M7 g7frirxy).0vslant_xs r5 (TextLine.transform_2d..s0KAaccACC'M113377s=Ac3,># UH oT-v M g7fri)rrrs shift_vectors r5rurvs=9a\)9srTc3p># UH+n[URT-URT-5v M- g7friro)rrrsscale_xscale_ys r5rurvs+OYaccGmQSS7];;Ys36c3D># UHoRT5v M g7fri)rotate)rrrsrotations r5rurvs?Y(++Ys )rgeneratemathtanr) r^rYr_rrPre vertices_rsr{r|ryrts ` @@@@r5rXTextLine.transform_2dsD%)MM($;  hhw'GKKIE{ =9=I! a<7a<OYOI ?Y?If$-.Iq I...s#B4)r-r0r1r/N)r3strr4fonts.AbstractFont)r>rr?rr@rreturnNonerfloat)rfonts.FontMeasurements)rrrrS) rYrrZintr[rr\rrPtuple[float, float]r list[Vec3])rrrrSr)rYrrZrr[rr\rrPrrerrr)rZrr[rr]rrr)r^zIterable[UVec]rYrr_rrrrPrrerrr)__name__ __module__ __qualname____firstlineno____doc__r6rDpropertyrHrMrQr`rfrW staticmethodrrX__static_attributes__rxr8r5r)r)4s% $22FF>%+ LLL L  L # L L>%+UUU U  U # UU U>BB#&B,BB B Aq!}%+%+ 8/ 8/8/#8/ 8/ # 8/  8/ 8/8/r8r)c>U[:XaU*S- $U[:XaU*$g)Ng@)rr) total_widthrZs r5rjrjs) |c!! | r8cU[:Xa UR$U[:XaUR*URS- -$U[ :XaUR*UR S- -$U[:Xa UR*$UR*$)N) rrVrrd cap_heightX_MIDDLErLrrc)r]r[s r5rkrksw {{  {R]]Q...  {R__q000 } { II:r8cUR5nUS;aURRnURRnU[R [R 4;a[n[nX#4$U[R:Xa [n[nX#4$US:Xa5[R"URR[[45$[!SU35e)zReturn unified horizontal and vertical alignment. horizontal alignment: left=0, center=1, right=2 vertical alignment: baseline=0, bottom=1, middle=2, top=3 Returns: tuple(halign, valign) )TEXTATTRIBATTDEFMTEXTz invalid DXF )dxftypedxfrZr[rr<r;rrrrrgetattachment_pointrr TypeError)entityrrZr[s r5unified_alignmentrsnnG.."""" j((*..9 9FF~z(( (FF~''++FJJ,G,G$PSUU l7), --r8c Sn[[R"[U555nUR(aUR 5nUS:XaUR S5S:XauUR S5R 5n[RRU5nU(aURS5 X- nMUS;aURS5 MURS5 X- nUR(aMU$)zReturns the plain text for :class:`~ezdxf.entities.Text`, :class:`~ezdxf.entities.Attrib` and :class:`~ezdxf.entities.Attdef` content. %rTrkou) TextScannerr fix_one_line_text caret_decodehas_datapeeklowerr SPECIAL_CHAR_ENCODINGrconsume)r3resultscannercharcodeletters r5 plain_textrsF)55l46HIJG   ||~ 3;||A#%||A,,.4488>OOA&$F5=OOA&#    $ Mr8 PNLlOoKkXcj/n[[[U555nU(GaUR5nUS:XaUR5nUS;aUR U5 GOUU[ ;a2US:XaUR S5 GO2US:XaUR S5 GOUS:HnUnUR5nUS:wa6UR5nU(aUS:waUR U5 US:waM6UnOUS ;aOUS :XaU(aUS S :XaUR5 U(ajUR5n[RRUR55n U (aUR U 5 O8URS S U45 O#UR U5 OUR U5 U(aGMS RU5n U(aU RS5$U $![a M8f=f![a% UR S5 UR U5 Ntf=f) ayReturns the plain MTEXT content as a single string or a list of strings if `split` is ``True``. Replaces ``\P`` by ``\n`` and removes other controls chars and inline codes. This function is more than 4x faster than :func:`plain_mtext`, but does not remove single letter inline commands with arguments without a terminating semicolon like this ``"\C1red text"``. .. note:: Well behaved CAD applications and libraries always create inline codes for commands with arguments with a terminating semicolon like this ``"\C1;red text"``! Args: text: MTEXT content string split: split content at line endings ``\P`` \\{}P N S;z{}rr)listreversedrpop IndexErrorappendONE_CHAR_COMMANDScopyr rrrextendjoinsplit) r3rchars raw_charsrstacking first_char search_charsrrrs r5fast_plain_mtextrs( EXl4012I }} 4<  }}v~ T"**3;LL&S[LL% 3;! (~~/  -#++//1# !LL. #+ !-I T\  S[Yr]c1 $==?D"88<.replace_matchs'  A AFc>""r8z\^(.))rzre.Matchrr)resub)r3rs r5rrs# 66(M 00r8c/nSnXX1-n[U5(aK[U5U:aURU5 U$X1- nUSS:Xa USSnUS-nURU5 OU$Me)z9Split the MTEXT content string into chunks of max `size`.rr^NrT)lenr)ssizechunksposchunks r5split_mtext_stringrs~ F C  # u::5zD  e$ KCRyCcr q MM% M r8c /n/n[[5tnnnnn n n n nSU-n [U5HnURnX:XaUR UR 5 M1X:XdX:XaUR S5 MNX:XdX:Xa2UR SR U55 UR5 MX:XaUR U 5 MX:XdMUR unnnUR UU-U-5 M U(a UR SR U55 U(aU$SR U5$)aReturns the plain MTEXT content as a single string or a list of strings if `split` is ``True``. Replaces ``\P`` by ``\n`` and removes other controls chars and inline codes. This function is much slower than :func:`fast_plain_mtext`, but removes all inline codes. Args: text: MTEXT content string split: split content at line endings ``\P`` tabsize: count of replacement spaces for tabulators ``^I`` rrr)iter TokenType MTextParsertyperdatarclear)r3rtabsizecontent paragraph_wordstackspacenbsp tabulator new_paragraph new_columntab_replacementtokentuprlwrdividers r5 plain_mtextrs!$GI Y       GmOT" JJ 9   UZZ ( Z19   S !  1? NN2779- . OO  ^   _ - Z % Cg   S7]S0 1#rwwy)*  99W r8cFURSS5RSS5$)N rr\Preplacer3s r5escape_dxf_line_endingsr Ns" <<b ! ) )$ 66r8c:^SRU4SjU55$)Nrc3L># UHn[U5(aTOUv M g7fri)is_non_printable_char)rrr replacements r5ru3replace_non_printable_characters..Us!P4a"7":":;A4s!$)r)r3rs `r5 replace_non_printable_charactersrTs 77P4P PPr8cVS[U5s=:*=(a S:Os =(a US:g$)Nr  )r)rs r5rrXs" D  B  /44</r8cU(aUR5(a/$[R"SU5nUVVs/sH,n[R"SU5H oU(dM UPM M. nnn/nSnSn UHnU(+n US:Xa U (aMSn US:Xa#URUR 55 SnMDUR5(aU(dU (aX- nMmMoUb@U"X-5U:a2U(dX- nMURUR 55 UnSn MX- nM U(a4UR5(dURUR 55 U$s snnf)aWrap text at ``\n`` and given `box_width`. This tool was developed for usage with the MTEXT entity. This isn't the most straightforward word wrapping algorithm, but it aims to match the behavior of AutoCAD. Args: text: text to wrap, included ``\n`` are handled as manual line breaks box_width: wrapping length, ``None`` to just wrap at ``\n`` get_text_width: callable which returns the width of the given string z(\n)z(\s+)rFrT)isspacerrrrstrip) r3 box_widthget_text_width manual_lineslinertokenslines current_lineline_just_wrapped on_first_lines r5 text_wrapr#\s?" 4<<>> 88GT*L( PLD"((8T2JQaa2JaLF PEL ! 9* ! 9 LL,,. /L YY[[}!  -$ 8H)II)U# %LLL!4!4!67#$L(,%! ),L0022 \((*+ L;Qs %E0$ E0c"URS5(d[UR5S35eUR(aLURRR UR R5nU(a UR$g)z`Returns ``True`` if the associated text :class:`~ezdxf.entities.Textstyle` is vertical stacked. stylez& does not support the style attribute.F) is_supported_dxf_attribrrdocstylesrrr%is_vertical_stacked)r3r%s r5is_text_vertical_stackedr*sh  ' ' 0 04<<>**PQRR xx##DHHNN3 ,, , r8rlrrjd, 01234567890cD[U[[45(aUS$U$)Ng)r:rr)rs r5rstrip0r3s!!c5\""A Hr8c\rSrSr%SrSrS\S'SrS\S'SrS\S'\ Rr S\S '\ "5r S \S 'SS jrS rg)ParagraphPropertiesiaStores all known MTEXT paragraph properties in a :class:`NamedTuple`. Indentations and tab stops are multiples of the default text height :attr:`MText.dxf.char_height`. E.g. :attr:`char_height` is 0.25 and :attr:`indent` is 4, the real indentation is 4 x 0.25 = 1 drawing unit. The default tabulator stops are 4, 8, 12, ... if no tabulator stops are explicit defined. Args: indent (float): left indentation of the first line, relative to :attr:`left`, which means an :attr:`indent` of 0 has always the same indentation as :attr:`left` left (float): left indentation of the paragraph except for the first line right (float): left indentation of the paragraph align: :class:`~ezdxf.lldxf.const.MTextParagraphAlignment` enum tab_stops: tuple of tabulator stops, as ``float`` or as ``str``, ``float`` values are left aligned tab stops, strings with prefix ``"c"`` are center aligned tab stops and strings with prefix ``"r"`` are right aligned tab stops rrindentleftrightraligntuple tab_stopsc |/nUR(a4URSURS35 UR[5 UR(a4URSURS35 UR[5 UR(a4URSURS35 UR[5 UR (a:URS[ UR 35 UR[5 UR(aTURS[R[[UR5535 UR[5 U(a4US[:XaUR5 SS RU5-S -$g ) zTReturns the MTEXT paragraph properties as MTEXT inline code e.g. ``"\pxi-2,l2;"``. ir2r+r,qrrz\pxrr) r6rCOMMAr7r8r9_alignment_charr;rmapr3r)r2argss r5tostringParagraphProperties.tostrings+  ;; KK!DKK?+ , KK  99 KK!DIIa=) * KK  :: KK!DJJq>* + KK  :: KK!ODJJ789 : KK  >> KK!EJJs7DNN'CDEF G KK  Bx5  BGGDM)C/ /r8rxNrr)rrrrrr6__annotations__r7r8rDEFAULTr9r:r;rCrrxr8r5r5r5sJ,FED%OE5%<%D%DE "D wIur8r5cB\rSrSrSrS)S*SjjrSrSrSrSr Sr Sr S r S r S rS rS rSrSrSrSrSrS+SjrS+SjrS,SjrSrS-S.SjjrS/SjrS0SjrS/SjrS/SjrS1SjrS2Sjr S3Sjr!S4Sjr"S5S6S jjr#S+S!jr$S+S"jr%S+S#jr&S+S$jr'S7S%jr(S8S&jr)S'r*g()9 MTextEditoriaThe :class:`MTextEditor` is a helper class to build MTEXT content strings with support for inline codes to change color, font or paragraph properties. The result is always accessible by the :attr:`text` attribute or the magic :func:`__str__` function as :code:`str(MTextEditor("text"))`. All text building methods return `self` to implement a floating interface:: e = MTextEditor("This example ").color("red").append("switches color to red.") mtext = msp.add_mtext(str(e)) The initial text height, color, text style and so on is determined by the DXF attributes of the :class:`~ezdxf.entities.MText` entity. .. warning:: The :class:`MTextEditor` assembles just the inline code, which has to be parsed and rendered by the target CAD application, `ezdxf` has no influence to that result. Keep inline formatting as simple as possible, don't test the limits of its capabilities, this will not work across different CAD applications and keep the formatting in a logic manner like, do not change paragraph properties in the middle of a paragraph. **There is no official documentation for the inline codes!** Args: text: init value of the MTEXT content string. c$[U5Ulgri)rr3r2r3s r5r6MTextEditor.__init__s I r8r z\N\L\l\O\o\K\k{}z\A0;z\A1;z\A2;\~z^Ic0U=RU- slU$)zAppend `text`.r rKs r5rMTextEditor.append*s T  r8c0U=RU- slU$)z] Append `text`:: e = MTextEditor("First paragraph.\P") e += "Second paragraph.\P") r rKs r5__iadd__MTextEditor.__iadd__/s T  r8cUR$)z1Returns the MTEXT content attribute :attr:`text`.r rGs r5__str__MTextEditor.__str__: yyr8cSUlg)z%Reset the content to an empty string.rNr rGs r5rMTextEditor.clear>s  r8c \URSUS[U5S[U5S35$)aSet the text font by the font family name. Changing the font height should be done by the :meth:`height` or the :meth:`scale_height` method. The font family name is the name shown in font selection widgets in desktop applications: "Arial", "Times New Roman", "Comic Sans MS". Switching the codepage is not supported. Args: name: font family name bold: flag italic: flag z\fz|bz|irrr)r2namebolditalics r5r4MTextEditor.fontBs0&{{bbT 2c&k]!DEEr8c@URS[US5S35$)aScale the text height by a `factor`. This scaling will accumulate, which means starting at height 2.5 and scaling by 2 and again by 3 will set the text height to 2.5 x 2 x 3 = 15. The current text height is not stored in the :class:`MTextEditor`, you have to track the text height by yourself! The initial text height is stored in the :class:`~ezdxf.entities.MText` entity as DXF attribute :class:`~ezdxf.entities.MText.dxf.char_height`. \Hrzx;rroundr2factors r5 scale_heightMTextEditor.scale_heightWs${{bvq!1 2"566r8c@URS[US5S35$)z.Set the absolute text height in drawing units.rhrrri)r2rMs r5rMMTextEditor.heightc"{{bvq!1 2!455r8c@URS[US5S35$)z#Set the absolute text width factor.z\Wrrrirks r5 width_factorMTextEditor.width_factorgrqr8c@URS[US5S35$)z+Set the absolute character tracking factor.z\Trrrirks r5char_tracking_factor MTextEditor.char_tracking_factorkrqr8c>URS[U5S35$)zpSet the text oblique angle in degrees, vertical is 0, a value of 15 will lean the text 15 degree to the right. z\Qrrb)r2r\s r5reMTextEditor.obliqueos {{bU A.//r8cbUR[RUR55$)zcSet the text color by color name: "red", "yellow", "green", "cyan", "blue", "magenta" or "white". )acir MTEXT_COLOR_INDEXr)r2rcs r5colorMTextEditor.colorvs$ xx// =>>r8cbSUs=::aS::aO OURSUS35$[S5e)z3Set the text color by :ref:`ACI` in range [0, 256].rz\Crzaci not in range [0, 256])r ValueErrorr2r{s r5r{MTextEditor.aci}s0 ?s?;;"SE|, ,455r8cLUup#nURS[XCU45S35$)z Set the text color as RGB value.z\cr)rr)r2rgbr,r2bs r5rMTextEditor.rgbs-a{{b!!3 4A677r8crUS;a[SU35eUS:XaUS- nURSUUUS35$)aAppend stacked text `upr` over `lwr`, argument `t` defines the kind of stacking, the space " " after the "^" will be added automatically to avoid caret decoding: .. code-block:: none "^": vertical stacked without divider line, e.g. \SA^ B: A B "/": vertical stacked with divider line, e.g. \SX/Y: X - Y "#": diagonal stacked, with slanting divider line, e.g. \S1#4: 1/4 ^/#zinvalid type symbol: rrz\Sr)rr)r2rrrs r5rMTextEditor.stacksN( E>4QC89 9 8 HA{{baSQ/00r8c,URSUS35$)zGroup `text`, all properties changed inside a group are reverted at the end of the group. AutoCAD supports grouping up to 8 levels. rSrTrrKs r5rMTextEditor.groups {{RvR=))r8c,URSUS35$)z)Append `text` with a line below the text.rMrNrrKs r5 underlineMTextEditor.underline{{bb>**r8c,URSUS35$)z)Append `text` with a line above the text.rOrPrrKs r5overlineMTextEditor.overlinerr8c,URSUS35$)z+Append `text` with a line through the text.rQrRrrKs r5strike_throughMTextEditor.strike_throughrr8c@URUR55$)zBSet paragraph properties by a :class:`ParagraphProperties` object.)rrC)r2propss r5rMTextEditor.paragraphs{{5>>+,,r8c ^[5R[U*S-UU4S95nURSR U4Sj[ X#5555 TR [U55$)uBuild bulleted lists by utilizing paragraph indentation and a tabulator stop. Any string can be used as bullet. Indentation is a multiple of the initial MTEXT char height (see also docs about :class:`ParagraphProperties`), which means indentation in drawing units is :attr:`MText.dxf.char_height` x `indent`. Useful UTF bullets: - "bull" U+2022 = • (Alt Numpad 7) - "circle" U+25CB = ○ (Alt Numpad 9) For numbered lists just use numbers as bullets:: MTextEditor.bullet_list( indent=2, bullets=["1.", "2."], content=["first", "second"], ) Args: indent: content indentation as multiple of the initial MTEXT char height bullets: iterable of bullet strings, e.g. :code:`["-"] * 3`, for 3 dashes as bullet strings content: iterable of list item strings, one string per list item, list items should not contain new line or new paragraph commands. g?)r6r7r;rc3f># UH&upUTR-U-TR-v M( g7fri)TAB NEW_PARAGRAPH)rrrrr2s r5ru*MTextEditor.bullet_list..s/BW$!DHH q 4#5#55BWs.1)rIrr5rrziprr)r2r6bulletsritemss` r5 bullet_listMTextEditor.bullet_listsq< '' w~!)    GGBEgBW  zz#e*%%r8r N)rr3r)r3rrrIrE)FF)rcrrdboolrerrrI)rlrrrI)rMrrrI)r\rrrI)rcrrrI)r{rrrI)rrrrI)r)rrrrrrrrI)rr5rrI)r6rr Iterable[str]rrrrI)+rrrrrr6NEW_LINEr NEW_COLUMNUNDERLINE_STARTUNDERLINE_STOPOVERSTRIKE_STARTOVERSTRIKE_STOP STRIKE_START STRIKE_STOP GROUP_START GROUP_END ALIGN_BOTTOM ALIGN_MIDDLE ALIGN_TOPNBSPrrrYr\rr4rmrMrsrvrer}r{rrrrrrrrrrxr8r5rIrIs@HMJONOLKKILLI D C F* 76660?6 8 16*+++-*&*&&3*&>K*& *&r8rIc\rSrSrSrg)UnknownCommandirxN)rrrrrrxr8r5rrsr8rcR\rSrSrSrSSjrSSjr\rSrSSjr \ SSj5r \ RSSj5r SSS jjr \ SS j5r\RSS j5r\ SS j5r\RSS j5r\ SSj5r\RSSj5r\ SSj5rSrg) MTextContextiz0Internal class to store the MTEXT context state.cSSKJn SUlSUlSUlSUl[ RUlUR"5Ul SUl SUl SUl SUl[5Ulg)Nrr%Fr,r) ezdxf.fontsr&_strokecontinue_stroke_acirrBOTTOMr9FontFace font_facerrsrvrer5r)r2r&s r5r6MTextContext.__init__se% %* "&'.. )!$#&+.!! ,.r8c[5nURUlURUlURUlURUlUR UlUR UlURUlURUlURUl URUl URUl U$ri) rrrrrr9rrrsrvrer)r2ps r5__copy__MTextContext.__copy__s NLL  00**nn  **!%!:!:LL nn r8c  [URURURURUR UR URURURURUR4 5$ri) hashrrrrr9rrrsrvrerrGs r5__hash__MTextContext.__hash__sg $$  !!))    r8c0[U5[U5:H$ri)r)r2others r5__eq__MTextContext.__eq__sDzT%[((r8cUR$ri)rrGs r5r{MTextContext.aci"r^r8cTSUs=::aS::aO OXlSUlg[S5e)Nrrzaci not in range[0,256])rrrrs r5r{r&s% ?s?IDH67 7r8cjU(aU=RU-slgU=RU)-slg)zSet/clear binary `stroke` flag in `self._stroke`. Args: stroke: set/clear stroke flag state: ``True`` for setting, ``False`` for clearing N)r)r2strokestates r5_set_stroke_stateMTextContext._set_stroke_state.s%  LLF "L LLVG #Lr8cN[UR[R-5$ri)rrr UNDERLINErGs r5rMTextContext.underline;sDLL;#8#8899r8cDUR[RU5 gri)rrrr2values r5rr?s {44e>r8cDUR[RU5 gri)rrrrs r5rrGs {995Ar8cN[UR[R-5$ri)rrrOVERLINErGs r5rMTextContext.overlineKsDLL;#7#7788r8cDUR[RU5 gri)rrrrs r5rrOs {33U;r8c,[UR5$ri)rrrGs r5has_any_strokeMTextContext.has_any_strokeSsDLL!!r8) rrr9rrvrrrerrrsNrr)rrrrrr)r{r)T)rrrrrr)rrrr)rrrrrr6rrrrrr{setterrrrrrrrxr8r5rrs: /  D ") ZZ88 $::==??BB99__<<""r8rc\rSrSrSrSSjr\SSj5r\SSj5rSSjr SSSjjr SSSjjr SSS jjr SSS jjr SSS jjrSS jrSS jrSSjrSSjrSrg)riX)_text _text_len_indexcf[U5Ul[UR5UlSUlg)Nr)rrrrrrKs r5r6TextScanner.__init__[s#Y TZZ r8c4URUR:$rirrrGs r5is_emptyTextScanner.is_empty`s{{dnn,,r8c4URUR:$rirrGs r5rTextScanner.has_datads{{T^^++r8cURURnU=RS- slU$![a gf=f)NrTrrrr)r2rs r5rTextScanner.gethsB ::dkk*D KK1 K   s .2 ??cPUS:a [U5eU=RU- slg)NrT)rrr2counts r5rTextScanner.consumeps" 19U# # u r8c.U=RU- slg)zconsume() without safety checkNrrs r5 fast_consumeTextScanner.fast_consumeus u r8c~US:a [U5eURURU-$![a gf=f)Nrr)rrrrr2offsets r5rTextScanner.peekysC A:V$ $ ::dkkF23 3  s / <<c\URURU-$![a gf=f)zpeek() without safety checkrrrs r5 fast_peekTextScanner.fast_peeks1 ::dkkF23 3  s  ++cURURURS5nUR(aUR 5nU(a.US:Xa(UR S5U:XaUR S5 MVXA:XaURUR-$UR S5 UR(aMg)a<Return the index of the next `char`. If `escape` is True, backslash escaped `chars` will be ignored e.g. "\;;" index of the next ";" is 1 if `escape` is False and 2 if `escape` is True. Returns -1 if `char` was not found. Args: char: single letter as string escape: ignore backslash escaped chars if True. NrrTrr) __class__rrrrr)r2rescaperrs r5findTextScanner.finds..DKKM!:; A!t) Q4(?"y{{W^^33 OOA r8chXR:a [U5eURURU$)zCReturns the substring from the current location until index < stop.)rrr)r2stops r5substrTextScanner.substrs, ++ T" "zz$++--r8c4URURS$)z,Returns the unprocessed part of the content.N)rrrGs r5tailTextScanner.tailszz$++-((r8cUR$rirrGs r5indexTextScanner.indexs {{r8cURX$ri)r)r2startrs r5substr2TextScanner.substr2szz%%%r8)rrrNrrrE)rT)rrrr)r)rrrrF)rrrr)rrrrr)rrrrrr)rrrr __slots__r6rrrrrrrr rrrrrrrxr8r5rrXsf0I --,, .. )&r8rc<\rSrSrSrSrSrSrSrSr Sr S r S r S r S rg )rirrTrrr'r rxN)rrrrNONEWORDSTACKSPACEr TABULATORrrWRAP_AT_DIMLINEPROPERTIES_CHANGEDrrxr8r5rrs5 D D E E DIMJOr8rc&\rSrSrSrSSSjjrSrg) MTextTokenirctxrNc(XlX lX0lgrir.)r2rr/rs r5r6MTextToken.__init__s !$ r8)r/rrri)rrr/r)rrrrrr6rrxr8r5r-r-s'Ir8r-z#[+-]?\d+(:?\.\d*)?(:?[eE][+-]?\d+)?z)[+-]?\d+(:?\.\d*)?(:?[eE][+-]?\d+)?([x]?))r+r,rr-r.c\rSrSrSrSSSjjrSSjrSSjrSSjrSSjr SS jr SS jr S S jr S S jr S S jrS SjrS!SjrS SjrS SjrS SjrS"S#SjjrS#SjrS"S#SjjrS SjrS SjrSrSrg)$riaParses the MText content string and yields the content as tokens and the current MText properties as MTextContext object. The context object is treated internally as immutable object and should be treated by the client the same way. The parser works as iterator and yields MTextToken objects. Args: content: MText content string ctx: initial MText context yield_property_commands: yield commands that change properties or context, default is ``False`` NcUc [5nX l[[U55Ul/UlSUl[U5UlgNF) rr/rrr _ctx_stack_continue_stroker_yield_property_commands)r2rr/yield_property_commandss r5r6MTextParser.__init__sC ;.C"<#89 .0 %(,-D(E%r8c"UR5$ri)parserGs r5__iter__MTextParser.__iter__szz|r8cNURRUR5 gri)r5rr/rGs r5push_ctxMTextParser.push_ctxs txx(r8cfUR(a URR5Ulggri)r5rr/rGs r5pop_ctxMTextParser.pop_ctxs" ??**,DH r8c#r^^^^^^^ ^ # TRmTRmTRmSm[Rm[R m UUU 4Sjm SUUUUUU U 4SjjnU"5up#U(a<[ UTRU5v T(a[ TTRS5v SmOgMO7f)Nc4>T"5 U(aUmTU4$US4$rirx)rrrfollowup_token word_tokens r5word_and_token)MTextParser.parse..word_and_tokens% I!&!4''$; r8cX>SnT R(GaaSnT"5nT R5nUS:XGaT"S5S;aSnT"5 T"5nOU(aT U4$T"5 T R5nUS:Xa[RS4$US:Xa[R S4$US :Xa[R S4$US :Xa[RS4$US :XaT R5$U(aTT RU5 T R(a0[RT RUT R554$GMEUS :a=US :XaT "U[R5$US:XaT "U[R 5$S nOXUS:XaRT"S5S:XaFT"S5R5n[ R"RU5nU(a T"S5 UnUS :Xa T "UT 5$U(dXUS:Xa&U(aT U4$T"S5 T R%5 GM"US:Xa&U(aT U4$T"S5 T R'5 GMNT"5 US :aX- nT R(aGMaU(aT U4$[R(S4$![a XU-- nGNbf=f)NrFrrTrT~rrXrrrrrrrSrT)rrrrrrrr*parse_stackingparse_propertiesr7r+rrr)rr rr?rBr%)rr rcmd_start_indexcmdr special_charrrrr2 space_tokenrHrGs r5 next_token%MTextParser.parse..next_token sD"""")--/T>Aw&(!% !% #-t#33 %kkm#:#,>>4#77#:#,#:#:D#@@#:#,#7#7#==#:#,#<##>#B#B4#HL# !-S=)$ <<}#-t#33#AJ MMO$3#-t#33#AJ LLN$ S=NDa"""d!4'' ~~t++o$25 $ 45s3JJ)(J)rztuple[TokenType, Any])rrr rr(r&r-r/) r2rStype_rrrFrrrRrHrGs ` @@@@@@@r5r;MTextParser.parses,,&&  .2oo ^^  X ,X ,t$,KE $77!$^TXXtDD%)NsB-B7c^^^U4SjmUU4SjmSUU4SjjnS UU4Sjjn[URSS95mU"5up4U(aU"5OSn[RX5U44$) aReturns a tuple of strings: (numerator, denominator, type). The numerator and denominator is always a single and can contain spaces, which are not decoded as separate tokens. The type string is "^" for a limit style fraction without a line, "/" for a horizontal fraction and "#" for a diagonal fraction. If the expression does not contain any stacking type char, the type and denominator string are empty "". cJ>TR5n[U5S:aSnU$)Nrr)rr)rstacking_scanners r5 peek_char-MTextParser.parse_stacking..peek_charzs& %%'A1v{Hr8c~>SnT"5nUS:XaSnTRS5 T"5nTRS5 X4$)NFrTrT)r)r rr[rZs r5 get_next_char1MTextParser.parse_stacking..get_next_charsFF ADy ((+K  $ $Q '9 r8c>SnTR(a0T"5upU(d US;aX4$X- nTR(aM0US4$)Nrrr)rrr r^rZs r5parse_numerator3MTextParser.parse_stacking..parse_numeratorsJD"++)O !u*7N  #+++ 8Or8cn>SnTR(a UT"5S- nTR(aM U$)Nrrra)rr^rZs r5parse_denominator5MTextParser.parse_stacking..parse_denominators5D"++ **#+++Kr8Tr r)rztuple[str, str]rE)rextract_expressionrr') r2rbre numerator stacking_type denominatorr^r[rZs @@@r5rMMTextParser.parse_stackingpsh       't'>'>d'>'KL#2#4 -:')  GGGr8cURR5nUS:XaSUlSUlGOUS:Xa!SUlUR(dSUlGOeUS:XaSUlSUlGOOUS:Xa!SUlUR(dSUlGO(US:XaSUlSUlGOUS:Xa SUlUR(dSUlOUS :XaURU5 OUS :XaURU5 OUS :XaURU5 OUS :XaURU5 OUS :XaURU5 OtUS:XaURU5 O\US:XaURU5 ODUS:XaURU5 O,US:XdUS:XaURU5 O[!SU35eURUlX lg)NLTr+FOoKkACrHWQTrfFzunknown command: )r/rrr6rrr parse_alignparse_aci_colorparse_rgb_color parse_height parse_width parse_obliqueparse_char_trackingparse_paragraph_propertiesparse_font_propertiesrr)r2rPnew_ctxs r5rNMTextParser.parse_propertiess((--/ #: $G $(D ! CZ %G ))(-% CZ#G $(D ! CZ$G ))(-% CZ%)G "$(D ! CZ%*G "))(-% CZ   W % CZ   ) CZ   ) CZ   g & CZ   W % CZ   w ' CZ  $ $W - CZ  + +G 4 CZ3#:  & &w / #4SE!:; ;"&"7"7r8cURR5nUS;a[[U55UlO[R UlUR 5 g)N012)rrrrr9rconsume_optional_terminator)r2r/rs r5r{MTextParser.parse_alignsD||! 5=*3t95CI*11CI ((*r8cdURUR5UlUR5 gri)parse_float_value_or_factorrrr2r/s r5r~MTextParser.parse_heights$99#..I ((*r8cdURUR5UlUR5 gri)rrsrrs r5rMTextParser.parse_widths';;C>SnT"5nU(a [U5nU$)Nr)r)rrparse_float_exprs r5 parse_float;MTextParser.parse_paragraph_properties..parse_float+s!E#%Dd Lr8c>SnTR5n[R"[U5nU(a.UR 5up4XUnTR U5 T"5 U$r)rrrrrr)rrrrrparagraph_scanner skip_commass r5r@MTextParser.parse_paragraph_properties..parse_float_expr2sWD$))+DHHXt,E"ZZ\ #!))#. Kr8c~>TR5S:Xa(TRS5 TR5S:XaM'gg)Nr/rT)rr)rsr5r;MTextParser.parse_paragraph_properties..skip_commas=s5#((*c1!))!,$((*c1r8r=r+r,rpr>rrrrE)rrhrrr CHAR_TO_ALIGNrrGrrrrr5r:)r2r/rr6r7r8r9r;rP adjustmentrV float_exprrrrs @@@r5r&MTextParser.parse_paragraph_properties*ss    -((?(?(AB03 -eI(((#'')Ccz$"}# .224 %))*6M6U6UV  '00-224E|u|)113!((1A1C)CD%5%7 %%,,U:->?.557(000! (((:, %i(8  r8c2SSKJn UR5RS5nU(akUS(a`USnSnSnUSSH7nUR S5(aSnMUR S 5(dM5S nM9 UR "XEUS 9Ulggg) Nrr%|RegularirTb1ii1Italic)familyr%weight)rr&rhr startswithrr)r2r/r&partsrcr%rparts r5r!MTextParser.parse_font_propertiesds%'')//4 U1X8DEFab ??4(( F__T**$E " "NN$FSCM5r8cxURR5S:XaURRS5 gg)NrrT)rrrrGs r5r'MTextParser.consume_optional_terminatorvs. <<   # % LL  # &r8)r6r5r7r/rr4)rrr/zOptional[MTextContext])rzIterator[MTextToken]rrU)rPrrr)r/rrrrE)rrrrrr6r<r?rBr;rMrNr{r~rrrrr|r}rrrhrrrrrxr8r5rrs $'+ % F F$ F)-tl-H^.`++++ + ++  8 tT$$r8rcfSnSnUHup4US:XaUnMUS:XdMX$- nM [X!-5$)NrrTr)r )tagsrrrrs r5load_mtext_contentr{sB DG  19D QY  G  #7> 22r8cLSURSS5RSS5;$)zDReturns `True` if `text` contains any MTEXT inline formatting codes.rr rrUr r s r5has_inline_formatting_codesrs0 4<< r g r r8cBUS-nSU-Us=:=(a SU- :$s $)upReturns ``True`` if the given text `angle` in degrees causes an upside down text in the :ref:`WCS`. The strict flip range is 90° < `angle` < 270°, the tolerance angle `tol` extends this range to: 90+tol < `angle` < 270-tol. The angle is normalized to [0, 360). Args: angle: text angle in degrees tol: tolerance range in which text flipping will be avoided v@gV@gp@rxr\tols r5is_upside_down_text_anglers. UNE #: + + ++ ++r8c6[X5(aUS- nUS-$)zReturns a readable (upright) text angle in the range `angle` <= 90+tol or `angle` >= 270-tol. The angle is normalized to [0, 360). Args: angle: text angle in degrees tol: tolerance range in which text flipping will be avoided gf@r)rrs r5upright_text_anglers"!,,  5=r8cUS-U-$)zReturns the distance from baseline to baseline. Args: cap_height: cap height of the line line_spacing: line spacing factor as percentage of 3-on-5 spacing gy&1?rx)r line_spacings r5leadingrs   ,,r8c^SU4Sjjn[TRU"5TRRSS5TRR S5S9$)a@Estimate the width and height of a single column :class:`~ezdxf.entities.MText` entity. This function is faster than the :func:`~ezdxf.tools.text_size.mtext_size` function, but the result is very inaccurate if inline codes are used or line wrapping at the column border is involved! Returns: Tuple[width, height] c:>SSKJn TRRS5nTRnU(aHUR R TRRS55nUbURU5$UR"[RUS9$)Nrr% char_heightr%)r) rr&r get_defaultr'r(r make_fontr DEFAULT_TTF)r&rr'r%mtexts r5 _make_font*estimate_mtext_extents.._make_fontss%!II11-@ ii JJNN599#8#8#ABE z22u00ZHHr8rHrline_spacing_factor)rr4 column_widthr)rr)estimate_mtext_content_extentsr3rrr)rrs` r5estimate_mtext_extentsrsI I * \YY]]7C0!II112GH  r8)\(?cUqg)z7Set the global safety factor for MTEXT size estimation.N_SAFETY_FACTOR)rls r5set_estimation_safety_factorrs Nr8cSqg)zZReset the global safety factor for MTEXT size estimation to the hard coded default value. rNrrxr8r5reset_estimation_safety_factorrs Nr8cSnSnURRnUS:n[USS9n[U5(aSn UH{n UR U 5n U S:Xa#U (a[ U 5UR 5-n U(a'U [R"X- 5- n [X5n OU S- n [XK5nM} [Xc5U- n Xi-XS- --nU[-U4$)a3Estimate the width and height of the :class:`~ezdxf.entities.MText` content string. The result is very inaccurate if inline codes are used or line wrapping at the column border is involved! Column breaks ``\N`` will be ignored. Args: content: the :class:`~ezdxf.entities.MText` content string font: font abstraction based on :class:`ezdxf.tools.fonts.AbstractFont` column_width: :attr:`MText.dxf.width` or 0.0 for an unrestricted column width line_spacing_factor: :attr:`MText.dxf.line_spacing_factor` Returns: tuple[width, height] rT)rrrT) rKrranyr.r space_widthrceilminmaxrr) rr4rr max_widthrMrhas_column_widthr line_countr line_widthspacings r5rrs,IF))44J)C/'tSnX[;aUS- nX[;aMXS:XaUU3$[USU5T-nUSnUUXS3$![a N,f=f![a SnN(f=f)NrrTrpz.3gr)VALID_HEIGHT_CHARSrrr)rprefixrnew_sizerrls r5_scale_leading_number:scale_mtext_inline_commands.._scale_leading_number4s -#55 -#55}# &**$ VFU^,v5HnE(5'&.!122     E s'A AA# A A # A21A2rhrrTNr)rrrrrr)rrrr)rrlr old_parts new_partsrs ` r5scale_mtext_inline_commandsr1sp3$ G [F e$I%aL>I!" .tU;< 779 r8)rrrZrrr)r]rr[rrr)rzUnion[Text, MText]rztuple[int, int])r3rrrr)r3rrUnion[list[str], str]))rrrrr list[str])Fr')r3rrrrr)u▯)r3rrrrr)rrrr)r3rrzOptional[float]rzCallable[[str], float]rr )r3r#rr)rrrr)rr$rr)r3rrr)g@)r\rrrrr)r\rrrrr)r,)rrrrrr)rr"rr)rlrrrr)rr,) rrr4rrrrrrr)rz Optional[str]rrrr)rrrlrrr)dr __future__rtypingrrrrrr r r enumrr ezdxf.lldxfr r ezdxf.enumsrrrrrrezdxf.lldxf.constrrrrrrr ezdxf.mathrrr ezdxf.colorsrrr ezdxf.entitiesr!r"r#ezdxf.lldxf.tagsr$rr&rr)rjrkrrrrrrrr rrr#r*rG JUSTIFIED DISTRIBUTEDr@r?DIGITSr3r5rI ExceptionrrrIntEnumrr-compilerrrrrrrrrrrrrrrsetrrrxr8r5rs#    (('..55%! j/j/Z .:< dK3\ 1 , 7 77 7t7 Q01 11+1 1h ##R  #!!3""C%%s''    =*=Ho&o&d Y j"j"ZU&U&p   ::< = ZZD E  ! % % & & ' ' * * , ,  f$f$R 3  ,  -@ !$ 2. 2. 2.2. 2.  2.j2='r8