Модуль pygame.freetype — замена для pygame.font. Он имеет все функциональные возможности оригинального, плюс множество новых функций. При этом он абсолютно не зависит от библиотеки SDL_ttf. Он реализован непосредственно на основе библиотеки FreeType 2. Модуль pygame.freetype несовместим с pygame.font в обратной перспективе. Вместо этого используйте модуль pygame.ftfont как прямую замену для pygame.font.

Все форматы файлов шрифтов, поддерживаемые FreeType, могут быть отрисованы модулем pygame.freetype, а именно TTF, Type1, CFF, OpenType, SFNT, PCF, FNT, BDF, и Type42 шрифты. Доступны все глифы с кодовыми точками UTF-32 (см. Font.ucs4).

Большая часть работы со шрифтами выполняется с помощью экземпляров Font. Сам модуль содержит только функции для инициализации и создания объектов Font. Вы можете загружать шрифты из системы, используя функцию SysFont().

Доступна дополнительная поддержка растровых шрифтов. Доступные размеры растровых шрифтов можно перечислить (см. Font.get_sizes()). Для растровых шрифтов Font может установить размер для вас (см. свойство Font.size).

На данный момент кодовые точки неопределенных символов заменяются на символ .notdef (не определен). Способ обработки неопределенных кодов может быть настраиваемым в будущих версиях.

В пакете Pygame есть встроенный шрифт по умолчанию. К нему всегда можно получить доступ, передав None в качестве имени шрифта конструктору Font.

Дополнительные функции отрисовки, доступные для pygame.freetype.Font, — это прямая отрисовка на поверхности (см. Font.render_to()), кернинг символов (см. Font.kerning), вертикальное выравнивание (см. Font.vertical), поворот отрисованного текста (см. Font.rotation), и сильный стиль (см. Font.strong). Некоторые свойства настраиваются, например, сила сильного стиля (см. Font.strength) и позиционирование подчеркивания (см. Font.underline_adjustment). Текст может быть размещен по верхнему правому углу текстового поля или по базовой линии текста (см. Font.origin). Наконец, размер шрифта по вертикали и горизонтали можно настраивать отдельно (см. Font.size). Пример pygame.examples.freetype_misc демонстрирует использование этих функций.

Пакет pygame не импортирует freetype автоматически при загрузке. Этот модуль необходимо импортировать явно для использования.

import pygame
import pygame.freetype

pygame.freetype.get_error()

Возвращает последнюю ошибку FreeType

get_error() -> str

get_error() -> None

Возвращает описание последней ошибки, произошедшей в библиотеке FreeType2, или None если ошибок не было.

pygame.freetype.get_version()

Возвращает версию FreeType

get_version(linked=True) -> (int, int, int)

Возвращает версию используемой библиотеки FreeType в этом модуле. По умолчанию linked=True, и возвращает связанную версию FreeType, а linked=False возвращает собранную версию FreeType.

Обратите внимание, что модуль freetype зависит от библиотеки FreeType 2. Он не будет компилироваться с оригинальной FreeType 1.0. Поэтому первый элемент кортежа всегда будет "2".

Изменено в pygame 2.2.0: linked аргумент добавлен, и поведение по умолчанию изменено с возврата скомпилированной версии на возвращение связанной версии

pygame.freetype.init()

Инициализирует базовый FreeType.

init(cache_size=64, resolution=72) -> None

Эта функция инициализирует базовый FreeType и должна быть вызвана перед использованием любой функциональности модуля freetype.

Однако, pygame.init() автоматически вызовет эту функцию, если модуль freetype уже импортирован. Вызов этой функции несколько раз безопасен.

По желанию, можно указать размер кеша по умолчанию cache_size: максимальное количество глифов, которые будут кэшированы в модуле в любой момент времени. Очень маленькие значения будут автоматически настроены для производительности. Также можно указать значение по умолчанию для resolution (пикселей на дюйм) для настройки масштабирования шрифтов.

pygame.freetype.quit()

Закрывает базовый FreeType.

quit() -> None

