1
1
"""
2
2
A module for finding, managing, and using fonts across platforms.
3
3
4
- This module provides a single :class: `FontManager` instance that can
5
- be shared across backends and platforms. The :func: `findfont`
4
+ This module provides a single `FontManager` instance that can
5
+ be shared across backends and platforms. The `findfont`
6
6
function returns the best TrueType (TTF) font file in the local or
7
- system font path that matches the specified :class: `FontProperties`
8
- instance. The :class: `FontManager` also handles Adobe Font Metrics
7
+ system font path that matches the specified `FontProperties`
8
+ instance. The `FontManager` also handles Adobe Font Metrics
9
9
(AFM) font files for use by the PostScript backend.
10
10
11
11
The design is based on the `W3C Cascading Style Sheet, Level 1 (CSS1)
@@ -569,29 +569,29 @@ class FontProperties:
569
569
<http://www.w3.org/TR/1998/REC-CSS2-19980512/>`_ font
570
570
specification. The six properties are:
571
571
572
- - family: A list of font names in decreasing order of priority.
573
- The items may include a generic font family name, either
574
- 'serif', 'sans-serif', 'cursive', 'fantasy', or 'monospace'.
575
- In that case, the actual font to be used will be looked up
576
- from the associated rcParam.
572
+ - family: A list of font names in decreasing order of priority.
573
+ The items may include a generic font family name, either
574
+ 'serif', 'sans-serif', 'cursive', 'fantasy', or 'monospace'.
575
+ In that case, the actual font to be used will be looked up
576
+ from the associated rcParam.
577
577
578
- - style: Either 'normal', 'italic' or 'oblique'.
578
+ - style: Either 'normal', 'italic' or 'oblique'.
579
579
580
- - variant: Either 'normal' or 'small-caps'.
580
+ - variant: Either 'normal' or 'small-caps'.
581
581
582
- - stretch: A numeric value in the range 0-1000 or one of
583
- 'ultra-condensed', 'extra-condensed', 'condensed',
584
- 'semi-condensed', 'normal', 'semi-expanded', 'expanded',
585
- 'extra-expanded' or 'ultra-expanded'
582
+ - stretch: A numeric value in the range 0-1000 or one of
583
+ 'ultra-condensed', 'extra-condensed', 'condensed',
584
+ 'semi-condensed', 'normal', 'semi-expanded', 'expanded',
585
+ 'extra-expanded' or 'ultra-expanded'.
586
586
587
- - weight: A numeric value in the range 0-1000 or one of
588
- 'ultralight', 'light', 'normal', 'regular', 'book', 'medium',
589
- 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy',
590
- 'extra bold', 'black'
587
+ - weight: A numeric value in the range 0-1000 or one of
588
+ 'ultralight', 'light', 'normal', 'regular', 'book', 'medium',
589
+ 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy',
590
+ 'extra bold', 'black'.
591
591
592
- - size: Either an relative value of 'xx-small', 'x-small',
593
- 'small', 'medium', 'large', 'x-large', 'xx-large' or an
594
- absolute font size, e.g., 12
592
+ - size: Either an relative value of 'xx-small', 'x-small',
593
+ 'small', 'medium', 'large', 'x-large', 'xx-large' or an
594
+ absolute font size, e.g., 12.
595
595
596
596
The default font property for TrueType fonts (as specified in the
597
597
default rcParams) is ::
0 commit comments