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...
ResourceImporterImageFont
Наследует: ResourceImporter < RefCounted < Object
Импортирует растровый шрифт, в котором все глифы имеют одинаковую ширину и высоту.
Описание
Этот рабочий процесс на основе изображений может быть проще в использовании, чем ResourceImporterBMFont, но он требует, чтобы все глифы имели одинаковую ширину и высоту, можно настраивать продвижение глифов и смещения рисования. Это делает ResourceImporterImageFont наиболее подходящим для шрифтов с фиксированной шириной.
См. также ResourceImporterDynamicFont.
Обучающие материалы
Свойства
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Описания свойств
Подъем шрифта (количество пикселей над базовой линией). Если установлено значение 0, используется половина высоты символа.
Rect2i character_margin = Rect2i(0, 0, 0, 0) 🔗
Margin применяется вокруг каждого импортированного глифа. Если изображение шрифта содержит направляющие (в виде линий между глифами) или если интервал между символами выглядит неправильным, попробуйте настроить character_margin.
PackedStringArray character_ranges = PackedStringArray() 🔗
Диапазоны символов для импорта из изображения шрифта. Это массив, который отображает каждую позицию на изображении (в координатах тайлов, а не пикселей). Атлас шрифта обходится слева направо и сверху вниз. Символы могут быть указаны десятичными числами (126), шестнадцатеричными числами (0x007e или U+007e) или в одинарных кавычках ('~'). Диапазоны могут быть указаны с дефисом между символами.
Например, 0-127 представляет полный диапазон ASCII. Его также можно записать как 0x0000-0x007f (или U+0000-U+007f). В качестве еще одного примера, ' '-'~' эквивалентно 32-126 и представляет собой диапазон печатных (видимых) символов ASCII.
Для любого диапазона можно настроить смещение и продвижение символа, добавив в конец три разделенных пробелами целочисленных значения (дополнительное смещение, смещение по оси x, смещение по оси y). Например, 'a'-'b' 4 5 2 устанавливает смещение равным ширине_символа + 4 и смещение равным Vector2(5, 2) для символов a и b.
Примечание: Общее количество символов не должно превышать количество columns, умноженное на rows. В противном случае импорт шрифта завершится неудачей.
Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.
Количество столбцов в изображении шрифта. См. также rows.
Если true, используется сжатие без потерь для результирующего шрифта.
Снижение шрифта (количество пикселей ниже базовой линии). Если установлено значение 0, используется половина высоты символа.
Список резервных шрифтов для использования, если глиф не найден в этом растровом шрифте. Шрифты в начале массива пробуются первыми.
Rect2i image_margin = Rect2i(0, 0, 0, 0) 🔗
Поле для обрезки по бокам всего изображения. Это можно использовать для обрезки частей изображения, содержащих информацию об атрибуции или подобную информацию.
PackedStringArray kerning_pairs = PackedStringArray() 🔗
Кернинговые пары для шрифта. Кернинговые пары регулируют интервал между двумя символами.
Каждая строка состоит из трех значений, разделенных пробелами: строка «from», строка «to» и смещение целого числа. Каждая комбинация образует две строки для кернинговой пары, например, ab cd -3 создаст кернинговые пары ac, ad, bc и bd со смещением -3. Для добавления символов Unicode можно использовать escape-последовательности \uXXXX.
Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.
Количество строк в изображении шрифта. См. также columns.
Режим масштабирования шрифта.