Эта функция закрывает модуль freetype. После вызова этой функции вы не должны вызывать классы, методы или функции, относящиеся к модулю freetype, так как они могут завершиться сбоем или дать непредсказуемые результаты. Вызов этой функции безопасен даже если модуль еще не был инициализирован.

pygame.freetype.get_init()

Возвращает True, если модуль FreeType инициализирован.

get_init() -> bool

Возвращает True если модуль pygame.freetype в настоящее время инициализирован.

Новое в pygame 1.9.5.

pygame.freetype.was_init()

УСТАРЕЛО: Используйте get_init() вместо этого.

was_init() -> bool

УСТАРЕЛО: Возвращает True если модуль pygame.freetype в настоящее время инициализирован. Используйте get_init() вместо этого.

pygame.freetype.get_cache_size()

Возвращает размер кеша глифов

get_cache_size() -> long

См. pygame.freetype.init().

pygame.freetype.get_default_resolution()

Возвращает значение по умолчанию в точках на дюйм

get_default_resolution() -> long

Возвращает значение по умолчанию для пиксельного размера в точках на дюйм для модуля. По умолчанию 72 DPI.

pygame.freetype.set_default_resolution()

Устанавливает значение по умолчанию в точках на дюйм

set_default_resolution([resolution])

Устанавливает значение по умолчанию для пиксельного размера в точках на дюйм для модуля. Если необязательный аргумент опущен или равен нулю, разрешение сбрасывается до 72 DPI.

pygame.freetype.SysFont()

создание объекта шрифта из системных шрифтов

SysFont(name, size, bold=False, italic=False) -> Font

Возвращает новый объект шрифта, загруженный из системных шрифтов. Шрифт будет соответствовать запрошенным флагам жирности и курсива. Pygame использует небольшой набор общих псевдонимов шрифтов. Если конкретный запрашиваемый шрифт недоступен, может быть использована приемлемая альтернатива. Если подходящий системный шрифт не найден, будет использоваться стандартный шрифт pygame.

Имя шрифта name также может быть итерируемым объектом имен шрифтов, строкой с запятыми, разделяющими имена шрифтов, или байтами с запятыми, разделяющими имена шрифтов, в этом случае набор имён будет проверяться в порядке их перечисления.

New in pygame 2.0.1: Поддержка итерируемых объектов имен шрифтов.

pygame.freetype.get_default_font()

Получить имя файла по умолчанию для шрифта

get_default_font() -> string

Возвращает имя файла по умолчанию для шрифта pygame. Это не полный путь к файлу. Файл обычно находится в той же директории, что и модуль шрифтов, но также может быть упакован в отдельном архиве.

pygame.freetype.Font

Создать новый экземпляр шрифта из поддерживаемого файла шрифта.

Font(file, size=0, font_index=0, resolution=0, ucs4=False) -> Font

Font(pathlib.Path) -> Font

Аргумент file может быть строкой, представляющей имя файла шрифта, объектом-подобным файлу, содержащим шрифт, или None; если None, используется стандартный шрифт Pygame.

Необязательно, можно указать аргумент size для установки размера по умолчанию в пунктах, который определяет размер рендеренных символов. Размер также может быть явно передан в каждый вызов метода. Из-за работы системы кэширования указание размера по умолчанию в конструкторе не подразумевает выигрыша в производительности по сравнению с ручным указанием размера при каждом вызове функции. Если шрифт растровый и size не указан, размер по умолчанию устанавливается на первый доступный размер для шрифта.

Если файл шрифта содержит более одного шрифта, шрифт для загрузки можно выбрать с помощью аргумента index. Для значения индекса шрифта вне диапазона генерируется исключение.

Необязательный аргумент resolution устанавливает размер пикселей в точках на дюйм для использования при масштабировании глифов для этого экземпляра шрифта. Если 0, используется значение по умолчанию для модуля, установленное методом init(). Разрешение объекта Font можно изменить только путем повторной инициализации экземпляра шрифта.

Необязательный аргумент ucs4, целое число, устанавливает режим перевода текста по умолчанию: 0 (False) распознаёт пары суррогатов UTF-16, любое другое значение (True), для обработки текста Юникода как UCS-4 без пар суррогатов. См. Font.ucs4.

