VisibilityEnabler2D
Enables certain nodes only when approximately visible.
The VisibilityEnabler2D will disable , AnimationPlayer, and other nodes when they are not visible. It will only affect nodes with the same root node as the VisibilityEnabler2D, and the root node itself.
If you just want to receive notifications, use instead.
Note: For performance reasons, VisibilityEnabler2D uses an approximate heuristic with precision determined by ProjectSettings.world/2d/cell_size. If you need precise visibility checking, use another method such as adding an node as a child of a Camera2D node.
Properties
is_enabler_enabled ( enabler ) const | |
void | set_enabler ( enabler, bool enabled ) |
Enumerations
enum Enabler:
- ENABLER_FREEZE_BODIES = 1 —- This enabler will freeze nodes.
- ENABLER_PAUSE_PARTICLES = 2 —- This enabler will stop Particles2D nodes.
- ENABLER_PARENT_PROCESS = 3 —- This enabler will stop the parent’s _process function.
- ENABLER_PARENT_PHYSICS_PROCESS = 4 —- This enabler will stop the parent’s _physics_process function.
- ENABLER_PAUSE_ANIMATED_SPRITES = 5 —- This enabler will stop nodes animations.
- ENABLER_MAX = 6 —- Represents the size of the Enabler enum.
If true
, nodes will be paused.
- bool pause_animated_sprites
Default | true |
Setter | set_enabler(value) |
Getter | is_enabler_enabled() |
If true
, nodes will be paused.
- bool pause_animations
If true
, nodes will be paused.
- bool pause_particles
Default | |
Setter | set_enabler(value) |
Getter | is_enabler_enabled() |
- physics_process_parent
If true
, the parent’s Node._physics_process will be stopped.
- process_parent
Default | false |
Setter | set_enabler(value) |
Getter | is_enabler_enabled() |
If true
, the parent’s Node._process will be stopped.
Method Descriptions
- is_enabler_enabled ( Enabler enabler ) const
Returns whether the enabler identified by given constant is active.
Sets active state of the enabler identified by given Enabler constant.