Files
UnrealEngineUWP/Engine/Source/Editor/HardwareTargeting/Private/HardwareTargetingModule.cpp
Matthew Griffin bb70b349ce Merging CL 2804086 from //UE4/Release-4.11 to Dev-Main (//UE4/Dev-Main) to isolate copyright update
#lockdown Nick.Penwarden

[CL 2819020 by Matthew Griffin in Main branch]
2016-01-07 08:17:16 -05:00

311 lines
12 KiB
C++

// Copyright 1998-2016 Epic Games, Inc. All Rights Reserved.
#include "HardwareTargetingPrivatePCH.h"
#include "HardwareTargetingModule.h"
#include "HardwareTargetingSettings.h"
#include "Internationalization.h"
#include "ISettingsModule.h"
#include "ModuleManager.h"
#include "SDecoratedEnumCombo.h"
#include "Runtime/Engine/Classes/Engine/RendererSettings.h"
#include "Editor/Documentation/Public/IDocumentation.h"
#include "GameFramework/InputSettings.h"
#include "GameMapsSettings.h"
#include "EditorProjectSettings.h"
#define LOCTEXT_NAMESPACE "HardwareTargeting"
//////////////////////////////////////////////////////////////////////////
// FMetaSettingGatherer
struct FMetaSettingGatherer
{
FTextBuilder DescriptionBuffer;
TMap<UObject*, FTextBuilder> DescriptionBuffers;
TMap<UObject*, FText> CategoryNames;
// Are we just displaying what would change, or actually changing things?
bool bReadOnly;
bool bIncludeUnmodifiedProperties;
FMetaSettingGatherer()
: bReadOnly(false)
, bIncludeUnmodifiedProperties(false)
{
}
void AddEntry(UObject* SettingsObject, UProperty* Property, FText NewValue, bool bModified)
{
if (bModified || bIncludeUnmodifiedProperties)
{
FTextBuilder& SettingsDescriptionBuffer = DescriptionBuffers.FindOrAdd(SettingsObject);
if (!bReadOnly)
{
FPropertyChangedEvent ChangeEvent(Property, EPropertyChangeType::ValueSet);
SettingsObject->PostEditChangeProperty(ChangeEvent);
}
else
{
FText SettingDisplayName = Property->GetDisplayNameText();
FFormatNamedArguments Args;
Args.Add(TEXT("SettingName"), SettingDisplayName);
Args.Add(TEXT("SettingValue"), NewValue);
FText FormatString = bModified ?
LOCTEXT("MetaSettingDisplayStringModified", "{SettingName} is {SettingValue} <HardwareTargets.Strong>(modified)</>") :
LOCTEXT("MetaSettingDisplayStringUnmodified", "{SettingName} is {SettingValue}");
SettingsDescriptionBuffer.AppendLine(FText::Format(FormatString, Args));
}
}
}
template <typename ValueType>
static FText ValueToString(ValueType Value);
bool Finalize()
{
check(!bReadOnly);
bool bSuccess = true;
for (auto& Pair : DescriptionBuffers)
{
const FString Filename = Pair.Key->GetDefaultConfigFilename();
const FDateTime BeforeTime = IFileManager::Get().GetTimeStamp(*Filename);
Pair.Key->UpdateDefaultConfigFile();
const FDateTime AfterTime = IFileManager::Get().GetTimeStamp(*Filename);
bSuccess = BeforeTime != AfterTime && bSuccess;
}
return bSuccess;
}
};
template <>
FText FMetaSettingGatherer::ValueToString(bool Value)
{
return Value ? LOCTEXT("BoolEnabled", "enabled") : LOCTEXT("BoolDisabled", "disabled");
}
template <>
FText FMetaSettingGatherer::ValueToString(EAntiAliasingMethodUI::Type Value)
{
switch (Value)
{
case EAntiAliasingMethodUI::AAM_None:
return LOCTEXT("AA_None", "None");
case EAntiAliasingMethodUI::AAM_FXAA:
return LOCTEXT("AA_FXAA", "FXAA");
case EAntiAliasingMethodUI::AAM_TemporalAA:
return LOCTEXT("AA_TemporalAA", "Temporal AA");
default:
return FText::AsNumber((int32)Value);
}
}
#define UE_META_SETTING_ENTRY(Builder, Class, PropertyName, TargetValue) \
{ \
Class* SettingsObject = GetMutableDefault<Class>(); \
bool bModified = SettingsObject->PropertyName != (TargetValue); \
if (!Builder.bReadOnly) { SettingsObject->PropertyName = (TargetValue); } \
Builder.AddEntry(SettingsObject, FindFieldChecked<UProperty>(Class::StaticClass(), GET_MEMBER_NAME_CHECKED(Class, PropertyName)), FMetaSettingGatherer::ValueToString(TargetValue), bModified); \
}
//////////////////////////////////////////////////////////////////////////
// FHardwareTargetingModule
class FHardwareTargetingModule : public IHardwareTargetingModule
{
public:
// IModuleInterface interface
virtual void StartupModule() override;
virtual void ShutdownModule() override;
// End of IModuleInterface interface
// IHardwareTargetingModule interface
virtual void ApplyHardwareTargetingSettings() override;
virtual TArray<FModifiedDefaultConfig> GetPendingSettingsChanges() override;
virtual TSharedRef<SWidget> MakeHardwareClassTargetCombo(FOnHardwareClassChanged OnChanged, TAttribute<EHardwareClass::Type> SelectedEnum) override;
virtual TSharedRef<SWidget> MakeGraphicsPresetTargetCombo(FOnGraphicsPresetChanged OnChanged, TAttribute<EGraphicsPreset::Type> SelectedEnum) override;
// End of IHardwareTargetingModule interface
private:
void GatherSettings(FMetaSettingGatherer& Builder);
};
void FHardwareTargetingModule::StartupModule()
{
ISettingsModule* SettingsModule = FModuleManager::GetModulePtr<ISettingsModule>("Settings");
if (SettingsModule != nullptr)
{
SettingsModule->RegisterSettings("Project", "Project", "HardwareTargeting",
LOCTEXT("HardwareTargetingSettingsName", "Target Hardware"),
LOCTEXT("HardwareTargetingSettingsDescription", "Options for choosing which class of hardware to target"),
GetMutableDefault<UHardwareTargetingSettings>()
);
}
// Apply any settings on startup if necessary
ApplyHardwareTargetingSettings();
}
void FHardwareTargetingModule::ShutdownModule()
{
}
TArray<FModifiedDefaultConfig> FHardwareTargetingModule::GetPendingSettingsChanges()
{
// Gather and stringify the modified settings
FMetaSettingGatherer Gatherer;
Gatherer.bReadOnly = true;
Gatherer.bIncludeUnmodifiedProperties = true;
GatherSettings(Gatherer);
TArray<FModifiedDefaultConfig> OutArray;
for (auto& Pair : Gatherer.DescriptionBuffers)
{
FModifiedDefaultConfig ModifiedConfig;
ModifiedConfig.SettingsObject = Pair.Key;
ModifiedConfig.Description = Pair.Value.ToText();
ModifiedConfig.CategoryHeading = Gatherer.CategoryNames.FindChecked(Pair.Key);
OutArray.Add(ModifiedConfig);
}
return OutArray;
}
void FHardwareTargetingModule::GatherSettings(FMetaSettingGatherer& Builder)
{
UHardwareTargetingSettings* Settings = GetMutableDefault<UHardwareTargetingSettings>();
if (Builder.bReadOnly)
{
// Force the category order and give nice descriptions
Builder.CategoryNames.Add(GetMutableDefault<URendererSettings>(), LOCTEXT("RenderingCategoryHeader", "Engine - Rendering"));
Builder.CategoryNames.Add(GetMutableDefault<UInputSettings>(), LOCTEXT("InputCategoryHeader", "Engine - Input"));
Builder.CategoryNames.Add(GetMutableDefault<UGameMapsSettings>(), LOCTEXT("MapsAndModesCategoryHeader", "Project - Maps & Modes"));
Builder.CategoryNames.Add(GetMutableDefault<ULevelEditor2DSettings>(), LOCTEXT("EditorSettings2D", "Editor - 2D"));
}
const bool bLowEndMobile = (Settings->TargetedHardwareClass == EHardwareClass::Mobile) && (Settings->DefaultGraphicsPerformance == EGraphicsPreset::Scalable);
const bool bAnyMobile = (Settings->TargetedHardwareClass == EHardwareClass::Mobile);
const bool bHighEndMobile = (Settings->TargetedHardwareClass == EHardwareClass::Mobile) && (Settings->DefaultGraphicsPerformance == EGraphicsPreset::Maximum);
const bool bAnyPC = (Settings->TargetedHardwareClass == EHardwareClass::Desktop);
const bool bHighEndPC = (Settings->TargetedHardwareClass == EHardwareClass::Desktop) && (Settings->DefaultGraphicsPerformance == EGraphicsPreset::Maximum);
const bool bAnyScalable = Settings->DefaultGraphicsPerformance == EGraphicsPreset::Scalable;
{
// Based roughly on https://docs.unrealengine.com/latest/INT/Platforms/Mobile/PostProcessEffects/index.html
UE_META_SETTING_ENTRY(Builder, URendererSettings, bMobileHDR, !bLowEndMobile);
// Bloom works and isn't terribly expensive on anything beyond low-end
UE_META_SETTING_ENTRY(Builder, URendererSettings, bDefaultFeatureBloom, !bLowEndMobile);
// Separate translucency does nothing in the ES2 renderer
UE_META_SETTING_ENTRY(Builder, URendererSettings, bSeparateTranslucency, !bAnyMobile);
// Motion blur, auto-exposure, and ambient occlusion don't work in the ES2 renderer
UE_META_SETTING_ENTRY(Builder, URendererSettings, bDefaultFeatureMotionBlur, bHighEndPC);
UE_META_SETTING_ENTRY(Builder, URendererSettings, bDefaultFeatureAutoExposure, bHighEndPC);
UE_META_SETTING_ENTRY(Builder, URendererSettings, bDefaultFeatureAmbientOcclusion, bAnyPC);
// lens flare doesn't work in the ES2 renderer, the quality is low and the feature is controversial
UE_META_SETTING_ENTRY(Builder, URendererSettings, bDefaultFeatureLensFlare, false);
// DOF and AA work on mobile but are expensive, keeping them off by default
//@TODO: DOF setting doesn't exist yet
// UE_META_SETTING_ENTRY(Builder, URendererSettings, bDefaultFeatureDepthOfField, bHighEndPC);
UE_META_SETTING_ENTRY(Builder, URendererSettings, DefaultFeatureAntiAliasing, bHighEndPC ? EAntiAliasingMethodUI::AAM_TemporalAA : EAntiAliasingMethodUI::AAM_None);
}
{
// Mobile uses touch
UE_META_SETTING_ENTRY(Builder, UInputSettings, bUseMouseForTouch, bAnyMobile);
//@TODO: Use bAlwaysShowTouchInterface (sorta implied by bUseMouseForTouch)?
}
{
// Tablets or phones are usually shared-screen multiplayer instead of split-screen
UE_META_SETTING_ENTRY(Builder, UGameMapsSettings, bUseSplitscreen, bAnyPC);
}
}
void FHardwareTargetingModule::ApplyHardwareTargetingSettings()
{
UHardwareTargetingSettings* Settings = GetMutableDefault<UHardwareTargetingSettings>();
// Apply the settings if they've changed
if (Settings->HasPendingChanges())
{
// Gather and apply the modified settings
FMetaSettingGatherer Builder;
Builder.bReadOnly = false;
GatherSettings(Builder);
const bool bSuccess = Builder.Finalize();
// Write out the 'did we apply' values
if (bSuccess)
{
Settings->AppliedTargetedHardwareClass = Settings->TargetedHardwareClass;
Settings->AppliedDefaultGraphicsPerformance = Settings->DefaultGraphicsPerformance;
Settings->UpdateDefaultConfigFile();
}
}
}
TSharedRef<SWidget> FHardwareTargetingModule::MakeHardwareClassTargetCombo(FOnHardwareClassChanged OnChanged, TAttribute<EHardwareClass::Type> SelectedEnum)
{
TArray<SDecoratedEnumCombo<EHardwareClass::Type>::FComboOption> HardwareClassInfo;
HardwareClassInfo.Add(SDecoratedEnumCombo<EHardwareClass::Type>::FComboOption(
EHardwareClass::Unspecified, FSlateIcon(FEditorStyle::GetStyleSetName(), "HardwareTargeting.HardwareUnspecified"), LOCTEXT("UnspecifiedCaption", "Unspecified"), false));
HardwareClassInfo.Add(SDecoratedEnumCombo<EHardwareClass::Type>::FComboOption(
EHardwareClass::Desktop, FSlateIcon(FEditorStyle::GetStyleSetName(), "HardwareTargeting.DesktopPlatform"), LOCTEXT("DesktopCaption", "Desktop / Console")));
HardwareClassInfo.Add(SDecoratedEnumCombo<EHardwareClass::Type>::FComboOption(
EHardwareClass::Mobile, FSlateIcon(FEditorStyle::GetStyleSetName(), "HardwareTargeting.MobilePlatform"), LOCTEXT("MobileCaption", "Mobile / Tablet")));
return SNew(SDecoratedEnumCombo<EHardwareClass::Type>, MoveTemp(HardwareClassInfo))
.SelectedEnum(SelectedEnum)
.OnEnumChanged(OnChanged)
.ToolTip(IDocumentation::Get()->CreateToolTip(LOCTEXT("HardwareClassTooltip", "Choose the overall class of hardware to target (desktop/console or mobile/tablet)."), NULL, TEXT("Shared/Editor/Settings/TargetHardware"), TEXT("HardwareClass")));
}
TSharedRef<SWidget> FHardwareTargetingModule::MakeGraphicsPresetTargetCombo(FOnGraphicsPresetChanged OnChanged, TAttribute<EGraphicsPreset::Type> SelectedEnum)
{
TArray<SDecoratedEnumCombo<EGraphicsPreset::Type>::FComboOption> GraphicsPresetInfo;
GraphicsPresetInfo.Add(SDecoratedEnumCombo<EGraphicsPreset::Type>::FComboOption(
EGraphicsPreset::Unspecified, FSlateIcon(FEditorStyle::GetStyleSetName(), "HardwareTargeting.GraphicsUnspecified"), LOCTEXT("UnspecifiedCaption", "Unspecified"), false));
GraphicsPresetInfo.Add(SDecoratedEnumCombo<EGraphicsPreset::Type>::FComboOption(
EGraphicsPreset::Maximum, FSlateIcon(FEditorStyle::GetStyleSetName(), "HardwareTargeting.MaximumQuality"), LOCTEXT("MaximumCaption", "Maximum Quality")));
GraphicsPresetInfo.Add(SDecoratedEnumCombo<EGraphicsPreset::Type>::FComboOption(
EGraphicsPreset::Scalable, FSlateIcon(FEditorStyle::GetStyleSetName(), "HardwareTargeting.ScalableQuality"), LOCTEXT("ScalableCaption", "Scalable 3D or 2D")));
return SNew(SDecoratedEnumCombo<EGraphicsPreset::Type>, MoveTemp(GraphicsPresetInfo))
.SelectedEnum(SelectedEnum)
.OnEnumChanged(OnChanged)
.ToolTip(IDocumentation::Get()->CreateToolTip(LOCTEXT("GraphicsPresetTooltip", "Choose the graphical level to target (high-end only or scalable from low-end on up)."), NULL, TEXT("Shared/Editor/Settings/TargetHardware"), TEXT("GraphicalLevel")));
}
IHardwareTargetingModule& IHardwareTargetingModule::Get()
{
static FHardwareTargetingModule Instance;
return Instance;
}
IMPLEMENT_MODULE(FHardwareTargetingModule, HardwareTarget);
#undef UE_META_SETTING_ENTRY
#undef LOCTEXT_NAMESPACE