name

Правильное имя шрифта.

name -> string

Только для чтения. Возвращает реальное (полное) имя шрифта, как записано в файле шрифта.

path

Путь к файлу шрифта

path -> unicode

Только для чтения. Возвращает путь к загруженному файлу шрифта.

size

Размер по умолчанию в пунктах, используемый при рендеринге

size -> float

size -> (float, float)

Получить или установить размер по умолчанию для метрик текста и рендеринга. Он может быть одиночным размером в пунктах, заданным как Python int или float, или ppem шрифта (ширина, высота) tuple. Значения размера неотрицательны. Нулевой размер или ширина представляют неопределенный размер. В этом случае размер необходимо указать в качестве аргумента метода, или будет вызвано исключение. Нулевая ширина, но ненулевая высота - это ValueError.

Для масштабируемого шрифта, одно числовое значение эквивалентно кортежу с шириной, равной высоте. Шрифт может быть растянут по вертикали с высотой, большей ширины, или по горизонтали с шириной, большей высоты. Для встроенных растровых изображений, как перечисленных в get_sizes(), используйте номинальную ширину и высоту для выбора доступного размера.

Размер шрифта отличается для не масштабируемого растрового шрифта. При вызове метода он должен совпадать с одним из доступных размеров, возвращаемых методом get_sizes(). В противном случае будет вызвано исключение. Если размер является одиночным числом, размер сначала сопоставляется со значением размера в пунктах. Если совпадения нет, выбирается доступный размер с такой же номинальной шириной и высотой.

get_rect()

Возвращает размер и смещение рендерного текста

get_rect(text, style=STYLE_DEFAULT, rotation=0, size=0) -> rect

Получает окончательные размеры и начало, в пикселях, text с использованием необязательного size в пунктах, style и rotation. Для других релевантных свойств рендеринга и для любых необязательных аргументов, не переданных, используются значения по умолчанию, установленные для экземпляра Font.

Возвращает экземпляр Rect, содержащий ширину и высоту области текста, ограничивающей прямоугольник и положение начала текста. Начало полезно для выравнивания отдельно рендерных частей текста. Оно даёт позицию базовой линии и направление в начале текста. См. метод render_to() для примера.

Если text это строка char (байт), то предполагается кодировка LATIN1.

Необязательно, text может быть None, что вернёт ограничивающий прямоугольник для текста, переданного в предыдущий вызов get_rect(), render(), render_to(), render_raw() или render_raw_to(). См. render_to() для более подробной информации.

get_metrics()

Возвращает метрики глифов для данного текста

get_metrics(text, size=0) -> [(...), ...]

Возвращает метрики глифов для каждого символа в text.

Метрики глифов возвращаются как список кортежей. Каждый кортеж даёт метрики одного глифа. Метрики глифов:

(min_x, max_x, min_y, max_y, horizontal_advance_x, horizontal_advance_y)

Значения ограничивающего прямоугольника min_x, max_x, min_y и max_y возвращаются как координаты пикселей с сеткой типа int. Значения перемещения - значения с плавающей точкой.

Вычисления выполняются с использованием размера шрифта по умолчанию в пунктах. Необязательно, вы можете указать другой размер в пунктах с помощью аргумента size.

Метрики корректируются для текущих настроек поворота, наклона и начертания.

Если текст это строка char (байт), то предполагается кодировка LATIN1.

height

Немасштабируемая высота шрифта в единицах шрифта

height -> int

Только для чтения. Получает высоту шрифта. Это среднее значение всех глифов в шрифте.

ascender

Немасштабируемый восходящий параметр шрифта в единицах шрифта

ascender -> int

Только для чтения. Возвращает количество единиц от базовой линии шрифта до верхней части ограничивающей прямоугольника.

descender

Немасштабируемый нисходящий параметр шрифта в единицах шрифта

descender -> int

Только для чтения. Возвращает высоту в единицах шрифта для нисходящей части шрифта. Нисходящая часть - это количество единиц от базовой линии шрифта до нижней части ограничивающей прямоугольника.

