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 для автоматического включения на основе размера шрифта.