a Sic!@sdZddlmZddlZddlZddlmZddlmZddl Z ddl Z ddl m Z ddl Z ddlmZddlZddlZddlZddlZddlZddlmZmZmZmZdd lmZmZdd lmZe e Z!d d d dddddd dd Z"dddddddddddddd Z#dddddddddddddddZ$gdZ%hdZ&z e'Z(Wne)ydee j*Z(Yn0d Z+d!d"gZ,e-e(d#e-e(d$gZ.d%d&d'd(d)e-ee j/0d*pe(d+d,e-e(d-gZ1d.d/d0d1e-e(d2gZ2d3d4Z3d5d6Z4d7d8Z5d9d:Z6e7d;dd=d>Z8d?d@Z9edAdBZ:e7d;ddCdDZ;ddEdFZej?dKdLe-ej@dMdNfdOe-ej@dMdNfdPe-ej@dQdNfdRe-ej@dQdNfdSe-ej@dQdNfdTe-ej@dQdNfdUe-ej@dVdNfgdWdXdYdZdYd[d\ZAd]d^ZBd_d`ZCGdadbdbZDGdcdddde jEZFdedfZGdgdhZHdidjZIGdkdldlZJedmdnZKedodpdqZLeMe drrne jNeLjOdsedodtduZPeQdvdwdxddydzZRd{d|d}d~ZSeSZTeTjUZUeTjVZVdS)a A module for finding, managing, and using fonts across platforms. This module provides a single `FontManager` instance, ``fontManager``, that can be shared across backends and platforms. The `findfont` function returns the best TrueType (TTF) font file in the local or system font path that matches the specified `FontProperties` instance. The `FontManager` also handles Adobe Font Metrics (AFM) font files for use by the PostScript backend. The design is based on the `W3C Cascading Style Sheet, Level 1 (CSS1) font specification `_. Future versions may implement the Level 2 or 2.1 specifications. ) b64encodeN) lru_cache)BytesIO)Number)Path)_api_afmcbookft2font)parse_fontconfig_patterngenerate_fontconfig_pattern) _validatorsgI +?gh|?5?g-??g333333?g ףp= ?gS?) zxx-smallzx-smallsmallmediumlargezx-largezxx-largelargersmallerNd,X ) zultra-condensedzextra-condensed condensedsemi-condensednormalz semi-expandedz semi-extendedexpandedextendedzextra-expandedzextra-extendedzultra-expandedzultra-extended) ultralightlightrregularbookrromansemibolddemibolddemiboldheavyz extra boldblack))thinr) extralightr)r"r)Z demilight^)Z semilightr/)r#r)r%i|)r$r)rr)rr)r(r)r)r)r'r) extraboldr)Z superboldr)Z ultraboldr)r*r)Z ultrablack)Z superblackr1)Z extrablackr1)z\bultrar1)r,r)r+r> sans serifsans sans-serifZ monospaceZcursiveZfantasyZserifz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Foldersz2SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fontsz/SOFTWARE\Microsoft\Windows\CurrentVersion\Fontsz%AppData/Local/Microsoft/Windows/Fontsz'AppData/Roaming/Microsoft/Windows/Fontsz/usr/X11R6/lib/X11/fonts/TTF/z/usr/X11/lib/X11/fontsz/usr/share/fonts/z/usr/local/share/fonts/z)/usr/lib/openoffice/share/fonts/truetype/ XDG_DATA_HOMEz .local/sharefontsz.fontsz/Library/Fonts/z/Network/Library/Fonts/z/System/Library/Fonts/z/opt/local/share/fontsz Library/FontscCs dggdgdgdd|S)zh Return a list of file extensions that are synonyms for the given file extension *fileext*. afm)otfttcttf)r7r8r9r:fontextr;r;S/var/www/html/django/DPS/env/lib/python3.9/site-packages/matplotlib/font_manager.pyget_fontext_synonymssr?csVddDtjdkr:tkr:fddtDSfddtDSdS)zo Return a list of all fonts matching any of the extensions, found recursively under the directory. cSsg|] }d|qS.r;.0extr;r;r> zlist_fonts..win32cs&g|]}tj|rtj|qSr;)ospathisfilejoin)rCfilename) directoryr;r>rEs cs<g|]4\}}}|D]$}t|jvrtj||qqSr;)rsuffixlowerrHrIrK)rCdirpath_ filenamesrL) extensionsr;r>rEsN)sysplatformwin32FontDirectoryrHlistdirwalkrMrSr;rYr> list_fontss  rZcCsxddl}zD||jt"}||ddWdWS1s@0YWn&tyrtjtj ddYS0dS)a Return the user-specified font directory for Win32. This is looked up from the registry key :: \\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\Fonts If the key is not found, ``%WINDIR%\Fonts`` will be returned. rNZFontsZWINDIR) winregOpenKeyHKEY_CURRENT_USER MSFolders QueryValueExOSErrorrHrIrKenviron)r[userr;r;r>rVs 4 rVc Csddl}t}tD]}z|||z}t||dD]V}|||\}}} t|tsZq8zt || } Wnt yYq8Yn0| | q8Wdn1s0YWqt tfyYqYq0q|S)a Search for fonts in the Windows registry. Parameters ---------- reg_domain : int The top level registry domain (e.g. HKEY_LOCAL_MACHINE). base_dir : str The path to the folder where the font files are usually located (e.g. C:\Windows\Fonts). If only the filename of the font is stored in the registry, the absolute path is built relative to this base directory. Returns ------- `set` `pathlib.Path` objects with the absolute path to the font files found. rN)r[setMSFontDirectoriesr\range QueryInfoKey EnumValue isinstancestrrresolve RuntimeErroraddr` MemoryError) Z reg_domainbase_dirr[itemsreg_pathlocaljkeyvaluetprIr;r;r>_win32RegistryFontss"   . rwz3.5r:csnddl}|durt}ddtDt}|t|j|tD]}|t|j|qDfdd|DS)a  Search for fonts in the specified font directory, or use the system directories if none given. Additionally, it is searched for user fonts installed. A list of TrueType font filenames are returned by default, or AFM fonts if *fontext* == 'afm'. rNcSsg|] }d|qSr@r;rBr;r;r>rErFz'win32InstalledFonts..cs"g|]}|jvrt|qSr;rNrOrjrCrIr<r;r>rE#rF) r[rVr?rdupdaterwHKEY_LOCAL_MACHINEMSUserFontDirectoriesr])rMr=r[rpZuserdirr;r<r>win32InstalledFonts sr}c Csddl}t}|jtgf|jtffD]\}}|D]}tD]}z|||z}t| |dD]V}| ||\}} } t | t sq`zt || } WntyYq`Yn0|| q`Wdn1s0YWq:ttfyYq:Yq:0q:q2q&|S)z2List the font paths known to the Windows registry.rNrc)r[rdr{rVr]r|rer\rfrgrhrirjrrkrlrmr`rn) r[rpdomainZ base_dirsrorqrrrsrtrurvrIr;r;r>_get_win32_installed_fonts&s*     .rc Csfz4dtddgvr$tdgWStddg}WnttjfyPgYS0dd|dDS) z3Cache and list the font paths known to ``fc-list``.s--formatzfc-listz--helpz7Matplotlib needs fontconfig>=2.7 to query system fonts.z--format=%{file}\ncSsg|]}tt|qSr;)rrHfsdecoderCfnamer;r;r>rEQrFz)_get_fontconfig_fonts.. ) subprocess check_output_logwarningr`CalledProcessErrorsplit)outr;r;r>_get_fontconfig_fontsFs rcs&ddtDfddtDS)zDList font filenames known to ``fc-list`` having the given extension.cSsg|] }d|qSr@r;rBr;r;r>rEWrFz(get_fontconfig_fonts..cs"g|]}|jvrt|qSr;rxryr<r;r>rEXs)r?rr<r;r<r>get_fontconfig_fontsTsrcst}t||durptjdkr4t}ttg}n"t}tjdkrRgtt }nt}| fdd|Dnt |t r|g}|D]}| t tjjt|qdd|DS)a4 Search for fonts in the specified font paths. If no paths are given, will use a standard set of system paths, as well as the list of fonts tracked by fontconfig if fontconfig is installed and available. A list of TrueType fonts are returned by default with AFM fonts as an option. NrGdarwinc3s,|]$}|jddvrt|VqdS)rcNrxryZfontextsr;r> qsz"findSystemFonts..cSsg|]}tj|r|qSr;)rHrIexistsrr;r;r>rEzrFz#findSystemFonts..)rdr?rTrUrr|rVrX11FontDirectoriesOSXFontDirectoriesrzrirjmaprHrIabspathrZ)Z fontpathsr=Z fontfilesZinstalled_fontsrIr;rr>findSystemFonts\s    rcCsddlm}|}|jdkr&t|jnd}|jdd|j|dt(}|j|ddd|WdS1sr0YdS)Nr)Figure)fonttightT) bbox_inches transparent) matplotlib.figurerrrtextnamersavefiggetvalue)fontentrfig font_pathbufr;r;r>_fontentry_helper_repr_png}s rcCs t|}t|}d|dS)Nz!)rrdecode)rZ png_streamZpng_b64r;r;r>_fontentry_helper_repr_htmls r FontEntryrr)defaultrstylervariantweightstretchsizerzj A class for storing Font properties. It is used when populating the font lookup dictionary. cCst|SN)rselfr;r;r>rFrcCst|Sr)rrr;r;r>rrF)__doc__ _repr_html_ _repr_png_) namespacec sTj}}d}d}|g|dRddpT|g|dRdd}|g|dRddp|g|dRdddd krd}n>d d krd }n*|d d krd }njtj@rd }nd }|d vrd}nd }d}d} d} |g||Rdd|g|| Rdd|g|| Rdd|g||Rdd|g|| Rdd|g|| Rddggt dpj gfdd} t | } t fdddDrd} n2dvrd} n"t fdddDr&d} nd } j s:tdd}tj|||| | |S) a Extract information from a TrueType font file. Parameters ---------- font : `.FT2Font` The TrueType font file from which information will be extracted. Returns ------- `FontEntry` The extracted font properties. )rcrr)rci rFzlatin-1 utf_16_beobliqueritalicr$rcapitals small-capsrz utf-16-beNcsd}|r"|ddkr"|dSzdddp:d}WntyPYn(0tD] \}}t||tjrV|SqVD]:}|dd}tD]$\}}t||tjr|Sqq|j t j @rdSd S) NzOS/2versioniZ usWeightClassr rrr) get_sfnt_tableget_ps_font_inforeplace ValueError_weight_regexesre fullmatchIsearch style_flagsr BOLD)Zos2Zps_font_info_weightregexrr)rstylesr;r> get_weights&       z#ttfFontProperty..get_weightc3s|]}|vVqdSrr;rCwordsfnt4r;r>r rFz"ttfFontProperty..)narrowrcondr demi condrc3s|]}|vVqdSrr;rrr;r>rrFwider r!r z$Non-scalable fonts are not supportedscalable) family_nameget_sfntgetrrOfindrr ITALICfilter style_nameintanyrNotImplementedErrorrr)rrZsfntZmac_keyZms_keyZsfnt2rrZ wws_subfamilyZtypographic_subfamilyZfont_subfamilyrrrrr;)rrrr>ttfFontPropertys\       rcs|}||dks,d|vr2d}nd|vrDd}nd}|dvrZd}nd}|}|tvrvd}dvrd}nrQrFz"afmFontProperty..)rrrc3s|]}|vVqdSrr;rrr;r>rSrFrr r)Zget_familynameZ get_fontnamerOZ get_angler weight_dictrr)Zfontpathrrrrrrrr;rr>afmFontProperty"s,     rc@seZdZdZd5ddZeddZddZd d Zd d Z d dZ ddZ ddZ ddZ ddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4ZeZe ZeZ eZ!dS)6FontPropertiesa A class for storing and manipulating font properties. The font properties are the six properties described in the `W3C Cascading Style Sheet, Level 1 `_ font specification and *math_fontfamily* for math fonts: - family: A list of font names in decreasing order of priority. The items may include a generic font family name, either 'sans-serif', 'serif', 'cursive', 'fantasy', or 'monospace'. In that case, the actual font to be used will be looked up from the associated rcParam during the search process in `.findfont`. Default: :rc:`font.family` - style: Either 'normal', 'italic' or 'oblique'. Default: :rc:`font.style` - variant: Either 'normal' or 'small-caps'. Default: :rc:`font.variant` - stretch: A numeric value in the range 0-1000 or one of 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded' or 'ultra-expanded'. Default: :rc:`font.stretch` - weight: A numeric value in the range 0-1000 or one of 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'. Default: :rc:`font.weight` - size: Either an relative value of 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large' or an absolute font size, e.g., 10. Default: :rc:`font.size` - math_fontfamily: The family of fonts used to render math text. Supported values are: 'dejavusans', 'dejavuserif', 'cm', 'stix', 'stixsans' and 'custom'. Default: :rc:`mathtext.fontset` Alternatively, a font may be specified using the absolute path to a font file, by using the *fname* kwarg. However, in this case, it is typically simpler to just pass the path (as a `pathlib.Path`, not a `str`) to the *font* kwarg of the `.Text` object. The preferred usage of font sizes is to use the relative values, e.g., 'large', instead of absolute font sizes, e.g., 12. This approach allows all text sizes to be made larger or smaller based on the font manager's default font size. This class will also accept a fontconfig_ pattern_, if it is the only argument provided. This support does not depend on fontconfig; we are merely borrowing its pattern syntax for use here. .. _fontconfig: https://www.freedesktop.org/wiki/Software/fontconfig/ .. _pattern: https://www.freedesktop.org/software/fontconfig/fontconfig-user.html Note that Matplotlib's internal font manager and fontconfig use a different algorithm to lookup fonts, so the results of the same pattern may be different in Matplotlib than in other applications that use fontconfig. Nc Cs||||||||||||||||t|t r|dur|dur|dur|dur|dur|dur| |dSr) set_family set_style set_variant set_weight set_stretchset_fileset_sizeset_math_fontfamilyrirjset_fontconfig_pattern) rfamilyrrrrrrmath_fontfamilyr;r;r>__init__s,         zFontProperties.__init__cCsVt||r|S|dur|St|tjr2||dSt|trD||S|fi|SdS)a Generic constructor which can build a `.FontProperties` from any of the following: - a `.FontProperties`: it is passed through as is; - `None`: a `.FontProperties` using rc values is used; - an `os.PathLike`: it is used as path to the font file; - a `str`: it is parsed as a fontconfig pattern; - a `dict`: it is passed as ``**kwargs`` to `.FontProperties`. N)r)rirHPathLikerj)clsargr;r;r> _from_anys    zFontProperties._from_anyc Cs@t||||||||f}t |Sr) tuple get_family get_slant get_variantr get_stretchget_sizeget_fileget_math_fontfamilyhash)rlr;r;r>__hash__s zFontProperties.__hash__cCst|t|kSr)r)rotherr;r;r>__eq__szFontProperties.__eq__cCs|Sr)get_fontconfig_patternrr;r;r>__str__szFontProperties.__str__cCs|jS)a Return a list of individual font family names or generic family names. The font families or generic font families (which will be resolved from their respective rcParams when searching for a matching font) in the order of preference. )_familyrr;r;r>rszFontProperties.get_familycCstt|jS)zT Return the name of the font that best matches the font properties. )get_fontfindfontrrr;r;r>get_nameszFontProperties.get_namecCs|jS)zV Return the font style. Values are: 'normal', 'italic' or 'oblique'. )_slantrr;r;r> get_styleszFontProperties.get_stylecCs|jS)zQ Return the font variant. Values are: 'normal' or 'small-caps'. )_variantrr;r;r>rszFontProperties.get_variantcCs|jS)z Set the font weight. Options are: A numeric value in the range 0-1000 or one of 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black' )_weightrr;r;r>rszFontProperties.get_weightcCs|jS)z Return the font stretch or width. Options are: 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'. )_stretchrr;r;r>rszFontProperties.get_stretchcCs|jS)z' Return the font size. )_sizerr;r;r>rszFontProperties.get_sizecCs|jS)z= Return the filename of the associated font. )_filerr;r;r>rszFontProperties.get_filecCst|S)a Get a fontconfig_ pattern_ suitable for looking up the font as specified with fontconfig's ``fc-match`` utility. This support does not depend on fontconfig; we are merely borrowing its pattern syntax for use here. )r rr;r;r>r sz%FontProperties.get_fontconfig_patterncCs,|durtjd}t|tr"|g}||_dS)aV Change the font family. May be either an alias (generic name is CSS parlance), such as: 'serif', 'sans-serif', 'cursive', 'fantasy', or 'monospace', a real font name or a list of real font names. Real font names are not supported when :rc:`text.usetex` is `True`. Default: :rc:`font.family` Nz font.family)mplrcParamsrirjr )rrr;r;r>r$s   zFontProperties.set_familycCs.|durtjd}tjgd|d||_dS)z Set the font style. Parameters ---------- style : {'normal', 'italic', 'oblique'}, default: :rc:`font.style` Nz font.style)rrr)r)rrr check_in_listr)rrr;r;r>r2s zFontProperties.set_stylecCs.|durtjd}tjddg|d||_dS)z Set the font variant. Parameters ---------- variant : {'normal', 'small-caps'}, default: :rc:`font.variant` Nz font.variantrr)r)rrrrr)rrr;r;r>r?s zFontProperties.set_variantcCsz|durtjd}|tvr$||_dSz t|}WntyBYn$0d|krXdkrfnn ||_dStd|ddS)aC Set the font weight. Parameters ---------- weight : int or {'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}, default: :rc:`font.weight` If int, must be in the range 0-1000. Nz font.weightrr1zweight= is invalid)rrrrrrrrr;r;r>rLs    zFontProperties.set_weightcCsz|durtjd}|tvr$||_dSz t|}WntyBYn$0d|krXdkrfnn ||_dStd|ddS)aP Set the font stretch or width. Parameters ---------- stretch : int or {'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}, default: :rc:`font.stretch` If int, must be in the range 0-1000. Nz font.stretchrr1zstretch=r)rr stretch_dictrrr)rrr;r;r>rfs    zFontProperties.set_stretchc Cs|durtjd}z t|}Wnjtyz t|}Wn>tyv}z&tddttt|WYd}~nd}~00|t }Yn0|dkrt d|d}||_ dS)aE Set the font size. Parameters ---------- size : float or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}, default: :rc:`font.size` If float, the font size in points. The string values denote sizes relative to the default font size. N font.sizez%Size is invalid. Valid font size are , rzHFontsize %1.2f < 1.0 pt not allowed by FreeType. Setting fontsize = 1 pt)rrfloatr font_scalingsKeyErrorrKrrj FontManagerget_default_sizerinfor)rrscaleerrr;r;r>rs,     zFontProperties.set_sizecCs|durt|nd|_dS)zw Set the filename of the fontfile to use. In this case, all other properties will be ignored. N)rHfspathr)rfiler;r;r>rszFontProperties.set_filecCsPt|D]>\}}t|tkr8t|d||dq t|d||q dS)z Set the properties by parsing a fontconfig_ *pattern*. This support does not depend on fontconfig; we are merely borrowing its pattern syntax for use here. set_rN)r rptypelistgetattr)rpatternrtvalr;r;r>rs z%FontProperties.set_fontconfig_patterncCs|jS)z} Return the name of the font family used for math text. The default font is :rc:`mathtext.fontset`. )_math_fontfamilyrr;r;r>rsz"FontProperties.get_math_fontfamilycCs:|durtjd}ntdj}tj||d||_dS)a Set the font family for text in math mode. If not set explicitly, :rc:`mathtext.fontset` will be used. Parameters ---------- fontfamily : str The name of the font family. Available font families are defined in the matplotlibrc.template file :ref:`here ` See Also -------- .text.Text.get_math_fontfamily Nzmathtext.fontset)r)rrr validvaluesrrr.)rZ fontfamilyZ valid_fontsr;r;r>rs  z"FontProperties.set_math_fontfamilycCs t|S)zReturn a copy of self.)copyrr;r;r>r1szFontProperties.copy)NNNNNNNN)"__name__ __module__ __qualname__rr classmethodrrrr rrrrrrrrr rrrrrrrrrrr1set_namerZ set_slantget_size_in_pointsr;r;r;r>rfsF>         rcseZdZfddZZS) _JSONEncodercszt|trt|jddSt|trjt|jdd}z"tt|dt |d<Wnt ydYn0|St |SdS)Nr! __class__rr) rir!dict__dict__rrjr relative_tor get_data_pathrsuperr)rodr9r;r>rs    z_JSONEncoder.default)r2r3r4r __classcell__r;r;r9r>r8sr8cCs|dd}|dur|S|dkr:tt}|j||S|dkrtt}|j|tj|j s|tj t |j |_ |St d|dS)Nr:r!rz*Don't know how to deserialize __class__=%s)popr!__new__r<rzrrHrIisabsrrKrr>r)r@rrr;r;r> _json_decodes     rGc Cst|t|d\}ztj||tddWn4tyb}ztd |WYd}~n d}~00Wdn1sx0YWdn1s0YdS)a Dump `FontManager` *data* as JSON to the file named *filename*. See Also -------- json_load Notes ----- File paths that are children of the Matplotlib data path (typically, fonts shipped with Matplotlib) are stored relative to that data path (to remain valid across virtualenvs). This function temporarily locks the output file to prevent multiple processes from overwriting one another's output. wr)rindentz$Could not save font_manager cache {}N) r _lock_pathopenjsondumpr8r`rrformat)datarLfher;r;r> json_dumps rRcCs:t|}tj|tdWdS1s,0YdS)zl Load a `FontManager` from the JSON file named *filename*. See Also -------- json_dump ) object_hookN)rKrLloadrG)rLrPr;r;r> json_loads rUc@seZdZdZdZd*ddZddZed d Zd d Z e d dZ ddZ e ddZ ddZddZddZddZddZddZd+d!d"Zd#d$Zd,d%d&Zed'd(d)ZdS)-r!aQ On import, the `FontManager` singleton instance creates a list of ttf and afm fonts and caches their `FontProperties`. The `FontManager.findfont` method does a nearest neighbor search to find the font that most closely matches the specification. If no good enough match is found, the default font is returned. iJNrc Cs|j|_||_||_dddD}tdt|ddd|_g|_g|_ t dd d }| zd D]}gt ||d t |d D]v}z||Wqty}ztd ||WYd}~qd}~0ty}ztd||WYd}~qd}~00qqhW|n |0dS)NcSsg|]}td|qS)r6)r _get_data_path)rCsubdirr;r;r>rE=sz(FontManager.__init__..)r:r7Z pdfcorefontszfont search path %sz DejaVu SansZ Helvetica)r:r7cSs tdS)Nz>Matplotlib is building the font cache; this may take a moment.)rrr;r;r;r>rIsz&FontManager.__init__..)r7r:r<zFailed to open font file %s: %sz-Failed to extract font properties from %s: %s) __version___version_FontManager__default_weight default_sizerdebugrj defaultFamilyafmlistttflist threadingTimerstartraddfontr`r# Exceptioncancel)rrrpathstimerr=rIexcr;r;r>r6s8" zFontManager.__init__cCst|}t|jdkrht|d}t|}Wdn1sF0Yt||}|j |nt |}t |}|j ||jdS)z Cache the properties of the font at *path* to make it available to the `FontManager`. The type of font is inferred from the path suffix. Parameters ---------- path : str or path-like z.afmrbN)rHrrrNrOrKrZAFMrr_appendr FT2Fontrr`_findfont_cached cache_clear)rrIrPrpropr;r;r>rdZs  (   zFontManager.addfontcsfddjDS)Ncs i|]\}}|j||dqS)r<)r )rCrDrrr;r> usz+FontManager.defaultFont..)r^rprr;rr> defaultFontqs zFontManager.defaultFontcCs|jS)z1 Return the default font weight. r[rr;r;r>get_default_weightxszFontManager.get_default_weightcCs tjdS)z/ Return the default font size. rrrr;r;r;r>r"~szFontManager.get_default_sizecCs ||_dS)zN Set the default font weight. The initial value is 'normal'. Nrrrr;r;r>set_default_weightszFontManager.set_default_weightcCs|dvr d}tjd|S)N)r3r2r4zfont.rt)rr;r;r>_expand_aliasesszFontManager._expand_aliasescCst|ttfs|g}nt|dkr&dS|}dt|}t|D]n\}}|}|tvrgttj| |}||vr| |}||t||SqB||krB||SqBdS)a& Return a match score between the list of font families in *families* and the font family name *family2*. An exact match at the head of the list returns 0.0. A match further down the list will return between 0 and 1. No match will return 1.0. rrrc) rir*rlenrO enumeratefont_family_aliasesrrjrvindex)rfamiliesZfamily2stepiZfamily1optionsidxr;r;r> score_familys    zFontManager.score_familycCs$||kr dS|dvr |dvr dSdS)z Return a match score between *style1* and *style2*. An exact match returns 0.0. A match between 'italic' and 'oblique' returns 0.1. No match returns 1.0. )rrg?rr;)rZstyle1Zstyle2r;r;r> score_styles zFontManager.score_stylecCs||kr dSdSdS)z} Return a match score between *variant1* and *variant2*. An exact match returns 0.0, otherwise 1.0. rrNr;)rZvariant1Zvariant2r;r;r> score_variantszFontManager.score_variantcCshz t|}Wnty*t|d}Yn0z t|}WntyVt|d}Yn0t||dS)z Return a match score between *stretch1* and *stretch2*. The result is the absolute value of the difference between the CSS numeric values of *stretch1* and *stretch2*, normalized between 0.0 and 1.0. rg@@)rrrrabs)rZstretch1Zstretch2Z stretchval1Z stretchval2r;r;r> score_stretchs    zFontManager.score_stretchcCsTt||rdSt|tr|nt|}t|tr4|nt|}dt||ddS)ah Return a match score between *weight1* and *weight2*. The result is 0.0 if both weight1 and weight 2 are given as strings and have the same value. Otherwise, the result is the absolute value of the difference between the CSS numeric values of *weight1* and *weight2*, normalized between 0.05 and 1.0. rgffffff?r1g?)r _str_equalrirrr)rZweight1Zweight2w1w2r;r;r> score_weights zFontManager.score_weightcCsl|dkr dSz t|}Wn ty8|jt|}Yn0z t|}WntyZYdS0t||dS)a Return a match score between *size1* and *size2*. If *size2* (the size specified in the font file) is 'scalable', this function always returns 0.0, since any font size can be generated. Otherwise, the result is the absolute distance between *size1* and *size2*, normalized so that the usual range of font sizes (6pt - 72pt) will lie between 0.0 and 1.0. rrrH)rrr\rr)rsize1size2Zsizeval1Zsizeval2r;r;r> score_sizes     zFontManager.score_sizer:TcCs&tdddD}|||||||S)a Find a font that most closely matches the given font properties. Parameters ---------- prop : str or `~matplotlib.font_manager.FontProperties` The font properties to search for. This can be either a `.FontProperties` object or a string defining a `fontconfig patterns`_. fontext : {'ttf', 'afm'}, default: 'ttf' The extension of the font file: - 'ttf': TrueType and OpenType fonts (.ttf, .ttc, .otf) - 'afm': Adobe Font Metrics (.afm) directory : str, optional If given, only search this directory and its subdirectories. fallback_to_default : bool If True, will fallback to the default font family (usually "DejaVu Sans" or "Helvetica") if the first lookup hard-fails. rebuild_if_missing : bool Whether to rebuild the font cache and search again if the first match appears to point to a nonexisting font (i.e., the font cache contains outdated entries). Returns ------- str The filename of the best matching font. Notes ----- This performs a nearest neighbor search. Each font is given a similarity score to the target font properties. The first font with the highest score is returned. If no matches below a certain threshold are found, the default font (usually DejaVu Sans) is returned. The result is cached, so subsequent lookups don't have to perform the O(n) nearest neighbor search. See the `W3C Cascading Style Sheet, Level 1 `_ documentation for a description of the font finding algorithm. .. _fontconfig patterns: https://www.freedesktop.org/software/fontconfig/fontconfig-user.html css|]}ttj|VqdSr)rrr)rCrtr;r;r>rArFz'FontManager.findfont..)z font.serifzfont.sans-serifz font.cursivez font.fantasyzfont.monospace)rrm)rror=rMfallback_to_defaultrebuild_if_missing rc_paramsr;r;r>r  s 8 zFontManager.findfontcCsttdd|jDS)z#Return the list of available fonts.cSsg|] }|jqSr;)r)rCrr;r;r>rEJrFz.FontManager.get_font_names..)r*rdr`rr;r;r>get_font_namesHszFontManager.get_font_namesc Cst|}g}|D]x}|}||z||j|||d|dWqty|tvr|t d|d | |n t d|Yq0q|s|r|j |} |}|| ||j|||d|dntd|S)as Find font families that most closely match the given properties. Parameters ---------- prop : str or `~matplotlib.font_manager.FontProperties` The font properties to search for. This can be either a `.FontProperties` object or a string defining a `fontconfig patterns`_. fontext : {'ttf', 'afm'}, default: 'ttf' The extension of the font file: - 'ttf': TrueType and OpenType fonts (.ttf, .ttc, .otf) - 'afm': Adobe Font Metrics (.afm) directory : str, optional If given, only search this directory and its subdirectories. fallback_to_default : bool If True, will fallback to the default font family (usually "DejaVu Sans" or "Helvetica") if none of the families were found. rebuild_if_missing : bool Whether to rebuild the font cache and search again if the first match appears to point to a nonexisting font (i.e., the font cache contains outdated entries). Returns ------- list[str] The paths of the fonts found Notes ----- This is an extension/wrapper of the original findfont API, which only returns a single font for given font properties. Instead, this API returns an dict containing multiple fonts and their filepaths which closely match the given font properties. Since this internally uses the original API, there's no change to the logic of performing the nearest neighbor search. See `findfont` for more details. F)rr[findfont: Generic family %r not found because none of the following families were found: %srz#findfont: Font family %r not found.TzFFailed to find any font, and fallback to the default font was disabled)rrrr1rrkr rryrrrKrvr^) rror=rMrrZfpathsrZcpropZdfamilyr;r;r>_find_fonts_by_propsLsD-      z FontManager._find_fonts_by_propsic Cs.t|}|}|dur|S|dkr.|j}n|j}d} d} td||D]} |durnt|t| jj vrnqL| | | j d| || j||| j||| j||| j||| j} td| | | | kr| } | } | dkrLq qL| dus | dkr|rtd| |j|ttj | D]*} | t!vrNtd | d "|#| qN|$}|%|j||j&|||d d St'd |dntd|| j | j| | j}t(j)*|s&|rt+dt,d d}t-|.t-||j&|||d dSt'dt/|S)Nr7g?O8Mzfindfont: Matching %s. zfindfont: score(%s) = %srg$@z7findfont: Font family %s not found. Falling back to %s.rrF)rzFailed to find font z/, and fallback to the default font was disabledz2findfont: Matching %s to %s (%r) with score of %f.z7findfont: Found a missing font file. Rebuilding cache.try_read_cache)rzNo valid font could be found)0rrrr_r`rr]rrparentsrrrrrrrrrrrrrrrrrrrr^rrjrOryrKrvr1rr rrHrIrJr#_load_fontmanagervarsrz_cached_realpath)rror=rMrrrrZfontlistZ best_scoreZ best_fontrscorerZ default_propresultZnew_fmr;r;r>rms      zFontManager._findfont_cached)Nr)r:NTT)r:NTT)r2r3r4rrYrrdpropertyrqrs staticmethodr"rurvrrrrrrr rrrrmr;r;r;r>r!)s6  $     ? Zr!cCsZtj|ddkrRt|d}|ddkWdS1sF0YndSdS)z Return whether the given font is a Postscript Compact Font Format Font embedded in an OpenType wrapper. Used by the PostScript and PDF backends that can not subset these fonts. rcz.otfrjrsOTTONF)rHrIsplitextrOrKread)rLfdr;r;r>is_opentype_cff_fonts .r@cs*|^}}tj|fdd|DdS)Ncsg|]}tj|dqS))_kerning_factorr rl)rCfpathrhinting_factorr;r>rEs z_get_font..)Z_fallback_listrr)font_filepathsrr thread_idZfirst_fontpathrestr;rr> _get_fonts rregister_at_fork)after_in_childcCs tj|Sr)rHrIrealpath)rIr;r;r>rsrz3.6filepathrcCsZt|tttfrt|f}ntdd|D}|dur@tjd}t||tjdt dS)a= Get an `.ft2font.FT2Font` object given a list of file paths. Parameters ---------- font_filepaths : Iterable[str, Path, bytes], str, Path, bytes Relative or absolute paths to the font files to be used. If a single string, bytes, or `pathlib.Path`, then it will be treated as a list with that entry only. If more than one filepath is passed, then the returned FT2Font object will fall back through the fonts, in the order given, to find a needed glyph. Returns ------- `.ft2font.FT2Font` css|]}t|VqdSr)rrr;r;r>r;rFzget_font..Nztext.hinting_factorztext.kerning_factor)rr) rirjrbytesrrrrrra get_ident)rrrgr;r;r>r "s  r TrcCs~ttdtjd}|r`z t|}Wnty:Yn&0t|dttjkr`t d||St}t ||t d|S)Nz fontlist-vz.jsonrZz"Using fontManager instance from %szgenerated new fontManager) rr get_cachedirr!rYrUrer+objectrr]rRr#)rZfm_pathfmr;r;r>rJs     r)Nr:)r:)Nr:)N)Wrbase64rr1 dataclasses functoolsriorrLloggingnumbersrrHpathlibrrrrTra matplotlibrrrr r matplotlib._fontconfig_patternr r matplotlib.rcsetupr getLoggerr2rrrrrryhomeZ_HOMEredevnullr^rerjr|rarrrr?rZrVrw deprecatedr}rrrrrrmake_dataclassfieldrrrr JSONEncoderr8rGrRrUr!rrhasattrrrnrrename_parameterr r fontManagerr rr;r;r;r>s"                0     !  D} N      '