get_sized_ascender()

Масштабируемый восходящий параметр шрифта в пикселях

get_sized_ascender(<size>=0) -> int

Возвращает количество единиц от базовой линии шрифта до верхней части ограничивающей прямоугольника. Она не корректируется для наклона или поворота.

get_sized_descender()

Масштабируемый нисходящий параметр шрифта в пикселях

get_sized_descender(<size>=0) -> int

Возвращает количество пикселей от базовой линии шрифта до верхней части ограничивающей прямоугольника. Она не корректируется для наклона или поворота.

get_sized_height()

Масштабируемая высота шрифта в пикселях

get_sized_height(<size>=0) -> int

Возвращает высоту шрифта. Это среднее значение всех глифов в шрифте. Она не корректируется для наклона или поворота.

get_sized_glyph_height()

Масштабируемая высота ограничивающего прямоугольника глифа шрифта в пикселях

get_sized_glyph_height(<size>=0) -> int

Возвращает высоту ограничивающего прямоугольника глифа шрифта в пикселях. Это среднее значение всех глифов в шрифте. Она не корректируется для наклона или поворота.

get_sizes()

возвращает доступные размеры встроенных растровых изображений

get_sizes() -> [(int, int, int, float, float), ...]

get_sizes() -> []

Возвращает список кортежей записей, по одной для каждого поддерживаемого размера шрифта. Каждый кортеж содержит размер шрифта, высоту в пикселях, ширину в пикселях, горизонтальное значение ppem (номинальная ширина) в дробных пикселях и вертикальное значение ppem (номинальная высота) в дробных пикселях.

render()

Возвращает отрисованный текст в виде поверхности

render(text, fgcolor=None, bgcolor=None, style=STYLE_DEFAULT, rotation=0, size=0) -> (Surface, Rect)

Возвращает новую Surface, на которой текст отрисован в цвете, заданном параметром 'fgcolor'. Если цвет переднего плана не задан, используется значение по умолчанию для переднего плана, fgcolor. Если параметр bgcolor задан, поверхность будет заполнена этим цветом. При отсутствии цвета фона, поверхность будет прозрачной с альфа-каналом равным нулю. Обычно возвращаемая поверхность имеет размер 32 бита на пиксель. Однако, если bgcolor равно None и сглаживание отключено, возвращается монохромная поверхность 8 бит с цветовым ключом, установленным для цвета фона.

Возвращаемое значение — кортеж: новая поверхность и прямоугольник, определяющий размер и положение отрисованного текста.

Если для параметра text передана пустая строка, возвращаемый прямоугольник будет иметь нулевую ширину и высоту, равную высоте шрифта.

Необязательные аргументы fgcolor, style, rotation и size переопределяют значения по умолчанию, установленные для экземпляра Font.

Если text — строка символов (байтов), то предполагается, что её кодировка — LATIN1.

Необязательно, text может быть None, что позволит перерисовать текст, переданный ранее методу get_rect(), render(), render_to(), render_raw() или render_raw_to(). Подробнее см. render_to().

render_to()

Отрисовка текста на существующую поверхность

render_to(surf, dest, text, fgcolor=None, bgcolor=None, style=STYLE_DEFAULT, rotation=0, size=0) -> Rect

Отрисовывает строку text на поверхность pygame.Surface surf в позиции dest (координаты x, y на поверхности). Если x или y не являются целыми числами, они преобразуются в целые, если это возможно. Принимается любой последовательность, где первые два элемента — x и y, включая экземпляр Rect. Как и в render(), доступны необязательные аргументы fgcolor, style, rotation и size.

Если цвет фона bgcolor задан, прямоугольник области текста сначала заполняется этим цветом. Затем происходит отрисовка текста. И заполнение фоном, и отрисовка текста осуществляются с использованием полного альфа-смешивания. То есть значения альфа-канала переднего плана, фона и целевой поверхности влияют на процесс смешивания.

Возвращаемое значение — прямоугольник, определяющий размер и положение отрисованного текста на поверхности.

