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.

VisibleOnScreenNotifier2D

Eredita: Node2D < CanvasItem < Node < Object

Ereditato da: VisibleOnScreenEnabler2D

Una regione rettangolare dello spazio 2D che rileva se è visibile sullo schermo.

Descrizione

VisibleOnScreenEnabler2D rappresenta una regione rettangolare nello spazio 2D. Quando una parte di questa regione diventa visibile sullo schermo o in una viewport, emetterà un segnale screen_entered e, allo stesso modo, emetterà un segnale screen_exited quando nessuna parte di essa rimane visibile.

Se vuoi che un nodo sia abilitato automaticamente quando questa regione è visibile sullo schermo, usa VisibleOnScreenEnabler2D.

Nota: VisibleOnScreenNotifier2D usa il codice di culling del renderer per determinare se è visibile sullo schermo, quindi non funzionerà a meno che CanvasItem.visible non sia impostato su true.

Tutorial

Proprietà

Rect2

rect

Rect2(-10, -10, 20, 20)

bool

show_rect

true

Metodi

bool

is_on_screen() const


Segnali

screen_entered() 🔗

Emesso quando il VisibleOnScreenNotifier2D entra nello schermo.


screen_exited() 🔗

Emesso quando il VisibleOnScreenNotifier2D esce dallo schermo.


Descrizioni delle proprietà

Rect2 rect = Rect2(-10, -10, 20, 20) 🔗

Il rettangolo di delimitazione del VisibleOnScreenNotifier2D.


bool show_rect = true 🔗

  • void set_show_rect(value: bool)

  • bool is_showing_rect()

Se true, mostra l'area rettangolare di rect nell'editor con un riempimento magenta traslucido. A differenza di cambiare la visibilità del VisibleOnScreenNotifier2D, questo non influisce sul rilevamento dello screen culling.


Descrizioni dei metodi

bool is_on_screen() const 🔗

Se true, il rettangolo di delimitazione è sullo schermo.

Nota: Ci vuole un frame per determinare la visibilità di VisibleOnScreenNotifier2D una volta aggiunto all'albero di scene, quindi questo metodo restituirà sempre false subito dopo essere stato istanziato, prima del passaggio di disegno.