Files
UnrealEngineUWP/Engine/Plugins/Runtime/Metasound/Source/MetasoundFrontend/Public/MetasoundReceiveNode.h
phil popp 3519ebada8 Deprecate send and receive nodes
#jira UE-137119
#rb Jimmy.Smith
#preflight 61df3c5a484d866ec01d358b

#ROBOMERGE-AUTHOR: phil.popp
#ROBOMERGE-SOURCE: CL 18589115 in //UE5/Release-5.0/... via CL 18589194 via CL 18589235
#ROBOMERGE-BOT: STARSHIP (Release-Engine-Test -> Main) (v899-18417669)

[CL 18589271 by phil popp in ue5-main branch]
2022-01-12 15:58:54 -05:00

239 lines
7.4 KiB
C++

// Copyright Epic Games, Inc. All Rights Reserved.
#pragma once
#include "MetasoundBuilderInterface.h"
#include "MetasoundNode.h"
#include "MetasoundNodeInterface.h"
#include "MetasoundOperatorInterface.h"
#include "MetasoundDataFactory.h"
#include "MetasoundDataReference.h"
#include "MetasoundExecutableOperator.h"
#include "MetasoundRouter.h"
#include <type_traits>
#define LOCTEXT_NAMESPACE "MetasoundFrontend"
namespace Metasound
{
namespace ReceiveNodeInfo
{
METASOUNDFRONTEND_API const FVertexName& GetAddressInputName();
METASOUNDFRONTEND_API const FVertexName& GetDefaultDataInputName();
METASOUNDFRONTEND_API const FVertexName& GetOutputName();
METASOUNDFRONTEND_API FNodeClassName GetClassNameForDataType(const FName& InDataTypeName);
METASOUNDFRONTEND_API int32 GetCurrentMajorVersion();
METASOUNDFRONTEND_API int32 GetCurrentMinorVersion();
};
template<typename TDataType>
class TReceiveNode : public FNode
{
public:
static FVertexInterface DeclareVertexInterface()
{
return FVertexInterface(
FInputVertexInterface(
TInputDataVertexModel<FSendAddress>(ReceiveNodeInfo::GetAddressInputName(), FText::GetEmpty()),
TInputDataVertexModel<TDataType>(ReceiveNodeInfo::GetDefaultDataInputName(), FText::GetEmpty())
),
FOutputVertexInterface(
TOutputDataVertexModel<TDataType>(ReceiveNodeInfo::GetOutputName(), FText::GetEmpty())
)
);
}
static const FNodeClassMetadata& GetNodeInfo()
{
auto InitNodeInfo = []() -> FNodeClassMetadata
{
FNodeClassMetadata Info;
Info.ClassName = ReceiveNodeInfo::GetClassNameForDataType(GetMetasoundDataTypeName<TDataType>());
Info.MajorVersion = ReceiveNodeInfo::GetCurrentMajorVersion();
Info.MinorVersion = ReceiveNodeInfo::GetCurrentMinorVersion();
Info.DisplayName = FText::Format(LOCTEXT("Metasound_ReceiveNodeDisplayNameFormat", "Receive {0}"), GetMetasoundDataTypeDisplayText<TDataType>());
Info.Description = LOCTEXT("Metasound_ReceiveNodeDescription", "Receives data from a send node with the same name.");
Info.Author = PluginAuthor;
Info.PromptIfMissing = PluginNodeMissingPrompt;
Info.DefaultInterface = DeclareVertexInterface();
Info.CategoryHierarchy = { LOCTEXT("Metasound_TransmissionNodeCategory", "Transmission") };
Info.Keywords = { };
// Then send & receive nodes do not work as expected, particularly
// around multiple-consumer scenarios. Deprecate them to avoid
// metasound assets from relying on send & receive nodes.
Info.bDeprecated = true;
return Info;
};
static const FNodeClassMetadata Info = InitNodeInfo();
return Info;
}
private:
class TReceiverOperator : public TExecutableOperator<TReceiverOperator>
{
TReceiverOperator() = delete;
public:
TReceiverOperator(TDataReadReference<TDataType> InInitDataRef, TDataWriteReference<TDataType> InOutDataRef, TDataReadReference<FSendAddress> InSendAddress, const FOperatorSettings& InOperatorSettings)
: bHasNotReceivedData(true)
, DefaultData(InInitDataRef)
, OutputData(InOutDataRef)
, SendAddress(InSendAddress)
, CachedSendAddress(*InSendAddress)
, CachedReceiverParams({InOperatorSettings})
, Receiver(nullptr)
{
Receiver = CreateNewReceiver();
}
virtual ~TReceiverOperator()
{
ResetReceiverAndCleanupChannel();
}
virtual FDataReferenceCollection GetInputs() const override
{
FDataReferenceCollection Inputs;
Inputs.AddDataReadReference<TDataType>(ReceiveNodeInfo::GetDefaultDataInputName(), DefaultData);
Inputs.AddDataReadReference<FSendAddress>(ReceiveNodeInfo::GetAddressInputName(), SendAddress);
return Inputs;
}
virtual FDataReferenceCollection GetOutputs() const override
{
FDataReferenceCollection Outputs;
Outputs.AddDataReadReference<TDataType>(ReceiveNodeInfo::GetOutputName(), TDataReadReference<TDataType>(OutputData));
return Outputs;
}
void Execute()
{
if (*SendAddress != CachedSendAddress)
{
ResetReceiverAndCleanupChannel();
CachedSendAddress = *SendAddress;
Receiver = CreateNewReceiver();
}
bool bHasNewData = false;
if (ensure(Receiver.IsValid()))
{
bHasNewData = Receiver->CanPop();
if (bHasNewData)
{
Receiver->Pop(*OutputData);
bHasNotReceivedData = false;
}
}
if (bHasNotReceivedData)
{
*OutputData = *DefaultData;
bHasNewData = true;
}
if (TExecutableDataType<TDataType>::bIsExecutable)
{
TExecutableDataType<TDataType>::ExecuteInline(*OutputData, bHasNewData);
}
}
private:
TReceiverPtr<TDataType> CreateNewReceiver() const
{
if (ensure(SendAddress->GetDataType().IsNone() || (GetMetasoundDataTypeName<TDataType>() == SendAddress->GetDataType())))
{
FSendAddress DataChannelKey(SendAddress->GetChannelName(), GetMetasoundDataTypeName<TDataType>(), SendAddress->GetInstanceID());
return FDataTransmissionCenter::Get().RegisterNewReceiver<TDataType>(DataChannelKey, CachedReceiverParams);
}
return TReceiverPtr<TDataType>(nullptr);
}
void ResetReceiverAndCleanupChannel()
{
Receiver.Reset();
FDataTransmissionCenter::Get().UnregisterDataChannelIfUnconnected(CachedSendAddress);
}
bool bHasNotReceivedData;
TDataReadReference<TDataType> DefaultData;
TDataWriteReference<TDataType> OutputData;
TDataReadReference<FSendAddress> SendAddress;
FSendAddress CachedSendAddress;
FReceiverInitParams CachedReceiverParams;
TReceiverPtr<TDataType> Receiver;
};
class FReceiverOperatorFactory : public IOperatorFactory
{
public:
FReceiverOperatorFactory() = default;
virtual TUniquePtr<IOperator> CreateOperator(const FCreateOperatorParams& InParams, FBuildErrorArray& OutErrors) override
{
TDataReadReference<TDataType> DefaultReadRef = TDataReadReferenceFactory<TDataType>::CreateAny(InParams.OperatorSettings);
if (InParams.InputDataReferences.ContainsDataReadReference<TDataType>(ReceiveNodeInfo::GetDefaultDataInputName()))
{
DefaultReadRef = InParams.InputDataReferences.GetDataReadReference<TDataType>(ReceiveNodeInfo::GetDefaultDataInputName());
}
return MakeUnique<TReceiverOperator>(
DefaultReadRef,
TDataWriteReferenceFactory<TDataType>::CreateAny(InParams.OperatorSettings, *DefaultReadRef),
InParams.InputDataReferences.GetDataReadReferenceOrConstruct<FSendAddress>(ReceiveNodeInfo::GetAddressInputName()),
InParams.OperatorSettings
);
}
};
public:
TReceiveNode(const FNodeInitData& InInitData)
: FNode(InInitData.InstanceName, InInitData.InstanceID, GetNodeInfo())
, Interface(DeclareVertexInterface())
, Factory(MakeOperatorFactoryRef<FReceiverOperatorFactory>())
{
}
virtual ~TReceiveNode() = default;
virtual const FVertexInterface& GetVertexInterface() const override
{
return Interface;
}
virtual bool SetVertexInterface(const FVertexInterface& InInterface) override
{
return Interface == InInterface;
}
virtual bool IsVertexInterfaceSupported(const FVertexInterface& InInterface) const override
{
return Interface == InInterface;
}
virtual FOperatorFactorySharedRef GetDefaultOperatorFactory() const override
{
return Factory;
}
private:
FVertexInterface Interface;
FOperatorFactorySharedRef Factory;
};
}
#undef LOCTEXT_NAMESPACE