Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

FontVariation

继承： Font < Resource < RefCounted < Object

字体的变体，提供额外的设置。

描述

提供 OpenType 变体，模拟的粗体/斜体，以及 OpenType 特性和额外间距等额外的字体设置。

要使用模拟的粗体变体：

GDScriptC#

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

要设置多个变体轴的坐标：

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
Dictionary	opentype_features	{}
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 ( SpacingType spacing, int value )

---

属性说明

Font base_font

• void set_base_font ( Font value )

• Font get_base_font ( )

用于创建变体的基础字体。如果未设置，则使用默认的 Theme 字体。

---

Dictionary opentype_features = {}

• void set_opentype_features ( Dictionary value )

• Dictionary get_opentype_features ( )

一组 OpenType 功能标签。更多信息：OpenType 功能标签。

---

int spacing_bottom = 0

• void set_spacing ( SpacingType spacing, int value )

• int get_spacing ( )

行底部的额外间距，单位为像素。

---

int spacing_glyph = 0

• void set_spacing ( SpacingType spacing, int value )

• int get_spacing ( )

图形字形之间的额外间距。

---

int spacing_space = 0

• void set_spacing ( SpacingType spacing, int value )

• int get_spacing ( )

空格字形的额外宽度。

---

int spacing_top = 0

• void set_spacing ( SpacingType spacing, int value )

• int get_spacing ( )

行顶部的额外间距，单位为像素。

---

float variation_embolden = 0.0

• void set_variation_embolden ( float value )

• float get_variation_embolden ( )

如果不等于零，则加粗字体轮廓。负值会减小轮廓厚度。

注意：加粗字体可能有自相交的轮廓，这将阻止 MSDF 字体和 TextMesh 正常工作。

---

int variation_face_index = 0

• void set_variation_face_index ( int value )

• int get_variation_face_index ( )

在 TrueType / OpenType 集合文件中的活动字体索引。

---

Dictionary variation_opentype = {}

• void set_variation_opentype ( Dictionary value )

• 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 ( Transform2D value )

• Transform2D get_variation_transform ( )

应用于字体轮廓的 2D 变换，可用于倾斜、翻转和旋转字形。

例如，要通过倾斜来模拟斜体字体，请应用以下变换 Transform2D(1.0, slant, 0.0, 1.0, 0.0, 0.0)。

---

方法说明

void set_spacing ( SpacingType spacing, int value )

将 spacing 的间距（见 SpacingType）设置为 value，单位为像素（与字体大小无关）。