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...
TextServer
Eredita: RefCounted < Object
Ereditato da: TextServerExtension
Un'interfaccia server per la gestione dei font e il rendering del testo.
Descrizione
TextServer è il backend API per la gestione dei font e il rendering del testo.
Nota: Questa è un'API di basso livello, considera di usare le classi TextLine, TextParagraph e Font.
Questa è una classe astratta, quindi per ottenere l'istanza del TextServer attualmente attiva, usa il seguente codice:
var ts = TextServerManager.get_primary_interface()
var ts = TextServerManager.GetPrimaryInterface();
Metodi
Enumerazioni
enum FontAntialiasing: 🔗
FontAntialiasing FONT_ANTIALIASING_NONE = 0
I glifi dei font sono rasterizzati come bitmap a 1 bit.
FontAntialiasing FONT_ANTIALIASING_GRAY = 1
I glifi dei font sono rasterizzati come bitmap con anti-alias in scala di grigi a 8 bit.
FontAntialiasing FONT_ANTIALIASING_LCD = 2
I glifi dei font sono rasterizzati per gli schermi LCD.
La disposizione dei subpixel LCD è determinata dal valore dell'impostazione ProjectSettings.gui/theme/lcd_subpixel_layout.
La modalità anti-aliasing dei subpixel LCD è adatta solo per renderizzare testo in 2D, orizzontale e non ridimensionato.
enum FontLCDSubpixelLayout: 🔗
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_NONE = 0
Disposizione dei subpixel sconosciuta o non supportata, l'antialiasing dei subpixel LCD è disabilitato.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_HRGB = 1
Disposizione orizzontale dei subpixel RGB.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_HBGR = 2
Disposizione orizzontale dei subpixel BGR.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_VRGB = 3
Disposizione verticale RGB dei subpixel.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_VBGR = 4
Disposizione verticale BGR dei subpixel.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_MAX = 5
Rappresenta la dimensione dell'enumerazione FontLCDSubpixelLayout.
enum Direction: 🔗
Direction DIRECTION_AUTO = 0
La direzione del testo è determinata in base al contenuto e alle impostazioni locali attuali.
Direction DIRECTION_LTR = 1
Il testo è scritto da sinistra a destra.
Direction DIRECTION_RTL = 2
Il testo è scritto da destra a sinistra.
Direction DIRECTION_INHERITED = 3
La direzione di scrittura del testo è la stessa della direzione di scrittura della stringa base. Utilizzata solo per la sovrascrittura BiDi.
enum Orientation: 🔗
Orientation ORIENTATION_HORIZONTAL = 0
Il testo è scritto orizzontalmente.
Orientation ORIENTATION_VERTICAL = 1
Il testo da sinistra a destra è scritto verticalmente dall'alto verso il basso.
Il testo da destra a sinistra è scritto verticalmente dal basso verso l'alto.
flags JustificationFlag: 🔗
JustificationFlag JUSTIFICATION_NONE = 0
Non giustificare il testo.
JustificationFlag JUSTIFICATION_KASHIDA = 1
Giustifica il testo aggiungendo e rimuovendo kashida.
JustificationFlag JUSTIFICATION_WORD_BOUND = 2
Giustifica il testo modificando la larghezza degli spazi tra le parole.
JustificationFlag JUSTIFICATION_TRIM_EDGE_SPACES = 4
Rimuovi gli spazi iniziali e finali dal testo giustificato.
JustificationFlag JUSTIFICATION_AFTER_LAST_TAB = 8
Applica la giustificazione solo alla parte del testo dopo l'ultima tabulazione.
JustificationFlag JUSTIFICATION_CONSTRAIN_ELLIPSIS = 16
Applica la giustificazione alla linea tagliata con l'ellissi.
JustificationFlag JUSTIFICATION_SKIP_LAST_LINE = 32
Non applicare la giustificazione all'ultima riga del paragrafo.
JustificationFlag JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS = 64
Non applicare la giustificazione all'ultima riga del paragrafo con caratteri visibili (ha la precedenza su JUSTIFICATION_SKIP_LAST_LINE).
JustificationFlag JUSTIFICATION_DO_NOT_SKIP_SINGLE_LINE = 128
Applicare sempre la giustificazione ai paragrafi con una sola riga (JUSTIFICATION_SKIP_LAST_LINE e JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS sono ignorati).
enum AutowrapMode: 🔗
AutowrapMode AUTOWRAP_OFF = 0
L'avvolgimento automatico è disattivato.
AutowrapMode AUTOWRAP_ARBITRARY = 1
Racchiude il testo all'interno del rettangolo di delimitazione del nodo consentendo di interrompere le righe in posizioni arbitrarie, il che è utile quando lo spazio disponibile è molto limitato.
AutowrapMode AUTOWRAP_WORD = 2
Avvolge il testo all'interno del rettangolo di delimitazione del nodo effettuando un'interruzione graduale tra le parole.
AutowrapMode AUTOWRAP_WORD_SMART = 3
Si comporta in modo simile a AUTOWRAP_WORD, ma forza l'interruzione di una parola se questa non entra in una riga.
flags LineBreakFlag: 🔗
LineBreakFlag BREAK_NONE = 0
Non interrompere la riga.
LineBreakFlag BREAK_MANDATORY = 1
Interrompere la riga in corrispondenza dei caratteri di interruzione obbligatori (ad esempio "\n").
LineBreakFlag BREAK_WORD_BOUND = 2
Interrompere la riga tra le parole.
LineBreakFlag BREAK_GRAPHEME_BOUND = 4
Interrompere la riga tra tutti i grafemi non connessi.
LineBreakFlag BREAK_ADAPTIVE = 8
Dovrebbe essere utilizzato solo insieme a BREAK_WORD_BOUND, interrompe la riga tra tutti i grafemi non collegati, se è impossibile interromperla tra le parole.
LineBreakFlag BREAK_TRIM_EDGE_SPACES = 16
Deprecato: Use BREAK_TRIM_START_EDGE_SPACES | BREAK_TRIM_END_EDGE_SPACES instead.
Rimuove gli spazi dai bordi dei segmenti della riga interrotta.
LineBreakFlag BREAK_TRIM_INDENT = 32
Sottrai la larghezza del rientro della prima riga da tutte le righe successive alla prima.
LineBreakFlag BREAK_TRIM_START_EDGE_SPACES = 64
Rimuove spazi e caratteri di interruzione di riga dall'inizio dei segmenti di riga interrotti.
Ad esempio, dopo l'interruzione di riga, il secondo segmento del testo seguente test \n next, è next se il flag è impostato, e `` next`` se non lo è.
LineBreakFlag BREAK_TRIM_END_EDGE_SPACES = 128
Rimuove spazi e caratteri di interruzione di riga dalla fine dei segmenti di riga interrotti.
Ad esempio, dopo l'interruzione di riga, il primo segmento del testo seguente test \n next, è test se il flag è impostato, e test \n se non lo è.
enum VisibleCharactersBehavior: 🔗
VisibleCharactersBehavior VC_CHARS_BEFORE_SHAPING = 0
Ritaglia il testo prima della formazione. Ad esempio, aumentare il valore Label.visible_characters o RichTextLabel.visible_characters è visivamente identico alla digitazione del testo.
Nota: In questa modalità, il testo ritagliato non viene elaborato affatto. Non viene preso in considerazione per calcolare le interruzioni di riga e le dimensioni.
VisibleCharactersBehavior VC_CHARS_AFTER_SHAPING = 1
Visualizza i glifi mappati sui primi Label.visible_characters o RichTextLabel.visible_characters caratteri dall'inizio del testo.
VisibleCharactersBehavior VC_GLYPHS_AUTO = 2
Visualizza Label.visible_ratio o RichTextLabel.visible_ratio glifi, partendo da sinistra o da destra, a seconda del valore di Control.layout_direction.
VisibleCharactersBehavior VC_GLYPHS_LTR = 3
Visualizza Label.visible_ratio o RichTextLabel.visible_ratio glifi, partendo da sinistra.
VisibleCharactersBehavior VC_GLYPHS_RTL = 4
Visualizza Label.visible_ratio o RichTextLabel.visible_ratio glifi, partendo da destra.
enum OverrunBehavior: 🔗
OverrunBehavior OVERRUN_NO_TRIMMING = 0
Non viene eseguito alcun ritaglio del testo.
OverrunBehavior OVERRUN_TRIM_CHAR = 1
Ritaglia il testo per carattere.
OverrunBehavior OVERRUN_TRIM_WORD = 2
Ritaglia il testo per parola.
OverrunBehavior OVERRUN_TRIM_ELLIPSIS = 3
Riduce il testo per carattere e aggiunge un'elissi per indicare che alcune parti sono nascoste se il testo ridotto è lungo 6 caratteri o più.
OverrunBehavior OVERRUN_TRIM_WORD_ELLIPSIS = 4
Riduce il testo per parola e aggiunge un'elissi per indicare che alcune parti sono nascoste se il testo ridotto è lungo 6 caratteri o più.
OverrunBehavior OVERRUN_TRIM_ELLIPSIS_FORCE = 5
Riduce il testo per carattere e aggiunge un'elissi per indicare che alcune parti sono nascoste a prescindere dalla lunghezza del testo ridotto.
OverrunBehavior OVERRUN_TRIM_WORD_ELLIPSIS_FORCE = 6
Riduce il testo per parola e aggiunge un'elissi per indicare che alcune parti sono nascoste a prescindere dalla lunghezza del testo ridotto.
flags TextOverrunFlag: 🔗
TextOverrunFlag OVERRUN_NO_TRIM = 0
Non viene eseguito alcun ritaglio.
TextOverrunFlag OVERRUN_TRIM = 1
Ritaglia il testo quando supera la larghezza specificata.
TextOverrunFlag OVERRUN_TRIM_WORD_ONLY = 2
Ritaglia il testo parola per parola anziché per grafema.
TextOverrunFlag OVERRUN_ADD_ELLIPSIS = 4
Determina se aggiungere un'elissi (puntini di sospensione) alla fine del testo.
TextOverrunFlag OVERRUN_ENFORCE_ELLIPSIS = 8
Determina se l'elissi (puntini di sospensione) alla fine del testo sono imposti e non possono essere nascosti.
TextOverrunFlag OVERRUN_JUSTIFICATION_AWARE = 16
Tiene conto del fatto che il testo è giustificato prima di tentare di ritagliarlo (vedi JustificationFlag).
TextOverrunFlag OVERRUN_SHORT_STRING_ELLIPSIS = 32
Determines whether the ellipsis should be added regardless of the string length, otherwise it is added only if the string is 6 characters or longer.
flags GraphemeFlag: 🔗
GraphemeFlag GRAPHEME_IS_VALID = 1
Il grafema è supportato dal font e può essere disegnato.
GraphemeFlag GRAPHEME_IS_RTL = 2
Il grafema fa parte dell'esecuzione da destra a sinistra o dal basso verso l'alto.
GraphemeFlag GRAPHEME_IS_VIRTUAL = 4
Il grafema non fa parte del testo sorgente, è stato aggiunto tramite il processo di giustificazione.
GraphemeFlag GRAPHEME_IS_SPACE = 8
Il grafema è spazio vuoto.
GraphemeFlag GRAPHEME_IS_BREAK_HARD = 16
Il grafema è un punto di interruzione obbligatorio (ad esempio "\n").
GraphemeFlag GRAPHEME_IS_BREAK_SOFT = 32
Il grafema è un punto di interruzione facoltativo (ad esempio uno spazio).
GraphemeFlag GRAPHEME_IS_TAB = 64
Il grafema è il carattere di tabulazione.
GraphemeFlag GRAPHEME_IS_ELONGATION = 128
Il grafema è kashida.
GraphemeFlag GRAPHEME_IS_PUNCTUATION = 256
Il grafema è un carattere di punteggiatura.
GraphemeFlag GRAPHEME_IS_UNDERSCORE = 512
Il grafema è un carattere di sottolineatura.
GraphemeFlag GRAPHEME_IS_CONNECTED = 1024
Il grafema è collegato al grafema precedente. Interrompere la riga prima di questo grafema non è sicuro.
GraphemeFlag GRAPHEME_IS_SAFE_TO_INSERT_TATWEEL = 2048
È sicuro inserire un U+0640 prima di questo grafema per l'allungamento.
GraphemeFlag GRAPHEME_IS_EMBEDDED_OBJECT = 4096
Il grafema è un carattere di sostituzione dell'oggetto incorporato.
GraphemeFlag GRAPHEME_IS_SOFT_HYPHEN = 8192
Il grafema è un trattino morbido.
enum Hinting: 🔗
Hinting HINTING_NONE = 0
Disattiva l'hinting del font (più fluido ma meno nitido).
Hinting HINTING_LIGHT = 1
Utilizza la modalità di hinting del font leggero.
Hinting HINTING_NORMAL = 2
Usa la modalità di hinting predefinita (più nitida ma meno fluida).
Nota: Questa modalità di hinting modifica sia le metriche dei glifi orizzontali sia quelle verticali. Se applicata a un font monospazio, alcuni glifi potrebbero avere una larghezza diversa.
enum SubpixelPositioning: 🔗
SubpixelPositioning SUBPIXEL_POSITIONING_DISABLED = 0
La posizione orizzontale del glifo è arrotondata alla dimensione intera del pixel, ogni glifo è rasterizzato una volta.
SubpixelPositioning SUBPIXEL_POSITIONING_AUTO = 1
La posizione orizzontale del glifo è arrotondata in base alla dimensione del font.
A un quarto della dimensione in pixel, se la dimensione del font è inferiore o uguale a SUBPIXEL_POSITIONING_ONE_QUARTER_MAX_SIZE.
A metà della dimensione in pixel, se la dimensione del font è inferiore o uguale a SUBPIXEL_POSITIONING_ONE_HALF_MAX_SIZE.
All'intera dimensione in pixel per i font più grandi.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_HALF = 2
La posizione orizzontale del glifo è arrotondata alla metà della dimensione del pixel; ogni glifo è rasterizzato fino a due volte.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_QUARTER = 3
La posizione orizzontale del glifo è arrotondata a un quarto della dimensione del pixel; ogni glifo è rasterizzato fino a quattro volte.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_HALF_MAX_SIZE = 20
Dimensione massima per i font che utilizzerà il posizionamento subpixel "metà di un pixel" in modalità SUBPIXEL_POSITIONING_AUTO.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_QUARTER_MAX_SIZE = 16
Dimensione massima per i font che utilizzerà il posizionamento subpixel "un quarto di un pixel" in modalità SUBPIXEL_POSITIONING_AUTO.
enum Feature: 🔗
Feature FEATURE_SIMPLE_LAYOUT = 1
Il TextServer supporta layout di testo semplici.
Feature FEATURE_BIDI_LAYOUT = 2
Il TextServer supporta layout di testo bidirezionali.
Feature FEATURE_VERTICAL_LAYOUT = 4
Il TextServer supporta layout verticali.
Feature FEATURE_SHAPING = 8
TextServer supporta la formazione complessa di testo.
Feature FEATURE_KASHIDA_JUSTIFICATION = 16
Il TextServer supporta la giustificazione tramite kashida.
Feature FEATURE_BREAK_ITERATORS = 32
TextServer supporta regole complesse di interruzione di riga/parola (ad esempio basate su dizionari).
Feature FEATURE_FONT_BITMAP = 64
Il TextServer supporta il caricamento di font bitmap.
Feature FEATURE_FONT_DYNAMIC = 128
Il TextServer supporta il caricamento di font dinamici (TrueType, OpeType, ecc.).
Feature FEATURE_FONT_MSDF = 256
Il TextServer supporta il rendering dei font dinamici con multichannel signed distance field (MSDF).
Feature FEATURE_FONT_SYSTEM = 512
Il TextServer supporta il caricamento dei font di sistema.
Feature FEATURE_FONT_VARIABLE = 1024
Il TextServer supporta i font variabili.
Feature FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION = 2048
Il TextServer supporta la conversione delle maiuscole e delle minuscole in base al contesto e alle impostazioni locali.
Feature FEATURE_USE_SUPPORT_DATA = 4096
Il TextServer richiede un file esterno di dati per alcune funzionalità, vedi load_support_data().
Feature FEATURE_UNICODE_IDENTIFIERS = 8192
Il TextServer supporta la convalida dell'identificatore UAX #31, vedi is_valid_identifier().
Feature FEATURE_UNICODE_SECURITY = 16384
Il TextServer supporta le funzionalità di rilevamento di spoofing basate su Unicode Technical Report #36 e Unicode Technical Standard #39.
enum ContourPointTag: 🔗
ContourPointTag CONTOUR_CURVE_TAG_ON = 1
Il punto di contorno si trova sulla curva.
ContourPointTag CONTOUR_CURVE_TAG_OFF_CONIC = 0
Il punto di contorno non si trova sulla curva, ma funge da punto di controllo per un arco di Bézier conico (quadratico).
ContourPointTag CONTOUR_CURVE_TAG_OFF_CUBIC = 2
Il punto di contorno non si trova sulla curva, ma funge da punto di controllo per un arco di Bézier cubico.
enum SpacingType: 🔗
SpacingType SPACING_GLYPH = 0
Spaziatura per ogni glifo.
SpacingType SPACING_SPACE = 1
Spaziatura per il carattere di spazio.
SpacingType SPACING_TOP = 2
Spaziatura sopra la riga.
SpacingType SPACING_BOTTOM = 3
Spaziatura sotto la riga.
SpacingType SPACING_MAX = 4
Rappresenta la dimensione dell'enumerazione SpacingType.
flags FontStyle: 🔗
FontStyle FONT_BOLD = 1
Il font è in grassetto.
FontStyle FONT_ITALIC = 2
Il font è in corsivo o obliquo.
FontStyle FONT_FIXED_WIDTH = 4
Il font ha caratteri a larghezza fissa (noti anche come monospace).
enum StructuredTextParser: 🔗
StructuredTextParser STRUCTURED_TEXT_DEFAULT = 0
Utilizza l'algoritmo Unicode BiDi predefinito.
StructuredTextParser STRUCTURED_TEXT_URI = 1
Sovrascrittura BiDi per URI.
StructuredTextParser STRUCTURED_TEXT_FILE = 2
Sovrascrittura BiDi per il percorso di file.
StructuredTextParser STRUCTURED_TEXT_EMAIL = 3
Sovrascrittura BiDi per l'email.
StructuredTextParser STRUCTURED_TEXT_LIST = 4
Sovrascrittura BiDi per le liste. Opzioni di testo strutturato: separatore di lista String.
StructuredTextParser STRUCTURED_TEXT_GDSCRIPT = 5
Sovrascrittura BiDi per GDScript.
StructuredTextParser STRUCTURED_TEXT_CUSTOM = 6
Funzione di sostituzione del BiDi di testo strutturato definito dall'utente.
enum FixedSizeScaleMode: 🔗
FixedSizeScaleMode FIXED_SIZE_SCALE_DISABLE = 0
Il font bitmap non è ridimensionato.
FixedSizeScaleMode FIXED_SIZE_SCALE_INTEGER_ONLY = 1
Il font bitmap è ridimensionato al multiplo intero più vicino della dimensione fissa del font. Questa è l'opzione consigliata per i font pixel art.
FixedSizeScaleMode FIXED_SIZE_SCALE_ENABLED = 2
Il font bitmap è ridimensionato a una dimensione arbitraria (frazionaria). Questa è l'opzione consigliata per i font non pixel art.
Descrizioni dei metodi
Crea una nuova risorsa vuota per la voce nella cache del font. Per liberare la risorsa risultante, usa il metodo free_rid().
RID create_font_linked_variation(font_rid: RID) 🔗
Crea una nuova variazione di font esistente che riutilizza la stessa cache dei glifi e gli stessi dati del font. Per liberare la risorsa risultante, usa il metodo free_rid().
RID create_shaped_text(direction: Direction = 0, orientation: Orientation = 0) 🔗
Crea un nuovo buffer per i layout di testo complesso, con la direzione (direction) e l'orientamento (orientation) specificati. Per liberare il buffer risultante, usa il metodo free_rid().
Nota: La direzione è ignorata se il server non supporta la funzionalità FEATURE_BIDI_LAYOUT (supportata da TextServerAdvanced).
Nota: L'orientamento è ignorato se il server non supporta la funzionalità FEATURE_VERTICAL_LAYOUT (supportata da TextServerAdvanced).
void draw_hex_code_box(canvas: RID, size: int, pos: Vector2, index: int, color: Color) const 🔗
Disegna una casella che visualizza il codice esadecimale di un carattere. Utilizzato per sostituire i caratteri mancanti.
void font_clear_glyphs(font_rid: RID, size: Vector2i) 🔗
Rimuove tutte le informazioni sui glifi renderizzati dalla voce nella cache.
Nota: Questa funzione non rimuoverà le texture associate ai glifi, usa font_remove_texture() per rimuoverle manualmente.
void font_clear_kerning_map(font_rid: RID, size: int) 🔗
Rimuove tutte le sostituzioni di crenatura.
void font_clear_size_cache(font_rid: RID) 🔗
Rimuove tutte le dimensioni del font dalla voce nella cache.
void font_clear_system_fallback_cache() 🔗
Libera tutti i font di sistema caricati automaticamente.
void font_clear_textures(font_rid: RID, size: Vector2i) 🔗
Rimuove tutte le texture dalla voce nella cache di un font.
Nota: Questa funzione non rimuoverà i glifi associati alla texture, usa font_remove_texture() per rimuoverle manualmente.
void font_draw_glyph(font_rid: RID, canvas: RID, size: int, pos: Vector2, index: int, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Disegna un singolo glifo in un elemento canvas nella posizione specificata, usando font_rid alla dimensione size. Se oversampling è maggiore di zero, è utilizzato come fattore di sovracampionamento del font, altrimenti sono utilizzate le impostazioni di sovracampionamento della viewport.
Nota: L'indice del glifo è specifico del font, usa gli indici dei glifi restituiti da shaped_text_get_glyphs() o font_get_glyph_index().
Nota: Se ci sono glifi in sospeso da renderizzare, chiamare questa funzione potrebbe attivare l'aggiornamento della cache delle texture.
void font_draw_glyph_outline(font_rid: RID, canvas: RID, size: int, outline_size: int, pos: Vector2, index: int, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Disegna il singolo contorno di dimensioni outline_size di un glifo in un elemento canvas nella posizione specificata, usando font_rid alla dimensione size. Se oversampling è maggiore di zero, è utilizzato come fattore di sovracampionamento del font, altrimenti sono utilizzate le impostazioni di sovracampionamento della viewport.
Nota: L'indice del glifo è specifico del font, usa gli indici dei glifi restituiti da shaped_text_get_glyphs() o font_get_glyph_index().
Nota: Se ci sono glifi in sospeso da renderizzare, chiamare questa funzione potrebbe attivare l'aggiornamento della cache delle texture.
FontAntialiasing font_get_antialiasing(font_rid: RID) const 🔗
Restituisce la modalità di antialiasing del font.
float font_get_ascent(font_rid: RID, size: int) const 🔗
Restituisce l'ascesa del font (numero di pixel sopra la linea di base).
float font_get_baseline_offset(font_rid: RID) const 🔗
Restituisce lo scostamento aggiuntivo dalla linea di base (come frazione dell'altezza del font).
int font_get_char_from_glyph_index(font_rid: RID, size: int, glyph_index: int) const 🔗
Restituisce il codice carattere associato all'indice del glifo glyph_index, oppure 0 se glyph_index non è valido. Vedi font_get_glyph_index().
float font_get_descent(font_rid: RID, size: int) const 🔗
Restituisce la discesa del font (numero di pixel sotto la linea di base).
bool font_get_disable_embedded_bitmaps(font_rid: RID) const 🔗
Restituisce se il caricamento della bitmap incorporata nel font è disabilitato.
float font_get_embolden(font_rid: RID) const 🔗
Restituisce l'intensità del grassetto del font.
int font_get_face_count(font_rid: RID) const 🔗
Restituisce il numero di facce nella collezione TrueType / OpenType.
int font_get_face_index(font_rid: RID) const 🔗
Restituisce un indice di faccia attivo nella collezione TrueType / OpenType.
int font_get_fixed_size(font_rid: RID) const 🔗
Restituisce la dimensione fissa di un font bitmap.
FixedSizeScaleMode font_get_fixed_size_scale_mode(font_rid: RID) const 🔗
Restituisce la modalità di ridimensionamento di un font bitmap.
bool font_get_generate_mipmaps(font_rid: RID) const 🔗
Restituisce true se la generazione delle mipmap per la texture del font è abilitata.
float font_get_global_oversampling() const 🔗
Deprecato: Use Viewport oversampling, or the oversampling argument of the draw_* methods instead.
This method does nothing and always returns 1.0.
Vector2 font_get_glyph_advance(font_rid: RID, size: int, glyph: int) const 🔗
Restituisce l'avanzamento di un glifo (scostamento del glifo successivo).
Nota: L'avanzamento per i contorni dei glifi è lo stesso di quello di base e non viene salvato.
Dictionary font_get_glyph_contours(font: RID, size: int, index: int) const 🔗
Restituisce i contorni del glifo come un Dictionary con il seguente contenuto:
points - PackedVector3Array, contenente i punti del contorno. x e y sono coordinate del punto. z è il tipo del punto, usando i valori di ContourPointTag.
contours - PackedInt32Array, contenente gli indici dei punti finali di ogni contorno.
orientation - bool, orientamento del contorno. Se true, i contorni in senso orario devono essere riempiti.
Due punti CONTOUR_CURVE_TAG_ON successivi indicano un segmento di linea.
Un punto CONTOUR_CURVE_TAG_OFF_CONIC tra due punti CONTOUR_CURVE_TAG_ON indica un singolo arco di Bézier conico (quadratico).
Due punti CONTOUR_CURVE_TAG_OFF_CUBIC tra due punti CONTOUR_CURVE_TAG_ON costanti indicano un singolo arco di Bézier cubico.
Due punti CONTOUR_CURVE_TAG_OFF_CONIC successivi indicano due archi di Bézier conici (quadratici) successivi con un punto virtuale CONTOUR_CURVE_TAG_ON al centro.
Ogni contorno è chiuso. L'ultimo punto di un contorno usa il primo punto di un contorno come punto successivo e viceversa. Il primo punto può essere un punto CONTOUR_CURVE_TAG_OFF_CONIC.
int font_get_glyph_index(font_rid: RID, size: int, char: int, variation_selector: int) const 🔗
Restituisce l'indice di glifo del carattere char, facoltativamente modificato dal selettore di variazione variation_selector. Vedi font_get_char_from_glyph_index().
PackedInt32Array font_get_glyph_list(font_rid: RID, size: Vector2i) const 🔗
Restituisce la lista dei glifi renderizzati nella voce nella cache.
Vector2 font_get_glyph_offset(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Restituisce l'offset del glifo dalla linea di base.
Vector2 font_get_glyph_size(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Restituisce le dimensioni del glifo.
int font_get_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Restituisce l'indice della texture nella cache contenente il glifo.
RID font_get_glyph_texture_rid(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Restituisce l'ID risorsa della texture nella cache contenente il glifo.
Nota: Se ci sono glifi in sospeso da renderizzare, la chiamata di questa funzione potrebbe attivare l'aggiornamento della cache delle texture.
Vector2 font_get_glyph_texture_size(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Restituisce le dimensioni della texture nella cache contenente il glifo.
Nota: Se ci sono glifi in sospeso da renderizzare, la chiamata di questa funzione potrebbe attivare l'aggiornamento della cache delle texture.
Rect2 font_get_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Restituisce il rettangolo nella texture nella cache contenente il glifo.
Hinting font_get_hinting(font_rid: RID) const 🔗
Restituisce la modalità di hinting del font. Utilizzata solo dai font dinamici.
bool font_get_keep_rounding_remainders(font_rid: RID) const 🔗
Restituisce il comportamento di arrotondamento delle posizioni dei glifi. Se impostato su true, quando si allineano i glifi ai confini dei pixel, il resto dopo l'arrotondamento viene accumulato per garantire una distribuzione più uniforme dei glifi. Questa impostazione non ha effetto se è abilitato il posizionamento subpixel.
Vector2 font_get_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) const 🔗
Restituisce la crenatura per la coppia di glifi.
Array[Vector2i] font_get_kerning_list(font_rid: RID, size: int) const 🔗
Restituisce la lista delle sostituzioni di crenatura.
bool font_get_language_support_override(font_rid: RID, language: String) 🔗
Restituisce true se la sostituzione di supporto è abilitata per la lingua language.
PackedStringArray font_get_language_support_overrides(font_rid: RID) 🔗
Restituisce la lista di sostituzioni di supporto di lingua.
int font_get_msdf_pixel_range(font_rid: RID) const 🔗
Returns the width of the range around the shape between the minimum and maximum representable signed distance.
int font_get_msdf_size(font_rid: RID) const 🔗
Restituisce la dimensione del font sorgente utilizzato per generare le texture MSDF.
String font_get_name(font_rid: RID) const 🔗
Restituisce il nome della famiglia del font.
Dictionary font_get_opentype_feature_overrides(font_rid: RID) const 🔗
Restituisce la sostituzione dell'insieme di funzionalità OpenType del font.
Dictionary font_get_ot_name_strings(font_rid: RID) const 🔗
Restituisce un Dictionary con le stringhe di nomi di font OpenType (nomi di font localizzati, versione, descrizione, informazioni sulla licenza, testo di esempio, ecc.).
float font_get_oversampling(font_rid: RID) const 🔗
Restituisce la sostituzione del fattore di sovracampionamento. Se impostato su un valore positivo, sostituisce il fattore di sovracampionamento della viewport in cui è utilizzato questo font. Vedi Viewport.oversampling. Questo valore non sostituisce il parametro oversampling dei metodi draw_*. Utilizzato solo dai font dinamici.
PackedColorArray font_get_palette_colors(font_rid: RID, index: int) const 🔗
Returns the array in the predefined color palette at index. Palette contains all colors used to render font glyphs. Each palette has the same number of colors. Colors can be overridden using font_set_palette_custom_colors().
int font_get_palette_count(font_rid: RID) const 🔗
Returns the number of predefined color palettes. Palette contains all colors used to render font glyphs. Each palette has the same number of colors.
PackedColorArray font_get_palette_custom_colors(font_rid: RID) const 🔗
Returns array of custom colors to override predefined palette.
String font_get_palette_name(font_rid: RID, index: int) const 🔗
Returns the name of the predefined color palette at index. Palette contains all colors used to render font glyphs. Each palette has the same number of colors.
float font_get_scale(font_rid: RID, size: int) const 🔗
Restituisce il fattore di scala del font bitmap a colori.
bool font_get_script_support_override(font_rid: RID, script: String) 🔗
Restituisce true se la sostituzione di supporto è abilitata per l'alfabeto script.
PackedStringArray font_get_script_support_overrides(font_rid: RID) 🔗
Restituisce la lista delle sostituzioni di supporto d'alfabeto.
Array[Dictionary] font_get_size_cache_info(font_rid: RID) const 🔗
Restituisce informazioni sulla cache del font, ogni voce contiene i seguenti campi: Vector2i size_px - dimensione del font in pixel, float viewport_oversampling - fattore di sovracampionamento della viewport, int glyphs - numero di glifi renderizzati, int textures - numero di texture utilizzate, int textures_size - dimensione dei dati della texture in byte.
Array[Vector2i] font_get_size_cache_list(font_rid: RID) const 🔗
Restituisce la lista delle dimensioni del font nella cache. Ogni dimensione è un Vector2i con dimensioni del font e dimensioni del contorno.
int font_get_spacing(font_rid: RID, spacing: SpacingType) const 🔗
Restituisce la spaziatura per spacing in pixel (non relativa alla dimensione del font).
int font_get_stretch(font_rid: RID) const 🔗
Restituisce la quantità di allungamento del font, rispetto a una larghezza normale. Un valore percentuale compreso tra 50% e 200%.
BitField[FontStyle] font_get_style(font_rid: RID) const 🔗
Restituisce i flag di stile del font.
String font_get_style_name(font_rid: RID) const 🔗
Restituisce il nome dello stile del font.
SubpixelPositioning font_get_subpixel_positioning(font_rid: RID) const 🔗
Restituisce la modalità di posizionamento subpixel del glifo di un font.
String font_get_supported_chars(font_rid: RID) const 🔗
Restituisce una stringa contenente tutti i caratteri disponibili nel font.
PackedInt32Array font_get_supported_glyphs(font_rid: RID) const 🔗
Restituisce un array contenente tutti gli indici dei glifi nel font.
int font_get_texture_count(font_rid: RID, size: Vector2i) const 🔗
Restituisce il numero di texture utilizzate dalla voce nella cache del font.
Image font_get_texture_image(font_rid: RID, size: Vector2i, texture_index: int) const 🔗
Restituisce i dati dell'immagine della texture nella cache del font.
PackedInt32Array font_get_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int) const 🔗
Restituisce l'array contenente i dati di impacchettamento dei glifi.
Transform2D font_get_transform(font_rid: RID) const 🔗
Restituisce la trasformazione 2D applicata ai contorni del font.
float font_get_underline_position(font_rid: RID, size: int) const 🔗
Restituisce l'offset in pixel della sottolineatura sotto la linea di base.
float font_get_underline_thickness(font_rid: RID, size: int) const 🔗
Restituisce lo spessore della sottolineatura in pixel.
int font_get_used_palette(font_rid: RID) const 🔗
Returns used palette index.
Dictionary font_get_variation_coordinates(font_rid: RID) const 🔗
Restituisce le coordinate di variazione per la voce specificata nella cache del font. Vedi font_supported_variation_list() per maggiori informazioni.
int font_get_weight(font_rid: RID) const 🔗
Restituisce il peso (grassetto) del font. Un valore nell'intervallo 100...999, il peso normale di un font è 400, il peso di un font in grassetto è 700.
bool font_has_char(font_rid: RID, char: int) const 🔗
Restituisce true se il carattere Unicode char è disponibile nel font.
bool font_is_allow_system_fallback(font_rid: RID) const 🔗
Restituisce true se i font del sistema possono essere utilizzati automaticamente come alternative di riserva.
bool font_is_force_autohinter(font_rid: RID) const 🔗
Restituisce true se l'hinting automatico è supportato e preferito rispetto all'hinting integrato nel font. Utilizzato solo dai font dinamici.
bool font_is_language_supported(font_rid: RID, language: String) const 🔗
Returns true if the font supports the given language (as a ISO 639 code).
bool font_is_modulate_color_glyphs(font_rid: RID) const 🔗
Returns true if color modulation is applied when drawing the font's colored glyphs.
bool font_is_multichannel_signed_distance_field(font_rid: RID) const 🔗
Restituisce true se i glifi di tutte le dimensioni sono renderizzati utilizzando un singolo MSDF generato dai dati vettoriali dei font dinamici.
bool font_is_script_supported(font_rid: RID, script: String) const 🔗
Returns true if the font supports the given script (as a ISO 15924 code).
void font_remove_glyph(font_rid: RID, size: Vector2i, glyph: int) 🔗
Rimuove le informazioni specificate sui glifi renderizzati dalla voce nella cache.
Nota: Questa funzione non rimuoverà le texture associate ai glifi, usa font_remove_texture() per rimuoverle manualmente.
void font_remove_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) 🔗
Rimuove la sostituzione della crenatura per la coppia di glifi.
void font_remove_language_support_override(font_rid: RID, language: String) 🔗
Rimuove la sostituzione di supporto di lingua.
void font_remove_script_support_override(font_rid: RID, script: String) 🔗
Rimuove la sostituzione di supporto d'alfabeto.
void font_remove_size_cache(font_rid: RID, size: Vector2i) 🔗
Rimuove la dimensione specificata del font dalla voce nella cache.
void font_remove_texture(font_rid: RID, size: Vector2i, texture_index: int) 🔗
Rimuove la texture specificata dalla voce nella cache.
Nota: Questa funzione non rimuoverà i glifi associati alla texture. Rimuovili manualmente usando font_remove_glyph().
void font_render_glyph(font_rid: RID, size: Vector2i, index: int) 🔗
Renderizza il glifo specificato nella texture nella cache del font.
void font_render_range(font_rid: RID, size: Vector2i, start: int, end: int) 🔗
Renderizza l'intervallo di caratteri nella texture nella cache del font.
void font_set_allow_system_fallback(font_rid: RID, allow_system_fallback: bool) 🔗
Se impostato su true, i font del sistema possono essere utilizzati automaticamente come alternative di riserva.
void font_set_antialiasing(font_rid: RID, antialiasing: FontAntialiasing) 🔗
Imposta la modalità di antialiasing del font.
void font_set_ascent(font_rid: RID, size: int, ascent: float) 🔗
Imposta l'ascesa del font (numero di pixel sopra la linea di base).
void font_set_baseline_offset(font_rid: RID, baseline_offset: float) 🔗
Imposta lo scostamento aggiuntivo dalla linea di base (come frazione dell'altezza del font).
void font_set_data(font_rid: RID, data: PackedByteArray) 🔗
Imposta i dati di origine del font, ad esempio il contenuto del file sorgente di un font dinamico.
void font_set_descent(font_rid: RID, size: int, descent: float) 🔗
Imposta la discesa del font (numero di pixel sotto la linea di base).
void font_set_disable_embedded_bitmaps(font_rid: RID, disable_embedded_bitmaps: bool) 🔗
Se impostato su true, il caricamento delle bitmap dei font incorporati è disabilitato (i font solo con bitmap e i font colorati ignorano questa proprietà).
void font_set_embolden(font_rid: RID, strength: float) 🔗
Imposta l'intensità del grassetto del font. Se strength non è uguale a zero, applica il grassetto ai contorni del font. I valori negativi riducono lo spessore del contorno.
void font_set_face_index(font_rid: RID, face_index: int) 🔗
Imposta un indice di faccia attivo nella collezione TrueType/OpenType.
void font_set_fixed_size(font_rid: RID, fixed_size: int) 🔗
Imposta la dimensione fissa del font bitmap. Se impostato su un valore maggiore di zero, verrà utilizzata la stessa voce nella cache per tutte le dimensioni del font.
void font_set_fixed_size_scale_mode(font_rid: RID, fixed_size_scale_mode: FixedSizeScaleMode) 🔗
Imposta la modalità di ridimensionamento dei font bitmap. Questa proprietà viene utilizzata solo se fixed_size è maggiore di zero.
void font_set_force_autohinter(font_rid: RID, force_autohinter: bool) 🔗
Se impostato su true l'hinting automatico è preferito all'hinting incorporato nel font.
void font_set_generate_mipmaps(font_rid: RID, generate_mipmaps: bool) 🔗
Se impostato su true la generazione delle mipmap per la texture del font è abilitata.
void font_set_global_oversampling(oversampling: float) 🔗
Deprecato: Use Viewport oversampling, or the oversampling argument of the draw_* methods instead.
Questo metodo non fa nulla.
void font_set_glyph_advance(font_rid: RID, size: int, glyph: int, advance: Vector2) 🔗
Imposta l'avanzamento del glifo (offset del glifo successivo).
Nota: L'avanzamento per i contorni dei glifi è lo stesso dell'avanzamento del glifo di base e non viene salvato.
void font_set_glyph_offset(font_rid: RID, size: Vector2i, glyph: int, offset: Vector2) 🔗
Imposta l'offset del glifo dalla linea di base.
void font_set_glyph_size(font_rid: RID, size: Vector2i, glyph: int, gl_size: Vector2) 🔗
Imposta le dimensioni del glifo.
void font_set_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int, texture_idx: int) 🔗
Imposta l'indice della texture nella cache contenente il glifo.
void font_set_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int, uv_rect: Rect2) 🔗
Imposta il rettangolo nella texture nella cache contenente il glifo.
void font_set_hinting(font_rid: RID, hinting: Hinting) 🔗
Imposta la modalità di hinting del font. Utilizzata solo dai font dinamici.
void font_set_keep_rounding_remainders(font_rid: RID, keep_rounding_remainders: bool) 🔗
Imposta il comportamento di arrotondamento delle posizioni dei glifi. Se impostato su true, quando si allineano i glifi ai confini dei pixel, il resto dopo l'arrotondamento viene accumulato per garantire una distribuzione più uniforme dei glifi. Questa impostazione non ha effetto se è abilitato il posizionamento subpixel.
void font_set_kerning(font_rid: RID, size: int, glyph_pair: Vector2i, kerning: Vector2) 🔗
Imposta la crenatura per la coppia di glifi.
void font_set_language_support_override(font_rid: RID, language: String, supported: bool) 🔗
Aggiunge una sostituzione per font_is_language_supported().
void font_set_modulate_color_glyphs(font_rid: RID, modulate: bool) 🔗
Se impostato su true, la modulazione del colore è applicata quando si disegnano glifi colorati, altrimenti è applicata solo ai glifi monocromatici.
void font_set_msdf_pixel_range(font_rid: RID, msdf_pixel_range: int) 🔗
Sets the width of the range around the shape between the minimum and maximum representable signed distance.
void font_set_msdf_size(font_rid: RID, msdf_size: int) 🔗
Imposta la dimensione del font sorgente utilizzato per generare le texture MSDF.
void font_set_multichannel_signed_distance_field(font_rid: RID, msdf: bool) 🔗
Se impostato su true, i glifi di tutte le dimensioni sono renderizzati utilizzando un singolo MSDF, generato dai dati vettoriali dei font dinamici. Il rendering MSDF consente di visualizzare il font a qualsiasi fattore di scala senza sfocatura e senza comportare un costo sulla CPU quando cambia la dimensione del font (poiché il font non deve più essere rasterizzato sulla CPU). Come svantaggio, il font hinting non è disponibile con MSDF. La mancanza di font hinting può risultare in font meno nitidi e meno leggibili a piccole dimensioni.
Nota: Il rendering dei font MSDF non renderizza correttamente i glifi con forme sovrapposte. Le forme sovrapposte non sono valide secondo lo standard OpenType, ma sono ancora comunemente presenti in molti file di font, in particolare quelli convertiti da Google Fonts. Per evitare problemi con i glifi sovrapposti, si consiglia di scaricare il file dei font direttamente dalla fonderia di font invece di affidarti a Google Fonts.
void font_set_name(font_rid: RID, name: String) 🔗
Imposta il nome della famiglia del font.
void font_set_opentype_feature_overrides(font_rid: RID, overrides: Dictionary) 🔗
Imposta la sostituzione dell'insieme di funzionalità OpenType del font.
void font_set_oversampling(font_rid: RID, oversampling: float) 🔗
Se impostato su un valore positivo, sostituisce il fattore di sovracampionamento della viewport in cui è utilizzato questo font. Vedi Viewport.oversampling. Questo valore non sostituisce il parametro oversampling dei metodi draw_*. Utilizzato solo dai font dinamici.
void font_set_palette_custom_colors(font_rid: RID, colors: PackedColorArray) 🔗
Sets array of custom colors to override predefined palette. Set to empty array to reset overrides. Use Color(0, 0, 0, 0), to keep predefined palette color at specific position.
void font_set_scale(font_rid: RID, size: int, scale: float) 🔗
Imposta il fattore di scala del font bitmap a colori.
void font_set_script_support_override(font_rid: RID, script: String, supported: bool) 🔗
Aggiunge una sostituzione per font_is_script_supported().
void font_set_spacing(font_rid: RID, spacing: SpacingType, value: int) 🔗
Imposta la spaziatura per spacing su value in pixel (non relativa alla dimensione del font).
void font_set_stretch(font_rid: RID, weight: int) 🔗
Imposta la quantità di allungamento del font, rispetto a una larghezza normale. Un valore percentuale compreso tra 50% e 200%.
Nota: Questo valore è utilizzato solo per corrispondere i font e non influirà su come un font viene renderizzato. Utilizza invece font_set_face_index(), font_set_variation_coordinates() o font_set_transform().
void font_set_style(font_rid: RID, style: BitField[FontStyle]) 🔗
Imposta i flag di stile del font.
Nota: Questo valore è usato solo per abbinare i font e non influirà sul rendering del font. Usa invece font_set_face_index(), font_set_variation_coordinates(), font_set_embolden() o font_set_transform().
void font_set_style_name(font_rid: RID, name: String) 🔗
Imposta il nome dello stile del font.
void font_set_subpixel_positioning(font_rid: RID, subpixel_positioning: SubpixelPositioning) 🔗
Imposta la modalità di posizionamento subpixel del glifo di un font.
void font_set_texture_image(font_rid: RID, size: Vector2i, texture_index: int, image: Image) 🔗
Imposta i dati dell'immagine della texture nella cache del font.
void font_set_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int, offset: PackedInt32Array) 🔗
Imposta l'array contenente i dati di impacchettamento dei glifi.
void font_set_transform(font_rid: RID, transform: Transform2D) 🔗
Imposta 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).
void font_set_underline_position(font_rid: RID, size: int, underline_position: float) 🔗
Imposta l'offset in pixel della sottolineatura sotto la linea di base.
void font_set_underline_thickness(font_rid: RID, size: int, underline_thickness: float) 🔗
Imposta lo spessore della sottolineatura in pixel.
void font_set_used_palette(font_rid: RID, index: int) 🔗
Sets used palette index.
void font_set_variation_coordinates(font_rid: RID, variation_coordinates: Dictionary) 🔗
Imposta le coordinate di variazione per la voce specificata nella cache nel font. Vedi font_supported_variation_list() per maggiori informazioni.
void font_set_weight(font_rid: RID, weight: int) 🔗
Imposta il peso (grassetto) del font. Un valore nell'intervallo 100...999, il peso normale di un font è 400, il peso di un font in grassetto è 700.
Nota: Questo valore è utilizzato solo per la corrispondenza dei font e non influirà sul rendering dei font. Utilizza invece font_set_face_index(), font_set_variation_coordinates() o font_set_embolden().
Dictionary font_supported_feature_list(font_rid: RID) const 🔗
Restituisce il dizionario delle funzionalità OpenType supportate.
Dictionary font_supported_variation_list(font_rid: RID) const 🔗
Restituisce il dizionario delle coordinate delle variazioni OpenType supportate.
String format_number(number: String, language: String = "") const 🔗
Deprecato: Use TranslationServer.format_number() instead.
Converts a number from Western Arabic (0..9) to the numeral system used in the given language.
If language is an empty string, the active locale will be used.
Libera un oggetto creato da questo TextServer.
Restituisce le funzionalità del server di testo, vedi Feature.
Vector2 get_hex_code_box_size(size: int, index: int) const 🔗
Restituisce le dimensioni del carattere sostitutivo (la casella con il codice esadecimale di un carattere che è visualizzata al posto dei caratteri non validi).
Restituisce il nome dell'interfaccia del server.
PackedByteArray get_support_data() const 🔗
Restituisce il database predefinito (ad esempio, iteratori di interruzione ICU e dizionari) del TextServer.
String get_support_data_filename() const 🔗
Restituisce il nome del file database predefinito (ad esempio, iteratori di interruzione ICU e dizionari) del TextServer.
String get_support_data_info() const 🔗
Restituisce la descrizione del database (ad esempio, iteratori di interruzione ICU e dizionari) del TextServer.
Restituisce true se rid è una risorsa valida posseduta da questo server di testo.
bool has_feature(feature: Feature) const 🔗
Restituisce true se il server supporta una funzionalità.
int is_confusable(string: String, dict: PackedStringArray) const 🔗
Restituisce l'indice della prima stringa in dict che è visivamente confondibile con string, oppure -1 se nessuna ne viene trovata.
Nota: Questo metodo non rileva i caratteri invisibili, per il rilevamento di spoofing utilizzalo in combinazione con spoof_check().
Nota: Restituisce sempre -1 se il server non supporta la funzionalità FEATURE_UNICODE_SECURITY.
bool is_locale_right_to_left(locale: String) const 🔗
Restituisce true se la localizzazione è di destra a sinistra.
bool is_locale_using_support_data(locale: String) const 🔗
Returns true if the locale requires text server support data for line/word breaking.
bool is_valid_identifier(string: String) const 🔗
Restituisce true se string è un identificatore valido.
Se il server di testo supporta la funzionalità FEATURE_UNICODE_IDENTIFIERS, un identificatore valido deve:
Essere conforme al formato di normalizzazione C.
Iniziare con un carattere Unicode di classe XID_Start o
"_".Può contenere caratteri Unicode di classe XID_Continue nelle altre posizioni.
Utilizzare solo alfabeti consigliati UAX #31 (sono consentiti alfabeti misti).
Se la funzionalità FEATURE_UNICODE_IDENTIFIERS non è supportata, un identificatore valido deve:
Iniziare con un carattere Unicode di classe XID_Start o
"_".Può contenere caratteri Unicode di classe XID_Continue nelle altre posizioni.
bool is_valid_letter(unicode: int) const 🔗
Restituisce true se il punto di codice indicato è una lettera valida, ossia appartiene alla categoria Unicode "L".
bool load_support_data(filename: String) 🔗
Carica il database facoltativo (ad esempio, iteratori di interruzione ICU e dizionari) del TextServer.
Nota: È necessario chiamare questa funzione prima di qualsiasi altra funzione nel TextServer utilizzata, altrimenti non avrà alcun effetto.
int name_to_tag(name: String) const 🔗
Converts the given readable name of a feature, variation, script, or language to an OpenType tag.
String parse_number(number: String, language: String = "") const 🔗
Deprecato: Use TranslationServer.parse_number() instead.
Converts number from the numeral system used in the given language to Western Arabic (0..9).
If language is an empty string, the active locale will be used.
Array[Vector3i] parse_structured_text(parser_type: StructuredTextParser, args: Array, text: String) const 🔗
Implementazione predefinita della funzione di sovrascrittura dell'algoritmo BiDi.
String percent_sign(language: String = "") const 🔗
Deprecato: Use TranslationServer.get_percent_sign() instead.
Returns the percent sign used in the given language.
If language is an empty string, the active locale will be used.
bool save_support_data(filename: String) const 🔗
Salva il database facoltativo (ad esempio, iteratori di interruzione ICU e dizionari) del TextServer nel file.
Nota: Questa funzione viene utilizzata durante l'esportazione del progetto, per includere il database del TextServer.
int shaped_get_run_count(shaped: RID) const 🔗
Restituisce il numero di sequenze di testo uniformi nel buffer.
Direction shaped_get_run_direction(shaped: RID, index: int) const 🔗
Restituisce la direzione della sequenza di testo all'indice index (in ordine visuale).
RID shaped_get_run_font_rid(shaped: RID, index: int) const 🔗
Restituisce il RID del font della sequenza di testo all'indice index (in ordine visuale).
int shaped_get_run_font_size(shaped: RID, index: int) const 🔗
Restituisce la dimensione del font della sequenza di testo all'indice index (in ordine visuale).
Vector2i shaped_get_run_glyph_range(shaped: RID, index: int) const 🔗
Returns the glyph range of the index text run (in visual order).
String shaped_get_run_language(shaped: RID, index: int) const 🔗
Restituisce la lingua della sequenza di testo all'indice index (in ordine visuale).
Variant shaped_get_run_object(shaped: RID, index: int) const 🔗
Restituisce l'oggetto incorporato della sequenza di testo all'indice index (in ordine visuale).
Vector2i shaped_get_run_range(shaped: RID, index: int) const 🔗
Restituisce l'intervallo di testo sorgente della sequenza di testo all'indice index (in ordine visuale).
String shaped_get_run_text(shaped: RID, index: int) const 🔗
Restituisce il testo sorgente della sequenza di testo all'indice index (in ordine visuale).
int shaped_get_span_count(shaped: RID) const 🔗
Restituisce il numero di righe di testo aggiunte tramite shaped_text_add_string() o shaped_text_add_object().
Variant shaped_get_span_embedded_object(shaped: RID, index: int) const 🔗
Restituisce la chiave di un oggetto incorporato di un testo.
Variant shaped_get_span_meta(shaped: RID, index: int) const 🔗
Restituisce i metadati di una riga di testo.
Variant shaped_get_span_object(shaped: RID, index: int) const 🔗
Restituisce la chiave di un oggetto incorporato in una riga di testo.
String shaped_get_span_text(shaped: RID, index: int) const 🔗
Restituisce il testo sorgente di una riga di testo.
String shaped_get_text(shaped: RID) const 🔗
Restituisce il testo sorgente di una riga di testo, inclusi caratteri di sostituzione degli oggetti.
void shaped_set_span_update_font(shaped: RID, index: int, fonts: Array[RID], size: int, opentype_features: Dictionary = {}) 🔗
Modifica il font, la dimensione del font e le funzionalità OpenType di una riga di testo, senza modificare il testo stesso.
bool shaped_text_add_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment = 5, length: int = 1, baseline: float = 0.0) 🔗
Aggiunge un oggetto in riga al buffer di testo, la chiave key deve essere univoca. Nel testo, l'oggetto è rappresentato come un numero di length caratteri di sostituzione.
bool shaped_text_add_string(shaped: RID, text: String, fonts: Array[RID], size: int, opentype_features: Dictionary = {}, language: String = "", meta: Variant = null) 🔗
Aggiunge una riga di testo e un font per disegnarlo nel buffer di testo.
void shaped_text_clear(rid: RID) 🔗
Cancella il buffer di testo (rimuove il testo e gli oggetti in riga).
int shaped_text_closest_character_pos(shaped: RID, pos: int) const 🔗
Restituisce la posizione del carattere composito più vicina a pos.
void shaped_text_draw(shaped: RID, canvas: RID, pos: Vector2, clip_l: float = -1, clip_r: float = -1, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Disegna un testo sagomato su un elemento canvas in una posizione specificata, con il colore color. pos specifica il punto più a sinistra della linea di base (per un layout orizzontale) o il punto più in alto della linea di base (per un layout verticale). Se oversampling è maggiore di zero, è utilizzato come fattore di sovracampionamento del font, altrimenti sono utilizzate le impostazioni di sovracampionamento della viewport.
clip_l e clip_r sono offset relativi a pos, che vanno verso destra nel layout orizzontale e verso il basso nel layout verticale. Se clip_l non è negativo, i glifi che iniziano prima dell'offset vengono troncati. Se clip_r non è negativo, i glifi che finiscono dopo l'offset sono troncati.
void shaped_text_draw_outline(shaped: RID, canvas: RID, pos: Vector2, clip_l: float = -1, clip_r: float = -1, outline_size: int = 1, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Disegna il contorno di un testo sagomato su un elemento canvas in una posizione specificata, con il colore color. pos specifica il punto più a sinistra della linea di base (per un layout orizzontale) o il punto più in alto della linea di base (per un layout verticale). Se oversampling è maggiore di zero, è utilizzato come fattore di sovracampionamento del font, altrimenti sono utilizzate le impostazioni di sovracampionamento della viewport.
clip_l e clip_r sono offset relativi a pos, che vanno verso destra nel layout orizzontale e verso il basso nel layout verticale. Se clip_l non è negativo, i glifi che iniziano prima dell'offset vengono troncati. Se clip_r non è negativo, i glifi che finiscono dopo l'offset sono troncati.
RID shaped_text_duplicate(rid: RID) 🔗
Duplicates shaped text buffer.
float shaped_text_fit_to_width(shaped: RID, width: float, justification_flags: BitField[JustificationFlag] = 3) 🔗
Adatta la larghezza del testo alla larghezza specificata, restituendo la nuova larghezza del testo.
float shaped_text_get_ascent(shaped: RID) const 🔗
Restituisce l'ascesa del testo (numero di pixel sopra la linea di base per un layout orizzontale o a sinistra della linea di base per un layout verticale).
Nota: L'ascesa totale può essere maggiore dell'ascesa del font, se alcuni glifi sono dislocati dalla linea di base.
Dictionary shaped_text_get_carets(shaped: RID, position: int) const 🔗
Restituisce le forme dei cursori corrispondenti al carattere nella posizione position nel testo. La forma restituita del cursore è un rettangolo largo 1 pixel.
PackedInt32Array shaped_text_get_character_breaks(shaped: RID) const 🔗
Restituisce un array dei confini dei caratteri compositi.
int shaped_text_get_custom_ellipsis(shaped: RID) const 🔗
Restituisce il carattere di elissi utilizzato per ritagliare il testo.
String shaped_text_get_custom_punctuation(shaped: RID) const 🔗
Restituisce una lista personalizzata di caratteri di punteggiatura, utilizzati per suddividere le parole. Se impostato su una stringa vuota, sono utilizzati i valori predefiniti del server.
float shaped_text_get_descent(shaped: RID) const 🔗
Restituisce la discesa del testo (numero di pixel sotto la linea di base per un layout orizzontale o a destra della linea di base per un layout verticale).
Nota: La discesa totale può essere maggiore della discesa del font, se alcuni glifi sono dislocati dalla linea di base.
Direction shaped_text_get_direction(shaped: RID) const 🔗
Restituisce la direzione del testo.
Direction shaped_text_get_dominant_direction_in_range(shaped: RID, start: int, end: int) const 🔗
Restituisce la direzione dominante nell'intervallo di testo.
int shaped_text_get_ellipsis_glyph_count(shaped: RID) const 🔗
Restituisce il numero di glifi nell'ellissi.
Array[Dictionary] shaped_text_get_ellipsis_glyphs(shaped: RID) const 🔗
Restituisce l'array dei glifi nell'ellissi.
int shaped_text_get_ellipsis_pos(shaped: RID) const 🔗
Restituisce la posizione dell'ellissi.
int shaped_text_get_glyph_count(shaped: RID) const 🔗
Restituisce il numero di glifi nel buffer.
Array[Dictionary] shaped_text_get_glyphs(shaped: RID) const 🔗
Restituisce un array di glifi nell'ordine visivo.
Vector2 shaped_text_get_grapheme_bounds(shaped: RID, pos: int) const 🔗
Restituisce i confini del carattere composito come offset dall'inizio della riga.
Direction shaped_text_get_inferred_direction(shaped: RID) const 🔗
Restituisce la direzione del testo, dedotta dall'algoritmo BiDi.
PackedInt32Array shaped_text_get_line_breaks(shaped: RID, width: float, start: int = 0, break_flags: BitField[LineBreakFlag] = 3) const 🔗
Suddivide il testo in righe e restituisce gli intervalli dei caratteri per ogni riga.
PackedInt32Array shaped_text_get_line_breaks_adv(shaped: RID, width: PackedFloat32Array, start: int = 0, once: bool = true, break_flags: BitField[LineBreakFlag] = 3) const 🔗
Suddivide il testo in righe e colonne. Restituisce gli intervalli dei caratteri per ogni segmento.
int shaped_text_get_object_glyph(shaped: RID, key: Variant) const 🔗
Restituisce l'indice di glifo dell'oggetto in riga.
Vector2i shaped_text_get_object_range(shaped: RID, key: Variant) const 🔗
Restituisce l'intervallo di caratteri dell'oggetto in riga.
Rect2 shaped_text_get_object_rect(shaped: RID, key: Variant) const 🔗
Restituisce il rettangolo di delimitazione dell'oggetto in riga.
Array shaped_text_get_objects(shaped: RID) const 🔗
Restituisce un array di oggetti in riga.
Orientation shaped_text_get_orientation(shaped: RID) const 🔗
Restituisce l'orientamento del testo.
RID shaped_text_get_parent(shaped: RID) const 🔗
Restituisce il buffer padre da cui proviene la sottostringa.
bool shaped_text_get_preserve_control(shaped: RID) const 🔗
Restituisce true se il buffer di testo è configurato per visualizzare i caratteri di controllo.
bool shaped_text_get_preserve_invalid(shaped: RID) const 🔗
Restituisce true se il buffer di testo è configurato per visualizzare codici esadecimali al posto di caratteri non validi.
Nota: Se impostato su false, nulla viene visualizzato al posto dei caratteri non validi.
Vector2i shaped_text_get_range(shaped: RID) const 🔗
Restituisce l'intervallo di caratteri nel buffer della sottostringa nel buffer padre.
PackedVector2Array shaped_text_get_selection(shaped: RID, start: int, end: int) const 🔗
Restituisce i rettangoli di selezione per l'intervallo di caratteri specificato.
Vector2 shaped_text_get_size(shaped: RID) const 🔗
Restituisce le dimensioni del testo.
int shaped_text_get_spacing(shaped: RID, spacing: SpacingType) const 🔗
Restituisce la spaziatura addizionale aggiunta tra i glifi o le righe, in pixel.
int shaped_text_get_trim_pos(shaped: RID) const 🔗
Restituisce la posizione del taglio di superamento.
float shaped_text_get_underline_position(shaped: RID) const 🔗
Restituisce l'offset in pixel della sottolineatura sotto la linea di base.
float shaped_text_get_underline_thickness(shaped: RID) const 🔗
Restituisce lo spessore della sottolineatura.
float shaped_text_get_width(shaped: RID) const 🔗
Restituisce la larghezza (per un layout orizzontale) o l'altezza (per un layout verticale) del testo.
PackedInt32Array shaped_text_get_word_breaks(shaped: RID, grapheme_flags: BitField[GraphemeFlag] = 264, skip_grapheme_flags: BitField[GraphemeFlag] = 4) const 🔗
Suddivide il testo in parole e restituisce un array di intervalli di caratteri. Usa grapheme_flags per impostare quali caratteri sono utilizzati per la suddivisione.
bool shaped_text_has_object(shaped: RID, key: Variant) const 🔗
Returns true if an object with key is embedded in this shaped text buffer.
bool shaped_text_has_visible_chars(shaped: RID) const 🔗
Restituisce true se il buffer di testo contiene caratteri visibili.
int shaped_text_hit_test_grapheme(shaped: RID, coords: float) const 🔗
Restituisce l'indice del grafema allo scostamento specificato in pixel sulla linea di base, oppure -1 se nessuno ne viene trovato.
int shaped_text_hit_test_position(shaped: RID, coords: float) const 🔗
Restituisce l'offset per il cursore nel pixel specificato sulla linea di base. Questa funzione restituisce sempre una posizione valida.
bool shaped_text_is_ready(shaped: RID) const 🔗
Restituisce true se il buffer è modellato con successo.
int shaped_text_next_character_pos(shaped: RID, pos: int) const 🔗
Restituisce la posizione finale del carattere composito più vicina a pos.
int shaped_text_next_grapheme_pos(shaped: RID, pos: int) const 🔗
Restituisce la posizione finale del grafema più vicina a pos.
void shaped_text_overrun_trim_to_width(shaped: RID, width: float = 0, overrun_trim_flags: BitField[TextOverrunFlag] = 0) 🔗
Ritaglia il testo se supera la larghezza specificata.
int shaped_text_prev_character_pos(shaped: RID, pos: int) const 🔗
Restituisce la posizione iniziale del carattere composito più vicina alla posizione pos.
int shaped_text_prev_grapheme_pos(shaped: RID, pos: int) const 🔗
Restituisce la posizione iniziale del grafema più vicina a pos.
bool shaped_text_resize_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment = 5, baseline: float = 0.0) 🔗
Imposta le nuove dimensioni e l'allineamento di un oggetto incorporato.
void shaped_text_set_bidi_override(shaped: RID, override: Array) 🔗
Sostituisce il BiDi per il testo strutturato.
Gli intervalli di sostituzione devono coprire l'intero testo sorgente senza sovrapposizioni. L'algoritmo BiDi sarà utilizzato separatamente su ogni intervallo.
void shaped_text_set_custom_ellipsis(shaped: RID, char: int) 🔗
Imposta il carattere di elissi utilizzato per ritagliare il testo.
void shaped_text_set_custom_punctuation(shaped: RID, punct: String) 🔗
Imposta una lista personalizzata di caratteri di punteggiatura, utilizzati per suddividere le parole. Se impostato su una stringa vuota, sono utilizzati i valori predefiniti del server.
void shaped_text_set_direction(shaped: RID, direction: Direction = 0) 🔗
Imposta la direzione del testo desiderata. Se impostato su DIRECTION_AUTO, la direzione verrà rilevata in base al contenuto nel buffer e alla localizzazione attuale.
Nota: La direzione è ignorata se il server non supporta la funzionalità FEATURE_BIDI_LAYOUT (supportata da TextServerAdvanced).
void shaped_text_set_orientation(shaped: RID, orientation: Orientation = 0) 🔗
Imposta l'orientamento desiderato del testo.
Nota: L'orientamento è ignorato se il server non supporta la funzionalità FEATURE_VERTICAL_LAYOUT (supportata da TextServerAdvanced).
void shaped_text_set_preserve_control(shaped: RID, enabled: bool) 🔗
Se impostato su true il buffer di testo visualizzerà i caratteri di controllo.
void shaped_text_set_preserve_invalid(shaped: RID, enabled: bool) 🔗
Se impostato su true il buffer di testo visualizzerà i caratteri non validi come codici esadecimali, altrimenti nulla è visualizzato.
void shaped_text_set_spacing(shaped: RID, spacing: SpacingType, value: int) 🔗
Imposta la spaziatura addizionale aggiunta tra i glifi o le righe, in pixel.
bool shaped_text_shape(shaped: RID) 🔗
Modella il buffer se non è modellato. Restituisce true se la stringa è modellata con successo.
Nota: Non è necessario chiamare manualmente questa funzione, il buffer verrà modellato automaticamente non appena verrà richiesto uno qualsiasi dei suoi dati prodotti.
Array[Dictionary] shaped_text_sort_logical(shaped: RID) 🔗
Restituisce glifi di testo nell'ordine logico.
RID shaped_text_substr(shaped: RID, start: int, length: int) const 🔗
Restituisce il buffer di testo per la sottostringa del testo nel buffer di testo sagomato shaped (includendo gli oggetti in riga).
float shaped_text_tab_align(shaped: RID, tab_stops: PackedFloat32Array) 🔗
Allinea il testo sagomato alle tabulazioni specificate.
bool spoof_check(string: String) const 🔗
Restituisce true se è probabile che la stringa string sia un tentativo di confondere il lettore.
Nota: Restituisce sempre false se il server non supporta la funzionalità FEATURE_UNICODE_SECURITY.
PackedInt32Array string_get_character_breaks(string: String, language: String = "") const 🔗
Restituisce un array dei confini dei caratteri compositi.
var ts = TextServerManager.get_primary_interface()
print(ts.string_get_word_breaks("Test ❤️🔥 Test")) # Stampa [1, 2, 3, 4, 5, 9, 10, 11, 12, 13, 14]
PackedInt32Array string_get_word_breaks(string: String, language: String = "", chars_per_line: int = 0) const 🔗
Restituisce un array dei confini di interruzione delle parole. Gli elementi nell'array restituito sono gli offset dell'inizio e della fine delle parole. Pertanto la lunghezza dell'array è sempre pari.
Quando chars_per_line è maggiore di zero, vengono invece restituiti i confini di interruzione delle righe.
var ts = TextServerManager.get_primary_interface()
# Corrisponde alle sottostringhe "The", "Godot", "Engine" e "4".
print(ts.string_get_word_breaks("The Godot Engine, 4")) # Stampa [0, 3, 4, 9, 10, 16, 18, 19]
# Corrisponde alle sottostringhe "The", "Godot", "Engin" e "e, 4".
print(ts.string_get_word_breaks("The Godot Engine, 4", "en", 5)) # Stampa [0, 3, 4, 9, 10, 15, 15, 19]
# Corrisponde alle sottostringhe "The Godot" e "Engine, 4".
print(ts.string_get_word_breaks("The Godot Engine, 4", "en", 10)) # Stampa [0, 9, 10, 19]
String string_to_lower(string: String, language: String = "") const 🔗
Returns the string converted to lowercase.
Note: Casing is locale dependent and context sensitive if server support FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION feature (supported by TextServerAdvanced).
Note: The result may be longer or shorter than the original.
String string_to_title(string: String, language: String = "") const 🔗
Returns the string converted to Title Case.
Note: Casing is locale dependent and context sensitive if server support FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION feature (supported by TextServerAdvanced).
Note: The result may be longer or shorter than the original.
String string_to_upper(string: String, language: String = "") const 🔗
Returns the string converted to UPPERCASE.
Note: Casing is locale dependent and context sensitive if server support FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION feature (supported by TextServerAdvanced).
Note: The result may be longer or shorter than the original.
String strip_diacritics(string: String) const 🔗
Rimuove i segni diacritici dalla stringa.
Nota: Il risultato potrebbe essere più lungo o più corto dell'originale.
String tag_to_name(tag: int) const 🔗
Converts the given OpenType tag to the readable name of a feature, variation, script, or language.