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

SubViewport

Eredita: Viewport < Node < Object

Un'interfaccia per un mondo di gioco che non crea una finestra né disegna direttamente sullo schermo.

Descrizione

SubViewport isola una regione rettangolare di una scena da visualizzare in modo indipendente. Può essere utilizzato, ad esempio, per visualizzare l'interfaccia utente nello spazio 3D.

Nota: SubViewport è un Viewport che non è un Window, ovvero non disegna nulla da solo. Per visualizzare qualcosa, SubViewport deve avere una dimensione diversa da zero ed essere inserito in un SubViewportContainer o assegnato a una ViewportTexture.

Nota: Gli InputEvent non vengono passati a un SubViewport a sé stante, come predefinito. Per garantire la propagazione degli InputEvent, un SubViewport può essere posizionato all'interno di un SubViewportContainer.

Tutorial

• Utilizzo dei Viewport

• Viewport e trasformazioni di canvas

• Demo di GUI in Viewport 3D

• Demo di viewport 3D in 2D

• Demo di viewport 2D in 3D

• Demo di cattura dello schermo

• Demo di schermo diviso dinamico

• Demo di scala della risoluzione 3D

Proprietà

ClearMode	render_target_clear_mode	0
UpdateMode	render_target_update_mode	2
Vector2i	size	Vector2i(512, 512)
Vector2i	size_2d_override	Vector2i(0, 0)
bool	size_2d_override_stretch	false
int	view_count	1

---

Enumerazioni

enum ClearMode: 🔗

ClearMode CLEAR_MODE_ALWAYS = 0

Cancella sempre la destinazione di rendering prima di disegnare.

ClearMode CLEAR_MODE_NEVER = 1

Non cancella mai la destinazione di rendering.

ClearMode CLEAR_MODE_ONCE = 2

Cancella la destinazione di rendering nel frame successivo, quindi passa a CLEAR_MODE_NEVER.

---

enum UpdateMode: 🔗

UpdateMode UPDATE_DISABLED = 0

Non aggiorna mai la destinazione di rendering.

UpdateMode UPDATE_ONCE = 1

Aggiorna la destinazione di rendering una sola volta, quindi passa a UPDATE_DISABLED.

UpdateMode UPDATE_WHEN_VISIBLE = 2

Aggiorna la destinazione di rendering solo quando è visibile. Questo è il valore predefinito.

UpdateMode UPDATE_WHEN_PARENT_VISIBLE = 3

Aggiorna la destinazione di rendering solo quando il suo genitore è visibile.

UpdateMode UPDATE_ALWAYS = 4

Aggiornare sempre la destinazione di rendering.

---

Descrizioni delle proprietà

ClearMode render_target_clear_mode = 0 🔗

• void set_clear_mode(value: ClearMode)

• ClearMode get_clear_mode()

La modalità di cancellazione quando la viewport secondaria è utilizzata come destinazione di rendering.

Nota: Questa proprietà è progettata per l'uso in 2D.

---

UpdateMode render_target_update_mode = 2 🔗

• void set_update_mode(value: UpdateMode)

• UpdateMode get_update_mode()

La modalità di aggiornamento quando la viewport secondaria è utilizzata come destinazione di rendering.

---

Vector2i size = Vector2i(512, 512) 🔗

• void set_size(value: Vector2i)

• Vector2i get_size()

La larghezza e l'altezza della viewport secondaria. Deve essere impostata su un valore maggiore o uguale a 2 pixel su entrambe le dimensioni. Altrimenti, non sarà visualizzato nulla.

Nota: se il nodo padre è un SubViewportContainer e il suo SubViewportContainer.stretch è true, la dimensione della viewport non può essere modificata manualmente.

---

Vector2i size_2d_override = Vector2i(0, 0) 🔗

• void set_size_2d_override(value: Vector2i)

• Vector2i get_size_2d_override()

Sostituzione delle dimensioni 2D della viewport secondaria. Se la larghezza o l'altezza sono 0, la sostituzione è disabilitata.

---

bool size_2d_override_stretch = false 🔗

• void set_size_2d_override_stretch(value: bool)

• bool is_size_2d_override_stretch_enabled()

Se true, la sostituzione delle dimensioni 2D influisce anche sull'allungamento.

---

int view_count = 1 🔗

• void set_view_count(value: int)

• int get_view_count()

The number of view layers we are rendering to. Set this to 2 to enable stereo rendering.