SystemFont

Успадковує: Font < Resource < RefCounted < Object

Завантажений шрифт з системного шрифту. Повернутися до типового шрифту теми, якщо не реалізовано на ОС.

Опис

SystemFont завантажує шрифт з системного шрифту з ім'ям першого матчу з font_names.

Вона спробує відповідати стилю шрифту, але це не гарантується.

Повернутий шрифт може бути частиною збору шрифту або бути змінним шрифтом з OpenType "вагою", "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, italic або oblique font.

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

bool generate_mipmaps = false 🔗

  • void set_generate_mipmaps(value: bool)

  • bool get_generate_mipmaps()

Якщо встановити на true, генеруйте карти для текстур шрифту.

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 необхідно встановити принаймні twice розмір найбільшого шрифту. 16 дозволяє визначити розміри до 8, щоб виглядати правильно.

int msdf_size = 48 🔗

  • void set_msdf_size(value: int)

  • int get_msdf_size()

Розмір шрифту джерела використовується для створення текстур MSDF. Найвищі значення дозволяють більш точність, але повільніше рендерити і вимагати більше пам'яті. Тільки збільшити це значення, якщо ви помітили видимий недолік точності в рендерингу glyph.

bool multichannel_signed_distance_field = false 🔗

  • void set_multichannel_signed_distance_field(value: bool)

  • bool is_multichannel_signed_distance_field()

Якщо встановити до true, glyphs всіх розмірів подаються за допомогою одного багатоканального підписаного поля відстані, створеного з динамічних вхідних даних шрифту.

float oversampling = 0.0 🔗

  • void set_oversampling(value: float)

  • float get_oversampling()

Якщо встановлено додатне значення, перевизначає коефіцієнт передискретизації області перегляду, в якій використовується цей шрифт. Див. Viewport.oversampling. Це значення не перевизначає параметр oversampling методів draw_*.

SubpixelPositioning subpixel_positioning = 1 🔗

Режим позиціонування шрифту glyph. Підпіксельне позиціонування забезпечує формувальний текст та кращий кермінг для менших розмірів шрифтів, за вартістю використання пам'яті та швидкості обертання шрифту. Використовуйте TextServer. SUBPIXEL_SETTINGING_AUTO для автоматичного включення його на основі розміру шрифту.