o3de/Code/Editor/TrackView/SelectKeyUIControls.cpp

/*
 * Copyright (c) Contributors to the Open 3D Engine Project.
 * For complete copyright and license terms please see the LICENSE at the root of this distribution.
 *
 * SPDX-License-Identifier: Apache-2.0 OR MIT
 *
 */


#include "EditorDefs.h"

#include "KeyUIControls.h"
#include "TrackViewKeyPropertiesDlg.h"                          // for CTrackViewKeyUIControls

#include <AzCore/Component/EntityBus.h>                         // for AZ::EntitySystemBus
#include <AzFramework/Components/CameraBus.h>                   // for Camera::CameraNotificationBus
#include <CryCommon/Maestro/Types/AnimValueType.h>              // for AnimValueType

CSelectKeyUIControls::~CSelectKeyUIControls()
{
    AZ::EntitySystemBus::Handler::BusDisconnect();
    Camera::CameraNotificationBus::Handler::BusDisconnect();
}

bool CSelectKeyUIControls::OnKeySelectionChange(const CTrackViewKeyBundle& selectedKeys)
{
    if (!selectedKeys.AreAllKeysOfSameType())
    {
        return false;
    }

    bool bAssigned = false;
    if (selectedKeys.GetKeyCount() == 1)
    {
        const CTrackViewKeyHandle& keyHandle = selectedKeys.GetKey(0);

        AnimValueType valueType = keyHandle.GetTrack()->GetValueType();
        if (valueType == AnimValueType::Select)
        {
            ResetCameraEntries();

            // Get All cameras.
            mv_camera.SetEnumList(nullptr);

            mv_camera->AddEnumItem(QObject::tr(defaultNoneKeyName), QString::number(static_cast<AZ::u64>(AZ::EntityId::InvalidEntityId)));

            // Find all Component Entity Cameras
            AZ::EBusAggregateResults<AZ::EntityId> cameraComponentEntities;
            Camera::CameraBus::BroadcastResult(cameraComponentEntities, &Camera::CameraRequests::GetCameras);

            // add names of all found entities with Camera Components
            for (int i = 0; i < cameraComponentEntities.values.size(); i++)
            {
                AZ::Entity* entity = nullptr;
                AZ::ComponentApplicationBus::BroadcastResult(entity, &AZ::ComponentApplicationBus::Events::FindEntity, cameraComponentEntities.values[i]);
                if (entity)
                {
                    // For Camera Components the enum value is the stringified AZ::EntityId of the entity with the Camera Component
                    QString entityIdString = QString::number(static_cast<AZ::u64>(entity->GetId()));
                    mv_camera->AddEnumItem(entity->GetName().c_str(), entityIdString);
                }
            }            

            m_skipOnUIChange = true;
            ISelectKey selectKey;
            keyHandle.GetKey(&selectKey);

            mv_camera = QString::number(static_cast<AZ::u64>(selectKey.cameraAzEntityId));            

            mv_BlendTime.GetVar()->SetLimits(0.0f, selectKey.fDuration > .0f ? selectKey.fDuration : 1.0f, 0.1f, true, false);
            mv_BlendTime = selectKey.fBlendTime;
            mv_BlendTime->OnSetValue(false); // update dialog value
            m_skipOnUIChange = false;

            bAssigned = true;        
        }
    }
    return bAssigned;
}

