U \ aF9@sddlmZddlZddlZddlZddlZddlm Z m Z m Z m Z ddl mZmZddlmZmZddlmZddlmZddlmZeeZGd 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 dddZ dddZ dddZ ddZd ddZeedddZdS)! TextToPathz'A class that converts strings to paths.gY@HcCstd|_d|_dS)Npath)r mathtext_parser _texmanagerselfr7/tmp/pip-unpacked-wheel-wjyw_3jo/matplotlib/textpath.py__init__s zTextToPath.__init__cCs&t|}t|}||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_flagcCstj|jd|dS)zO Return a unique id for the given font and character-code set. -x)urllibparsequoteZpostscript_name)rrccoderrr _get_char_id(szTextToPath._get_char_idcCs|dkr8|}|}|j||dd\}}}|||fS|}||j} |r|}||j|j|d|^} } } } | | | | | | fS||}|j |dt d| \}}|d}|d}| }|d}|| || || fS)NTeX)ZrendererrgflagsgP@) get_texmanagerget_size_in_pointsget_text_width_height_descentrcopyrrr#rZset_textr Zget_width_heightZ get_descent)rsrismathZ texmanagerfontsizewhdscalewidthheightdescent_rrrrr,.s.       z(TextToPath.get_text_width_height_descentFcCs|dkr|||\}}}n4|s>||}|||\}}}n|||\}}}gg}} |D]J\} } } } || \}}t|r^t|| | | g}||| |q^|D]\}}||| |q|| 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_pathIs"(        zTextToPath.get_text_pathNc Cs|dkrt}|rt}n|}g}g}t||D]@}||t|j} || ||j| |kr2||| <q2dgt |} dgt |} g} t t ||| | || fS)zW Convert string *s* to vertices and codes using the provided ttf font. Nrg?) rrZlayoutr&ordcharappendr!get_pathr<listzip) rrr.r@return_new_glyphs_only glyph_map_new xpositions glyph_idsitemchar_id ypositionssizesrArrrr:s(  zTextToPath.get_glyphs_with_fontcCsr|}||j|j||j|\}}}}} |s:t}|rFt} n|} g} g} g} g}|D]\}}}}}|||}||kr|||j|j|j |t d| | |<| || || |||j}| |q^g}| D]j\}}}}||f|||f||||f|||f||fdg}t jt jt jt jt jt jg}| ||fqtt| | | || |fS)zW Parse mathtext string *s* and convert it to a (vertices, codes) pair. r(rr)r-rrrr#rrr&clear load_charr rGrFr MOVETOLINETO CLOSEPOLYrHrI)rrr.r@rJr5r6r7ZglyphsrArKrLrPrMrQrr0r%oxoyrOsizemyrectsr1r2vert1code1rrrr;s^         zTextToPath.get_glyphs_mathtextcCs$|jdkrddlm}||_|jS)z5Return the cached `~.texmanager.TexManager` instance.Nr) TexManager)rZmatplotlib.texmanagerr^)rr^rrrr*s  zTextToPath.get_texmanagerc Cs|||j}t||j }|\}W5QRX|dkr@t}|rLt}n|}ggggf\} } } } |jD]\} }}}}||j \}}| ||}||kr| | |j|j|dk r| ||}|j|tdn|j|td|||<| || | | || |j|jqjg}|jD]l\}}}}||f|||f||||f|||f||fdg}tjtjtjtjtjtjg}|||fq0tt| | | | ||fS)z?Convert the string *s* to vertices and codes using usetex mode.Nr(rR)r*Zmake_dvirrZDvirrtext_get_ps_font_and_encodingtexnamer&rSrZget_name_indexZ load_glyphr rTrGrFrZZboxesr rUrVrWrHrI)rrr.r@rJZdvifileZdvipagerKrMrLrPrQx1y1ZdvifontZglyphr5rencrOindexr[rXrYr2r1r\r]rrrr9sV      zTextToPath.get_glyphs_tex2c Csttd}||}|jdkr:td|jd|dt|j}|jrXt|j}nHdD]0}z| |Wntt fk rYq\Xqq\t d|jd}||fS)Nz pdftex.mapzNo usable font file found for z (z&). The font may lack a Type-1 version.)iCBDAiBODAz#No supported encoding in font (%s).) rZ PsfontsMapZ find_tex_filefilename ValueErrorZpsnamerencodingZ _parse_encZselect_charmap RuntimeError_logwarning)raZ tex_font_mapZpsfontrreZ charmap_coderrrr`s(  z$TextToPath._get_ps_font_and_encoding)F)NF)NF)NF)__name__ __module__ __qualname____doc__rrrrrr&r,rCr:r;r*r9 staticmethod functools lru_cacher`rrrrrs,  ?  3 6rc@sJeZdZdZdddZddZd d Zed d Zed dZ ddZ dS)TextPathz& Create a path from the text. NFc Csddlm}t|}|dkr&|}||_||d|_||d|\}}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_pathrC _vertices_codesZ_should_simplifyrZ_simplify_threshold_interpolation_steps) rZxyr.rZrr~rxrwr/rrrrLs -    zTextPath.__init__cCs||_d|_dS)zSet the text size.TN)_size_invalid)rrZrrrrszTextPath.set_sizecCs|jS)zGet the text size.)rrrrrget_sizeszTextPath.get_sizecCs||jS)zH Return the cached path after updating it if necessary. )_revalidate_pathrzrrrrverticesszTextPath.verticescCs|jS)z" Return the codes )r}rrrrrBszTextPath.codescCsD|js|jdkr@t|jtjj|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) rnrorprqrrrpropertyrrBrrrrrruGs >  ru) collectionsrrslogging urllib.parser"Znumpyr=Z matplotlibrrrrZmatplotlib.font_managerrrZmatplotlib.ft2fontr r Zmatplotlib.mathtextr Zmatplotlib.pathr Zmatplotlib.transformsr getLoggerrnrlrr{rurrrrs     4