^j1 d dl mZ d dlZd dlZd dlZd dlmZm Z d dl
m Z m Z m
Z d dlmZ d dlmZ d dlmZ d dlmZ d d lmZ ej2 e Z G d
d Z e Z G d d
e Z y) ) OrderedDictN)
_text_helpersdviread)FontPropertiesget_font fontManager) LoadFlags)MathTextParser)Path)
TexManager)Affine2Dc r e Zd ZdZdZdZd Zd Zd Zd Z d Z
dd d d
d Z dd d d
d Z dd
Z
ddZy )
TextToPathz'A class that converts strings to paths.g Y@H c 2 t d | _ d | _ y )Npath)r
mathtext_parser _texmanagerselfs L/opt/ringagent/.cad-venv/lib/python3.12/site-packages/matplotlib/textpath.py__init__zTextToPath.__init__ s -f 5 c t j | }t | }|j | j | j
|S )zX
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_fontzTextToPath._get_font s9 !55d; "
dootxx0 r c " t j S )N)r
NO_HINTINGr s r _get_hinting_flagz TextToPath._get_hinting_flag' s ###r c ` t j j |j d|d S )z6Return a unique id for the given font and glyph index.-x)urllibparsequotepostscript_name)r r" glyphs r _get_glyph_reprzTextToPath._get_glyph_repr* s+ ||!!T%9%9$:!E!9"EFFr c |j }|dk( rt j || S || j z }|rZ|j }|j | j | j j |d| ^}}}} ||z ||z ||z fS | j | }
|
j |dt j |
j \ } } | dz } | dz } |
j }
|
dz }
| |z | |z |
|z fS )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 r5 z(TextToPath.get_text_width_height_descent. s **, U? <==aJ J4??* 99;D MM$// *$$**1b$7
'E67Q5=&5.'E/A A~~d#
aI$8$8
9$$&1 T T T 5y!e)QY..r Nfeatureslanguagec |dk( r| j || \ }}}nC|s+| j | } | j | ||| \ }}}n| j || \ }}}g g } }
|D ]9 \ } }
}}|| \ }}|
j ||z |
|gz | j | ; |D ]' \ }}|
j | | j | ) |
st j d }
|
| fS )a`
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.
r1 rE )r )get_glyphs_texr# get_glyphs_with_fontget_glyphs_mathtextextendnpempty)r r r: r; rF rG
glyph_info glyph_maprectsr" vertscodes
glyph_repr xposition ypositionr= verts1codes1s r
get_text_pathzTextToPath.get_text_pathF s N U?+/+>+>tQ+G (J 5>>$'D+/+D+Da(X ,E ,? (J 5 ,0+C+CD!+L (J 52u7A ! 3J 9e &z 2NFF LL% 9i*@@ A LL ! $ !NFF LL LL ! HHV$Ee|r c |
t }|r t }n|}g }g } g }
t j |||| D ] } | j | j | j
} |
j
| |j
| j | j
| j | |vsu| j j || < dgt | z }
g }t t |
|| |
||fS )zW
Convert string *s* to vertices and codes using the provided ttf font.
rE g ?)
r r layoutr/ ft_object glyph_indexappendr) yget_pathlenlistzip)r r" r: rQ return_new_glyphs_onlyrF rG
glyph_map_new
xpositions
ypositions glyph_reprsitemrU sizesrR s r rK z TextToPath.get_glyphs_with_font s #
I ! 'MM %M
!((D8hW FD --dnnd>N>NOJ z * dff % dff %*,0NN,C,C,E
j)
F s:&Sj*eDE u& &r c $ |j }|j | j | j j || j
| \ }}}}} |s
t
}|r t
}
n|}
g } g } g }
g }|D ] \ }}}}}}| j || }||vrj|j |j | j | j
|j |t j |j |
|< | j | | j | |
j | || j z }|j | g }| D ] \ }}}}||f|||z f||z ||z f||z |f||fdg}t j t j t j t j t j t j" g}|j ||f t% t' |
| | | |
|fS )zW
Parse mathtext string *s* and convert it to a (vertices, codes) pair.
r2 r r )r6 r r r r+ r r r/ clear
load_glyphr r% ra r_ r MOVETOLINETO CLOSEPOLYrc rd ) r r r: rQ re r> r? r@ glyphsrR rf rg rh ri rk r" r< ccoder^ oxoyrU sizemyrectsrB rC vert1code1s r rL z TextToPath.get_glyphs_mathtext s yy{
doo&040D0D0J0J
txx1 -vw #
I ! 'MM %M
:@ 6D(E;B --dK@J*
dootxx8 93G3GH,0MMO
j) b ! b ! z *doo-D LL ! +LBAq"XBF|b1fb1f-=1fb\B8V5E[[[[$++t{{DKK^^%E
NNE5> *
+ Sj*eDE w( (r c < t j || j }t j || j
5 }|\ }ddd |
t
}|r t
}n|}g g g g f\ } }
} } j D ]J }
t |
j j }|
j j r t d | j ||
j }||vrt|j |j! | j | j
|j# |
j t$ j& |j) ||< | j+ | |
j+ |
j, | j+ |
j. | j+ |
j0 | j z M g }|j2 D ] \ }}}}||f||z |f||z ||z f|||z f||fdg}t4 j6 t4 j8 t4 j8 t4 j8 t4 j8 t4 j: g}|j+ ||f t= t? | |
| | ||fS # 1 sw Y IxY w)z?Convert the string *s* to vertices and codes using usetex mode.Nz'Indexing TTC fonts is not supported yetr2 rm ) r make_dvir r Dvir r textr r" resolve_pathsubfontNotImplementedErrorr/ indexrn r ro r TARGET_LIGHTra r_ r) r` font_sizeboxesr rp rq rr rc rd )r r r: rQ re dvifiledvipagerf ri rg rh rk r~ r" rU rx ru rv rC rB ry rz s r rJ zTextToPath.get_glyphs_tex s8
,''4??;
[[$((
+ sED #
I ! 'MM %M57R^2 ZU II ;DDII 2 2 45Dyy )*STT --dDJJ?J*
dootxx8
)2H2HI,0MMO
j) z * dff % dff % LL $//9 : ; JJ +LBAq"XQ|b1fb1f-="q&\B8V5E[[[[$++t{{DKK^^%E
NNE5> *
+ Sj*eDE w( (S s JJ)F)NF)__name__
__module__ __qualname____doc__r r r r# r& r/ r5 rZ rK rL rJ r r r r sl 1J
C $G/0> td > @ 7;49 &GK&* &B 6:381(f 15.30(r r c Z e Zd ZdZ d fd Zd Zd Zed Zed Z d Z
xZ S ) TextPathz&
Create a path from the text.
c . ddl m} t j | }||j }|| _ | j
| d| _ || j | \ }}t | ( t j ||| |dd d| _
y) 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_anyr4 _xyr _cached_vertices_preprocess_mathsuperr text_to_pathrZ _should_simplify)
r xyr: rw r r r r r; __class__s
r r zTextPath.__init__ s Z ) ''- <**,D
d $ '88; 6
'
'a
'
?!5 !& r c || _ d| _ y)zSet the text size.TN)_size_invalid)r rw s r r zTextPath.set_sizeS s
r c | j S )zGet the text size.)r r s r get_sizezTextPath.get_sizeX s zzr c : | j | j S )zH
Return the cached path after updating it if necessary.
)_revalidate_pathr r s r verticeszTextPath.vertices\ s
$$$r c | j S )z"
Return the codes
)_codesr s r rT zTextPath.codesd s
{{r c P | j s | j t j | j t
j z j | j }|j | j | _ d| j j _ d| _ yy)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
r= r r r translater transform _verticesr3 writeable)r trs r r zTextPath._revalidate_pathk s ==D 1 1 9 (*5l&=&==> 9dhh(B %'LL $@D !49D ! ! ' ' 1 !DM
:r )NN F) r r r r r r r propertyr rT r
__classcell__)r s @r r r sM /305<&|
% %
"r r ) collectionsr logging urllib.parser* numpyrN
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 se # - ) . , *w"v( v(r | h"t h"r