You are reading an old version of the documentation (v3.0.2). For the latest version see
Version 3.0.2
Fork me on GitHub

Table of Contents


matplotlib.pyplot.figtext(x, y, s, *args, **kwargs)[source]

Add text to figure.

x, y : float

The position to place the text. By default, this is in figure coordinates, floats in [0, 1]. The coordinate system can be changed using the transform keyword.

s : str

The text string.

fontdict : dictionary, optional, default: None

A dictionary to override the default text properties. If fontdict is None, the defaults are determined by your rc parameters. A property in kwargs override the same property in fontdict.

withdash : boolean, optional, default: False

Creates a TextWithDash instance instead of a Text instance.

text : Text
Other Parameters:
**kwargs : Text properties

Other miscellaneous text parameters.

Property Description
agg_filter a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array
alpha float
animated bool
backgroundcolor color
bbox dict with properties for patches.FancyBboxPatch
clip_box matplotlib.transforms.Bbox
clip_on bool
clip_path { (path.Path, transforms.Transform), patches.Patch, None }
color color
contains callable
figure Figure
fontfamily {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties font_manager.FontProperties
fontsize {size in points, 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch {a numeric value in range 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle {'normal', 'italic', 'oblique'}
fontvariant {'normal', 'small-caps'}
fontweight {a numeric value in range 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid str
horizontalalignment {'center', 'right', 'left'}
in_layout bool
label object
linespacing float (multiple of font size)
multialignment {'left', 'right', 'center'}
path_effects AbstractPathEffect
picker None or bool or float or callable
position (float, float)
rasterized bool or None
rotation {angle in degrees, 'vertical', 'horizontal'}
rotation_mode {None, 'default', 'anchor'}
sketch_params (scale: float, length: float, randomness: float)
snap bool or None
text string or object castable to string (but None becomes '')
transform Transform
url str
usetex bool or None
verticalalignment {'center', 'top', 'bottom', 'baseline', 'center_baseline'}
visible bool
wrap bool
x float
y float
zorder float

Examples using matplotlib.pyplot.figtext