Files
UnrealEngineUWP/Engine/Plugins/Runtime/Metasound/Source/MetasoundStandardNodes/Public/MetasoundValueNode.h
helen yang 5a2d9e55da Use loc text for MetaSound node vertex names (Part 1)
- New macro for defining node parameters to generate localized metadata struct
- Simple find and replace to use new macro

#jira UE-143472
#rb rob.gay
#preflight 621ed5c231454c90cce4b154

#ROBOMERGE-AUTHOR: helen.yang
#ROBOMERGE-SOURCE: CL 19225883 in //UE5/Release-5.0/... via CL 19228005
#ROBOMERGE-BOT: UE5 (Release-Engine-Staging -> Main) (v921-19075845)

[CL 19231251 by helen yang in ue5-main branch]
2022-03-02 17:22:27 -05:00

201 lines
7.4 KiB
C++

// Copyright Epic Games, Inc. All Rights Reserved.
#pragma once
#include "CoreMinimal.h"
#include "MetasoundFacade.h"
#include "MetasoundExecutableOperator.h"
#include "MetasoundNodeRegistrationMacro.h"
#include "MetasoundPrimitives.h"
#include "MetasoundStandardNodesNames.h"
#include "MetasoundTrigger.h"
#include "Internationalization/Text.h"
#include "MetasoundParamHelper.h"
#define LOCTEXT_NAMESPACE "MetasoundStandardNodes_ValueNode"
namespace Metasound
{
namespace MetasoundValueNodePrivate
{
METASOUNDSTANDARDNODES_API FNodeClassMetadata CreateNodeClassMetadata(const FName& InDataTypeName, const FName& InOperatorName, const FText& InDisplayName, const FText& InDescription, const FVertexInterface& InDefaultInterface);
}
namespace ValueVertexNames
{
METASOUND_PARAM(InputSetTrigger, "Set", "Trigger to write the set value to the output.");
METASOUND_PARAM(InputResetTrigger, "Reset", "Trigger to reset the value to the initial value.");
METASOUND_PARAM(InputInitValue, "Init Value", "Value to initialize the output value to.");
METASOUND_PARAM(InputTargetValue, "Target Value", "Value to immediately set the output to when triggered.");
METASOUND_PARAM(OutputOnSet, "On Set", "Triggered when the set input is triggered.");
METASOUND_PARAM(OutputOnReset, "On Reset", "Triggered when the reset input is triggered.");
METASOUND_PARAM(OutputValue, "Output Value", "The current output value.");
}
template<typename ValueType>
class TValueOperator : public TExecutableOperator<TValueOperator<ValueType>>
{
public:
static const FVertexInterface& GetDefaultInterface()
{
using namespace ValueVertexNames;
static const FVertexInterface DefaultInterface(
FInputVertexInterface(
TInputDataVertexModel<FTrigger>(METASOUND_GET_PARAM_NAME_AND_METADATA(InputSetTrigger)),
TInputDataVertexModel<FTrigger>(METASOUND_GET_PARAM_NAME_AND_METADATA(InputResetTrigger)),
TInputDataVertexModel<ValueType>(METASOUND_GET_PARAM_NAME_AND_METADATA(InputInitValue)),
TInputDataVertexModel<ValueType>(METASOUND_GET_PARAM_NAME_AND_METADATA(InputTargetValue))
),
FOutputVertexInterface(
TOutputDataVertexModel<FTrigger>(METASOUND_GET_PARAM_NAME_AND_METADATA(OutputOnSet)),
TOutputDataVertexModel<FTrigger>(METASOUND_GET_PARAM_NAME_AND_METADATA(OutputOnReset)),
TOutputDataVertexModel<ValueType>(METASOUND_GET_PARAM_NAME_AND_METADATA(OutputValue))
)
);
return DefaultInterface;
}
static const FNodeClassMetadata& GetNodeInfo()
{
auto CreateNodeClassMetadata = []() -> FNodeClassMetadata
{
const FName DataTypeName = GetMetasoundDataTypeName<ValueType>();
const FName OperatorName = "Value";
const FText NodeDisplayName = METASOUND_LOCTEXT_FORMAT("ValueDisplayNamePattern", "Value ({0})", GetMetasoundDataTypeDisplayText<ValueType>());
const FText NodeDescription = METASOUND_LOCTEXT("ValueDescription", "Allows setting a value to output on trigger.");
const FVertexInterface NodeInterface = GetDefaultInterface();
return MetasoundValueNodePrivate::CreateNodeClassMetadata(DataTypeName, OperatorName, NodeDisplayName, NodeDescription, NodeInterface);
};
static const FNodeClassMetadata Metadata = CreateNodeClassMetadata();
return Metadata;
}
static TUniquePtr<IOperator> CreateOperator(const FCreateOperatorParams& InParams, TArray<TUniquePtr<IOperatorBuildError>>& OutErrors)
{
using namespace ValueVertexNames;
const FInputVertexInterface& InputInterface = InParams.Node.GetVertexInterface().GetInputInterface();
const FDataReferenceCollection& InputCollection = InParams.InputDataReferences;
FTriggerReadRef SetTrigger = InputCollection.GetDataReadReferenceOrConstruct<FTrigger>(METASOUND_GET_PARAM_NAME(InputSetTrigger), InParams.OperatorSettings);
FTriggerReadRef ResetTrigger = InputCollection.GetDataReadReferenceOrConstruct<FTrigger>(METASOUND_GET_PARAM_NAME(InputResetTrigger), InParams.OperatorSettings);
TDataReadReference<ValueType> InitValue = InputCollection.GetDataReadReferenceOrConstructWithVertexDefault<ValueType>(InputInterface, METASOUND_GET_PARAM_NAME(InputInitValue), InParams.OperatorSettings);
TDataReadReference<ValueType> TargetValue = InputCollection.GetDataReadReferenceOrConstructWithVertexDefault<ValueType>(InputInterface, METASOUND_GET_PARAM_NAME(InputTargetValue), InParams.OperatorSettings);
return MakeUnique<TValueOperator<ValueType>>(InParams.OperatorSettings, SetTrigger, ResetTrigger, InitValue, TargetValue);
}
TValueOperator(const FOperatorSettings& InSettings, const FTriggerReadRef& InSetTrigger, const FTriggerReadRef& InResetTrigger, const TDataReadReference<ValueType>& InInitValue, const TDataReadReference<ValueType>& InTargetValue)
: SetTrigger(InSetTrigger)
, ResetTrigger(InResetTrigger)
, InitValue(InInitValue)
, TargetValue(InTargetValue)
, OutputValue(TDataWriteReferenceFactory<ValueType>::CreateAny(InSettings))
, TriggerOnSet(FTriggerWriteRef::CreateNew(InSettings))
, TriggerOnReset(FTriggerWriteRef::CreateNew(InSettings))
{
*OutputValue = *InitValue;
}
virtual ~TValueOperator() = default;
virtual FDataReferenceCollection GetInputs() const override
{
using namespace ValueVertexNames;
FDataReferenceCollection Inputs;
Inputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(InputSetTrigger), SetTrigger);
Inputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(InputResetTrigger), ResetTrigger);
Inputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(InputInitValue), InitValue);
Inputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(InputTargetValue), TargetValue);
return Inputs;
}
virtual FDataReferenceCollection GetOutputs() const override
{
using namespace ValueVertexNames;
FDataReferenceCollection Outputs;
Outputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(OutputOnSet), TriggerOnSet);
Outputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(OutputOnReset), TriggerOnReset);
Outputs.AddDataReadReference(METASOUND_GET_PARAM_NAME(OutputValue), OutputValue);
return Outputs;
}
void Execute()
{
TriggerOnReset->AdvanceBlock();
TriggerOnSet->AdvanceBlock();
if (*ResetTrigger)
{
*OutputValue = *InitValue;
}
if (*SetTrigger)
{
*OutputValue = *TargetValue;
}
ResetTrigger->ExecuteBlock(
[&](int32 StartFrame, int32 EndFrame)
{
},
[this](int32 StartFrame, int32 EndFrame)
{
TriggerOnReset->TriggerFrame(StartFrame);
}
);
SetTrigger->ExecuteBlock(
[&](int32 StartFrame, int32 EndFrame)
{
},
[this](int32 StartFrame, int32 EndFrame)
{
TriggerOnSet->TriggerFrame(StartFrame);
}
);
}
private:
TDataReadReference<FTrigger> SetTrigger;
TDataReadReference<FTrigger> ResetTrigger;
TDataReadReference<ValueType> InitValue;
TDataReadReference<ValueType> TargetValue;
TDataWriteReference<ValueType> OutputValue;
TDataWriteReference<FTrigger> TriggerOnSet;
TDataWriteReference<FTrigger> TriggerOnReset;
};
/** TValueNode
*
* Generates a random float value when triggered.
*/
template<typename ValueType>
class METASOUNDSTANDARDNODES_API TValueNode : public FNodeFacade
{
public:
/**
* Constructor used by the Metasound Frontend.
*/
TValueNode(const FNodeInitData& InInitData)
: FNodeFacade(InInitData.InstanceName, InInitData.InstanceID, TFacadeOperatorClass<TValueOperator<ValueType>>())
{}
virtual ~TValueNode() = default;
};
} // namespace Metasound
#undef LOCTEXT_NAMESPACE