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.

VisibleOnScreenEnabler3D

繼承: VisibleOnScreenNotifier3D < VisualInstance3D < Node3D < Node < Object

3D 空間的盒形區塊,當在螢幕上可見時,啟用目標節點。

說明

VisibleOnScreenEnabler3D 包含 3D 空間的盒形區塊和目標節點。當該區域的任何部分在螢幕上可見時,目標節點將自動啟用(通過其 Node.process_mode 屬性),否則將自動停用。例如,這可以被用於僅在玩家接近敵人時啟用敵人。

如果你只想在該區塊在螢幕上可見時收到通知,請參閱 VisibleOnScreenNotifier3D。

注意:VisibleOnScreenEnabler3D 使用近似啓發式,不考慮牆壁和其他遮擋,除非使用遮擋剔除。除非將 Node3D.visible 設定為 true,否則它也不會起作用。

屬性

EnableMode

enable_mode

0

NodePath

enable_node_path

NodePath("..")


列舉

enum EnableMode: 🔗

EnableMode ENABLE_MODE_INHERIT = 0

對應 Node.PROCESS_MODE_INHERIT。

EnableMode ENABLE_MODE_ALWAYS = 1

對應 Node.PROCESS_MODE_ALWAYS。

EnableMode ENABLE_MODE_WHEN_PAUSED = 2

對應 Node.PROCESS_MODE_WHEN_PAUSED。


屬性說明

EnableMode enable_mode = 0 🔗

確定如何啟用目標節點。對應於 ProcessMode。當該節點被停用時,它始終使用 Node.PROCESS_MODE_DISABLED。


NodePath enable_node_path = NodePath("..") 🔗

目標節點的路徑,相對於 VisibleOnScreenEnabler3D。目標節點會被快取;只有在設定這個屬性時(VisibleOnScreenEnabler3D 位於場景樹中),以及 VisibleOnScreenEnabler3D 進入場景樹時會進行賦值。如果路徑為空,則不會影響任何節點。如果路徑無效,則還會生成錯誤。