// Called when UI variable changes.
void CSelectKeyUIControls::OnUIChange(IVariable* pVar, CTrackViewKeyBundle& selectedKeys)
{
    CTrackViewSequence* sequence = GetIEditor()->GetAnimation()->GetSequence();

    if (!sequence || !selectedKeys.AreAllKeysOfSameType() || m_skipOnUIChange)
    {
        return;
    }

    for (unsigned int keyIndex = 0; keyIndex < selectedKeys.GetKeyCount(); ++keyIndex)
    {
        CTrackViewKeyHandle keyHandle = selectedKeys.GetKey(keyIndex);

        AnimValueType valueType = keyHandle.GetTrack()->GetValueType();
        if (valueType == AnimValueType::Select)
        {
            ISelectKey selectKey;
            keyHandle.GetKey(&selectKey);

            bool isKeyChanged = false;
            if (pVar == mv_camera.GetVar())
            {
                QString entityIdString = mv_camera;
                selectKey.cameraAzEntityId = AZ::EntityId(entityIdString.toULongLong());
                selectKey.szSelection =  mv_camera.GetVar()->GetDisplayValue().toUtf8().data();
                if (selectKey.szSelection == defaultNoneKeyName)
                {
                    selectKey.szSelection.clear(); // Erase "<None>" got from menu for unassigned key 
                }
                isKeyChanged = true;
            }

            if (pVar == mv_BlendTime.GetVar())
            {
                if (mv_BlendTime < 0.0f)
                {
                    mv_BlendTime = 0.0f;
                }
                else if ((selectKey.fDuration > AZ::Constants::Tolerance) && (mv_BlendTime > selectKey.fDuration))
                {
                    mv_BlendTime = selectKey.fDuration;
                }
                selectKey.fBlendTime = mv_BlendTime;
                isKeyChanged = true;
            }

            if (!isKeyChanged)
            {
                return; // nothing to do
            }

            bool isDuringUndo = false;
            AzToolsFramework::ToolsApplicationRequests::Bus::BroadcastResult(isDuringUndo, &AzToolsFramework::ToolsApplicationRequests::Bus::Events::IsDuringUndoRedo);

            if (isDuringUndo)
            {
                keyHandle.SetKey(&selectKey);
            }
            else
            {
                AzToolsFramework::ScopedUndoBatch undoBatch("Set Key Value");
                keyHandle.SetKey(&selectKey);
                undoBatch.MarkEntityDirty(sequence->GetSequenceComponentEntityId());
            }

        }
    }
}

void CSelectKeyUIControls::OnCameraAdded(const AZ::EntityId & cameraId)
{
    // Add a single camera component
    AZ::Entity* entity = nullptr;
    AZ::ComponentApplicationBus::BroadcastResult(entity, &AZ::ComponentApplicationBus::Events::FindEntity, cameraId);
    if (entity)
    {
        // For Camera Components the enum value is the stringified AZ::EntityId of the entity with the Camera Component
        QString entityIdString = QString::number(static_cast<AZ::u64>(entity->GetId()));
        mv_camera->AddEnumItem(entity->GetName().c_str(), entityIdString);
    }
}

void CSelectKeyUIControls::OnCameraRemoved(const AZ::EntityId & cameraId)
{
    mv_camera->EnableUpdateCallbacks(false);

    // We can't iterate or remove an item from the enum list, and Camera::CameraRequests::GetCameras
    // still includes the deleted camera at this point. Reset the list anyway and filter out the
    // deleted camera.
    mv_camera->SetEnumList(nullptr);
    mv_camera->AddEnumItem(QObject::tr(defaultNoneKeyName), QString::number(static_cast<AZ::u64>(AZ::EntityId::InvalidEntityId)));

    AZ::EBusAggregateResults<AZ::EntityId> cameraComponentEntities;
    Camera::CameraBus::BroadcastResult(cameraComponentEntities, &Camera::CameraRequests::GetCameras);
    for (int i = 0; i < cameraComponentEntities.values.size(); i++)
    {
        if (cameraId == cameraComponentEntities.values[i])
        {
            continue;
        }
        OnCameraAdded(cameraComponentEntities.values[i]);
    }

    mv_camera->EnableUpdateCallbacks(true);
}

void CSelectKeyUIControls::OnEntityNameChanged(const AZ::EntityId & entityId, [[maybe_unused]] const AZStd::string & name)
{
    AZ::Entity* entity = nullptr;
    AZ::ComponentApplicationBus::BroadcastResult(entity, &AZ::ComponentApplicationBus::Events::FindEntity, entityId);
    if (entity == nullptr)
    {
        return;
    }

    AZ::Entity::ComponentArrayType cameraComponents = entity->FindComponents(EditorCameraComponentTypeId);
    if (cameraComponents.size() == 0)
    {
        return;
    }

    mv_camera->EnableUpdateCallbacks(false);
    ResetCameraEntries();
    mv_camera->EnableUpdateCallbacks(true);
}

void CSelectKeyUIControls::ResetCameraEntries()
{
    mv_camera.SetEnumList(nullptr);
    mv_camera->AddEnumItem(QObject::tr(defaultNoneKeyName), QString::number(static_cast<AZ::u64>(AZ::EntityId::InvalidEntityId)));

    // Find all Component Entity Cameras
    AZ::EBusAggregateResults<AZ::EntityId> cameraComponentEntities;
    Camera::CameraBus::BroadcastResult(cameraComponentEntities, &Camera::CameraRequests::GetCameras);

    // add names of all found entities with Camera Components
    for (int i = 0; i < cameraComponentEntities.values.size(); i++)
    {
        OnCameraAdded(cameraComponentEntities.values[i]);
    }
}