3 ƽh:@sddlmZddlZddlZddlZddlZddlm Z m Z m Z m Z ddl mZmZddlmZmZddlmZddlmZddlmZejeZGd d d ZeZGd d d eZdS) ) OrderedDictN) _text_layoutdviread font_managerrcParams)FontPropertiesget_font)LOAD_NO_HINTINGLOAD_TARGET_LIGHT)MathTextParser)Path)Affine2Dc@seZdZdZdZdZddZddZdd Zd d Z d d Z ddZ dddZ d ddZ d!ddZddZd"ddZeejdddZdS)# TextToPathz'A class that converts strings to paths.gY@HcCstd|_d|_dS)Npath)r mathtext_parser _texmanager)selfr9/tmp/pip-build-7iwl8md4/matplotlib/matplotlib/textpath.py__init__s zTextToPath.__init__cCs&tj|}t|}|j|j|j|S)zX Find the `FT2Font` matching font properties *prop*, with its size set. )rZfindfontrset_size FONT_SCALEDPI)rpropfnamefontrrr _get_fonts zTextToPath._get_fontcCstS)N)r )rrrr_get_hinting_flag%szTextToPath._get_hinting_flagcCstjjdj|j|S)zO Return a unique id for the given font and character-code set. z{}-{})urllibparsequoteformatZpostscript_name)rrccoderrr _get_char_id(szTextToPath._get_char_idcCs$|jd}tjjd||f}|S)zY Return a unique id for the given font and character-code set (for tex). z%s-%d)Zget_ps_font_inforr r!)rrr#Zps_namechar_idrrr_get_char_id_ps.s zTextToPath._get_char_id_pscCs|dkr8|j}|j}|j||dd\}}}|||fS|j}||j} |r|j}|j|j|jj|d|\} } } } }| | | | | | fS|j|}|j |dt d|j \}}|d}|d}|j }|d}|| || || fS)NTeX)Zrendererrg)flagsgP@) get_texmanagerget_size_in_pointsget_text_width_height_descentrcopyrrr rZset_textr Zget_width_heightZ get_descent)rsrismathZ texmanagerfontsizewhdscalewidthheightdescentZtrashZused_charactersrrrrr,6s*     z(TextToPath.get_text_width_height_descentFcCs|dkr|j||\}}}n4|s>|j|}|j||\}}}n|j||\}}}gg}} xR|D]J\} } } } || \}}t|r`tj|| | | g}|j|| j|q`Wx$|D]\}}|j|| j|qW|| 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. Returns ------- verts : list A list of numpy arrays containing the x and 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.textpath import TextToPath from matplotlib.font_manager import FontProperties fp = FontProperties(family="Humor Sans", 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. r()get_glyphs_texrget_glyphs_with_fontget_glyphs_mathtextlennparrayextend)rrr.r/Z glyph_info glyph_maprectsrZvertscodesZglyph_idZ xpositionZ ypositionr4Zverts1Zcodes1rrr get_text_pathRs"(     zTextToPath.get_text_pathNcCs|dkrt}|rt}n|}g}g}xZt|tj||D]D\}\} } |j|t|} |j| |j| | |kr:|j|| <q:Wdgt|} dgt|} g}t t||| | ||fS)zW Convert string *s* to vertices and codes using the provided ttf font. Nrg?) rziprZlayoutr$ordappendget_pathr;list)rrr.r?return_new_glyphs_only glyph_map_new xpositions glyph_idschar_xr& ypositionssizesr@rrrr9s$   zTextToPath.get_glyphs_with_fontcCsz|j}|j|j|jj||j|\}}}}} |s:t}|rFt} n|} g} g} g} g}x|D]\}}}}}|j||}||kr|j|j|j|j|j |t d|j | |<| j || j || j |||j}|j |q`Wg}xr| D]j\}}}}||f|||f||||f|||f||fdg}t jt jt jt jt jt jg}|j ||fqWtt| | | || |fS)zW Parse mathtext string *s* and convert it to a (vertices, codes) pair. )r)r)rr)r-rrrr rrr$clear load_charr rFrEr MOVETOLINETO CLOSEPOLYrGrC)rrr.r?rHr5r6r7Zglyphsr@rIrJrOrKrPrr0r#oxoyr&sizemyrectsr1r2vert1code1rrrr:sF       zTextToPath.get_glyphs_mathtextcCs$|jdkrddlm}||_|jS)z5Return the cached `~.texmanager.TexManager` instance.Nr) TexManager)rZmatplotlib.texmanagerr\)rr\rrrr*s  zTextToPath.get_texmanagercCs|jj||j}tj||j }|\}WdQRX|dkr@t}|rLt}n|}ggggf\} } } } x|jD]\} }}}}|j|j \}}|j ||}||kr|j |j |j|j|dk r|j ||}|j|tdn|j|td|j||<| j|| j| | j|| j|j|jqlWg}xv|jD]l\}}}}||f|||f||||f|||f||fdg}tjtjtjtjtjtjg}|j||fq6Wtt| | | | ||fS)z?Convert the string *s* to vertices and codes using usetex mode.N)r)r)rr)r*Zmake_dvirrZDvirrtext_get_ps_font_and_encodingtexnamer'rQrZget_name_indexZ load_glyphr rRrFrErXZboxesr rSrTrUrGrC)rrr.r?rHZdvifileZdvipagerIrKrJrOrPx1y1ZdvifontZglyphr5rencr&indexrYrVrWr2r1rZr[rrrr8sD     zTextToPath.get_glyphs_tex2c Cstjtjd}||}|jdkr:td|jd|dt|j}|jrXtj|j}nJxDdD].}y|j |Wntt fk rYq^XPq^Wt j d|jd}||fS) Nz pdftex.mapzNo usable font file found for z (z&). The font may lack a Type-1 version.CBDABODAz#No supported encoding in font (%s).)rfrg) rZ PsfontsMapZ find_tex_filefilename ValueErrorZpsnamerencodingZ _parse_encZselect_charmap RuntimeError_logwarning)r_Z tex_font_mapZpsfontrrcZ charmap_coderrrr^ s(  z$TextToPath._get_ps_font_and_encoding)F)NF)NF)NF)__name__ __module__ __qualname____doc__rrrrrr$r'r,rBr9r:r*r8 staticmethod functools lru_cacher^rrrrrs&  ?  2 5rc@sJeZdZdZdddZddZd d Zed d Zed dZ ddZ dS)TextPathz& Create a path from the text. NFc Csddlm}tj|}|dkr&|j}||_|j|d|_||dj|\}}t j |||d\|_ |_ d|_ td|_||_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.textpath 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/Fzpath.simplify_threshold)Zmatplotlib.textrwrZ _from_anyr+_xyr_cached_verticesZ_preprocess_math text_to_pathrB _vertices_codesZ_should_simplifyrZ_simplify_threshold_interpolation_steps) rZxyr.rXrr~rxrwr/rrrrUs-    zTextPath.__init__cCs||_d|_dS)zSet the text size.TN)_size_invalid)rrXrrrrszTextPath.set_sizecCs|jS)zGet the text size.)r)rrrrget_sizeszTextPath.get_sizecCs|j|jS)zH Return the cached path after updating it if necessary. )_revalidate_pathrz)rrrrverticesszTextPath.verticescCs|jS)z" Return the codes )r})rrrrrAszTextPath.codescCsD|js|jdkr@tj|jtjj|j}|j |j |_d|_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) rrzr r4rr{r translateryZ transformr|)rtrrrrrs zTextPath._revalidate_path)NNrvF) rnrorprqrrrpropertyrrArrrrrruPs =  ru) collectionsrrslogging urllib.parsernumpyr<Z matplotlibrrrrZmatplotlib.font_managerrrZmatplotlib.ft2fontr r Zmatplotlib.mathtextr Zmatplotlib.pathr Zmatplotlib.transformsr getLoggerrnrlrr{rurrrrs     =