Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

SystemFont

Наследует: Font < Resource < RefCounted < Object

Шрифт, загруженный из системного шрифта. Возвращается к шрифту темы по умолчанию, если он не реализован в хостовой ОС.

Описание

SystemFont загружает шрифт из системного шрифта с первым совпадающим именем из font_names.

Он попытается сопоставить стиль шрифта, но это не гарантируется.

Возвращаемый шрифт может быть частью коллекции шрифтов или быть переменным шрифтом с набором функций OpenType «weight», «width» и/или «italic».

Вы можете создать FontVariation системного шрифта для точного управления его функциями.

Примечание: Этот класс реализован в iOS, Linux, macOS и Windows, на других платформах он будет возвращаться к шрифту темы по умолчанию.

Свойства

bool

allow_system_fallback

true

FontAntialiasing

antialiasing

1

bool

disable_embedded_bitmaps

true

bool

font_italic

false

PackedStringArray

font_names

PackedStringArray()

int

font_stretch

100

int

font_weight

400

bool

force_autohinter

false

bool

generate_mipmaps

false

Hinting

hinting

1

bool

keep_rounding_remainders

true

bool

modulate_color_glyphs

false

int

msdf_pixel_range

16

int

msdf_size

48

bool

multichannel_signed_distance_field

false

float

oversampling

0.0

SubpixelPositioning

subpixel_positioning

1

Описания свойств

bool allow_system_fallback = true 🔗

  • void set_allow_system_fallback(value: bool)

  • bool is_allow_system_fallback()

Если задано значение true, системные шрифты могут автоматически использоваться в качестве резервных.

FontAntialiasing antialiasing = 1 🔗

Способ сглаживания шрифтов.

bool disable_embedded_bitmaps = true 🔗

  • void set_disable_embedded_bitmaps(value: bool)

  • bool get_disable_embedded_bitmaps()

Если задано значение true, загрузка встроенного растрового изображения шрифта отключена (только растровые и цветные шрифты игнорируют это свойство).

bool font_italic = false 🔗

  • void set_font_italic(value: bool)

  • bool get_font_italic()

Если установлено значение true, предпочтительным будет курсивный или наклонный шрифт.

PackedStringArray font_names = PackedStringArray() 🔗

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

Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.

int font_stretch = 100 🔗

  • void set_font_stretch(value: int)

  • int get_font_stretch()

Предпочтительная величина растяжения шрифта по сравнению с нормальной шириной. Процентное значение между 50% и 200%.

int font_weight = 400 🔗

  • void set_font_weight(value: int)

  • int get_font_weight()

Предпочтительная толщина (жирность) шрифта. Значение в диапазоне 100...999, нормальная толщина шрифта 400, жирная толщина шрифта 700.

bool force_autohinter = false 🔗

  • void set_force_autohinter(value: bool)

  • bool is_force_autohinter()

Если установлено значение true, поддерживается автоматическая подсказка (auto-hinting), которая имеет приоритет над встроенной подсказкой шрифта.

bool generate_mipmaps = false 🔗

  • void set_generate_mipmaps(value: bool)

  • bool get_generate_mipmaps()

Если установлено значение true, будут сгенерированы MIP-текстуры для текстур шрифтов.

Hinting hinting = 1 🔗

Режим подсказки шрифтов.

bool keep_rounding_remainders = true 🔗

  • void set_keep_rounding_remainders(value: bool)

  • bool get_keep_rounding_remainders()

Если установлено значение true, при выравнивании глифов по границам пикселей остатки округления накапливаются для обеспечения более равномерного распределения глифов. Этот параметр не действует, если включено субпиксельное позиционирование.

bool modulate_color_glyphs = false 🔗

  • void set_modulate_color_glyphs(value: bool)

  • bool is_modulate_color_glyphs()

Если установлено значение true, цветовая модуляция применяется при рисовании цветных глифов, в противном случае она применяется только к монохромным глифам.

int msdf_pixel_range = 16 🔗

  • void set_msdf_pixel_range(value: int)

  • int get_msdf_pixel_range()

Ширина диапазона вокруг фигуры между минимальным и максимальным представимым расстоянием со знаком. При использовании контуров шрифта msdf_pixel_range должен быть установлен как минимум в дважды размера самого большого контура шрифта. Значение msdf_pixel_range по умолчанию 16 позволяет контурам размером до 8 выглядеть правильно.

int msdf_size = 48 🔗

  • void set_msdf_size(value: int)

  • int get_msdf_size()

Исходный размер шрифта, используемый для генерации текстур MSDF. Более высокие значения обеспечивают большую точность, но медленнее отрисовываются и требуют больше памяти. Увеличивайте это значение только в том случае, если вы заметили видимую неточность в отрисовке глифов.

bool multichannel_signed_distance_field = false 🔗

  • void set_multichannel_signed_distance_field(value: bool)

  • bool is_multichannel_signed_distance_field()

Если установлено значение true, глифы всех размеров визуализируются с использованием одного многоканального знакового поля расстояния, созданного из динамических векторных данных шрифта.

float oversampling = 0.0 🔗

  • void set_oversampling(value: float)

  • float get_oversampling()

Положительное значение переопределяет коэффициент передискретизации области просмотра, в которой используется этот шрифт. См. Viewport.oversampling. Это значение не переопределяет параметр oversampling методов draw_*.

SubpixelPositioning subpixel_positioning = 1 🔗

Режим субпиксельного позиционирования глифа шрифта. Субпиксельное позиционирование обеспечивает более четкий текст и лучший кернинг для шрифтов меньшего размера за счет использования памяти и скорости растеризации шрифта. Используйте TextServer.SUBPIXEL_POSITIONING_AUTO для автоматического включения на основе размера шрифта.