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

SystemFont

Eredita: Font < Resource < RefCounted < Object

Un font caricato da un font di sistema. Ritorna a un font del tema predefinito se non implementato sul sistema operativo host.

Descrizione

SystemFont carica un font da un font di sistema con il primo nome corrispondente da font_names.

Tenterà di abbinare lo stile del font, ma non è garantito.

Il font restituito potrebbe far parte di una collezione di font o essere un font variabile con le funzionalità OpenType "weight", "width" e/o "italic".

Puoi creare un FontVariation del font di sistema per un controllo preciso sulle sue funzionalità.

Nota: Questa classe è implementata su iOS, Linux, macOS e Windows, su altre piattaforme tornerà al font del tema predefinito.

Proprietà

bool

allow_system_fallback

true

FontAntialiasing

antialiasing

1

bool

disable_embedded_bitmaps

true

bool

font_italic

false

PackedStringArray

font_names

PackedStringArray()

int

font_stretch

100

int

font_weight

400

bool

force_autohinter

false

bool

generate_mipmaps

false

Hinting

hinting

1

bool

keep_rounding_remainders

true

bool

modulate_color_glyphs

false

int

msdf_pixel_range

16

int

msdf_size

48

bool

multichannel_signed_distance_field

false

float

oversampling

0.0

SubpixelPositioning

subpixel_positioning

1

Descrizioni delle proprietà

bool allow_system_fallback = true 🔗

  • void set_allow_system_fallback(value: bool)

  • bool is_allow_system_fallback()

Se impostato su true, i font del sistema possono essere utilizzati automaticamente come alternative di riserva.

FontAntialiasing antialiasing = 1 🔗

Modalità anti-aliasing del font.

bool disable_embedded_bitmaps = true 🔗

  • void set_disable_embedded_bitmaps(value: bool)

  • bool get_disable_embedded_bitmaps()

Se impostato su true, il caricamento delle bitmap dei font incorporati è disabilitato (i font solo con bitmap e i font colorati ignorano questa proprietà).

bool font_italic = false 🔗

  • void set_font_italic(value: bool)

  • bool get_font_italic()

Se impostato su true, i font in italico o in obliquo sono preferiti.

PackedStringArray font_names = PackedStringArray() 🔗

Array di nomi di famiglie di font da ricercare; è utilizzato il primo font corrispondente.

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

int font_stretch = 100 🔗

  • void set_font_stretch(value: int)

  • int get_font_stretch()

Quantità preferita dell'allungamento del font, rispetto a una larghezza normale. Un valore di percentuale compreso tra 50% e 200%.

int font_weight = 400 🔗

  • void set_font_weight(value: int)

  • int get_font_weight()

Peso preferito (grassetto) del font. Un valore nell'intervallo 100...999, il peso normale dei font è 400, il peso dei font in grassetto è 700.

bool force_autohinter = false 🔗

  • void set_force_autohinter(value: bool)

  • bool is_force_autohinter()

Se impostato su true, l'hinting automatico è supportato e preferito rispetto all'hinting integrato nel font.

bool generate_mipmaps = false 🔗

  • void set_generate_mipmaps(value: bool)

  • bool get_generate_mipmaps()

Se impostato su true, genera mipmap per le texture del font.

Hinting hinting = 1 🔗

Modalità di hinting del font.

bool keep_rounding_remainders = true 🔗

  • void set_keep_rounding_remainders(value: bool)

  • bool get_keep_rounding_remainders()

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.

bool modulate_color_glyphs = false 🔗

  • void set_modulate_color_glyphs(value: bool)

  • bool is_modulate_color_glyphs()

Se impostato su true, la modulazione del colore è applicata quando si disegnano glifi colorati, altrimenti è applicata solo ai glifi monocromatici.

int msdf_pixel_range = 16 🔗

  • void set_msdf_pixel_range(value: int)

  • int get_msdf_pixel_range()

The width of the range around the shape between the minimum and maximum representable signed distance. If using font outlines, msdf_pixel_range must be set to at least twice the size of the largest font outline. The default msdf_pixel_range value of 16 allows outline sizes up to 8 to look correct.

int msdf_size = 48 🔗

  • void set_msdf_size(value: int)

  • int get_msdf_size()

Dimensione del font sorgente utilizzata per generare le texture MSDF. Valori più alti consentono una maggiore precisione, ma sono più lenti da renderizzare e richiedono più memoria. Aumenta questo valore solo se noti una notevole mancanza di precisione nel rendering dei glifi.

bool multichannel_signed_distance_field = false 🔗

  • void set_multichannel_signed_distance_field(value: bool)

  • bool is_multichannel_signed_distance_field()

Se impostato su true, i glifi di tutte le dimensioni sono renderizzati utilizzando un singolo MSDF generato dai dati vettoriali dei font dinamici.

float oversampling = 0.0 🔗

  • void set_oversampling(value: float)

  • float get_oversampling()

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

SubpixelPositioning subpixel_positioning = 1 🔗

Modalità di posizionamento in mezzo ai pixel del glifo del font. Il posizionamento in mezzo ai pixel fornisce testo più definito e migliore crenatura per dimensioni di font più piccole, a scapito dell'utilizzo di memoria e della velocità di rasterizzazione del font. Utilizza TextServer.SUBPIXEL_POSITIONING_AUTO per abilitarlo automaticamente in base alla dimensione del font.