Files
UnrealEngineUWP/Engine/Plugins/Runtime/Metasound/Source/MetasoundEngine/Private/MetasoundEngineAsset.h
rob gay b3ab5744bf - Fix for attempting to access EngineSubsystem during MetaSound versioning (serialization), which can assert when apparently certain commands in certain contexts can attempt to preload assets prior to the init phase.
- Minor Fix for LocText duplication
#tests BuildCookRun, -game, version MetaSounds assets in editor, PIE

[FYI] bob.tellez
Original CL Desc
-----------------------------------------------------------------
[Backout] - CL33084850
[FYI] Rob.Gay
Original CL Desc
-----------------------------------------------------------------
Version Metasound Document to include all ed data and make all Metasound EdGraph data transient
- Add input template nodes
- Add comment node data to document
- Keep references to member literal data (i.e. knob/slider ranges) in document metadata to ensure continued serialization and flexibility to add more editor-only fields and literal metadata
- Misc builder API updates, bug fixes and migration of controllers to builder API in anticipation of pages
- Sunset non-deterministic guid cvar
#rb phil.popp, helen.yang
[FYI] sondra.moyls
#tests Standard Automated Audio Tests, EngineTests, Offline QA Smoke pass, CPR, etc., extensive MetaSound Editor use, -game MetaSound qa levels, AudioUnitTests
#jira UE-194159

[CL 33102023 by rob gay in ue5-main branch]
2024-04-19 10:09:04 -04:00

231 lines
8.4 KiB
C++