Если для параметра text передана пустая строка, возвращаемый прямоугольник Rect будет иметь нулевую ширину и высоту шрифта. Прямоугольник будет ложным.

Необязательно, text может быть None, что позволит перерисовать текст, переданный ранее методу render_to(), get_rect(), render(), render_raw() или render_raw_to(). В основном эта функция помогает использовать render_to() в сочетании с get_rect(). Пример:

def word_wrap(surf, text, font, color=(0, 0, 0)):
    font.origin = True
    words = text.split(' ')
    width, height = surf.get_size()
    line_spacing = font.get_sized_height() + 2
    x, y = 0, line_spacing
    space = font.get_rect(' ')
    for word in words:
        bounds = font.get_rect(word)
        if x + bounds.width + bounds.x >= width:
            x, y = 0, y + line_spacing
        if x + bounds.width + bounds.x >= width:
            raise ValueError("word too wide for the surface")
        if y + bounds.height - bounds.y >= height:
            raise ValueError("text to long for the surface")
        font.render_to(surf, (x, y), None, color)
        x += bounds.width + space.width
    return x, y

Когда render_to() вызывается с теми же свойствами шрифта ― size, style, strength, wide, antialiased, vertical, rotation, kerning и use_bitmap_strikes ― как get_rect(), render_to() будет использовать макет, рассчитанный get_rect(). В противном случае, render_to() пересчитает макет, если вызывается со строкой текста или одно из вышеперечисленных свойств изменилось после вызова get_rect().

Если text — строка символов (байтов), то предполагается, что её кодировка — LATIN1.

render_raw()

Возвращает отрисованный текст как строку байтов

render_raw(text, style=STYLE_DEFAULT, rotation=0, size=0, invert=False) -> (bytes, (int, int))

Как render(), но с пикселями, возвращёнными в виде строки байтов 8-битных оттенков серого. Цвет переднего плана — 255, фона — 0, полезно в качестве альфа-маски для рисунка на переднем плане.

render_raw_to()

Отрисовка текста в массив целых чисел

render_raw_to(array, text, dest=None, style=STYLE_DEFAULT, rotation=0, size=0, invert=False) -> Rect

Отрисовка в объект массива, поддерживающий интерфейс структуры массива. Массив должен быть двумерным с целочисленными элементами. Значение по умолчанию для dest, None, эквивалентно позиции (0, 0). См. render_to(). Как и в других методах отрисовки, text может быть None для перерисовки текста, переданного ранее другому методу.

Возвращаемое значение — pygame.Rect(), определяющий размер и положение отрисованного текста.

style

Флаги стиля шрифта

style -> int

Получает или устанавливает значения флагов стиля шрифта по умолчанию. Этот стиль по умолчанию будет использоваться для всех операций рендеринга текста и вычисления размеров, если не переопределён явно в вызове метода рендеринга или get_rect(). Значение стиля может быть результатом побитового ИЛИ одного или нескольких следующих констант:

STYLE_NORMAL
STYLE_UNDERLINE
STYLE_OBLIQUE
STYLE_STRONG
STYLE_WIDE
STYLE_DEFAULT

Эти константы можно найти в модуле констант FreeType. Также можно изменять или получать значения отдельных атрибутов стиля (подчеркивание, наклон, полужирный).

Стиль STYLE_OBLIQUE и STYLE_STRONG доступны только для масштабируемых шрифтов. Попытка установить их для растрового шрифта приведёт к ошибке AttributeError. Попытка установить их для неактивного шрифта, как возвращаемого Font.__new__(), вызовет ошибку RuntimeError.

Присваивание STYLE_DEFAULT свойству style не изменяет значение свойства, так как это свойство определяет значение по умолчанию. Свойство style никогда не вернёт STYLE_DEFAULT.

underline

Состояние флага стиля подчеркивания шрифта

underline -> bool

Получает или устанавливает, будет ли шрифт подчеркнут при отрисовке текста. Это значение стиля по умолчанию используется для всех операций рендеринга и вычисления размеров, если не переопределено явно в вызове метода рендеринга или get_rect(), через параметр 'style'.

strong

