ResourceImporterImageFont
Наследует: ResourceImporter < RefCounted < Object
Импортирует растровый шрифт, в котором все глифы имеют одинаковую ширину и высоту.
Описание
Этот рабочий процесс на основе изображений может быть проще в использовании, чем ResourceImporterBMFont, но он требует, чтобы все глифы имели одинаковую ширину и высоту, можно настраивать продвижение глифов и смещения рисования. Это делает ResourceImporterImageFont наиболее подходящим для шрифтов с фиксированной шириной.
См. также ResourceImporterDynamicFont.
Обучающие материалы
Свойства
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Описания свойств
Подъем шрифта (количество пикселей над базовой линией). Если установлено значение 0, используется половина высоты символа.
Rect2i character_margin = Rect2i(0, 0, 0, 0) 🔗
Margin применяется вокруг каждого импортированного глифа. Если изображение шрифта содержит направляющие (в виде линий между глифами) или если интервал между символами выглядит неправильным, попробуйте настроить character_margin.
PackedStringArray character_ranges = PackedStringArray() 🔗
Диапазоны символов для импорта из изображения шрифта. Это массив, который отображает каждую позицию на изображении (в координатах плитки, а не в пикселях). Атлас шрифтов просматривается слева направо и сверху вниз. Символы можно указывать десятичными числами (127), шестнадцатеричными числами (0x007f или U+007f) или в одинарных кавычках ('~'). Диапазоны можно указывать с помощью дефиса между символами.
Например, 0-127 представляет собой полный диапазон ASCII. Его также можно записать как 0x0000-0x007f (или U+0000-U+007f). Другой пример: ' '-'~' эквивалентно 32-127 и представляет собой диапазон печатных (видимых) символов ASCII.
Для любого диапазона сдвиг и смещение можно настроить, добавив в конец три целочисленных значения, разделенных пробелами (дополнительный сдвиг, смещение по оси x, смещение по оси y). Например, 'a'-'b' 4 5 2 устанавливает сдвиг равным char_width + 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.
Режим масштабирования шрифта.