)Uc @ s d Z d d l Z d d l Z d d l Z d d l Z d d l Z y e Wn! e k
rm d d l m Z n Xd d l
Z
d d l
m Z d d l
m Z d d l
m
Z
m Z d d l m Z d d l m Z m Z y d d l Z Wn e k
rd d l Z n Xe Z e
j Z i
d d
6d d 6d
d 6d d 6d d 6d d 6d d 6d d 6d
d 6d e 6Z i d d 6d d 6d d 6d d 6d! d" 6d# d$ 6d% d& 6d' d( 6d) d* 6Z i d d+ 6d d, 6d d" 6d d- 6d d. 6d! d 6d! d/ 6d# d0 6d# d1 6d# d2 6d% d3 6d' d4 6d' d5 6d) d6 6Z e d7 d8 d9 d: d; d< d= g Z d> Z d? d@ g Z dA dB dC dD g Z! dE dF dG g Z" e re j# j$ dH Z% e% e k re j& j' e% dI dJ Z& e" j( e& e j& j' e% dK Z& e! j( e& n n dL Z) dM Z* e dN dO Z+ dP Z, e dN dQ Z- dR Z. dN dS Z/ e dN dT Z0 dU Z1 dV e2 f dW YZ3 dX Z4 dY Z5 dN dZ Z6 d[ e2 f d\ YZ7 d] Z8 d^ Z9 d_ Z: d` f da YZ; i Z< db Z= e a> e j& j' e dc Z? dd Z@ e oe jA de k r6d d lB ZB df ZC eB jD dg ZE i ZF dN dh ZG np yV e: e? a> eH t> di pdt> jI e; jJ k rqe@ n e t> _K e jL dj e? Wn e@ n Xdk ZG d S(l s
A module for finding, managing, and using fonts across platforms.
This module provides a single :class:`FontManager` instance that can
be shared across backends and platforms. The :func:`findfont`
function returns the best TrueType (TTF) font file in the local or
system font path that matches the specified :class:`FontProperties`
instance. The :class:`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.
Experimental support is included for using `fontconfig` on Unix
variant platforms (Linux, OS X, Solaris). To enable it, set the
constant ``USE_FONTCONFIG`` in this file to ``True``. Fontconfig has
the advantage that it is the standard way to look up fonts on X11
platforms, so if a font is installed, it is much more likely to be
found.
iN( t Set( t afm( t ft2font( t rcParamst
get_configdir( t is_string_like( t parse_fontconfig_patternt generate_fontconfig_patterngI +?s xx-smallgh|?5?s x-smallg-?t smallg ?t mediumg333333?t largeg
ףp=
?s x-largegS?s xx-larget largert smallerid s ultra-condensedi s extra-condensedi, t condensedi s semi-condensedi t normaliX s
semi-expandedi t expandedi s extra-expandedi s ultra-expandedt
ultralightt lightt regulart bookt romant semiboldt demiboldt demit boldt heavys
extra boldt blackt serifs
sans-serifs
sans serift cursivet fantasyt monospacet sanss@ Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folderss2 SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fontss/ SOFTWARE\Microsoft\Windows\CurrentVersion\Fontss /usr/X11R6/lib/X11/fonts/TTF/s /usr/share/fonts/s /usr/local/share/fonts/s) /usr/lib/openoffice/share/fonts/truetype/s /Library/Fonts/s /Network/Library/Fonts/s /System/Library/Fonts/t HOMEt Libraryt Fontss .fontsc C s i d d 6d d 6d d 6| S( ss
Return a list of file extensions extensions that are synonyms for
the given file extension *fileext*.
t ttft otfR ( R# R$ ( R# R$ ( s afm( ( t fontext( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_fontext_synonyms s
c C s y d d l } Wn t k
r# no XyZ | j | j t } z0 y | j | d d SWn t k
rj n XWd | j | XWn t k
r n Xt j j
t j d d S( s
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.
iNR" i t WINDIR( t _winregt ImportErrort OpenKeyt HKEY_CURRENT_USERt MSFolderst QueryValueExt OSErrort CloseKeyt ost patht joint environ( R( t user( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt win32FontDirectory s
R# c C s d d l } | d k r$ t } n t | } d i } } xt D]{} y | j | j | } Wn t k
ry qD n X| s g } x7 | D]/ } | j t j t
j j | d | q W| Sz x t
| j | d D] } y | j | | \ } }
} t
j j |
s/t
j j | |
}
n t
j j |
j }
t
j j |
d d | k rtd | |
-
c sy g f d } x] t D]U } y/ t j j | rP t j j | | d n Wq t t t t f k
rp q Xq W S( s
Return the system font directories for OS X. This is done by
starting at the list of hardcoded paths in
:attr:`OSXFontDirectories` and returning all nested directories
within them.
c s j | d S( N( t append( t argRE RJ ( t fontpaths( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt add s N(
t OSXFontDirectoriesR0 R1 t isdirt walkR6 t IOErrorR. t TypeErrort
ValueError( RS RH ( ( RR sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt OSXFontDirectory s
c C s | d k r t } n t | } g } x | D] } | d k rk | j t j t j j | d q1 xf | D]^ } | j t j t j j | d | | j t j t j j | d | j qr Wq1 W| S( sJ
Get list of font files on OS X - ignores font suffix by default.
t *s *.N( R6 RZ R& R9 R: R0 R1 R2 t upper( RE R% RJ R1 RK ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt OSXInstalledFonts s
(
)7c sy g f d } x] t D]U } y/ t j j | rP t j j | | d n Wq t t t t f k
rp q Xq W S( s
Return the system font directories for X11. This is done by
starting at the list of hardcoded paths in
:attr:`X11FontDirectories` and returning all nested directories
within them.
c s j | d S( N( RP ( RQ RE RJ ( RR ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyRS s N(
t X11FontDirectoriesR0 R1 RU RV R6 RW R. RX RY ( RS RH ( ( RR sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt x11FontDirectory
s
c C s t | } i } y5 t j d d d g d t j } | j d } Wn t k
r[ | SX| j d k r xl | j d D]X } | j d d } t j j
| d d | k r{ t j j | r{ d | | ( R R0 R1 t basenameRo R R R R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt __repr__ s $( t __name__t
__module__t __doc__R R ( ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR x s
c C sa | j } | j } | j d } | j d } | rH | j } n d } | rc | j } n d } | j d d k r d } n[ | j d d k r d } n= | j d d k r d } n | j t j @r d } n d } | j d k r d } n d } d } x3 t j
D]% } | j | d k r| } PqqW| sg| j t j @r^d } qgd
} n t | } | j d d k s| j d d k s| j d d k rd } nW | j d d k rd } n9 | j d d k s| j d d k r d } n d } | j
r$d }
n t t | j }
d } t | j | | | | | |
S( s
A function for populating the :class:`FontKey` by extracting
information from the TrueType font file.
*font* is a :class:`FT2Font` instance.
i i i i R` t obliquet italicR R t capitalss
small-capsi i t narrowR
t conds demi conds semi-condensedt wideR t scalable( i i i i ( i i i i ( R s
small-capsN( t family_namet get_sfntt getR@ t findt style_flagsR t ITALICR6 R} RD t BOLDR R Rw R t get_fontsizeR Ro ( t fontR t sfntt sfnt2t sfnt4R R R t wR R t size_adjust( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt ttfFontProperty sZ * *
c
C s~ | j } | j j } | j d k sK | j j d d k rT d } n* | j j d d k rx d } n d } | j d k r d } n d } t | j j } | j d d k s | j d d k s | j d d k r d } nW | j d
d k r d } n9 | j d d k sG| j d
d k rPd
} n d } d } d } t | | | | | | | S( s
A function for populating a :class:`FontKey` instance by
extracting information from the AFM font file.
*font* is a class:`AFM` instance.
i R R R R s
small-capsR R
R s demi conds semi-condensedR R R ( s capitalss
small-capsN( t get_familynamet get_fontnameR@ t get_angleR R t
get_weightR6 R (
t fontpathR R t fontnameR R R R R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt afmFontProperty s, - * * c C s g } i } x{| D]s} t j d | d t j j | d } | | k rU q n
d | | <| d k r y t | d } Wn t j d | q n Xy% z t j | } Wd | j XWn% t k
r t j d | q n Xt
| | } n~ y t j t
| } WnE t k
r;t j d | q n! t k
r[t j d q n Xy t | } Wn
q n X| j | q W| S(
s
A function to create a font lookup list. The default is to create
a list of TrueType fonts. An AFM font list can optionally be
created.
s createFontDict: %st debugi R t rs Could not open font file %sNs Could not parse font file %ss Cannot handle unicode filenames( t verboset reportR0 R1 Ri t openR t AFMt closet RuntimeErrorR R t FT2FontRw t UnicodeErrorR RP ( Rk R% t fontlistt seent fpathRo t fhR t prop( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt createFontList8 sH
t FontPropertiesc B s e Z d Z d d d d d d d d d Z d Z d Z d Z d Z d Z d Z
e
Z d Z d Z
d
Z d Z d Z d
Z d Z d Z e Z d Z e Z d Z d Z d Z d Z d Z d Z d Z RS( s
A class for storing and manipulating font properties.
The font properties are those described in the `W3C Cascading
Style Sheet, Level 1
`_ font
specification. The six properties are:
- family: A list of font names in decreasing order of priority.
The items may include a generic font family name, either
'serif', 'sans-serif', 'cursive', 'fantasy', or 'monospace'.
In that case, the actual font to be used will be looked up
from the associated rcParam in :file:`matplotlibrc`.
- style: Either 'normal', 'italic' or 'oblique'.
- variant: Either 'normal' or 'small-caps'.
- 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'
- 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'
- size: Either an relative value of 'xx-small', 'x-small',
'small', 'medium', 'large', 'x-large', 'xx-large' or an
absolute font size, e.g. 12
The default font property for TrueType fonts (as specified in the
default :file:`matplotlibrc` file) is::
sans-serif, normal, normal, normal, normal, scalable.
Alternatively, a font may be specified using an absolute path to a
.ttf file, by using the *fname* kwarg.
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. See the documentation on `fontconfig patterns
`_. This support
does not require fontconfig to be installed. We are merely
borrowing its pattern syntax for use here.
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.
c C s) d | _ d | _ d | _ d | _ d | _ d | _ d | _ | d k rb | j j | j d St
| r | d k r | d k r | d k r | d k r | d k r | d k r | j | d Sn | j | | j
| | j | | j | | j | | j | | j | d S( N( R6 t _familyt _slantt _variantt _weightt _stretcht _sizet _filet __dict__t updateR t set_fontconfig_patternt
set_familyt set_stylet set_variantt
set_weightt set_stretcht set_filet set_size( R t familyR R R R R Ro t _init( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR s4
c C s
t | S( N( R ( R t pattern( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt _parse_fontconfig_pattern s c C sH g t | j D]" } | t | d | f ^ q } t t | S( NR ( t sortedR t getattrt hasht repr( R t kt l( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt __hash__ s 8c C s
| j S( N( t get_fontconfig_pattern( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt __str__ s c C s7 | j d k r0 t d } t | r, | g S| S| j S( sL
Return a list of font names that comprise the font family.
s font.familyN( R R6 R R ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt
get_family s
c C s t j t t | j S( s\
Return the name of the font that best matches the font
properties.
( R R Rw t findfontR ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_name s c C s | j d k r t d S| j S( s^
Return the font style. Values are: 'normal', 'italic' or
'oblique'.
s
font.styleN( R R6 R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_style s c C s | j d k r t d S| j S( sY
Return the font variant. Values are: 'normal' or
'small-caps'.
s font.variantN( R R6 R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_variant s c C s | j d k r t d S| j S( s
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'
s font.weightN( R R6 R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR s c C s | j d k r t d S| j S( s
Return the font stretch or width. Options are: 'ultra-condensed',
'extra-condensed', 'condensed', 'semi-condensed', 'normal',
'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'.
s font.stretchN( R R6 R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_stretch s c C s | j d k r t d S| j S( s'
Return the font size.
s font.sizeN( R R6 R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_size s c C sW | j d k r7 y t | j SWq7 t k
r3 q7 Xn t j } | t j | j S( N( R R6 R RY t fontManagert get_default_sizet
font_scalingsR ( R t default_size( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_size_in_points s
c C s | j S( s=
Return the filename of the associated font.
( R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt get_file! s c C s
t | S( s
Get a fontconfig pattern suitable for looking up the font as
specified with fontconfig's ``fc-match`` utility.
See the documentation on `fontconfig patterns
`_.
This support does not require fontconfig to be installed or
support for it to be enabled. We are merely borrowing its
pattern syntax for use here.
( R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR ' s c C s= | d k r d | _ n! t | r0 | g } n | | _ d S( s
Change the font family. May be either an alias (generic name
is CSS parlance), such as: 'serif', 'sans-serif', 'cursive',
'fantasy', or 'monospace', or a real font name.
N( R6 R R ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR 5 s
c C s( | d k r t d n | | _ d S( s[
Set the font style. Values are: 'normal', 'italic' or
'oblique'.
R R R s' style must be normal, italic or obliqueN( s normals italics obliqueN( R6 RY R ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR C s c C s( | d k r t d n | | _ d S( sN
Set the font variant. Values are: 'normal' or 'small-caps'.
R s
small-capss$ variant must be normal or small-capsN( s normals
small-capsN( R6 RY R ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR M s c C s | d k rr y4 t | } | d k s3 | d k r? t n Wqr t k
rn | t k ro t d qo qr Xn | | _ d S( s
Set the font weight. May be either 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'
i i s weight is invalidN( R6 t intRY R} R ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR U s
c C s | d k rr y4 t | } | d k s3 | d k r? t n Wqr t k
rn | t k ro t d qo qr Xn | | _ d S( s
Set the font stretch or width. Options are: 'ultra-condensed',
'extra-condensed', 'condensed', 'semi-condensed', 'normal',
'semi-expanded', 'expanded', 'extra-expanded' or
'ultra-expanded', or a numeric value in the range 0-1000.
i i s stretch is invalidN( R6 R RY t stretch_dictR ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR f s
c C sg | d k rZ y t | } WqZ t k
rV | d k rW | t k rW t d qW qZ Xn | | _ d S( s
Set the font size. Either an relative value of 'xx-small',
'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'
or an absolute font size, e.g. 12.
s size is invalidN( R6 R RY R R ( R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR w s
c C s
| | _ d S( sw
Set the filename of the fontfile to use. In this case, all
other properties will be ignored.
N( R ( R Ra ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR s c C sq xj | j | j D]S \ } } t | t k rR t | d | | d q t | d | | q Wd S( sg
Set the properties by parsing a fontconfig *pattern*.
See the documentation on `fontconfig patterns
`_.
This support does not require fontconfig to be installed or
support for it to be enabled. We are merely borrowing its
pattern syntax for use here.
t set_i N( R RG t typet listR ( R R RF t val( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR s " c C s
t d | S( s Return a deep copy of selfR ( R ( R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt copy s N( R R R R6 R R R R R R R t get_slantR R R R R R R R t set_nameR t set_slantR R R R R R R ( ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR f sD 9 #
c C s g } x | j D] } x} | j D]o } xf | j D]X } xO | j D]A } x8 | j D]* } x! | j D] } | j | qr Wq_ WqL Wq9 Wq& Wq W| S( s<
flatten a ttfdict to all the filenames it contains
( t valuesRP ( t dt fnamest namedt styledt variantdt weightdt stretchdRo ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt ttfdict_to_fnames s %c C s5 t | d } z t j | | Wd | j Xd S( su
Equivalent to pickle.dump(data, open(filename, 'w'))
but closes the file to prevent filehandle leakage.
R N( R t picklet dumpR ( t datat filenameR ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt pickle_dump s c C s4 t | d } z t j | } Wd | j X| S( so
Equivalent to pickle.load(open(filename, 'r'))
but closes the file to prevent filehandle leakage.
R N( R R t loadR ( R R R ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyt pickle_load s
t FontManagerc B s e Z d Z d Z d d d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
d Z d
Z d d e e d Z RS( s}
On import, the :class:`FontManager` singleton instance creates a
list of TrueType fonts based on the font properties: name, style,
variant, weight, stretch, and size. The :meth:`findfont` method
does a nearest neighbor search to find the font that most closely
matches the specification. If no good enough match is found, a
default font is returned.
i R c C s2 | j | _ | | _ | | _ t j j t d d d t j j t d d d t j j t d d d g } x d d g D] } | t j k r| t j | } | j d d k r | j
| j d q
| j d
d k r | j
| j d
q
| j | q| q| Wt
j d t | t | t | _ i d d 6d
d 6| _ i | _ xe | j D]F } t
j d | d | j j d d k re| | j d t" j# d | j | j$ | f | j% } | j& | j$ | | j' | | | t( St" j# d | | j) | f t* | j) | } n, t j d | | j | j |
f | j } t j
j+ | s| rt j d
t, t- j' | | | t. t( St/ d n | d k r| | t | `_ documentation
for a description of the font finding algorithm.
s findfont returning %sR R g?O8Mg $@i s6 findfont: Font family %s not found. Falling back to %ss* findfont: Could not match %s. Returning %ss1 findfont: Matching %s to %s (%s) with score of %fs7 findfont: Found a missing font file. Rebuilding cache.s No valid font could be foundN(0 Rv R R R6 R R R R R R R R R0 R1 t commonprefixRo R' R R R* R R R- R R R8 R R R3 R R R= R R t warningst warnR R R R t FalseR t UserWarningt isfilet _rebuildR t TrueRY ( R R R% RE t fallback_to_defaultt rebuild_if_missingRo t
font_cacheR t cachedt
best_scoret best_fontR t scoret default_propt result( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR sp
! N( R R R R
R6 R R R R R R' R* R- R3 R8 R= RE R ( ( ( sJ /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/font_manager.pyR s 1
c C s t j j | d j d k r t j | } | d k r~ t | d } | j d } | j | d k } | t | s <
- , ^ C . < 6