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...
TextureProgressBar
Eredita: Range < Control < CanvasItem < Node < Object
Barra di avanzamento basata su texture. Utile per le schermate di caricamento e le barre di vita o stamina.
Descrizione
TextureProgressBar funziona come ProgressBar, ma usa fino a 3 texture invece della risorsa Theme di Godot. Può essere usata per creare barre di avanzamento orizzontali, verticali e radiali.
Proprietà
|
||
mouse_filter |
|
|
|
||
|
||
|
||
|
||
BitField[SizeFlags] |
size_flags_vertical |
|
step |
|
|
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Metodi
get_stretch_margin(margin: Side) const |
|
void |
set_stretch_margin(margin: Side, value: int) |
Enumerazioni
enum FillMode: 🔗
FillMode FILL_LEFT_TO_RIGHT = 0
La texture_progress si riempie da sinistra a destra.
FillMode FILL_RIGHT_TO_LEFT = 1
La texture_progress si riempie da destra a sinistra.
FillMode FILL_TOP_TO_BOTTOM = 2
La texture_progress si riempie dall'alto verso il basso.
FillMode FILL_BOTTOM_TO_TOP = 3
La texture_progress si riempie dal basso verso l'alto.
FillMode FILL_CLOCKWISE = 4
Converte il nodo in una barra radiale. La texture_progress si riempie in senso orario. Vedi radial_center_offset, radial_initial_angle e radial_fill_degrees per controllare il modo in cui la barra si riempie.
FillMode FILL_COUNTER_CLOCKWISE = 5
Converte il nodo in una barra radiale. La texture_progress si riempie in senso antiorario. Vedi radial_center_offset, radial_initial_angle e radial_fill_degrees per controllare il modo in cui la barra si riempie.
FillMode FILL_BILINEAR_LEFT_AND_RIGHT = 6
La texture_progress si riempie dal centro, espandendosi sia verso sinistra sia verso destra.
FillMode FILL_BILINEAR_TOP_AND_BOTTOM = 7
La texture_progress si riempie dal centro, espandendosi sia verso l'alto sia verso il basso.
FillMode FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE = 8
Converte il nodo in una barra radiale. La texture_progress si riempie radialmente dal centro, espandendosi sia in senso orario sia antiorario. Vedi radial_center_offset, radial_initial_angle e radial_fill_degrees per controllare il modo in cui la barra si riempie.
Descrizioni delle proprietà
La direzione di riempimento. Vedi FillMode per i valori possibili.
bool nine_patch_stretch = false 🔗
Se true, Godot tratta le texture della barra come in NinePatchRect. Usa le proprietà stretch_margin_* come stretch_margin_bottom per impostare la griglia 3×3 del nove-sezioni. Quando si usa un fill_mode radiale, questa impostazione abiliterà lo stiramento solo per texture_progress, mentre texture_under e texture_over saranno trattati come in NinePatchRect.
Vector2 radial_center_offset = Vector2(0, 0) 🔗
Scosta texture_progress se fill_mode è FILL_CLOCKWISE, FILL_COUNTER_CLOCKWISE o FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE.
Nota: Il centro radiale effettivo rimane sempre entro i limiti di texture_progress. Se è necessario spostarlo fuori dai limiti della texture, modifica texture_progress per contenere ulteriore spazio vuoto dove necessario.
float radial_fill_degrees = 360.0 🔗
Il limite superiore per il riempimento di texture_progress se fill_mode è FILL_CLOCKWISE, FILL_COUNTER_CLOCKWISE o FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE. Quando il value del nodo è uguale al suo max_value, la texture si riempie fino a questo angolo.
Vedi Range.value, Range.max_value.
float radial_initial_angle = 0.0 🔗
Angolo di partenza per il riempimento di texture_progress se fill_mode è FILL_CLOCKWISE, FILL_COUNTER_CLOCKWISE o FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE. Quando il value del nodo è uguale al suo min_value, la texture non è visualizzata affatto. Quando il value aumenta, la texture si riempie e tende verso radial_fill_degrees.
Nota: radial_initial_angle è compreso tra 0 e 360 gradi (inclusi).
int stretch_margin_bottom = 0 🔗
L'altezza della riga inferiore del 9-sezioni. Un margine di 16 significa che gli angoli inferiori e il lato del 9-sezioni avranno un'altezza di 16 pixel. Puoi impostare tutti e 4 i valori di margine individualmente per creare pannelli con bordi non uniformi. Efficace solo se nine_patch_stretch è true.
La larghezza della colonna sinistra del 9-sezioni. Efficace solo se nine_patch_stretch è true.
int stretch_margin_right = 0 🔗
La larghezza della colonna destra del 9-sezioni. Efficace solo se nine_patch_stretch è true.
L'altezza della riga superiore del 9-sezioni. Efficace solo se nine_patch_stretch è true.
La Texture2D che è disegnata sopra la barra di avanzamento. Usalo per aggiungere evidenziazioni o una cornice superiore che nasconde parte di texture_progress.
La Texture2D che è ritagliata in base al value e al fill_mode del nodo. Man mano che value aumenta, la texture si riempie. È visualizzata completamente quando value raggiunge max_value. Non viene visualizzata affatto se value è uguale a min_value.
La proprietà value deriva da Range. Vedi Range.value, Range.min_value, Range.max_value.
Vector2 texture_progress_offset = Vector2(0, 0) 🔗
L'offset di texture_progress. Utile per texture_over e texture_under con bordi sofisticati, per evitare margini trasparenti nella texture di avanzamento.
La Texture2D che è disegnata sotto la barra di avanzamento. Lo sfondo della barra.
Color tint_over = Color(1, 1, 1, 1) 🔗
Moltiplica il colore della texture texture_over della barra. L'effetto è simile a CanvasItem.modulate, eccetto che influenza solo questa texture specifica invece che l'intero nodo.
Color tint_progress = Color(1, 1, 1, 1) 🔗
Moltiplica il colore della texture texture_progress della barra.
Color tint_under = Color(1, 1, 1, 1) 🔗
Moltiplica il colore della texture texture_under della barra.
Descrizioni dei metodi
int get_stretch_margin(margin: Side) const 🔗
Restituisce il margine di allungamento con l'indice specificato. Vedi stretch_margin_bottom e le proprietà correlate.
void set_stretch_margin(margin: Side, value: int) 🔗
Imposta il margine di allungamento con l'indice specificato. Vedi stretch_margin_bottom e le proprietà correlate.