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...

FontVariation

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

Вариант шрифта с дополнительными настройками.

Описание

Предоставляет вариации OpenType, имитацию жирного/наклонного начертания и дополнительные настройки шрифта, такие как функции OpenType и дополнительный интервал.

Чтобы использовать имитацию жирного шрифта:

GDScriptC#

var fv = FontVariation.new()
fv.base_font = load("res://BarlowCondensed-Regular.ttf")
fv.variation_embolden = 1.2
$Label.add_theme_font_override("font", fv)
$Label.add_theme_font_size_override("font_size", 64)

To set the coordinate of multiple variation axes:

var fv = FontVariation.new();
var ts = TextServerManager.get_primary_interface()
fv.base_font = load("res://BarlowCondensed-Regular.ttf")
fv.variation_opentype = { ts.name_to_tag("wght"): 900, ts.name_to_tag("custom_hght"): 900 }

Свойства

Font	base_font
float	baseline_offset	0.0
Dictionary	opentype_features	{}
PackedColorArray	palette_custom_colors	PackedColorArray()
int	palette_index	0
int	spacing_bottom	0
int	spacing_glyph	0
int	spacing_space	0
int	spacing_top	0
float	variation_embolden	0.0
int	variation_face_index	0
Dictionary	variation_opentype	{}
Transform2D	variation_transform	Transform2D(1, 0, 0, 1, 0, 0)

Методы

void	set_spacing(spacing: SpacingType, value: int)

---

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

Font base_font 🔗

• void set_base_font(value: Font)

• Font get_base_font()

Базовый шрифт, используемый для создания вариации. Если не задано, используется шрифт по умолчанию Theme.

---

float baseline_offset = 0.0 🔗

• void set_baseline_offset(value: float)

• float get_baseline_offset()

Дополнительное смещение базовой линии (в виде доли высоты шрифта).

---

Dictionary opentype_features = {} 🔗

• void set_opentype_features(value: Dictionary)

• Dictionary get_opentype_features()

Набор тегов функций OpenType. Дополнительная информация: Теги функций OpenType.

---

PackedColorArray palette_custom_colors = PackedColorArray() 🔗

• void set_palette_custom_colors(value: PackedColorArray)

• PackedColorArray get_palette_custom_colors()

Массив цветов для переопределения предопределенной палитры. Используйте Color(0, 0, 0, 0), чтобы сохранить цвет предопределенной палитры в определенной позиции.

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

---

int palette_index = 0 🔗

• void set_palette_index(value: int)

• int get_palette_index()

Индекс палитры.

---

int spacing_bottom = 0 🔗

• void set_spacing(spacing: SpacingType, value: int)

• int get_spacing()

Дополнительный интервал внизу строки в пикселях.

---

int spacing_glyph = 0 🔗

• void set_spacing(spacing: SpacingType, value: int)

• int get_spacing()

Дополнительный интервал между графическими глифами.

---

int spacing_space = 0 🔗

• void set_spacing(spacing: SpacingType, value: int)

• int get_spacing()

Дополнительная ширина пробельных глифов.

---

int spacing_top = 0 🔗

• void set_spacing(spacing: SpacingType, value: int)

• int get_spacing()

Дополнительный интервал в верхней части строки в пикселях.

---

float variation_embolden = 0.0 🔗

• void set_variation_embolden(value: float)

• float get_variation_embolden()

Если не равно нулю, то контуры шрифта становятся жирными. Отрицательные значения уменьшают толщину контура.

Примечание: У жирных шрифтов могут быть самопересекающиеся контуры, что помешает корректной работе шрифтов MSDF и TextMesh.

---

int variation_face_index = 0 🔗

• void set_variation_face_index(value: int)

• int get_variation_face_index()

Активный индекс шрифтов в файле коллекции TrueType/OpenType.

---

Dictionary variation_opentype = {} 🔗

• void set_variation_opentype(value: Dictionary)

• Dictionary get_variation_opentype()

Координаты вариаций шрифта OpenType. Дополнительная информация: Теги вариаций OpenType.

Примечание: Этот Dictionary использует теги OpenType в качестве ключей. Оси вариаций можно идентифицировать как по тегам (int, например 0x77678674), так и по именам (String, например wght). Некоторые оси могут быть доступны по нескольким именам. Например, wght относится к той же оси, что и weight. Теги, с другой стороны, уникальны. Для преобразования между именами и тегами используйте TextServer.name_to_tag() и TextServer.tag_to_name().

Примечание: Чтобы получить доступные оси вариаций шрифта, используйте Font.get_supported_variation_list().

---

Transform2D variation_transform = Transform2D(1, 0, 0, 1, 0, 0) 🔗

• void set_variation_transform(value: Transform2D)

• Transform2D get_variation_transform()

2D-преобразование, применяемое к контурам шрифта, можно использовать для наклона, переворачивания и поворота глифов.

Например, чтобы имитировать курсивное начертание с помощью наклона, примените следующее преобразование `` [code``Transform2D(1.0, slant, 0.0, 1.0, 0.0, 0.0)[/code].

---

Описания метода

void set_spacing(spacing: SpacingType, value: int) 🔗

Устанавливает интервал для spacing на value в пикселях (не относительно размера шрифта).