Состояние флага стиля полужирности шрифта

strong -> bool

Получает или устанавливает, будет ли шрифт полужирным при отрисовке текста. Это значение стиля по умолчанию используется для всех операций рендеринга и вычисления размеров, если не переопределено явно в вызове метода рендеринга или get_rect(), через параметр 'style'.

oblique

Состояние флага стиля наклона шрифта

oblique -> bool

Получает или устанавливает, будет ли шрифт наклонен при отрисовке. Это значение стиля по умолчанию используется для всех операций рендеринга и вычисления размеров, если не переопределено явно в вызове метода рендеринга или get_rect(), через параметр style.

Стиль наклона поддерживается только для масштабируемых (контурных) шрифтов. Попытка установить этот стиль для растрового шрифта вызовет ошибку AttributeError. Если объект шрифта неактивен, как возвращаемый Font.__new__(), установка этого свойства вызовет ошибку RuntimeError.

wide

Состояние флага стиля растяжения шрифта по горизонтали

wide -> bool

Получает или устанавливает, будет ли шрифт растянут по горизонтали при отрисовке. Результат аналогичен стилю полужирности у pygame.font.Font. Этот стиль недоступен для повернутого текста.

strength

Сила, связанная со стилями полужирности или растяжения

strength -> float

Величина увеличения размера глифа шрифта при применении стилей полужирности или растяжения как доля от исходного размера. Для стиля растяжения увеличивается только горизонтальная размерность. Для полужирного текста увеличиваются как горизонтальная, так и вертикальная размерности. Стиль растяжения с силой 0.08333 (1/12) эквивалентен стилю полужирности у pygame.font.Font. Значение по умолчанию 0.02778 (1/36).

Стиль силы поддерживается только для масштабируемых (контурных) шрифтов. Попытка установить это свойство для растрового шрифта вызовет ошибку AttributeError. Если объект шрифта неактивен, как возвращаемый Font.__new__(), присвоение значению этого свойства вызовет ошибку RuntimeError.

underline_adjustment

Коэффициент корректировки положения подчеркивания

underline_adjustment -> float

Получает или устанавливает коэффициент, который, при положительном значении, умножается на смещение подчеркивания шрифта для корректировки его положения. Отрицательное значение превращает подчеркивание в зачёркивание или надстрочный текст. Он умножается на восходящую величину. Допустимые значения находятся в диапазоне от -2.0 до 2.0 включительно. Значение 0.5 близко соответствует подчеркиванию в Tango. Значение 1.0 имитирует подчеркивание у pygame.font.Font.

fixed_width

Получение информации о фиксированной ширине шрифта

fixed_width -> bool

Только чтение. Возвращает True если шрифт содержит символы фиксированной ширины (например, Courier, Bitstream Vera Sans Mono, Andale Mono).

fixed_sizes

Количество доступных размеров растрового шрифта

fixed_sizes -> int

Только чтение. Возвращает количество размеров шрифта, для которых шрифт содержит растровые изображения символов. Если ноль, то шрифт не является растровым. Масштабируемый шрифт может содержать предопределённые размеры как элементы изображения.

scalable

Получение информации о масштабируемости шрифта

scalable -> bool

Только чтение. Возвращает True если шрифт содержит контурные глифы. В этом случае размер шрифта не ограничен доступными растровыми размерами.

use_bitmap_strikes

Разрешение использования встроенных растровых изображений в контурном шрифте

use_bitmap_strikes -> bool

Некоторые масштабируемые шрифты содержат встроенные растровые изображения для определённых размеров. Это свойство контролирует использование этих растровых изображений. Установите False чтобы отключить загрузку растровых изображений. Установите True, значение по умолчанию, чтобы разрешить растровые изображения для рендеринга без поворота и без стиля, кроме wide или underline. Это свойство игнорируется для растровых шрифтов.

См. также fixed_sizes и get_sizes().

antialiased

Режим сглаживания шрифта

antialiased -> bool

Получает или устанавливает режим сглаживания шрифта. По умолчанию для всех шрифтов установлено True, что обеспечивает полноцветное рендеринг с 8-битной прозрачностью.

