j 3 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 ej e Z G d
d Z e Z G d d
e Z dS ) ) OrderedDictN)
_text_helpersdviread)FontPropertiesget_font fontManager) LoadFlags)MathTextParser)Path)
TexManager)Affine2Dc t e Zd ZdZdZdZd Zd Zd Zd Z d Z
dd
d
d d Z dd
d
d d
Z ddZ
ddZd
S )
TextToPathz'A class that converts strings to paths.g Y@H c < t d | _ d | _ d S )Npath)r
mathtext_parser _texmanagerselfs AC:\Projects\DSCons\.venv\Lib\site-packages\matplotlib\textpath.py__init__zTextToPath.__init__ s -f 5 5 c t j | }t | }| | 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 s> !5d;; ""
dotx000 r c t j S )N)r
NO_HINTINGr s r _get_hinting_flagz TextToPath._get_hinting_flag' s ##r c V t 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"E"EE"E"E"EFFFr c H | }|dk r"t || S || j z }|r\| }| | j | j |d| ^}}}} ||z ||z ||z fS | | }
|
|dt j |
\ } } | dz } | dz } |
}
|
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. s0 **,, U?? <<==aJJ J4?* B99;;D MM$/ * * *$**1b$77
'E67Q5=&5.'E/A A~~d##
aI$8
999$$&&1 T T T 5y!e)QY..r FNfeatureslanguagec |dk r| || \ }}}nO|s3| | } | | ||| \ }}}n| || \ }}}g g } }
|D ]D\ } }
}}|| \ }}|
||z |
|gz | | E|D ]/\ }}|
| | | 0|
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 sR N U??+/+>+>tQ+G+G (J 55 M>>$''D+/+D+Da(X ,E ,? ,? (J 55 ,0+C+CD!+L+L (J 52u7A ! ! 3J 9e &z 2NFF LL% 9i*@@ A A A LL # ! !NFF LL LL %HV$$Ee|r c
|t }|rt }n|}g }g } g }
t j |||| D ]} | | j | j } |
| | | j | | j | |vr | j || < dgt | z }
g }t t |
|| |
||fS )zW
Convert string *s* to vertices and codes using the provided ttf font.
NrE 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 ! & 'MMMM %M
!(D8hWWW F FD --dnd>NOOJ z * * * df % % % df % % %**,0N,C,C,E,E
j)s:&Sj*eDDEE u& &r c 0 | }| | j | j || j | \ }}}}} |st
}|rt
}
n|}
g } g } g }
g }|D ]\ }}}}}}| || }||vrl| | | j | j | |t j | |
|< |
| |
| |
| || j z }|
| g }| D ]\ }}}}||f|||z f||z ||z f||z |f||fdg}t j t j t j t j t j t j g}|
||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 s4 yy{{
do&&&040D0J0J
tx1 1 -vw &#
I ! & 'MMMM %M
:@ 6D(E;B --dK@@J**
dotx888 93GHHH,0MMOO
j) b ! ! ! b ! ! ! z * * *do-D LL ! + +LBAq"XBF|b1fb1f-=1fb\B8V5E[[$+t{DK^%E
NNE5> * * * *Sj*eDDEE w( (r c t || j }t j || j 5 }|\ }ddd n # 1 swxY w Y |t
}|rt
}n|}g g g g f\ } }
} } |j D ]?}
t |
j
}|
j j rt d |
||
j }||vrq| | | j | j | |
j t$ j | ||< | | |
|
j | |
j | |
j | j z Ag }|j D ]\ }}}}||f||z |f||z ||z f|||z f||fdg}t4 j t4 j t4 j t4 j t4 j t4 j g}| ||f t= t? | |
| | ||fS )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 s
,,''4?;;
[$(
+
+ sED #
I ! & 'MMMM %M57R^2 ZU I ; ;DDI 2 2 4 455Dy
U)*STTT --dDJ??J**
dotx888
)2HIII,0MMOO
j) z * * * df % % % df % % % LL $/9 : : : : J + +LBAq"XQ|b1fb1f-="q&\B8V5E[[$+t{DK^%E
NNE5> * * * *Sj*eDDEE w( (s AAA)F)NF)__name__
__module__ __qualname____doc__r r r r# r& r/ r5 rZ rK rL rJ r r r r s 11J
C $ $ $G G G/ / /0> td > > > > > @ 7;49 &GK&* & & & & &B 6:381( 1( 1( 1(f 15.30( 0( 0( 0( 0( 0(r r c f e Zd ZdZ d fd Zd Zd Zed Zed Z d
Z
xZ S ) TextPathz&
Create a path from the text.
N Fc j ddl m} t j | }|| }|| _ | | d| _ || | \ }} t j
t ||| |dd d| _
dS ) 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 $ D'''88;; 6
'
'a
'
?
?!5 !& r c " || _ d| _ dS )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
zr c 8 | | 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 | j s| j y t | j t
j z j | j }| | j
| _ d| j j _ d| _ dS dS )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 9 (**5l&==>> dh(B %'LL $@$@D !49D ! ' 1 !DMMM
: 9r )NNr F) r r r r r r r propertyr rT r
__classcell__)r s @r r r s /305<& <& <& <& <& <&|
% % X% X
"
"
"
"
"
"
"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 sl # # # # # # - - - - - - - - ) ( ( ( ( ( . . . . . . , , , , , , * * * * * *w""v( v( v( v( v( v( v( v(r z|| h" h" h" h" h"t h" h" h" h" h"r