U Ev f4@sddlmZddlZddlZddlZddlmZm Z m Z ddl m Z m Z mZddlmZmZddlmZddlmZddlmZdd lmZeeZGd d d ZeZGd d d eZ dS)) OrderedDictN)_api _text_helpersdviread)FontPropertiesget_font fontManager)LOAD_NO_HINTINGLOAD_TARGET_LIGHT)MathTextParser)Path) TexManager)Affine2Dc@seZdZdZdZdZddZddZdd Zd d Z d d Z dddZ d ddZ d!ddZ ejdddddZd"ddZeddZdS)# TextToPathz'A class that converts strings to paths.gY@HcCstd|_d|_dS)Npath)r mathtext_parser _texmanagerselfr7/tmp/pip-unpacked-wheel-7vhvci0g/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. ) _fontManagerZ_find_fonts_by_propsrset_size FONT_SCALEDPI)rprop filenamesfontrrr _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|}|dkrt||S||j}|rn|}||j|j|d|^}}}} ||||||fS||} | j |dt d| \} } | d} | d} | } | d} | || || |fS)NTeXrgflagsgP@) get_size_in_pointsr get_text_width_height_descentrcopyrrr%r Zset_textr Zget_width_heightZ get_descent)rsrismathfontsizescalewidthheightdescent_rwhdrrrr-0s$     z(TextToPath.get_text_width_height_descentFcCs|dkr|||\}}}n4|s>||}|||\}}}n|||\}}}gg}} |D]8\} } } } || \}}||| | | g| |q^|D]\}}||| |q|std}|| 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.text 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))r)get_glyphs_texr get_glyphs_with_fontget_glyphs_mathtextextendnpempty)rrr/r0Z glyph_info glyph_maprectsrZvertscodesZglyph_idZ xpositionZ ypositionr2Zverts1Zcodes1rrr get_text_pathHs"(        zTextToPath.get_text_pathNc Cs|dkrt}|rt}n|}g}g}t||D]D}||jt|j} || ||j| |kr2|j || <q2dgt |} dgt |} g} t t ||| | || fS)zW Convert string *s* to vertices and codes using the provided ttf font. Nrg?) rrZlayoutr(Z ft_objectordcharappendr#get_pathlenlistzip) rrr/rAreturn_new_glyphs_only glyph_map_new xpositions glyph_idsitemchar_id ypositionssizesrBrrrr<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 rHrGr MOVETOLINETO CLOSEPOLYrJrK)rrr/rArLr3r4r5ZglyphsrBrMrNrRrOrSrr1r'oxoyrQsizemyrectsr7r8vert1code1rrrr=s^         zTextToPath.get_glyphs_mathtextz3.6z TexManager()) alternativecCs|jdkrt|_|jS)z5Return the cached `~.texmanager.TexManager` instance.N)rr rrrrget_texmanagers zTextToPath.get_texmanagerc Cst||j}t||j }|\}W5QRX|dkr>t}|rJt}n|}ggggf\} } } } |jD]} t| j }| || j }||kr| | |j|j| j}t|tr||}|j|tdn2t|tr|||j|tdntd||||<| || | j| | j| | j|jqhg}|jD]l\}}}}||f|||f||||f|||f||fdg}tjtj tj tj tj tj!g}|||fqNt"t#| | | | ||fS)z?Convert the string *s* to vertices and codes using usetex mode.Nr*zGlyph spec of unexpected type: rT)$r Zmake_dvirrZDvirrtextrZ font_pathr(ZglyphrUrglyph_name_or_index isinstancestrZget_name_indexZ load_glyphr int_select_native_charmaprV TypeErrorrHrGr#yZ font_sizeZboxesr rWrXrYrJrK)rrr/rArLZdvifileZdvipagerMrOrNrRrSrbrrQrcindexr]rZr[r8r7r^r_rrrr;sd            zTextToPath.get_glyphs_texc CsHdD]0}z||Wnttfk r.YqXqDqtd|jdS)N)iCBDAiBODAz#No supported encoding in font (%s).)Zselect_charmap ValueError RuntimeError_logwarningfname)rZ charmap_coderrrrgsz!TextToPath._select_native_charmap)F)NF)NF)NF)__name__ __module__ __qualname____doc__rrrr r!r(r-rDr<r=r deprecatedrar; staticmethodrgrrrrrs,  @  3   :rcsReZdZdZdfdd ZddZd d Zed d Zed dZ ddZ Z S)TextPathz& Create a path from the text. NFc szddlm}t|}|dkr&|}||_||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.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)r0T)_interpolation_stepsreadonlyF)Zmatplotlib.textryrZ _from_anyr,_xyr_cached_verticesZ_preprocess_mathsuperr text_to_pathrDZ_should_simplify) rZxyr/r\rr{rzryr0 __class__rrr5s-   zTextPath.__init__cCs||_d|_dS)zSet the text size.TN)_size_invalid)rr\rrrrsszTextPath.set_sizecCs|jS)zGet the text size.)rrrrrget_sizexszTextPath.get_sizecCs||jS)zH Return the cached path after updating it if necessary. )_revalidate_pathr~rrrrvertices|szTextPath.verticescCs|jS)z" Return the codes )_codesrrrrrCszTextPath.codescCsN|js|jdkrJt|jtjj|j}| |j |_d|jj _ 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) rr~rr2rrr translater}Z transformZ _verticesr+Z writeable)rtrrrrrs  zTextPath._revalidate_path)NNrxF) rqrrrsrtrrrpropertyrrCr __classcell__rrrrrw0s>  rw)! collectionsrlogging urllib.parser$Znumpyr?Z matplotlibrrrZmatplotlib.font_managerrrrrZmatplotlib.ft2fontr r Zmatplotlib.mathtextr Zmatplotlib.pathr Zmatplotlib.texmanagerr Zmatplotlib.transformsr getLoggerrqrnrrrwrrrrs