OnScreenVisibleSignal

继承: VisualRender < Item3D < Item < Object

派生: OnScreenVisibleEnabler

3D空间的盒形区域,用于检测它在屏幕上是否可见。

描述

OnScreenVisibleSignal表示3D空间中的一个盒子状区域,当该区域的任何部分在屏幕上或Camera的视图中可见时,它会发出screen_entered信号,同样,当它的任何部分都不可见时,它也会发出screen_exited信号。

如果希望在此区域在屏幕上可见时自动启用节点,请使用OnScreenVisibleEnabler

注意:OnScreenVisibleSignal使用近似启发式,不考虑墙壁和其他遮挡,除非使用遮挡剔除。除非将Item3D.visible设置为true,否则它也不会起作用。

属性

AABB

aabb

AABB(-1, -1, -1, 2, 2, 2)

方法

bool

is_on_screen() const


信号

screen_entered() 🔗

OnScreenVisibleSignal进入屏幕时发出。


screen_exited() 🔗

OnScreenVisibleSignal退出屏幕时发出。


属性说明

AABB aabb = AABB(-1, -1, -1, 2, 2, 2) 🔗

  • void set_aabb(value: AABB)

  • AABB get_aabb()

OnScreenVisibleSignal的边界框。


方法说明

bool is_on_screen() const 🔗

如果边界框在屏幕上,则返回true

注意:一旦添加到场景树中,OnScreenVisibleSignal的可见性需要一帧时间来评估,因此此方法将始终在实例化后立即返回false