h3 S r SSKJr SSKJr SSKrSSKrSSKJr SSKrSSK J
r
SSK r SSK r SSK
Jr SSKrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSS KJrJrJrJ r SS
K J r J r SS K J!r! \ RD " \#5 r$S S
SSSSSSSSS.
r%SSSSSSSSSSSS S S .
r&SSSSSSSSSSSSSS S .r'/ S Qr(1 S kr) \RT " 5 r+S!r.S"S#/r/\0" \+S$- 5 \0" \+S%- 5 /r1S&S'S(S)S*\0" \" \Rd Rg S+5 =( d \+S,- 5 S-- 5 \0" \+S.- 5 /r4S/S0S1S2\0" \+S3- 5 /r5S4 r6S5 r7S6 r8S7 r9\S8 5 r:\S9 5 r;STS: jr<\Rz " S;S<9 " S= S>5 5 r>S? r?S@ r@SA rA " SB SC5 rB " SD SE\ R 5 rDSF rESG rFSH rG " SI SJ5 rH\SK 5 rI\" SL5 SM 5 rJ\K" \SN5 ( a \R " \JR SO9 \" SL5 SP 5 rNSUSQ jrOS;SR.SS jrP\P" 5 rQ\QR rR\QR rSg! \, a \" \RZ 5 r+ GN~f = f)Va
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 `FontManager.addfont` function adds a custom font from a file without
installing it into your operating system.
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.
) annotations) 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)
ultralightlightr! regularbookr romansemibolddemibolddemiboldheavyz
extra boldblack))thinr )
extralightr )r$ r ) demilight^ ) semilightr2 )r% r )r' i| )r& r )r! r )r r )r* r )r+ r )r) r ) extraboldr ) superboldr ) ultraboldr )r, r )
ultrablack )
superblackr8 )
extrablackr8 )z\bultrar8 )r. r )r- r > sansserifcursivefantasy monospace
sans serif
sans-serifz@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/Fontsc $ S// SQ/ SQ/ SQS.U $ )z\
Return a list of file extensions that are synonyms for
the given file extension *fileext*.
afm)otfttcttf)rE rF rG rH fontexts I/var/www/html/env/lib/python3.13/site-packages/matplotlib/font_manager.pyget_fontext_synonymsrM s& w$$$
c F U Vs/ s H nSU- PM
nn[ R " U 5 VVVVs/ s HX u p4nU HK n[ U5 R R 5 U; d M, [ R
R
X65 PMM MZ snnnn$ s snf s snnnnf )zc
Return a list of all fonts matching any of the extensions, found
recursively under the directory.
.)oswalkr suffixlowerpathjoin) directory
extensionsextdirpath_ filenamesfilenames rL
list_fontsr^ s
(22z#)zJ2 *,); <);%I %H~$$**,
:
,BGGLL + &
,); < < 3 ?
%
%'< = "H - 9U!&v':':5'A!'D!EA .4-=-=e-GNC#-eS#9#9 ( ) (,H'<'D'D'F "IIdO "F :9 . " 0 L
$0 ) ( ) :9 - sU D A C? *C.
C? D.
C<
8C? ;C<
<C? ?
D
DDD% $D% c f S[ R " SS/5 ; a [ R S5 / $ [ R " SS/5 n U R
S5 Vs/ s H" n[ [ R " U5 5 PM$ sn$ ! [ [ R
4 a / s $ f = fs snf )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}\n
)
subprocess check_output_logwarningrg CalledProcessErrorsplitr rQ fsdecode)outfnames rL _get_fontconfig_fontsr s j 5 5y(6K L L LLI
KI%%y2G&HI 36))E2B C2BDU# $2B CC
Z22 3 Cs 2B B )B. B+*B+c [ R " [ R " / SQ5 5 u n U S Vs/ s H n[ US 5 PM sn$ ! [ [ R
[ R 4 a / s $ f = fs snf )zKCache and list the font paths known to ``system_profiler SPFontsDataType``.)system_profilerz-xmlSPFontsDataType_itemsrU )plistlibloadsr r rg r InvalidFileExceptionr )dentrys rL _get_macos_fontsr sv
^^ # #$R SU ./x[ 9[EDv [ 99
Z22H4Q4Q R 9s .A B+B ?B c
f ^ [ 5 n[ U5 mU c} [ R S:X a
[ 5 n/ n O@[ 5 n[ R S:X a U[
5 -
n/ [ Q[ Qn O[ n UR U4S jU 5 5 O[ U [ 5 ( a U /n U H@ nUR [ [ R R [! UT5 5 5 MB U Vs/ s H+ n[ R R# U5 ( d M) UPM- sn$ s snf )a
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.
win32darwinc 3 ># U H3 nUR R 5 S S T; d M& [ U5 v M5 g7f)rl N)rS rT ru ).0rU fontextss rL "findSystemFonts..) s; At KK - - / 3x ? #Ts %>>)rm rM sysplatformr r r X11FontDirectoriesOSXFontDirectoriesupdatert ru maprQ rU abspathr^ exists) fontpathsrK fontfilesinstalled_fontsrU r r s @rL findSystemFontsr s I#G,H <<7 " 8 :OI 3 5O||x' #3#55 F 0 F3E F . A A A
Is # # K RWW__jx.HIJ ) ByeBGGNN5,AEy BB Bs 9(D.%D.T)frozenc \ rS rSr% SrSrS\S' SrS\S' SrS\S' Sr S\S ' Sr
S
\S ' Sr S\S ' S
r S\S' SS jr
SS jrSrg) FontEntryi5 z^
A class for storing Font properties.
It is used when populating the font lookup dictionary.
ru r namer! stylevariantz str | intweightstretchr sizec ` U R 5 n[ U5 R 5 nSU S3$ )Nz!
)
_repr_png_r decode)self
png_streampng_b64s rL _repr_html_FontEntry._repr_html_E s0 __&
J'..03G9EBBrN c . SSK Jn U" 5 nU R S:w a [ U R 5 OS nUR SSU R
US9 [
5 nUR USSS9 UR 5 sS S S 5 $ ! , ( d f g = f)Nr )Figurer )fonttightT) bbox_inches transparent) matplotlib.figurer r r textr r savefiggetvalue)r r fig font_pathbufs rL r FontEntry._repr_png_J sk ,h(,
b(8D$d Atyyy1
Y# KKdK C<<> YYs !B
BrI N)returnru )r bytes)__name__
__module__ __qualname____firstlineno____doc__r __annotations__r r r r r r r r __static_attributes__rI rN rL r r 5 sX E3OD#NE3GS FI GSD#C
"rN r c T ^ ^^ T R nT R 5 nSnSnUR / UQSP7S5 R S5 R 5 =( d4 UR / UQSP7S5 R S5 R 5 nUR / UQSP7S5 R S5 R 5 =( d4 UR / UQSP7S5 R S5 R 5 mTR S5 S : a SnO]TR S
5 S : a S
nOEUR S 5 S : a S nO-[ R R T R ; a S
nOS nUR 5 S
; a SnOS nSnSn Sn
UR / UQUP7S5 R S5 UR / UQU P7S5 R S5 UR / UQU
P7S5 R S5 UR / UQUP7S5 R S5 UR / UQU P7S5 R S5 UR / UQU
P7S5 R S5 /m/ [ ST5 Q=( d
T R /mU U4S jn [ U " 5 5 n [ U4S jS 5 5 ( a Sn
O(ST; a Sn
O [ U4S jS 5 5 ( a Sn
OS n
T R ( d [ S 5 eS n[! T R" XX|X5 $ ) z
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.
)rl r r ) rl i rN zlatin-1 utf_16_be obliquer italicr& r! capitals
small-capsr z utf-16-beNc L > TR S5 n U ( a U S S:w a U S $ TR 5 S R SS5 =( d Sn[ H3 u p#[ R
" X![ R 5 ( d M1 Us $ T HT nUR SS5 n[ H5 u p#[ R " X$[ R 5 ( d M1 Us s $ MV [ R R TR ; a gg ! [ a Nf = f)
NzOS/2versioni
usWeightClassr r r r )
get_sfnt_tableget_ps_font_inforeplace_weight_regexesre fullmatchI
ValueErrorsearchr
StyleFlagsBOLD style_flags)os2ps_font_info_weightregexr r r styless rL
get_weight#ttfFontProperty..get_weight s !!&) 3y>V+' ' "%%'199#rBHb
"1
<<BDDAA!M "1 EMM#r*E!0
99U24400!M "1
" "d&6&6 6 s ,D
D#"D#c 3 , ># U H oT; v M g 7fNrI r wordsfnt4s rL r "ttfFontProperty.. s
E%DT5=%D )narrowr condr demi condr c 3 , ># U H oT; v M g 7fr rI r s rL r r s H'GtU]'Gr wider" r# r" z$Non-scalable fonts are not supportedscalable) family_nameget_sfntgetr rT findr r ITALICr filter
style_nameintanyr NotImplementedErrorr r )r r sfntmac_keyms_keysfnt2r r
wws_subfamilytypographic_subfamilyfont_subfamilyr r r r r r s ` @@rL ttfFontPropertyr T s D ==?DGF XXmmmS
)
0
0
;
A
A
C E
XXlllC
(
/
/
<
B
B
D
XXmmmS
)
0
0
;
A
A
C E
XXlllC
(
/
/
<
B
B
D
zz) ! H " I ! # " "d&6&6 6
zz|11 M N *7*M*C077 B 272 12C8?? J +7+N+S188C )6)=)3/66{C 1610137>>{K *6*>*C077 D
F %vdF#
$
9 (9F2
F
E%D
EEE " H'G H H H ==!"HII D TZZgw MMrN c ^ UR 5 nUR 5 R 5 mUR 5 S:w d SUR 5 ; a SnOSUR 5 ; a SnOSnUR 5 S; a SnOSnUR 5 R 5 nU[
; a SnST; a SnO<[
U4S jS
5 5 ( a S nO [
U4S jS
5 5 ( a SnOSnSn[ XX4XVU5 $ )a
Extract information from an AFM font file.
Parameters
----------
fontpath : str
The filename corresponding to *font*.
font : AFM
The AFM font file from which information will be extracted.
Returns
-------
`FontEntry`
The extracted font properties.
r r r r! r r r r c 3 , ># U H oT; v M g 7fr rI r r fontnames rL r "afmFontProperty.. s =*<$X
*# U H oT; v M g 7fr rI r s rL r r s K*J$X
*Jr r r" r )get_familyname get_fontnamerT get_angler weight_dictr r ) fontpathr r r r r r r r s @rL afmFontPropertyr% s " D "((*H ~~1 DJJL 8 djjl "
zz|11
__
$
$
&F
[ h " =*< = = = K*J K K K D XUVd KKrN c F ^ [ R " T 5 U 4S j5 nU$ )a
A decorator to limit the call signature to single a positional argument
or alternatively only keyword arguments.
We still accept but deprecate all other call signatures.
When the deprecation expires we can switch the signature to::
__init__(self, pattern=None, /, *, family=None, style=None, ...)
plus a runtime check that pattern is not used alongside with the
keyword arguments. This results eventually in the two possible
call signatures::
FontProperties(pattern)
FontProperties(family=..., size=..., ...)
c " > [ U5 S: d [ U5 S:X a U( a [ R " SSS9 [ U5 S:X a: U( d3 [ R " US 5 ( d [ R " SSS9 T" U /UQ70 UD6$ )Nrl z3.10zPassing individual properties to FontProperties() positionally was deprecated in Matplotlib %(since)s and will be removed in %(removal)s. Please pass all properties via keyword arguments.)messager zPassing family as positional argument to FontProperties() was deprecated in Matplotlib %(since)s and will be removed in %(removal)s. Please pass family names as keywordargument.)lenr warn_deprecatedr is_scalar_or_string)r argskwargs init_methods rL wrapper-_cleanup_fontproperties_init..wrapper, s t9q=CINv
1
t9>&1J1J4PQ71S1S $
41$1&11rN ) functoolswraps)r. r/ s ` rL _cleanup_fontproperties_initr3 s' & __[!2 "28 NrN c \ rS rSrSr\ S S j5 r\S 5 rS r S r
S r S r S
r
S rS rS
rS rS rS rS rS rS rS rS rS rS rS rS r S r S r S r \r \r!\r"\r#S r$g) FontPropertiesiL a
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 a 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 accepts a single positional string as fontconfig_ pattern_,
or alternatively individual properties as keyword arguments::
FontProperties(pattern)
FontProperties(*, family=None, style=None, variant=None, ...)
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 U R U5 U R U5 U R U5 U R U5 U R U5 U R U5 U R
U5 U R U5 [ U[ 5 ( a* Uc& Uc" Uc Uc Uc Uc U R U5 g g g g g g g g r )
set_family set_style set_variant
set_weight set_stretchset_fileset_sizeset_math_fontfamilyrt ru set_fontconfig_pattern) r familyr r r r r r math_fontfamilys rL __init__FontProperties.__init__ s
u ! !
e
d 1
vs # #Mgo&.O ' ' / :G O ;IoM
$rN c Uc U " 5 $ [ X5 ( a U$ [ U[ R 5 ( a U " US9$ [ U[ 5 ( a U " U5 $ U " S0 UD6$ )ah
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`.
)r rI )rt rQ PathLikeru )clsargs rL _from_anyFontProperties._from_any s] ;5L
!
!J
R[[
)
)S> !
S
!
!s8O:: rN c [ U R 5 5 U R 5 U R 5 U R 5 U R 5 U R
5 U R 5 U R 5 4n[ U5 $ r )
tuple
get_family get_slant get_variantr get_stretchget_sizeget_fileget_math_fontfamilyhash)r ls rL __hash__FontProperties.__hash__ sm
4??$
%
^^
__
]]_
]]_
%
%
'
) AwrN c 0 [ U 5 [ U5 :H $ r )rS )r others rL __eq__FontProperties.__eq__ s DzT%[((rN c " U R 5 $ r )get_fontconfig_patternr s rL __str__FontProperties.__str__ s **,,rN c U R $ )z
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.
)_familyr] s rL rL FontProperties.get_family s ||rN c > [ [ U 5 5 R $ )zD
Return the name of the font that best matches the font properties.
)get_fontfindfontr r] s rL get_nameFontProperties.get_name s '333rN c U R $ )zF
Return the font style. Values are: 'normal', 'italic' or 'oblique'.
)_slantr] s rL get_styleFontProperties.get_style s {{rN c U R $ )zA
Return the font variant. Values are: 'normal' or 'small-caps'.
)_variantr] s rL rN FontProperties.get_variant s }} rN c U R $ )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'
)_weightr] s rL r FontProperties.get_weight s ||rN c U R $ )z
Return the font stretch or width. Options are: 'ultra-condensed',
'extra-condensed', 'condensed', 'semi-condensed', 'normal',
'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'.
)_stretchr] s rL rO FontProperties.get_stretch s }} rN c U R $ )z
Return the font size.
)_sizer] s rL rP FontProperties.get_size zzrN c U R $ )z-
Return the filename of the associated font.
)_filer] s rL rQ FontProperties.get_file rx rN c [ U 5 $ )z
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 r] s rL r\ %FontProperties.get_fontconfig_pattern s +400rN c l Uc [ R S n[ U[ 5 ( a U/nXl g)a&
Change the font family. Can 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)mplrcParamsrt ru ra )r r@ s rL r7 FontProperties.set_family s0 >\\-0F fc " " XF rN c j Uc [ R S n[ R " / SQUS9 Xl g)zo
Set the font style.
Parameters
----------
style : {'normal', 'italic', 'oblique'}, default: :rc:`font.style`
Nz
font.style)r! r r )r )r r r
check_in_listri )r r s rL r8 FontProperties.set_style s- =LL .E :%H rN c j Uc [ R S n[ R " SS/US9 Xl g)zn
Set the font variant.
Parameters
----------
variant : {'normal', 'small-caps'}, default: :rc:`font.variant`
Nz font.variantr! r )r )r r r r rm )r r s rL r9 FontProperties.set_variant+ s1 ?ll>2G Hl3WE
rN c Uc [ R S nU[ ; a Xl g [ U5 nSUs=:: a S:: a
O OXl g [ SU< S35 e! [
a N f = f)a
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.weightr r8 zweight= is invalid)r r r# rp r r r r s rL r: FontProperties.set_weight8 s{ >\\-0F [ !L [F F"d" % # GF9K011
A
A)(A)c Uc [ R S nU[ ; a Xl g [ U5 nSUs=:: a S:: a
O OXl g [ SU< S35 e! [
a N f = f)a
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.stretchr r8 zstretch=r )r r stretch_dictrs r r )r r s rL r; FontProperties.set_stretchR s{ ?ll>2G l " #M 'lG G#t# '
$ HG:[122
r c v Uc [ R S n [ U5 nUS: a [ R SU5 SnXl
g! [ af [ U nU[
R
5 - n NR! [ a5 n[ SSR [ [ [ 5 5 - 5 UeSnAff = ff = f)a
Set the font size.
Parameters
----------
size : float or {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}, default: :rc:`font.size`
If a 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 , r zHFontsize %1.2f < 1.0 pt not allowed by FreeType. Setting fontsize = 1 pt)r r floatr
font_scalings FontManagerget_default_sizeKeyErrorrV r ru r inforv )r r scaleerrs rL r= FontProperties.set_sizel s <<< ,D
>;D #: II 015
7D
>
>%d+ { ; ; ==
C ;iiC 789:?BC
C >s/ A
B8 A5 B85
B4?0B//B44B8c P Ub [ R " U5 U l gSU l g)z_
Set the filename of the fontfile to use. In this case, all
other properties will be ignored.
N)rQ fspathrz )r files rL r< FontProperties.set_file s
)-(8RYYt_
d
rN c [ U5 R 5 HF u p#[ U5 [ L a [ U SU- 5 " US 5 M1 [ U SU- 5 " U5 MH g)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_r N)r
rz typelistgetattr)r patternr vals rL r? %FontProperties.set_fontconfig_pattern sU 19??AHCCyD fsl+CF3fsl+C0 BrN c U R $ )ze
Return the name of the font family used for math text.
The default font is :rc:`mathtext.fontset`.
)_math_fontfamilyr] s rL rR "FontProperties.get_math_fontfamily s $$$rN c Uc [ R S nO5[ S R R 5 n[
R " X!S9 Xl g)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
:ref:`default matplotlibrc file `.
See Also
--------
.text.Text.get_math_fontfamily
Nzmathtext.fontset)rA )r r r validvaluesr r r )r
fontfamily valid_fontss rL r> "FontProperties.set_math_fontfamily sI $ &89J%&89??FFHK
{ G * rN c . [ R " U 5 $ )zReturn a copy of self.)copyr] s rL r FontProperties.copy s yy rN )ra rz r rv ri rs rm rp )NNNNNNNN)%r r r r r r3 rB classmethodrH rU rY r^ rL rf rj rN r rO rP rQ r\ r7 r8 r9 r: r; r= r< r? rR r> r set_namerM set_slantget_size_in_pointsr rI rN rL r5 r5 L s AF "EI$(!%0 "0( , )- 4 1 2434 <C 1%+6
HII!rN r5 c ( ^ \ rS rSrU 4S jrSrU =r$ ) _JSONEncoderi c f > [ U[ 5 ( a [ UR SS9$ [ U[ 5 ( aS [ UR SS9n [ [
US 5 R [ R " 5 5 5 US' U$ [ TU ]1 U5 $ ! [ a U$ f = f)Nr __class__r r )
rt r dict__dict__r ru r relative_tor
get_data_pathr superdefault)r or r s rL r _JSONEncoder.default s a % %
m< <
9
%
%QZZ;7A
!aj!1!=!=c>O>O>Q!R S'
H7?1% %
H
s Matplotlib is building the font cache; this may take a moment.)r r rI rN rL &FontManager.__init__..G s 4<< L,NrN )rE rH rJ z Failed to open font file %s: %sz-Failed to extract font properties from %s: %s) __version___version _FontManager__default_weight default_sizer _get_data_pathr debug
defaultFamilyafmlistttflist threadingTimerstartr addfontrg r Exceptioncancel) r r r subdirpathstimerrK rU excs rL rB FontManager.__init__4 sI ((
& >? =V %%gv6 = ?
(%0 ! $N O
) @oe E @ -g > @D3 T* @ *
LLN7?* # P "CTOO$ 3 #'(,3 33
LLNsM !C# D? 9C(
D? (
D<2DD?
D<D71D? 7D<<D? ?Ec [ R " U5 n[ U5 R R 5 S:X aS [ US5 n[ R " U5 nSSS5 [ UW5 nU R R U5 O<[ R " U5 n[ U5 nU R R U5 U R R! 5 g! , ( d f N= f)az
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
Notes
-----
This method is useful for adding a custom font without installing it in
your operating system. See the `FontManager` singleton instance for
usage and caveats about this function.
z.afmrbN)rQ r r rS rT r r
AFMr% r appendr FT2Fontr r _findfont_cached cache_clear)r rU r r props rL r FontManager.addfontX s " {{4 : " " $ .dD!Rxx| ""4.D LL %??4(D"4(D LL % ))+ "!s
C((
C6c
U R R 5 VVs0 s H u pXR X!S9_M snn$ s snnf )NrJ )r rz re )r rY r@ s rL defaultFontFontManager.defaultFontu sH
$(#5#5#;#;#=?#=KC ]]6]77#=? ? ?s =c U R $ )z!
Return the default font weight.
r r] s rL get_default_weight FontManager.get_default_weight| s $$$rN c ( [ R S $ )z
Return the default font size.
r r r rI rN rL r FontManager.get_default_size s
||K((rN c Xl g)z>
Set the default font weight. The initial value is 'normal'.
Nr r s rL set_default_weight FontManager.set_default_weight s
!' rN c > U S; a Sn [ R SU - $ )N)r; r@ rA zfont.r )r@ s rL _expand_aliasesFontManager._expand_aliases s$ + +!F||Gf ,--rN c [ U[ [ 45 ( d U/nO[ U5 S:X a gUR 5 nS[ U5 - n[ U5 H u pEUR 5 nU[ ; aX / [ [ R U R U5 5 QnX&; a& UR U5 nXG[ U5 - - U- s $ Mw XR:X d M~ XC- s $ g)z
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.
r r rl ) rt r rK r) rT enumeratefont_family_aliasesr ru r
index)r familiesfamily2stepifamily1optionsidxs rL score_familyFontManager.score_family s (T5M22 zH
]a
--/3x= #H-JA mmoG--JC 4+?+?+H IJ%!--0C s7|!3 4<< & # x . rN c * X:X a gUS; a US; a gg)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.
)r r g?r rI )r style1style2s rL score_styleFontManager.score_style s% -- 11rN c X:X a gg)ze
Return a match score between *variant1* and *variant2*.
An exact match returns 0.0, otherwise 1.0.
r r rI )r variant1variant2s rL
score_variantFontManager.score_variant s rN c [ U5 n [ U5 n[ X4-
5 S- $ ! [ a [ R US5 n N>f = f! [ a [ R US5 n NXf = f)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.
r g @@)r r r r
abs)r stretch1stretch2 stretchval1 stretchval2s rL
score_stretchFontManager.score_stretch sx : h-K : h-K ;,-66
:&**8S9K : :&**8S9K :s ) A A A A21A2c [ R " X5 ( a g[ U[ 5 ( a UO[ U n[ U[ 5 ( a UO[ U nS[ X4-
5 S- - S- $ )a0
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.
r gffffff?r8 g?)r
_str_equalrt r r# r( )r weight1weight2w1w2s rL score_weightFontManager.score_weight sc G - -"7F33WW9M"7F33WW9Ms27|d*+d22rN c US:X a g [ U5 n [ U5 n[ X4-
5 S- $ ! [ a U R [ U - n N>f = f! [ a gf = f)ae
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.
r r r H )r r r r r( )r size1size2sizeval1sizeval2s rL
score_sizeFontManager.score_size s| J @ U|H U|H 8&'",,
@((=+??H @ s 0 A AA
A#"A#c [ S S 5 5 nU R XX4UU5 n[ U[ R 5 ( a UR 5 eU$ )a[
Find the path to the font file most closely matching 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 fall back 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
c 3 Z # U H! n[ [ R U 5 v M# g 7fr )rK r r )r r s rL r 'FontManager.findfont..E s) ? s% S 122 ? s )+)z
font.serifzfont.sans-serifz font.cursivez font.fantasyzfont.monospace)rK r rt r _ExceptionInfo to_exception)r r rK rW fallback_to_defaultrebuild_if_missing rc_paramsrets rL re FontManager.findfont
sd p ? ## 9;M c5// 0 0""$ $
rN c j [ U R Vs1 s H oR iM sn5 $ s snf )z#Return the list of available fonts.)r r r )r r s rL get_font_namesFontManager.get_font_namesO s% 4<<8<4YY<8998s 0c [ R U5 n/ nUR 5 HF nUR 5 nUR U5 UR U R
XUSUS95 MH U( de U( aS U R U n UR 5 nUR U 5 UR U R
XUSUS95 U$ [ S5 eU$ ! [ a^ U[ ; a9 [ R SUSR U R U5 5 5 GM [ R SU5 GM f = f)ai
Find the paths to the font files most closely matching 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 fall back 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 a list of filepaths of multiple fonts 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)rD rE [findfont: Generic family %r not found because none of the following families were found: %sr z#findfont: Font family %r not found.TzFFailed to find any font, and fallback to the default font was disabled)r5 rH rL r r7 r re r r r r rV r
r )
r r rK rW rD rE fpathsr@ cpropdfamilys
rL _find_fonts_by_props FontManager._find_fonts_by_propsS sP Z ''-oo'FIIKE V $
P
MM ,1+= " (0 " ,,W5 )
MM ,0+= "
! "D E E
9
P 00LLH $*>*>v*F G LL!FOO
Ps
!C A E-EEi c
n [ R U5 nUR 5 nUb U$ US:X a
U R nO U R nSn S n
[
R
SU5 U GH` n Ub. [ U5 [ U R 5 R ; a M5 U R UR 5 U R 5 S- U R UR 5 U R 5 - U R! UR# 5 U R$ 5 - U R' UR) 5 U R* 5 - U R- UR/ 5 U R0 5 - U R3 UR5 5 U R6 5 - n [
R
SX5 X: a U n U n
U S:X d GMa O U
b U S: Ga U( a [
R9 SUR 5 U R: U 5 [= [> R@ UR 5 5 HD n
U
[B ; d M [
R9 S U
S
RE U RG U
5 5 5 MF URI 5 nURK U R: U 5 U RM XUS S 9$ [N RP " [R S
U S35 $ [
R
SXR U
R U 5 U
R n[T RV RY U5 ( dt U( aR [
R[ S5 [] S S9n[_ U 5 Ra [_ U5 5 U RM XUS S9$ [N RP " [R S5 $ [c U5 $ )NrE g?O8Mzfindfont: Matching %s.
zfindfont: score(%s) = %sr g $@z7findfont: Font family %s not found. Falling back to %s.rM r F)rD zFailed 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)rE z No valid font could be found)2r5 rH rQ r r r r r r parentsr rL r r rj r r% rN r r5 r r r- rO r r= rP r r r r ru rT r rV r
r r7 re r rB r rQ rU isfiler _load_fontmanagervarsr _cached_realpath)r r rK rW rD rE rF r fontlist
best_score best_fontr scorer@ default_propresultnew_fms rL r FontManager._findfont_cached s1 ''-
L e ||H||H
+T2 D%O4
+;+C+CC&&t'8$))DrI''(8$**EF))$*:*:* ?F !44 L "DIId.B.B6.J$KM @ $yy{ ''(:(:7(CD}}\I9> % @ @ ++ *4& 1
JJK^^Y__j
J __Fww~~f%%! MO*%@
T
!!$v,/}}9 % H H ++J8VWW ''rN )__default_weightr r r r r )Nr! )rH NTT)r r r r r r rB r propertyr r staticmethodr r
r
r r r% r- r5 r= re rJ rQ r r r rI rN rL r r s > K"H,: ? ? % ) ) ' . . <" 7$3$-0 7;>B@D: CGJNXt t_S( S(rN r c [ R R U 5 S R 5 S:X a* [ U S5 nUR S5 S:H sSSS5 $ g! , ( d f g= f)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 cannot subset these fonts.
rl z.otfr r s OTTONF)rQ rU splitextrT r read)r] fds rL is_opentype_cff_fontrk s[
ww!!$**,6
(D
!R771:( "
! "
!s A
A.@ c
U tpE[ R " XAU Vs/ s H n[ R " XaUS9PM snUS9$ s snf )N)_kerning_factor)_fallback_listrn )r r )font_filepathshinting_factorrn thread_idfirst_fontpathrestfpaths rL _get_fontrv sX *N ??
OO /
(
s > register_at_fork)after_in_childc @ [ R R U 5 $ r )rQ rU realpath)rU s rL r[ r[ + s 77 D !!rN c [ U [ [ [ 45 ( a
[ U 5 4nO[ S U 5 5 nUc [ R S n[ UU[ R S [ R " 5 S9$ )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`
c 3 8 # U H n[ U5 v M g 7fr )r[ )r r s rL r get_font..J s J>%&u-->s ztext.hinting_factorztext.kerning_factor)rn rr ) rt ru r r r[ rK r r rv r get_ident)rp rq r s rL rd rd 2 sv * .3e"455!.13J>JJ &;<
%:;%%'
rN rU c [ [ R " 5 S[ R S35 nU ( aL [ U5 n[
US[ 5 5 [ R :X a [ R SU5 U$ [ 5 n[ X!5 [ R S5 U$ ! [ a N8f = f)Nz
fontlist-vz.jsonr z"Using fontManager instance from %szgenerated new fontManager)
r r get_cachedirr r r r objectr r r r r )rV fm_pathfms rL rY rY Y s j)@)@(A GIG 7#B r:vx0K4K4KK
?I L
B
bII)*
I s B1 1
B>=B>)NrH r )Tr
__future__r base64r r dataclassesr1 r ior r loggingnumbersr rQ pathlibr r r r r r
matplotlibr r r
r r matplotlib._fontconfig_patternr
r matplotlib.rcsetupr getLoggerr r r r r# r r home_HOMEr devnullre rp ru ro rh r
r r rM r^ rj r r r r dataclassr r r% r3 r5 JSONEncoderr r r r r rk rv hasattrrw r r[ rd rY fontManagerre rJ rI rN rL r s6 6 #
1 1; *"
6 IIKE H
:68 77899: $ /bjjnn_-G 1G H
<;" @
D
D : : CD
d#" " $"<|N~CLL0f}" }"@ &4## &"M"@0 7o( o(d
2 ( 2!""y'<'<= 2 " " $N )- $ ! ++G/ E s :H. .I
I