o Gf3@sddlmZddlZddlZddlZddlmZm Z ddl m Z m Z m ZddlmZmZddlmZddlmZddlmZdd lmZeeZGd d d ZeZGd d d eZdS)) OrderedDictN) _text_helpersdviread)FontPropertiesget_font fontManager)LOAD_NO_HINTINGLOAD_TARGET_LIGHT)MathTextParser)Path) TexManager)Affine2Dc@seZdZdZdZdZddZddZdd Zd d Z d d Z dddZ  dddZ  dddZ  dddZeddZdS) TextToPathz'A class that converts strings to paths.gY@HcCstd|_d|_dS)Npath)r mathtext_parserZ _texmanagerselfr3lib/python3.10/site-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. ) _fontManagerZ_find_fonts_by_propsrset_size FONT_SCALEDPI)rprop filenamesfontrrr _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|}|dkrt||S||j}|r7|}||j|j|d|^}}}} ||||||fS||} | j |dt d| \} } | d} | d} | } | d} | || || |fS)NTeXrgflagsgP@) get_size_in_pointsr get_text_width_height_descentrcopyrrr#rZset_textrZget_width_heightZ get_descent)rsrismathfontsizescalewidthheightdescent_rwhdrrrr*0s$     z(TextToPath.get_text_width_height_descentFcCs|dkr|||\}}}n|s||}|||\}}}n |||\}}}gg}} |D]\} } } } || \}}||| | | g| |q/|D]\}}||| |qN|sdtd}|| 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 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. r&)r)get_glyphs_texrget_glyphs_with_fontget_glyphs_mathtextextendnpempty)rrr,r-Z glyph_info glyph_maprectsrZvertscodesZglyph_idZ xpositionZ ypositionr/Zverts1Zcodes1rrr get_text_pathHs"$        zTextToPath.get_text_pathNc Cs|durt}|r t}n|}g}g}t||D]"}||jt|j} || ||j| |vr;|j || <qdgt |} 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,r>return_new_glyphs_only glyph_map_new xpositions glyph_idsitemchar_id ypositionssizesr?rrrr9s(  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_charrrErDr MOVETOLINETO CLOSEPOLYrGrH)rrr,r>rIr0r1r2Zglyphsr?rJrKrOrLrPrr.r$oxoyrNsizemyrectsr4r5vert1code1rrrr:sN        zTextToPath.get_glyphs_mathtextcCst||j}t||j }|\}Wdn1swY|dur)t}|r/t}n|}ggggf\} } } } |jD]l} t| j }| || j }||vr| | |j|j| j}t|trq||}|j|tdnt|tr|||j|tdntd||||<| || | j| | j| | j|jq>g}|jD]5\}}}}||f|||f||||f|||f||fdg}tjtj tj tj tj tj!g}|||fqt"t#| | | | ||fS)z?Convert the string *s* to vertices and codes using usetex mode.Nr'zGlyph spec of unexpected type: rQ)$r Zmake_dvirrZDvirrtextrZ font_pathr%ZglyphrRrglyph_name_or_index isinstancestrZget_name_indexZ load_glyphr int_select_native_charmaprS TypeErrorrErDr!yZ font_sizeZboxesr rTrUrVrGrH)rrr,r>rIZdvifileZdviZpagerJrLrKrOrPr]rrNr^indexrZrWrXr5r4r[r\rrrr8s\          zTextToPath.get_glyphs_texc CsDdD]}z ||WdSttfyYqwtd|jdS)N)iCBDAiBODAz#No supported encoding in font (%s).)Zselect_charmap ValueError RuntimeError_logZwarningfname)rZ charmap_coderrrrbs z!TextToPath._select_native_charmap)F)NF)__name__ __module__ __qualname____doc__rrrrrr%r*rAr9r:r8 staticmethodrbrrrrrs*  <  3 :rcsVeZdZdZ  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.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)Zmatplotlib.textrqrZ _from_anyr)_xyr_cached_verticesZ_preprocess_mathsuperr text_to_pathrAZ_should_simplify) rZxyr,rYrrsrrrqr- __class__rrr*s -   zTextPath.__init__cCs||_d|_dS)zSet the text size.TN)_size_invalid)rrYrrrrhs zTextPath.set_sizecC|jS)zGet the text size.)r{rrrrget_sizemszTextPath.get_sizecCs||jS)zH Return the cached path after updating it if necessary. )_revalidate_pathrvrrrrverticesqszTextPath.verticescCr})z" Return the codes )Z_codesrrrrr@yszTextPath.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|rvr r/r{rxr translateruZ transformZ _verticesr(Z writeable)rtrrrrrs  zTextPath._revalidate_path)NNrpF) rjrkrlrmrrr~propertyrr@r __classcell__rrryrro%s>  ro) collectionsrZloggingZ urllib.parser"Znumpyr<Z matplotlibrrZmatplotlib.font_managerrrrrZmatplotlib.ft2fontrr Zmatplotlib.mathtextr Zmatplotlib.pathr Zmatplotlib.texmanagerr Zmatplotlib.transformsr Z getLoggerrjrhrrxrorrrrs"