20. ImageDraw text
20.1. Text
Use the ImageDraw.text() method to draw the string at the given position.
- ImageDraw.text(xy, text, fill=None, font=None, anchor=None, spacing=4, align='left', direction=None, features=None, language=None, stroke_width=0, stroke_fill=None, embedded_color=False)
- xy - The anchor coordinates of the text.text - String to be drawn. If it contains any newline characters, the text is passed on to multiline_text().fill - Color to use for the text.font - An ImageFont instance.anchor - The text anchor alignment determines the relative location of the anchor to the text. The default alignment is top left. This parameter is ignored for non-TrueType fonts.spacing - If the text is passed on to multiline_text(), the number of pixels between lines.align - If the text is passed on to multiline_text(), “left”, “center” or “right”. Determines the relative alignment of lines. Use the anchor parameter to specify the alignment to xy.direction - Direction of the text. It can be “rtl” (right to left), “ltr” (left to right) or “ttb” (top to bottom). Requires libraqm.features - A list of OpenType font features to be used during text layout. This is usually used to turn on optional font features that are not enabled by default, for example “dlig” or “ss01”, but can be also used to turn off default font features, for example “-liga” to disable ligatures or “-kern” to disable kerning. To get all supported features, see OpenType docs. Requires libraqm.language - Language of the text. Different languages may use different glyph shapes or ligatures. This parameter tells the font which language the text is in, and to apply the correct substitutions as appropriate, if available. It should be a BCP 47 language code. Requires libraqm.stroke_width - The width of the text stroke.stroke_fill - Color to use for the text stroke. If not given, will default to the fill parameter.embedded_color - Whether to use font embedded color glyphs (COLR, CBDT, SBIX).
The code below draws test at the top left of the image.
from PIL import Image, ImageDraw, ImageFont
font = ImageFont.truetype('C:/Windows/Fonts/Segoeui.ttf', 24)
with Image.open("test_images/shapes.jpg") as im:
drw = ImageDraw.Draw(im)
text = "Shapes"
drw.text((2, 0), text=text, font=font, fill=(0, 0, 255))
im.save("ImageDraw/ImageDraw_text.png")
# im.show()