// Copyright Epic Games, Inc. All Rights Reserved.
#pragma once
#include "Metasound.h"
#include "MetasoundAssetManager.h"
#include "MetasoundBuilderSubsystem.h"
#include "MetasoundFrontendDocumentIdGenerator.h"
#include "MetasoundFrontendRegistryKey.h"
#include "MetasoundUObjectRegistry.h"
#include "Misc/App.h"
#include "Serialization/Archive.h"
#if WITH_EDITORONLY_DATA
#include "MetasoundFrontendRegistries.h"
#include "Algo/Transform.h"
#endif // WITH_EDITORONLY_DATA
namespace Metasound
{
/** MetaSound Engine Asset helper provides routines for UObject based MetaSound assets.
* Any UObject deriving from FMetaSoundAssetBase should use these helper functions
* in their UObject overrides.
*/
struct FMetaSoundEngineAssetHelper
{
#if WITH_EDITOR
template <typename TMetaSoundObject>
static void PostEditUndo(TMetaSoundObject& InMetaSound)
{
InMetaSound.GetModifyContext().SetForceRefreshViews();
const FMetasoundFrontendDocument& Document = InMetaSound.GetConstDocumentChecked();
const FMetasoundFrontendClassName& ClassName = Document.RootGraph.Metadata.GetClassName();
UMetaSoundBuilderSubsystem::GetChecked().PostBuilderAssetTransaction(ClassName);
if (UMetasoundEditorGraphBase* Graph = Cast<UMetasoundEditorGraphBase>(InMetaSound.GetGraph()))
{
Graph->RegisterGraphWithFrontend();
}
}
template<typename TMetaSoundObject>
static void SetReferencedAssetClasses(TMetaSoundObject& InMetaSound, TSet<Frontend::IMetaSoundAssetManager::FAssetInfo>&& InAssetClasses)
{
using namespace Frontend;
InMetaSound.ReferencedAssetClassKeys.Reset();
InMetaSound.ReferencedAssetClassObjects.Reset();
for (const IMetaSoundAssetManager::FAssetInfo& AssetClass : InAssetClasses)
{
InMetaSound.ReferencedAssetClassKeys.Add(AssetClass.RegistryKey.ToString());
if (UObject* Object = AssetClass.AssetPath.TryLoad())
{
InMetaSound.ReferencedAssetClassObjects.Add(Object);
}
else
{
UE_LOG(LogMetaSound, Error, TEXT("Failed to load referenced asset %s from asset %s"), *AssetClass.AssetPath.ToString(), *InMetaSound.GetPathName());
}
}
}
#endif // WITH_EDITOR
template <typename TMetaSoundObject>
static FTopLevelAssetPath GetAssetPathChecked(TMetaSoundObject& InMetaSound)
{
FTopLevelAssetPath Path;
ensureAlwaysMsgf(Path.TrySetPath(&InMetaSound), TEXT("Failed to set TopLevelAssetPath from MetaSound '%s'. MetaSound must be highest level object in package."), *InMetaSound.GetPathName());
ensureAlwaysMsgf(Path.IsValid(), TEXT("Failed to set TopLevelAssetPath from MetaSound '%s'. This may be caused by calling this function when the asset is being destroyed."), *InMetaSound.GetPathName());
return Path;
}
template <typename TMetaSoundObject>
static TArray<FMetasoundAssetBase*> GetReferencedAssets(TMetaSoundObject& InMetaSound)
{
TArray<FMetasoundAssetBase*> ReferencedAssets;
IMetasoundUObjectRegistry& UObjectRegistry = IMetasoundUObjectRegistry::Get();
for (TObjectPtr<UObject>& Object : InMetaSound.ReferencedAssetClassObjects)
{
if (FMetasoundAssetBase* Asset = UObjectRegistry.GetObjectAsAssetBase(Object))
{
ReferencedAssets.Add(Asset);
}
else
{
UE_LOG(LogMetaSound, Error, TEXT("Referenced asset \"%s\", referenced from \"%s\", is not convertible to FMetasoundAssetBase"), *Object->GetPathName(), *InMetaSound.GetPathName());
}
}
return ReferencedAssets;
}
static void PreSaveAsset(FMetasoundAssetBase& InMetaSound, FObjectPreSaveContext InSaveContext)
{
#if WITH_EDITORONLY_DATA
using namespace Frontend;
// Do not call asset manager on CDO objects which may be loaded before asset
// manager is set.
if (IMetaSoundAssetManager* AssetManager = IMetaSoundAssetManager::Get())
{
AssetManager->WaitUntilAsyncLoadReferencedAssetsComplete(InMetaSound);
}
if (InSaveContext.IsCooking() || IsRunningCommandlet())
{
constexpr bool bIsDeterministic = true;
FDocumentIDGenerator::FScopeDeterminism DeterminismScope = FDocumentIDGenerator::FScopeDeterminism(bIsDeterministic);
InMetaSound.CookMetaSound();
}
else if (FApp::CanEverRenderAudio())
{
if (UMetasoundEditorGraphBase* MetaSoundGraph = Cast<UMetasoundEditorGraphBase>(InMetaSound.GetGraph()))
{
// Uses graph flavor of register with frontend to update editor systems/asset editors in case editor is enabled.
MetaSoundGraph->RegisterGraphWithFrontend();
InMetaSound.GetModifyContext().SetForceRefreshViews();
}
}
else
{
UE_LOG(LogMetaSound, Warning, TEXT("PreSaveAsset for MetaSound: (%s) is doing nothing because InSaveContext.IsCooking, IsRunningCommandlet, and FApp::CanEverRenderAudio were all false")
, *InMetaSound.GetOwningAssetName());
}
#endif // WITH_EDITORONLY_DATA
}
template <typename TMetaSoundObject>
static void SerializeToArchive(TMetaSoundObject& InMetaSound, FArchive& InArchive)
{
if (InArchive.IsLoading())
{
if (InMetaSound.VersionAsset())
{
#if WITH_EDITORONLY_DATA
InMetaSound.SetVersionedOnLoad();
#endif // WITH_EDITORONLY_DATA
}
}
}
template<typename TMetaSoundObject>
static void PostLoad(TMetaSoundObject& InMetaSound)
{
using namespace Frontend;
// Do not call asset manager on CDO objects which may be loaded before asset
// manager is set.
const bool bIsCDO = InMetaSound.HasAnyFlags(RF_ClassDefaultObject);
if (!bIsCDO)
{
if (InMetaSound.GetAsyncReferencedAssetClassPaths().Num() > 0)
{
if (IMetaSoundAssetManager* AssetManager = IMetaSoundAssetManager::Get())
{
AssetManager->RequestAsyncLoadReferencedAssets(InMetaSound);
}
else
{
UE_LOG(LogMetaSound, Warning, TEXT("Request for to load async references ignored from asset %s. Likely due loading before the MetaSoundEngine module."), *InMetaSound.GetPathName());
}
}
}
}
template<typename TMetaSoundObject>
static void OnAsyncReferencedAssetsLoaded(TMetaSoundObject& InMetaSound, const TArray<FMetasoundAssetBase*>& InAsyncReferences)
{
for (FMetasoundAssetBase* AssetBase : InAsyncReferences)
{
if (AssetBase)
{
if (UObject* OwningAsset = AssetBase->GetOwningAsset())
{
InMetaSound.ReferencedAssetClassObjects.Add(OwningAsset);
InMetaSound.ReferenceAssetClassCache.Remove(FSoftObjectPath(OwningAsset));
}
}
}
}
#if WITH_EDITORONLY_DATA
template <typename TMetaSoundObject>
static void SetMetaSoundRegistryAssetClassInfo(TMetaSoundObject& InMetaSound, const Frontend::FNodeClassInfo& InClassInfo)
{
using namespace Frontend;
check(AssetTags::AssetClassID == GET_MEMBER_NAME_CHECKED(TMetaSoundObject, AssetClassID));
check(AssetTags::IsPreset == GET_MEMBER_NAME_CHECKED(TMetaSoundObject, bIsPreset));
check(AssetTags::RegistryInputTypes == GET_MEMBER_NAME_CHECKED(TMetaSoundObject, RegistryInputTypes));
check(AssetTags::RegistryOutputTypes == GET_MEMBER_NAME_CHECKED(TMetaSoundObject, RegistryOutputTypes));
check(AssetTags::RegistryVersionMajor == GET_MEMBER_NAME_CHECKED(TMetaSoundObject, RegistryVersionMajor));
check(AssetTags::RegistryVersionMinor == GET_MEMBER_NAME_CHECKED(TMetaSoundObject, RegistryVersionMinor));
bool bMarkDirty = InMetaSound.AssetClassID != InClassInfo.AssetClassID;
bMarkDirty |= InMetaSound.RegistryVersionMajor != InClassInfo.Version.Major;
bMarkDirty |= InMetaSound.RegistryVersionMinor != InClassInfo.Version.Minor;
bMarkDirty |= InMetaSound.bIsPreset != InClassInfo.bIsPreset;
InMetaSound.AssetClassID = InClassInfo.AssetClassID;
InMetaSound.RegistryVersionMajor = InClassInfo.Version.Major;
InMetaSound.RegistryVersionMinor = InClassInfo.Version.Minor;
InMetaSound.bIsPreset = InClassInfo.bIsPreset;
{
TArray<FString> InputTypes;
Algo::Transform(InClassInfo.InputTypes, InputTypes, [](const FName& Name) { return Name.ToString(); });
const FString TypeString = FString::Join(InputTypes, *AssetTags::ArrayDelim);
bMarkDirty |= InMetaSound.RegistryInputTypes != TypeString;
InMetaSound.RegistryInputTypes = TypeString;
}
{
TArray<FString> OutputTypes;
Algo::Transform(InClassInfo.OutputTypes, OutputTypes, [](const FName& Name) { return Name.ToString(); });
const FString TypeString = FString::Join(OutputTypes, *AssetTags::ArrayDelim);
bMarkDirty |= InMetaSound.RegistryOutputTypes != TypeString;
InMetaSound.RegistryOutputTypes = TypeString;
}
}
#endif // WITH_EDITORONLY_DATA
};
} // namespace Metasound