Load fonts and render text.

This is a fairly-low level interface to text rendering. Obtain a font using load():

from pyglet import font
arial = font.load('Arial', 14, bold=True, italic=False)

Manually loading fonts is only required in the following situations:

  • When manually rendering fonts;
  • When using the deprecated font rendering in pyglet.font.text.

You are encouraged to use pyglet.text for actual text rendering. Classes in this module will handle font loading for you, so manual loading is not required.

pyglet will automatically load any system-installed fonts. You can add additional fonts (for example, from your program resources) using add_file() or add_directory(). These fonts are then available in the same way as system-installed fonts:

from pyglet import font
action_man = font.load('Action Man', 16)

See the pyglet.font.base module for documentation on the base classes used by this package.

class Text(font, text='', x=0, y=0, z=0, color=(1, 1, 1, 1), width=None, halign='left', valign='baseline')

Simple displayable text.

This is a convenience class for rendering strings of text. It takes care of caching the vertices so the text can be rendered every frame with little performance penalty.

Text can be word-wrapped by specifying a width to wrap into. If the width is not specified, it gives the width of the text as laid out.


Deprecated. Use pyglet.text.Label.

BASELINE = 'baseline'
BOTTOM = 'bottom'
CENTER = 'center'
LEFT = 'left'
RIGHT = 'right'
TOP = 'top'

Horizontal alignment of the text.

The text is positioned relative to x and width according to this property, which must be one of the alignment constants LEFT, CENTER or RIGHT.


Height of the text.

This property is the ascent minus the descent of the font, unless there is more than one line of word-wrapped text, in which case the height takes into account the line leading. Read-only.


Vertical space between adjacent lines, in pixels.


Vertical distance between adjacent baselines, in pixels.


Text to render.

The glyph vertices are only recalculated as needed, so multiple changes to the text can be performed with no performance penalty.


Vertical alignment of the text.

The text is positioned relative to y according to this property, which must be one of the alignment constants BOTTOM, BASELINE, CENTER or TOP.


Width of the text.

When set, this enables word-wrapping to the specified width. Otherwise, the width of the text as it will be rendered can be determined.


X coordinate of the text


Y coordinate of the text


Add a font to pyglet’s search path.

In order to load a font that is not installed on the system, you must call this method to tell pyglet that it exists. You can supply either a filename or any file-like object.

The font format is platform-dependent, but is typically a TrueType font file containing a single font face. Note that to use a font added with this method, you should pass the face name (not the file name) to :meth:pyglet.font.load() or any other place where you normally specify a font.

Parameters:font (str or file-like object) – Filename or file-like object to load fonts from.

Add a directory of fonts to pyglet’s search path.

This function simply calls pyglet.font.add_file() for each file with a .ttf extension in the given directory. Subdirectories are not searched.

Parameters:dir (str) – Directory that contains font files.
load(name=None, size=None, bold=False, italic=False, dpi=None)

Load a font for rendering.

  • name (str, or list of str) – Font family, for example, “Times New Roman”. If a list of names is provided, the first one matching a known font is used. If no font can be matched to the name(s), a default font is used. In pyglet 1.1, the name may be omitted.
  • size (float) – Size of the font, in points. The returned font may be an exact match or the closest available. In pyglet 1.1, the size may be omitted, and defaults to 12pt.
  • bold (bool) – If True, a bold variant is returned, if one exists for the given family and size.
  • italic (bool) – If True, an italic variant is returned, if one exists for the given family and size.
  • dpi (float) – The assumed resolution of the display device, for the purposes of determining the pixel size of the font. Defaults to 96.
Return type:



Check if specified system font name is available.

Previous topic


Next topic