o :aM9@sddlmZddlZddlZddlZddlZddlm Z m Z m Z ddl m Z mZddlmZmZddlmZddlmZddlmZeeZGd d d ZeZGd d d eZdS) ) OrderedDictN) _text_helpersdviread font_manager)FontPropertiesget_font)LOAD_NO_HINTINGLOAD_TARGET_LIGHT)MathTextParser)Path)Affine2Dc@seZdZdZdZdZddZddZdd Zd d Z d d Z dddZ  dddZ  dddZ ddZ  dddZeedddZdS) TextToPathz'A class that converts strings to paths.gY@HcCstd|_d|_dS)Npath)r mathtext_parser _texmanagerselfr5/usr/lib/python3/dist-packages/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)rrrrr_get_hinting_flag%szTextToPath._get_hinting_flagcCstj|jd|dS)zO Return a unique id for the given font and character-code set. -x)urllibparseZquoteZpostscript_name)rrccoderrr _get_char_id(szTextToPath._get_char_idcCs|dkr|}|}|j||dd\}}}|||fS|}||j} |rH|}||j|j|d|^} } } } | | | | | | fS||}|j |dt d| \}}|d}|d}| }|d}|| || || fS)NTeX)ZrendererrgflagsgP@) get_texmanagerget_size_in_pointsget_text_width_height_descentrcopyrrr"rZset_textrZget_width_heightZ get_descent)rsrismathZ texmanagerfontsizewhdscalewidthheightdescent_rrrrr*.s.      z(TextToPath.get_text_width_height_descentFcCs|dkr|||\}}}n|s||}|||\}}}n |||\}}}gg}} |D]%\} } } } || \}}t|rTt|| | | g}||| |q/|D]\}}||| |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_mathtextlennpZarrayextend)rrr,r-Z glyph_info glyph_maprectsrZvertscodesZglyph_idZ xpositionZ ypositionr2Zverts1Zcodes1rrr get_text_pathIs$(        zTextToPath.get_text_pathNc Cs|durt}|r t}n|}g}g}t||D] }||t|j} || ||j| |vr9||| <qdgt |} 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 ypositionssizesr>rrrr8s(   zTextToPath.get_glyphs_with_fontcCsr|}||j|j||j|\}}}}} |st}|r#t} n|} g} g} g} g}|D]C\}}}}}|||}||vrY|||j|j|j |t d| | |<| || || |||j}| |q/g}| D]5\}}}}||f|||f||||f|||f||fdg}t jt jt jt jt jt jg}| ||fqwtt| | | || |fS)zW Parse mathtext string *s* and convert it to a (vertices, codes) pair. r&rr)r+rrrr"rrr$clear load_charrrDrCr MOVETOLINETO CLOSEPOLYrErF)rrr,r=rGr3r4r5Zglyphsr>rHrIrMrJrNrr.r#oxoyrLsizemyrectsr/r0vert1code1rrrr9sN        zTextToPath.get_glyphs_mathtextcCs$|jdurddlm}||_|jS)z5Return the cached `~.texmanager.TexManager` instance.Nr) TexManager)rZmatplotlib.texmanagerr[)rr[rrrr(s  zTextToPath.get_texmanagercCs|||j}t||j }|\}Wdn1swY|dur*t}|r0t}n|}ggggf\} } } } |jD]]\} }}}}||j \}}| ||}||vr| | |j|j|durw| ||}|j|tdn|j|td|||<| || | | || |j|jq?g}|jD]5\}}}}||f|||f||||f|||f||fdg}tjtjtjtjtjtjg}|||fqtt| | | | ||fS)z?Convert the string *s* to vertices and codes using usetex mode.Nr&rO)r(Zmake_dvirrZDvirrtext_get_ps_font_and_encodingtexnamer$rPrZget_name_indexZ load_glyphr rQrDrCrWZboxesr rRrSrTrErF)rrr,r=rGZdvifileZdviZpagerHrJrIrMrNZx1Zy1ZdvifontZglyphr3rencrLindexrXrUrVr0r/rYrZrrrr7sL     zTextToPath.get_glyphs_tex2c Csttd}||}|jdurtd|jd|dt|j}|jr/t|j}||fSdD]}z| |Wn tt fyEYq1wnt 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_logZwarning)r^Z tex_font_mapZpsfontrr_Z charmap_coderrrr]s,   z$TextToPath._get_ps_font_and_encoding)F)NF)__name__ __module__ __qualname____doc__rrrrrr$r*r@r8r9r(r7 staticmethod functools lru_cacher]rrrrr s.  ?  3 6r csVeZdZdZ  dfdd ZddZd d Zed d Zed dZ ddZ Z S)TextPathz& Create a path from the text. NFc szddlm}t|}|dur|}||_||d|_||d|\}}t j t j |||d|ddd|_ 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-T)_interpolation_stepsreadonlyF)Zmatplotlib.textrprZ _from_anyr)_xyr_cached_verticesZ_preprocess_mathsuperr text_to_pathr@Z_should_simplify) rZxyr,rWrrrrqrpr- __class__rrrLs -   zTextPath.__init__cCs||_d|_dS)zSet the text size.TN)_size_invalid)rrWrrrrs zTextPath.set_sizecC|jS)zGet the text size.)rzrrrrget_sizeszTextPath.get_sizecCs||jS)zH Return the cached path after updating it if necessary. )_revalidate_pathrurrrrverticesszTextPath.verticescCr|)z" Return the codes )Z_codesrrrrr?szTextPath.codescCsR|js|jdur't|jtjj|j}| |j |_d|jj _ d|_dSdS)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{rur r2rzrwr translatertZ transformZ _verticesr'Z writeable)rtrrrrr~s  zTextPath._revalidate_path)NNroF) rgrhrirjrrr}propertyrr?r~ __classcell__rrrxrrnGs>  rn) collectionsrrlZloggingZ urllib.parser!Znumpyr;Z matplotlibrrrZmatplotlib.font_managerrrZmatplotlib.ft2fontrr Zmatplotlib.mathtextr Zmatplotlib.pathr Zmatplotlib.transformsr Z getLoggerrgrfr rwrnrrrrs"     4