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.

VisibleOnScreenEnabler2D

繼承: VisibleOnScreenNotifier2D < Node2D < CanvasItem < Node < Object

二維空間的矩形區塊,當在螢幕上可見時,啟用目標節點。

說明

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

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

注意:VisibleOnScreenEnabler2D 使用渲染剔除程式碼來確定它在螢幕上是否可見,因此除非 CanvasItem.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("..") 🔗

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