j1 S SK Jr S SKrS SKrS SKrS SKJrJ r S SK
J r J r J
r S SKJr S SKJr S SKJr S SKJr S S KJr \R2 " \5 r " S
S 5 r \ " 5 r " S S
\5 r g) ) OrderedDictN)
_text_helpersdviread)FontPropertiesget_font fontManager) LoadFlags)MathTextParser)Path)
TexManager)Affine2Dc \ rS rSrSrSrSrS rS rS r S r
S r SS
S
S .S jjr SS
S
S .S
jjr
SS jr SS jrSrg
)
TextToPath z'A class that converts strings to paths.g Y@H c 2 [ S5 U l S U l g )Npath)r
mathtext_parser _texmanagerselfs ڡC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\matplotlib/textpath.py__init__TextToPath.__init__ s -f 5 c [ R " U5 n[ U5 nUR U R U R
5 U$ )zH
Find the `FT2Font` matching font properties *prop*, with its size set.
) _fontManager_find_fonts_by_propsr set_size
FONT_SCALEDPI)r prop filenamesfonts r _get_fontTextToPath._get_font s9 !55d; "
dootxx0 r c " [ R $ )N)r
NO_HINTINGr s r _get_hinting_flag TextToPath._get_hinting_flag' s ###r c ` [ R R UR SUS 35 $ )z6Return a unique id for the given font and glyph index.-x)urllibparsequotepostscript_name)r r$ glyphs r _get_glyph_reprTextToPath._get_glyph_repr* s+ ||!!T%9%9$:!E!9"EFFr c UR 5 nUS:X a [ 5 R X5 $ X@R - nU( aU UR 5 nUR U R 5 U R R USU5 tpgpXe- Xu- X- 4$ U R U5 n
U
R US[ R S9 U
R 5 u pU S- n U S- n U
R 5 n
U
S- n
X- X- X- 4$ )NTeXr g flagsg P@)get_size_in_pointsr get_text_width_height_descentr copyr r r/ r% set_textr r( get_width_height get_descent)r sr" ismathfontsizescalewidthheightdescent_r$ whds r r: (TextToPath.get_text_width_height_descent. s **, U? <==aJ J??* 99;D MM$// *$$**1b$7
'E7=&.'/A A~~d#
aI$8$8
9$$& T T T y!)QY..r Nfeatureslanguagec US:X a U R X5 u pgnO@U( d% U R U5 n U R XXES9u pgnOU R X5 u pgn/ / pU H6 u ppX| u nnU
R UU- X/- 5 U R U5 M8 U H( u nnU
R U5 U R U5 M* U
( d [
R " S5 n
X4$ )ah
Convert text *s* to path (a tuple of vertices and codes for
matplotlib.path.Path).
Parameters
----------
prop : `~matplotlib.font_manager.FontProperties`
The font properties for the text.
s : str
The text to be converted.
ismath : {False, True, "TeX"}
If True, use mathtext parser. If "TeX", use tex for rendering.
language : str, optional
The language of the text in a format accepted by libraqm, namely `a BCP47
language code `_.
Returns
-------
verts : list
A list of arrays containing the (x, y) coordinates of the vertices.
codes : list
A list of path codes.
Examples
--------
Create a list of vertices and codes from a text, and create a `.Path`
from those::
from matplotlib.path import Path
from matplotlib.text import TextToPath
from matplotlib.font_manager import FontProperties
fp = FontProperties(family="Comic Neue", style="italic")
verts, codes = TextToPath().get_text_path(fp, "ABC")
path = Path(verts, codes, closed=False)
Also see `TextPath` for a more direct way to create a path from a text.
r6 rK )r )get_glyphs_texr% get_glyphs_with_fontget_glyphs_mathtextextendnpempty)r r" r? r@ rL rM
glyph_info glyph_maprectsr$ vertscodes
glyph_repr xposition ypositionrB verts1codes1s r
get_text_pathTextToPath.get_text_pathF s N U?+/+>+>t+G (J5>>$'D+/+D+D( ,E ,? (J5 ,0+C+CD+L (J52u7A 3J9 & 2NFF LL% 9*@@ A LL 8B $NFF LL LL $ HHV$E|r c Uc
[ 5 nU( a [ 5 nOUn/ n/ n / n
[ R " X!XVS9 H n U R U R U R
5 n U
R
U 5 UR
U R 5 U R
U R 5 X; d Mw U R R 5 X|' M S/[ U5 - n
/ n[ [ XX5 5 X~4$ )zG
Convert string *s* to vertices and codes using the provided ttf font.
rK g ?)
r r layoutr3 ft_object glyph_indexappendr- yget_pathlenlistzip)r r$ r? rW return_new_glyphs_onlyrL rM
glyph_map_new
xpositions
ypositions glyph_reprsitemr[ sizesrX s r rQ TextToPath.get_glyphs_with_font s #
I ! 'MM %M
!((8WD --dnnd>N>NOJ z * dff % dff %*,0NN,C,C,E
)
X s:&S*DE & &r c 4 UR 5 nUR U R 5 U R R X R
U5 u pVpxn U( d
[
5 nU( a [
5 n
OUn
/ n / n / n
/ nU H u nnnnnnU R UU5 nUU; ag UR 5 UR U R U R
5 UR U[ R S9 UR 5 U
U' U R U5 U R U5 U
R U5 UU R - nUR U5 M / nU H u nnnnUU4UUU- 4UU- UU- 4UU- U4UU4S/n[ R [ R [ R [ R [ R [ R" /nUR UU45 M [% [' XX5 5 U
U4$ )zG
Parse mathtext string *s* and convert it to a (vertices, codes) pair.
r7 r r )r; r r r r/ r! r r3 clear
load_glyphr r( rh rf r MOVETOLINETO CLOSEPOLYrj rk ) r r" r? rW rl rC rD rE glyphsrX rm rn ro rp rr r$ rA ccodere oxoyr[ sizemyrectsrG rH vert1code1s r rR TextToPath.get_glyphs_mathtext s yy{
doo&040D0D0J0J
xx1 -w #
I ! 'MM %M
:@ 6D(E;B --dK@J*
dootxx8 93G3GH,0MMO
j) b ! b ! z *doo-D LL ;A !LBAq"XBF|b1fb1f-=1fb\B8V5E[[[[$++t{{DKK^^%E
NNE5> *
" S*DE w( (r c R [ 5 R X R 5 n[ R " XPR
5 nUu nSSS5 Uc
[
5 nU( a [
5 nOUn/ / / / 4u ppWR GHL n
[ U
R R 5 5 nU
R R ( a [ S5 eU R XR 5 nX; ap UR 5 UR! U R U R
5 UR# U
R [$ R& S9 UR) 5 X' U R+ U5 U
R+ U
R, 5 U R+ U
R. 5 U R+ U
R0 U R - 5 GMO / nUR2 H u nnnnUU4UU- U4UU- UU- 4UUU- 4UU4S/n[4 R6 [4 R8 [4 R8 [4 R8 [4 R8 [4 R: /nUR+ UU45 M [= [? XX5 5 UU4$ ! , ( d f GNU= f)z?Convert the string *s* to vertices and codes using usetex mode.Nz'Indexing TTC fonts is not supported yetr7 ru ) r make_dvir r Dvir! r textr r$ resolve_pathsubfontNotImplementedErrorr3 indexrv r rw r TARGET_LIGHTrh rf r- rg font_sizeboxesr rx ry rz rj rk )r r" r? rW rl dvifiledvipagerm rp rn ro rr r r$ r[ r r} r~ rH rG r r s r rP TextToPath.get_glyphs_tex s
,''??;
[[((
+sED , #
I ! 'MM %M57R^2 IIDDII 2 2 45Dyy )*STT --dJJ?J*
dootxx8
)2H2HI,0MMO
) z * dff % dff % LL $//9 : JJLBAq"XQ|b1fb1f-="q&\B8V5E[[[[$++t{{DKK^^%E
NNE5> *
' S*DE w( (S ,
+s J
J&)r r )F)NF)__name__
__module__ __qualname____firstlineno____doc__r r! r r% r) r3 r: r` rQ rR rP __static_attributes__ r r r r sl 1J
C $G/0> td > @ 7;49 &GK&* &B 6:381(f 15.30(r r c f ^ \ rS rSrSr S
U 4S jjrS rS r\S 5 r \S 5 r
S r S r U =r
$ ) TextPathi z
Create a path from the text.
c " > SSK Jn [ R " U5 nUc UR 5 nXl U R
U5 SU l U" US9R U5 u p([ T U ]( " [ R XBUS9USS.6 SU l
g) a
Create a path from the text. Note that it simply is a path,
not an artist. You need to use the `.PathPatch` (or other artists)
to draw this path onto the canvas.
Parameters
----------
xy : tuple or array of two float values
Position of the text. For no offset, use ``xy=(0, 0)``.
s : str
The text to convert to a path.
size : float, optional
Font size in points. Defaults to the size specified via the font
properties *prop*.
prop : `~matplotlib.font_manager.FontProperties`, optional
Font property. If not provided, will use a default
`.FontProperties` with parameters from the
:ref:`rcParams`.
_interpolation_steps : int, optional
(Currently ignored)
usetex : bool, default: False
Whether to use tex rendering.
Examples
--------
The following creates a path from the string "ABC" with Helvetica
font face; and another path from the latex fraction 1/2::
from matplotlib.text import TextPath
from matplotlib.font_manager import FontProperties
fp = FontProperties(family="Helvetica", style="italic")
path1 = TextPath((12, 12), "ABC", size=12, prop=fp)
path2 = TextPath((0, 0), r"$\frac{1}{2}$", size=12, usetex=True)
Also see :doc:`/gallery/text_labels_and_annotations/demo_text_path`.
r )TextN)usetex)r@ T)_interpolation_stepsreadonlyF)matplotlib.textr r _from_anyr9 _xyr _cached_vertices_preprocess_mathsuperr text_to_pathr` _should_simplify)
r xyr? r r" r r r r@ __class__s
r r TextPath.__init__ s Z ) ''- <**,D
d $ '88;
'
'
'
?!5 !& r c Xl SU l g)zSet the text size.TN)_size_invalid)r r s r r TextPath.set_sizeS s
r c U R $ )zGet the text size.)r r s r get_sizeTextPath.get_sizeX s zzr c : U R 5 U R $ )z8
Return the cached path after updating it if necessary.
)_revalidate_pathr r s r verticesTextPath.vertices\ s
$$$r c U R $ )z
Return the codes
)_codesr s r rZ TextPath.codesd s
{{r c \ U R ( d
U R c [ 5 R U R [
R - 5 R " U R 6 nUR U R 5 U l SU R R l SU l gg)z
Update the path if necessary.
The path for the text is initially create with the font size of
`.FONT_SCALE`, and this path is rescaled to other size when necessary.
NF)
r r r
rB r r r translater transform _verticesr8 writeable)r trs r r TextPath._revalidate_pathk s ==D 1 1 9*5l&=&==> 9 "hh(B %'LL $@D !49D ! ! ' ' 1 !DM
:r )r r r r r )NN F)r r r r r r r r propertyr rZ r r
__classcell__)r s @r r r sR /305<&|
% %
"
"r r ) collectionsr logging urllib.parser. numpyrT
matplotlibr r matplotlib.font_managerr r r r matplotlib.ft2fontr matplotlib.mathtextr
matplotlib.pathr matplotlib.texmanagerr matplotlib.transformsr
getLoggerr _logr r r r r r r sc # - ) . , *"v( v(r | h"t h"r