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...
VisibleOnScreenNotifier2D¶
继承: Node2D < CanvasItem < Node < Object
2D 空间的矩形区域,用于检测其在屏幕上是否可见。
描述¶
VisibleOnScreenEnabler2D 表示 2D 空间的矩形区块。当该区块的任何部分在屏幕或视口中可见时,它将发出 screen_entered 信号,同样,当其任何部分都不可见时,它将发出 screen_exited 信号。
如果希望当该区块在屏幕上可见时自动启用节点,请使用 VisibleOnScreenEnabler2D。
注意:VisibleOnScreenNotifier2D 使用渲染剔除代码来确定它在屏幕上是否可见,因此除非 CanvasItem.visible 被设置为 true
,否则它不会起作用。
教程¶
属性¶
|
方法¶
is_on_screen() const |
信号¶
screen_entered() 🔗
当该 VisibleOnScreenNotifier2D 进入屏幕时发出。
screen_exited() 🔗
当该 VisibleOnScreenNotifier2D 退出屏幕时发出。
属性说明¶
Rect2 rect = Rect2(-10, -10, 20, 20)
🔗
该 VisibleOnScreenNotifier2D 的边界矩形。
方法说明¶
如果为 true
,则边界矩形在屏幕上。
注意:VisibleOnScreenNotifier2D 被添加到场景树后需要一帧才能确定其可见性,因此该方法在它被实例化后,在绘制阶段之前,将始终返回 false
。