VisibilityNotifier2D

Inherits: Node2D < CanvasItem < Node < Object

Inherited By: VisibilityEnabler2D

大约在节点在屏幕上可见时进行检测。

描述

VisibilityNotifier2D检测它在屏幕上是否可见。当它的边界矩形进入或退出屏幕或视窗时,它也会发出通知。

如果你想让节点在退出屏幕时自动禁用,请使用VisibilityEnabler2D代替。

注意: 由于性能原因,VisibilityNotifier2D使用一个近似的启发式方法,其精度由 ProjectSettings.world/2d/cell_size 决定。如果你需要精确的可见性检查,请使用另一种方法,如添加一个Area2D节点作为Camera2D节点的子节点。

教程

属性

Rect2

rect

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

方法

bool

is_on_screen ( ) const

信号

  • screen_entered ( )

当VisibilityNotifier2D进入屏幕时触发。


  • screen_exited ( )

当VisibilityNotifier2D退出屏幕时触发。


当VisibilityNotifier2D进入Viewport的视图时触发。


当VisibilityNotifier2D退出Viewport的视图时触发。

属性说明

Default

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

Setter

set_rect(value)

Getter

get_rect()

VisibilityNotifier2D的边界矩形。

方法说明

  • bool is_on_screen ( ) const

如果true,则边界矩形在屏幕上。

注意:一旦添加到场景树中,需要一帧来计算节点的可见性,所以这个方法将在它被实例化后立即返回false,即使屏幕在绘制过程中。