文本属性和布局

使用 Matplotlib 控制文本及其布局的属性。

matplotlib.text.Text 实例有多种属性，可以通过关键字参数配置，如 set_title、set_xlabel、text 等。

属性	值类型
alpha	float
backgroundcolor	任何 matplotlib 颜色
bbox	Rectangle prop dict 加一个键 'pad'，表示点的填充
clip_box	matplotlib.transform.Bbox 实例
clip_on	bool
clip_path	Path 实例和一个 Transform 实例，一个 Patch
color	任何 matplotlib 颜色
family	[ 'serif' | 'sans-serif' | 'cursive' | 'fantasy' | 'monospace' ]
fontproperties	FontProperties
horizontalalignment 或 ha	[ 'center' | 'right' | 'left' ]
label	任何字符串
linespacing	float
multialignment	['left' | 'right' | 'center' ]
name 或 fontname	字符串，例如，['Sans' | 'Courier' | 'Helvetica' ...]
picker	[None|float|bool|callable]
position	(x, y)
rotation	[角度（以度为单位） | 'vertical' | 'horizontal' ]
size 或 fontsize	[以点为单位的大小 | 相对大小，例如，'smaller'、'x-large' ]
style 或 fontstyle	[ 'normal' | 'italic' | 'oblique' ]
text	字符串或任何可以用 '%s' 转换打印的内容
transform	Transform 子类
variant	[ 'normal' | 'small-caps' ]
verticalalignment 或 va	[ 'center' | 'top' | 'bottom' | 'baseline' ]
visible	bool
weight 或 fontweight	[ 'normal' | 'bold' | 'heavy' | 'light' | 'ultrabold' | 'ultralight']
x	float
y	float
zorder	任何数字

您可以使用对齐参数 horizontalalignment、verticalalignment 和 multialignment 来布局文本。horizontalalignment 控制文本的 x 位置参数是指文本边界框的左侧、中心还是右侧。verticalalignment 控制文本的 y 位置参数是指文本边界框的底部、中心还是顶部。multialignment（仅适用于换行分隔的字符串）控制不同的行是左对齐、居中对齐还是右对齐。这是一个示例，它使用 text() 命令来显示各种对齐可能性。整个代码中使用 transform=ax.transAxes 表示坐标是相对于坐标轴边界框给定的，其中 (0, 0) 是坐标轴的左下角，(1, 1) 是右上角。

import matplotlib.pyplot as plt

import matplotlib.patches as patches

# build a rectangle in axes coords
left, width = .25, .5
bottom, height = .25, .5
right = left + width
top = bottom + height

fig = plt.figure()
ax = fig.add_axes([0, 0, 1, 1])

# axes coordinates: (0, 0) is bottom left and (1, 1) is upper right
p = patches.Rectangle(
    (left, bottom), width, height,
    fill=False, transform=ax.transAxes, clip_on=False
    )

ax.add_patch(p)

ax.text(left, bottom, 'left top',
        horizontalalignment='left',
        verticalalignment='top',
        transform=ax.transAxes)

ax.text(left, bottom, 'left bottom',
        horizontalalignment='left',
        verticalalignment='bottom',
        transform=ax.transAxes)

ax.text(right, top, 'right bottom',
        horizontalalignment='right',
        verticalalignment='bottom',
        transform=ax.transAxes)

ax.text(right, top, 'right top',
        horizontalalignment='right',
        verticalalignment='top',
        transform=ax.transAxes)

ax.text(right, bottom, 'center top',
        horizontalalignment='center',
        verticalalignment='top',
        transform=ax.transAxes)

ax.text(left, 0.5*(bottom+top), 'right center',
        horizontalalignment='right',
        verticalalignment='center',
        rotation='vertical',
        transform=ax.transAxes)

ax.text(left, 0.5*(bottom+top), 'left center',
        horizontalalignment='left',
        verticalalignment='center',
        rotation='vertical',
        transform=ax.transAxes)

ax.text(0.5*(left+right), 0.5*(bottom+top), 'middle',
        horizontalalignment='center',
        verticalalignment='center',
        fontsize=20, color='red',
        transform=ax.transAxes)

