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

Eredita: Font < Resource < RefCounted < Object

Una variazione di un font con impostazioni aggiuntive.

Descrizione

Fornisce variazioni OpenType, grassetto/inclinazione simulati e impostazioni aggiuntive per i font come funzionalità OpenType e spaziatura aggiuntiva.

Per utilizzare la variazione di font in grassetto simulato:

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 }

Proprietà

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)

Metodi

void	set_spacing(spacing: SpacingType, value: int)

---

Descrizioni delle proprietà

Font base_font 🔗

• void set_base_font(value: Font)

• Font get_base_font()

Font di base utilizzato per creare una variazione. Se non impostato, viene utilizzato il font predefinito del Theme.

---

float baseline_offset = 0.0 🔗

• void set_baseline_offset(value: float)

• float get_baseline_offset()

Lo scostamento aggiuntivo dalla linea di base (come frazione dell'altezza del font).

---

Dictionary opentype_features = {} 🔗

• void set_opentype_features(value: Dictionary)

• Dictionary get_opentype_features()

Un insieme di tag di funzionalità OpenType. Ulteriori informazioni: Tag di funzionalità OpenType.

---

PackedColorArray palette_custom_colors = PackedColorArray() 🔗

• void set_palette_custom_colors(value: PackedColorArray)

• PackedColorArray get_palette_custom_colors()

An array of colors to override predefined palette. Use Color(0, 0, 0, 0), to keep predefined palette color at specific position.

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()

A palette index.

---

int spacing_bottom = 0 🔗

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

• int get_spacing()

Spaziatura addizionale in fondo alla riga in pixel.

---

int spacing_glyph = 0 🔗

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

• int get_spacing()

Spaziatura addizionale tra i glifi grafici.

---

int spacing_space = 0 🔗

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

• int get_spacing()

Larghezza addizionale dei glifi di spazi.

---

int spacing_top = 0 🔗

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

• int get_spacing()

Spaziatura addizionale in cima alla riga in pixel.

---

float variation_embolden = 0.0 🔗

• void set_variation_embolden(value: float)

• float get_variation_embolden()

Se non è uguale a zero, applica grassetto ai contorni del font. I valori negativi riducono lo spessore del contorno.

Nota: I font in grassetto potrebbero avere contorni che si intersecano tra loro, il che impedirà ai font MSDF e TextMesh di funzionare correttamente.

---

int variation_face_index = 0 🔗

• void set_variation_face_index(value: int)

• int get_variation_face_index()

Indice della faccia attiva nel file di collezione TrueType/OpenType.

---

Dictionary variation_opentype = {} 🔗

• void set_variation_opentype(value: Dictionary)

• Dictionary get_variation_opentype()

Coordinate di variazione OpenType del font. Ulteriori informazioni: Tag di variazione OpenType.

Nota: Questo Dictionary utilizza i tag OpenType come chiavi. Gli assi di variazione possono essere identificati sia dai tag (int, ad esempio 0x77678674) sia dai nomi (String, ad esempio wght). Alcuni assi potrebbero essere accessibili tramite molteplici nomi. Ad esempio, wght si riferisce allo stesso asse di weight. I tag, d'altre parte, sono univoci. Per convertire tra nomi e tag, usa TextServer.name_to_tag() e TextServer.tag_to_name().

Nota: Per ottenere gli assi di variazione disponibili in un font, usa 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()

La trasformazione 2D, applicata ai contorni del font, che può essere utilizzata per inclinare, capovolgere e ruotare i glifi.

Ad esempio, per simulare un font in corsivo inclinandolo, applica la seguente trasformazione Transform2D(1.0, inclinazione, 0.0, 1.0, 0.0, 0.0).

---

Descrizioni dei metodi

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

Imposta la spaziatura per spacing su value in pixel (non relativa alla dimensione del font).