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

CharFXTransform

Eredita: RefCounted < Object

Controlla il modo in cui un singolo carattere sarà visualizzato in un RichTextEffect.

Descrizione

Impostando varie proprietà su questo oggetto, è possibile controllare il modo in cui i singoli caratteri saranno visualizzati in un RichTextEffect.

Tutorial

Proprietà

Color

color

Color(0, 0, 0, 1)

float

elapsed_time

0.0

Dictionary

env

{}

RID

font

RID()

int

glyph_count

0

int

glyph_flags

0

int

glyph_index

0

Vector2

offset

Vector2(0, 0)

bool

outline

false

Vector2i

range

Vector2i(0, 0)

int

relative_index

0

Transform2D

transform

Transform2D(1, 0, 0, 1, 0, 0)

bool

visible

true

Descrizioni delle proprietà

Color color = Color(0, 0, 0, 1) 🔗

Il colore con cui sarà disegnato il carattere.

float elapsed_time = 0.0 🔗

  • void set_elapsed_time(value: float)

  • float get_elapsed_time()

Il tempo trascorso da quando RichTextLabel è stato aggiunto all'albero di scene (in secondi). Il tempo si ferma quando RichTextLabel è in pausa (vedi Node.process_mode). Si azzera quando il testo in RichTextLabel viene modificato.

Nota: Il tempo passa comunque mentre RichTextLabel è nascosto.

Dictionary env = {} 🔗

Contiene gli argomenti passati nel tag BBCode di apertura. Per impostazione predefinita, gli argomenti sono stringhe; se il loro contenuto corrisponde a un tipo come bool, int o float, saranno convertiti automaticamente. I codici colore nel formato #rrggbb o #rgb saranno convertiti in un Color opaco. Gli argomenti stringa non possono contenere spazi, anche se sono racchiusi tra virgolette. Se presenti, le virgolette saranno presenti anche nella stringa finale.

Ad esempio, il tag BBCode di apertura [example foo=hello bar=true baz=42 color=#ffffff] verrà mappato nel seguente Dictionary:

{"foo": "hello", "bar": true, "baz": 42, "color": Color(1, 1, 1, 1)}

RID font = RID() 🔗

  • void set_font(value: RID)

  • RID get_font()

RID per il TextServer del font utilizzato per renderizzare il glifo, questo valore può essere utilizzato con i metodi TextServer.font_* per recuperare le informazioni sul font.

Nota: Di sola lettura. L'impostazione di questa proprietà non influirà sul disegno.

int glyph_count = 0 🔗

  • void set_glyph_count(value: int)

  • int get_glyph_count()

Numero di glifi nel cluster di grafemi. Questo valore è impostato nel primo glifo di un cluster.

Nota: Di sola lettura. Impostare questa proprietà non influirà sul disegno.

int glyph_flags = 0 🔗

  • void set_glyph_flags(value: int)

  • int get_glyph_flags()

Opzioni per il glifo. Vedi GraphemeFlag per ulteriori informazioni.

Nota: Di sola lettura. Impostare questa proprietà non influirà sul disegno.

int glyph_index = 0 🔗

  • void set_glyph_index(value: int)

  • int get_glyph_index()

Indice di glifo specifico del font. Se si desidera sostituire questo glifo, usa TextServer.font_get_glyph_index() con font per ottenere un nuovo indice di glifo per un singolo carattere.

Vector2 offset = Vector2(0, 0) 🔗

Lo scostamento della posizione con cui sarà disegnato il carattere (in pixel).

bool outline = false 🔗

  • void set_outline(value: bool)

  • bool is_outline()

Se true, la trasformazione FX viene chiamata per disegnare il contorno.

Nota: Di sola lettura. Impostare questa proprietà non influirà sul disegno.

Vector2i range = Vector2i(0, 0) 🔗

Intervallo assoluto di caratteri nella stringa, corrispondente al glifo.

Nota: Di sola lettura. Impostare questa proprietà non influirà sul disegno.

int relative_index = 0 🔗

  • void set_relative_index(value: int)

  • int get_relative_index()

Lo scostamento del carattere del glifo, relativo al blocco RichTextEffect personalizzato attuale.

Nota: Di sola lettura. Impostare questa proprietà non influirà sul disegno.

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

La trasformazione attuale del glifo attuale. Può essere sovrascritta (ad esempio, derivando la posizione e la rotazione da una curva). È possibile inoltre modificare il valore esistente per applicare le trasformazioni sopra altri effetti.

bool visible = true 🔗

  • void set_visibility(value: bool)

  • bool is_visible()

Se true, il carattere sarà disegnato. Se false, il carattere sarà nascosto. I caratteri attorno ai caratteri nascosti si riorganizzeranno per occupare lo spazio dei caratteri nascosti. Se ciò non è desiderato, imposta il loro color su Color(1, 1, 1, 0).