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
    voidset_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
    Defaulttrue
    Setterset_enabler(value)
    Getteris_enabler_enabled()

    If true, nodes will be paused.


    • bool pause_animations

    If true, nodes will be paused.


    • bool pause_particles
    Default
    Setterset_enabler(value)
    Getteris_enabler_enabled()

    • physics_process_parent

    If true, the parent’s Node._physics_process will be stopped.


    • process_parent
    Defaultfalse
    Setterset_enabler(value)
    Getteris_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.