Method DestroyChildren

Source/Engine/Level/Actor.cpp:506–577

}

void Actor::DestroyChildren(float timeLeft)
{
    if (Children.IsEmpty())
        return;
    PROFILE_CPU();

    // Actors system doesn't support editing scene hierarchy from multiple threads
    if (!IsInMainThread() && IsDuringPlay())
    {
        LOG(Error, "Editing scene hierarchy is only allowed on a main thread.");
        return;
    }

    // Get all actors
    Array<Actor*> children = Children;

#if USE_EDITOR
    // Inform Editor beforehand
    Level::callActorEvent(Level::ActorEventType::OnActorDestroyChildren, this, nullptr);
#endif

    if (_scene && IsActiveInHierarchy())
    {
        // Disable children
        for (Actor* child : children)
        {
            if (child->IsActiveInHierarchy())
            {
                child->OnDisableInHierarchy();
            }
        }
    }

    Level::ScenesLock.Lock();

    // Remove children all at once
    Children.Clear();
    _isHierarchyDirty = true;

    // Unlink children from scene hierarchy
    for (Actor* child : children)
    {
        child->_parent = nullptr;
        if (!_isActiveInHierarchy)
            child->_isActive = false; // Force keep children deactivated to reduce overhead during destruction
        if (_scene)
            child->SetSceneInHierarchy(nullptr);
    }

    Level::ScenesLock.Unlock();

    // Inform actors about this
    for (Actor* child : children)
    {
        child->OnParentChanged();
    }

    // Unlink children for hierarchy