VisibleOnScreenEnabler2D
A rectangular region of 2D space that, when visible on screen, enables a target node.
A rectangular region of 2D space that, when visible on screen, enables a target node.
VisibleOnScreenEnabler2D contains a rectangular region of 2D space and a target node. The target node will be automatically enabled (via its Entity.ProcessMode property) when any part of this region becomes visible on the screen, and automatically disabled otherwise. This can for example be used to activate enemies only when the player approaches them.
See VisibleOnScreenNotifier2D if you only want to be notified when the region is visible on screen.
Note: VisibleOnScreenEnabler2D uses the render culling code to determine whether it's visible on screen, so it won't function unless CanvasItem.Visible is set to true.
Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.
Constructors1
VisibleOnScreenEnabler2DConstructor
public VisibleOnScreenEnabler2D();Properties2
EnableEntityPathProperty
public EntityPath EnableEntityPath { get; set; }The path to the target node, relative to the VisibleOnScreenEnabler2D. The target node is cached; it's only assigned when setting this property (if the VisibleOnScreenEnabler2D is inside the scene tree) and every time the VisibleOnScreenEnabler2D enters the scene tree. If the path is empty, no node will be affected. If the path is invalid, an error is also generated.
EnableModeProperty
public VisibleOnScreenEnabler2D.EnableModeEnum EnableMode { get; set; }Determines how the target node is enabled. Corresponds to Entity.ProcessModeEnum. When the node is disabled, it always uses Entity.ProcessModeEnum.Disabled.
Methods4
GetEnableEntityPathEntityPath
public EntityPath GetEnableEntityPath();EntityPathGetEnableModeVisibleOnScreenEnabler2D.EnableModeEnum
public VisibleOnScreenEnabler2D.EnableModeEnum GetEnableMode();VisibleOnScreenEnabler2D.EnableModeEnumSetEnableEntityPathvoid
public void SetEnableEntityPath(EntityPath path);| Name | Type | Default |
|---|---|---|
path | EntityPath | — |
SetEnableModevoid
public void SetEnableMode(VisibleOnScreenEnabler2D.EnableModeEnum mode);| Name | Type | Default |
|---|---|---|
mode | VisibleOnScreenEnabler2D.EnableModeEnum | — |
VisibleOnScreenEnabler2D.EnableModeEnum
| Value | Description |
|---|---|
Always = 1 | Corresponds to |
Inherit = 0 | Corresponds to |
WhenPaused = 2 | Corresponds to |