Установите в False для монохромного рендеринга. Это должно немного ускорить процесс и уменьшить размер кеша.

kerning

Режим кернинга

kerning -> bool

Получает или устанавливает режим кернинга. По умолчанию для всех шрифтов установлено False, что означает отсутствие кернинга.

Установите в True чтобы добавить кернинг между парами символов, если это поддерживается шрифтом, при позиционировании глифов.

vertical

Режим вертикальной отрисовки

vertical -> bool

Получает или устанавливает режим вертикального вывода символов вместо горизонтального. Может быть полезно при рендеринге иероглифов или других вертикальных письменностей.

Установите в True чтобы переключиться на вертикальную компоновку текста. По умолчанию False, компоновка по горизонтали.

Обратите внимание, что класс Font не определяет автоматически ориентацию скрипта. Вертикальная компоновка должна быть выбрана явно.

Также обратите внимание, что некоторые форматы шрифтов (особенно растровые) не содержат необходимых метрик для вертикальной отрисовки, поэтому отрисовка в таких случаях даст неопределённые результаты.

rotation

Поворот текста в градусах против часовой стрелки

rotation -> int

Получает или задаёт угол наклона базовой линии рендерного текста в градусах. Угол задаётся целым числом. Значение по умолчанию равно 0, при этом текст отображается горизонтально вдоль оси X, а вертикально вдоль оси Y. Положительное значение вращает эти оси против часовой стрелки на заданное число градусов. Отрицательное значение соответствует повороту по часовой стрелке. Значение поворота нормализуется до значения в диапазоне от 0 до 359 включительно (например, 390 -> 390 - 360 -> 30, -45 -> 360 + -45 -> 315, 720 -> 720 - (2 * 360) -> 0).

Поворачивать можно только масштабируемые (контурные) шрифты. Попытка изменить поворот шрифта растрового типа вызывает AttributeError. Попытка изменить поворот неактивного экземпляра шрифта, как возвращается Font.__new__(), вызывает RuntimeError.

fgcolor

Цвет по умолчанию для переднего плана

fgcolor -> Color

Получает или задаёт цвет по умолчанию для рендеринга глифов. Изначально он непрозрачный чёрный ― (0, 0, 0, 255). Применяется к render() и render_to().

bgcolor

Цвет по умолчанию для заднего плана

bgcolor -> Color

Получает или задаёт цвет по умолчанию для рендеринга заднего фона. Изначально он не задан, и текст по умолчанию рендерится с прозрачным фоном. Применяется к render() и render_to().

Новое в pygame 2.0.0.

origin

Режим определения начала рендеринга текста

origin -> bool

Если задано True, render_to() и render_raw_to() будут использовать положение dest как начало текста, а не верхний левый угол области. Подробности см. в get_rect().

pad

Режим заполнения границ

pad -> bool

Если задано True, то прямоугольник границ текста будет расширен для соответствия font.Font. В противном случае, прямоугольник границ будет достаточно большим только для текста.

ucs4

Включить режим UCS-4

ucs4 -> bool

Получает или задаёт способ декодирования текста Юникод. По умолчанию модуль freetype выполняет декодирование пар суррогатов UTF-16 для текста Юникод. Это позволяет 32-битным кодовым последовательностям ('Uxxxxxxxx') между 0x10000 и 0x10FFFF представлять соответствующие точки кода UTF-32 в интерпретаторах Python, построенных с типом Юникод UCS-2 (например, в Windows). Это также означает, что значения символов в области суррогатов UTF-16 (от 0xD800 до 0xDFFF) считаются частью пары суррогатов. Неправильно сформированная пара суррогатов вызовет UnicodeEncodeError. Установка ucs4 True отключает декодирование пар суррогатов, что позволяет получить доступ ко всему диапазону символов UCS-4 интерпретатору Python, построенному с поддержкой четырёхбайтных символов Юникод.

resolution

Разрешение пикселей в точках на дюйм

resolution -> int

Только для чтения. Получает размер пикселей, используемый при масштабировании глифов шрифта для этого экземпляра Font.