ax.text(right, 0.5*(bottom+top), 'centered',
        horizontalalignment='center',
        verticalalignment='center',
        rotation='vertical',
        transform=ax.transAxes)

ax.text(left, top, 'rotated\nwith newlines',
        horizontalalignment='center',
        verticalalignment='center',
        rotation=45,
        transform=ax.transAxes)

ax.set_axis_off()
plt.show()

默认字体

基本默认字体由一组 rcParams 控制。要设置数学表达式的字体，请使用以 mathtext 开头的 rcParams（请参阅 mathtext）。

rcParam	用法
'font.family'	字体系列（安装在用户计算机上）和/或 {'cursive', 'fantasy', 'monospace', 'sans', 'sans serif', 'sans-serif', 'serif'} 的列表。
'font.style'	默认样式，例如 'normal'、'italic'。
'font.variant'	默认变体，例如 'normal'、'small-caps'（未经测试）
'font.stretch'	默认拉伸，例如 'normal'、'condensed'（不完整）
'font.weight'	默认粗细。字符串或整数
'font.size'	默认字体大小（以点为单位）。相对字体大小（'large'、'x-small'）是根据此大小计算的。

Matplotlib 可以使用安装在用户计算机上的字体系列，例如 Helvetica、Times 等。字体系列也可以使用通用系列别名来指定，如（{'cursive', 'fantasy', 'monospace', 'sans', 'sans serif', 'sans-serif', 'serif'}）。

注意

要访问可用字体的完整列表

matplotlib.font_manager.get_font_names()

通用系列别名和实际字体系列之间的映射（在 默认 rcParams 中提到）由以下 rcParams 控制

基于 CSS 的通用系列别名	带有映射的 rcParam
'serif'	'font.serif'
'monospace'	'font.monospace'
'fantasy'	'font.fantasy'
'cursive'	'font.cursive'
{'sans', 'sans serif', 'sans-serif'}	'font.sans-serif'

如果任何通用系列名称出现在 'font.family' 中，我们会将该条目替换为相应的 rcParam 映射中的所有条目。例如

matplotlib.rcParams['font.family'] = ['Family1', 'serif', 'Family2']
matplotlib.rcParams['font.serif'] = ['SerifFamily1', 'SerifFamily2']

# This is effectively translated to:
matplotlib.rcParams['font.family'] = ['Family1', 'SerifFamily1', 'SerifFamily2', 'Family2']

带有非拉丁字形的文本

从 v2.0 开始，默认字体 DejaVu 包含许多西方字母的字形，但不包含其他文字，例如中文、韩文或日文。

要将默认字体设置为支持您需要的代码点的字体，请将字体名称添加到 'font.family' 之前（推荐），或添加到所需的别名列表中。

# first method
matplotlib.rcParams['font.family'] = ['Source Han Sans TW', 'sans-serif']

# second method
matplotlib.rcParams['font.family'] = ['sans-serif']
matplotlib.rcParams['sans-serif'] = ['Source Han Sans TW', ...]

通用字体系列别名列表包含与 Matplotlib 一起发布的字体（因此它们有 100% 的机会被找到），或者是在大多数系统中很可能存在的字体。

设置自定义字体系列时，一个好的做法是将通用字体添加到字体系列列表的末尾作为最后的选择。

您也可以在您的 .matplotlibrc 文件中设置它

font.family: Source Han Sans TW, Arial, sans-serif

要控制每个艺术家使用的字体，请使用 文本属性和布局 中记录的name、fontname 或 fontproperties 关键字参数。

在 Linux 上，fc-list 可以成为发现字体名称的有用工具；例如

$ fc-list :lang=zh family
Noto to Sans Mono CJK TC,Noto Sans Mono CJK TC Bold
Noto Sans CJK TC,Noto Sans CJK TC Medium
Noto Sans CJK TC,Noto Sans CJK TC DemiLight
Noto Sans CJK KR,Noto Sans CJK KR Black
Noto Sans CJK TC,Noto Sans CJK TC Black
Noto Sans Mono CJK TC,Noto Sans Mono CJK TC Regular
Noto Sans CJK SC,Noto Sans CJK SC Light

列出所有支持中文的字体。