apply_font_style(font, style)

apply_font_style (font, style) -> None

Applies font rendering styles to a Font.

create_file_font(fontfile, size, style=0)

create_file_font (...) -> Font

Creates a new font from a given font file.

The 'fontfile' is the path to a font file or a python file-like object. The resulting pygame.Font will have the specified height 'size' in pixels. Additional styles can be passed to give the font a bold, italic, or underlined style. The 'styles' attribute must be a valid combination of the FONT_STYLE_TYPES.

The font will be cached internally, so it can be reused without creating it again and again. This also means, that any operation, which will modify the pygame.Font() object, will also be applied to the cached one. It is possible to avoid this by copying the font object using font.copy().

The following example will try to load a font with a height of 14 pixels from a subdirectory:

create_file_font ('fonts/MyFont.ttf', 14)

create_font(font, size, style=0)

create_font (...) -> Font

Wraps the create_file_font() and create_system_font() methods.

create_system_font(fontname, size, style=0)

create_system_font (...) -> Font

Creates a new font from a given font name of the system fonts.

The 'fontname' is a valid system font name of an installed font. The resulting pygame.Font will have the specified height 'size' in pixels. Additional styles can be passed to give the font a bold, italic, or underlined style. The 'styles' attribute must be a valid combination of the FONT_STYLE_TYPES.

The font will be cached internally, so it can be reused without creating it again and again. This also means, that any operation, which will modify the pygame.Font() object, will also be applied to the cached one. It is possible to avoid this by copying the font object using font.copy(). This will always return a valid Font object, and will fallback on the builtin pygame font if the given font is not found.

The following example will try to load a font with a height of 14:

create_system_font ('Helvetica', 14)

draw_string(text, font, size, antialias, color, style=0)

draw_string (...) -> Surface

Creates a surface displaying a string.

'text' is the text, which should be renderered to a surface. 'font' can be any valid font name of the system fonts or a font file (see the note). The 'size' is the height of the font in pixels, 'alias' is an integer value, which enables or disables antialiasing of the font, and 'color' is a pygame color style argument for the text. Additional styles can be passed to give the font a bold, italic, or underlined style. The 'styles' attribute must be a valid combination of the FONT_STYLE_TYPES.

The following example will create an antialiased string surface with a black font color and tries to use an installed 'Helvetica' font:

draw_string ('Test', 'Helvetica', 14, 1, (0, 0, 0))

draw_string_with_bg(text, font, size, antialias, color, bgcolor, style=0)

draw_string_with_bg (...) -> Surface

Creates a surface displaying a atring.

'text' is the text, which should be renderered to a surface. 'font' can be any valid font name of the system fonts or a font file (see the note). The 'size' is the height of the font in pixels, 'alias' is an integer value, which enables or disables antialiasing of the font, and 'color' is a pygame color style argument for the text. The Surface will be filled with the passed background color 'bgcolor' Additional styles can be passed to give the font a bold, italic, or underlined style. The 'styles' attribute must be a valid combination of the FONT_STYLE_TYPES.

The following example will create an antialiased string surface with a black font color and white background color and tries to use an installed 'Helvetica' font:

draw_string ('Test', 'Helvetica', 14, 1, (0, 0, 0), (255, 255, 255))