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

TextureRect

Eredita: Control < CanvasItem < Node < Object

Un controllo che visualizza una texture.

Descrizione

Un controllo che visualizza una texture, ad esempio un'icona all'interno di una GUI. Il posizionamento della texture può essere controllato con la proprietà stretch_mode. La texture può essere ridimensionata, ripetuta o centrata all'interno del suo rettangolo di delimitazione.

Tutorial

Demo di voxel 3D

Proprietà

ExpandMode	expand_mode	`0`
bool	flip_h	`false`
bool	flip_v	`false`
MouseFilter	mouse_filter	`1` (overrides Control)
StretchMode	stretch_mode	`0`
Texture2D	texture

Enumerazioni

enum ExpandMode: 🔗

ExpandMode EXPAND_KEEP_SIZE = 0

La dimensione minima sarà uguale alla dimensione della texture, ovvero il TextureRect non può essere più piccolo della texture.

ExpandMode EXPAND_IGNORE_SIZE = 1

La dimensione della texture non sarà presa in considerazione per il calcolo delle dimensioni minime, quindi il TextureRect può essere ridotto oltre le dimensioni della texture.

ExpandMode EXPAND_FIT_WIDTH = 2

L'altezza della texture sarà ignorata. La larghezza minima sarà uguale all'altezza attuale. Utile per i layout orizzontali, ad esempio all'interno di un HBoxContainer.

ExpandMode EXPAND_FIT_WIDTH_PROPORTIONAL = 3

Uguale a EXPAND_FIT_WIDTH, ma mantiene le proporzioni della texture.

ExpandMode EXPAND_FIT_HEIGHT = 4

La larghezza della texture sarà ignorata. L'altezza minima sarà uguale alla larghezza attuale. Utile per i layout verticali, ad esempio all'interno di un VBoxContainer.

ExpandMode EXPAND_FIT_HEIGHT_PROPORTIONAL = 5

Uguale a EXPAND_FIT_HEIGHT, ma mantiene le proporzioni della texture.

enum StretchMode: 🔗

StretchMode STRETCH_SCALE = 0

Ridimensiona la texture per adattarla al rettangolo di delimitazione del nodo.

StretchMode STRETCH_TILE = 1

Tile inside the node's bounding rectangle.

Note: STRETCH_TILE mode is not supported for texture set to an AtlasTexture with non-zero AtlasTexture.margin.

StretchMode STRETCH_KEEP = 2

La texture mantiene le sue dimensioni originali e rimane nell'angolo in alto a sinistra del rettangolo di delimitazione.

StretchMode STRETCH_KEEP_CENTERED = 3

La texture mantiene le sue dimensioni originali e centrata nel rettangolo di delimitazione del nodo.

StretchMode STRETCH_KEEP_ASPECT = 4

Ridimensiona la texture per adattarla al rettangolo di delimitazione del nodo, ma mantiene le proporzioni della texture.

StretchMode STRETCH_KEEP_ASPECT_CENTERED = 5

Ridimensiona la texture per adattarla al rettangolo di delimitazione del nodo, la centra, e mantiene le sue proporzioni.

StretchMode STRETCH_KEEP_ASPECT_COVERED = 6

Ridimensiona la texture in modo che il lato più corto si adatti al rettangolo di delimitazione. L'altro lato si adatta ai limiti del nodo.

Descrizioni delle proprietà

ExpandMode expand_mode = 0 🔗

void set_expand_mode(value: ExpandMode)
ExpandMode get_expand_mode()

Sperimentale: Using EXPAND_FIT_WIDTH, EXPAND_FIT_WIDTH_PROPORTIONAL, EXPAND_FIT_HEIGHT, or EXPAND_FIT_HEIGHT_PROPORTIONAL may result in unstable behavior in some Container controls. This behavior may be re-evaluated and changed in the future.

Definisce come le dimensioni minime sono determinate in base alle dimensioni della texture.

bool flip_h = false 🔗

void set_flip_h(value: bool)
bool is_flipped_h()

Se true, la texture è capovolta orizzontalmente.

bool flip_v = false 🔗

void set_flip_v(value: bool)
bool is_flipped_v()

Se true, la texture è capovolta verticalmente.

StretchMode stretch_mode = 0 🔗

void set_stretch_mode(value: StretchMode)
StretchMode get_stretch_mode()

Controlla il comportamento della texture quando si ridimensiona il rettangolo di delimitazione del nodo.

Texture2D texture 🔗

void set_texture(value: Texture2D)
Texture2D get_texture()

La risorsa Texture2D del nodo.