• 文本属性及布局

    文本属性及布局

    原文：Text properties and layout

    译者：飞龙

    协议：CC BY-NC-SA 4.0

    matplotlib.text.Text实例有各种属性，可以通过关键字参数配置文本命令（例如，title()，xlabel()和text()）。

    属性 值类型
    alpha 浮点
    backgroundcolor 任何 matplotlib 颜色
    bbox rectangle prop dict plus key ‘pad’ which is a pad in points
    clip_box matplotlib.transform.Bbox 实例
    clip_on [True / False]
    clip_path Path，Transform或Patch 实例
    color 任何 matplotlib 颜色
    family [ 'serif' / 'sans-serif' / 'cursive' / 'fantasy' / 'monospace' ]
    fontproperties matplotlib.font_manager.FontProperties 实例
    horizontalalignment or ha [ 'center' / 'right' / 'left' ]
    label 任何字符串
    linespacing 浮点
    multialignment ['left' / 'right' / 'center' ]
    name or fontname 字符串，例如 ['Sans' / 'Courier' / 'Helvetica' ...]
    picker [None / 浮点 / 布尔值 / 可调用对象]`
    position (x,y)
    rotation [ 角度制的角度 / ‘vertical’ / ‘horizontal’
    size or fontsize [ 点的尺寸 相对尺寸，例如 ['smaller', 'x-large' ]
    style or fontstyle [ 'normal' / 'italic' / 'oblique']
    text 字符串或任何可使用'%s'打印的东西
    transform matplotlib.transform 实例
    variant [ 'normal' / 'small-caps' ]
    verticalalignment or va [ 'center' / 'top' / 'bottom' / 'baseline' ]
    visible [True / False]
    weight or fontweight [ 'normal' / 'bold' / 'heavy' / 'light' / 'ultrabold' / 'ultralight']
    x 浮点
    y 浮点
    zorder 任意数值

    你可以使用对齐参数horizontalalignment，verticalalignment和multialignment来布置文本。 horizontalalignment控制文本的x位置参数表示文本边界框的左边，中间或右边。 verticalalignment控制文本的y位置参数表示文本边界框的底部，中心或顶部。 multialignment，仅对于换行符分隔的字符串，控制不同的行是左，中还是右对齐。 这里是一个使用text()命令显示各种对齐方式的例子。 在整个代码中使用transform = ax.transAxes，表示坐标相对于轴边界框给出，其中0,0是轴的左下角，1,1是右上角。

    1. import matplotlib.pyplot as plt
    2. import matplotlib.patches as patches
    4. # build a rectangle in axes coords
    5. left, width = .25, .5
    6. bottom, height = .25, .5
    7. right = left + width
    8. top = bottom + height
    10. fig = plt.figure()
    11. ax = fig.add_axes([0,0,1,1])
    13. # axes coordinates are 0,0 is bottom left and 1,1 is upper right
    14. p = patches.Rectangle(
    15.     (left, bottom), width, height,
    16.     fill=False, transform=ax.transAxes, clip_on=False
    17.     )
    19. ax.add_patch(p)
    21. ax.text(left, bottom, 'left top',
    22.         horizontalalignment='left',
    23.         verticalalignment='top',
    24.         transform=ax.transAxes)
    26. ax.text(left, bottom, 'left bottom',
    27.         horizontalalignment='left',
    28.         verticalalignment='bottom',
    29.         transform=ax.transAxes)
    31. ax.text(right, top, 'right bottom',
    32.         horizontalalignment='right',
    33.         verticalalignment='bottom',
    34.         transform=ax.transAxes)
    36. ax.text(right, top, 'right top',
    37.         horizontalalignment='right',
    38.         verticalalignment='top',
    39.         transform=ax.transAxes)
    41. ax.text(right, bottom, 'center top',
    42.         horizontalalignment='center',
    43.         verticalalignment='top',
    44.         transform=ax.transAxes)
    46. ax.text(left, 0.5*(bottom+top), 'right center',
    47.         horizontalalignment='right',
    48.         verticalalignment='center',
    49.         rotation='vertical',
    50.         transform=ax.transAxes)
    52. ax.text(left, 0.5*(bottom+top), 'left center',
    53.         horizontalalignment='left',
    54.         verticalalignment='center',
    55.         rotation='vertical',
    56.         transform=ax.transAxes)
    58. ax.text(0.5*(left+right), 0.5*(bottom+top), 'middle',
    59.         horizontalalignment='center',
    60.         verticalalignment='center',
    61.         fontsize=20, color='red',
    62.         transform=ax.transAxes)
    64. ax.text(right, 0.5*(bottom+top), 'centered',
    65.         horizontalalignment='center',
    66.         verticalalignment='center',
    67.         rotation='vertical',
    68.         transform=ax.transAxes)
    70. ax.text(left, top, 'rotated\nwith newlines',
    71.         horizontalalignment='center',
    72.         verticalalignment='center',
    73.         rotation=45,
    74.         transform=ax.transAxes)
    76. ax.set_axis_off()
    77. plt.show()

    文本属性及布局 - 图1