From 69869214399aabb4d9cf85a5eed14e44e8f92319 Mon Sep 17 00:00:00 2001 From: Steve Streeting Date: Mon, 14 Sep 2020 17:00:52 +0100 Subject: [PATCH] Code moved into separate repo --- .gitignore | 8 + License.txt | 8 + ReadMe.md | 183 +++++++++++++ Resources/Icon.afphoto | Bin 0 -> 42219 bytes Resources/Icon128.png | Bin 0 -> 5284 bytes Resources/bpexample.png | Bin 0 -> 121075 bytes Resources/gameinstance.png | Bin 0 -> 34403 bytes .../Private/StevesGameSubsystem.cpp | 184 +++++++++++++ .../Private/StevesGameViewportClientBase.cpp | 29 ++ .../Private/StevesUEHelpers.cpp | 22 ++ .../Private/StevesUI/FocusableButton.cpp | 82 ++++++ .../Private/StevesUI/FocusablePanel.cpp | 68 +++++ .../Private/StevesUI/FocusableUserWidget.cpp | 7 + .../Private/StevesUI/InputImage.cpp | 165 ++++++++++++ .../Private/StevesUI/MenuBase.cpp | 99 +++++++ .../Private/StevesUI/MenuStack.cpp | 152 +++++++++++ .../Private/StevesUI/OptionWidgetBase.cpp | 252 ++++++++++++++++++ .../Private/StevesUI/SFocusableButton.cpp | 75 ++++++ .../Private/StevesUI/SFocusableButton.h | 116 ++++++++ .../Private/StevesUI/StevesUI.cpp | 51 ++++ .../Private/StevesUI/StevesUI.h | 26 ++ .../Public/StevesGameSubsystem.h | 123 +++++++++ .../Public/StevesGameViewportClientBase.h | 24 ++ .../Public/StevesHelperCommon.h | 12 + .../StevesUEHelpers/Public/StevesUEHelpers.h | 29 ++ .../Public/StevesUI/FocusableButton.h | 54 ++++ .../Public/StevesUI/FocusablePanel.h | 62 +++++ .../Public/StevesUI/FocusableUserWidget.h | 20 ++ .../Public/StevesUI/InputImage.h | 93 +++++++ .../Public/StevesUI/KeySprite.h | 33 +++ .../Public/StevesUI/MenuBase.h | 59 ++++ .../Public/StevesUI/MenuStack.h | 100 +++++++ .../Public/StevesUI/OptionWidgetBase.h | 150 +++++++++++ .../StevesUEHelpers/Public/StevesUI/UiTheme.h | 25 ++ .../StevesUEHelpers/StevesUEHelpers.Build.cs | 49 ++++ StevesUEHelpers.uplugin | 31 +++ 36 files changed, 2391 insertions(+) create mode 100644 .gitignore create mode 100644 License.txt create mode 100644 ReadMe.md create mode 100644 Resources/Icon.afphoto create mode 100644 Resources/Icon128.png create mode 100644 Resources/bpexample.png create mode 100644 Resources/gameinstance.png create mode 100644 Source/StevesUEHelpers/Private/StevesGameSubsystem.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesGameViewportClientBase.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUEHelpers.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/FocusableButton.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/FocusablePanel.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/FocusableUserWidget.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/InputImage.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/MenuBase.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/MenuStack.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/OptionWidgetBase.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.h create mode 100644 Source/StevesUEHelpers/Private/StevesUI/StevesUI.cpp create mode 100644 Source/StevesUEHelpers/Private/StevesUI/StevesUI.h create mode 100644 Source/StevesUEHelpers/Public/StevesGameSubsystem.h create mode 100644 Source/StevesUEHelpers/Public/StevesGameViewportClientBase.h create mode 100644 Source/StevesUEHelpers/Public/StevesHelperCommon.h create mode 100644 Source/StevesUEHelpers/Public/StevesUEHelpers.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/FocusableButton.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/FocusablePanel.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/FocusableUserWidget.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/InputImage.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/KeySprite.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/MenuBase.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/MenuStack.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/OptionWidgetBase.h create mode 100644 Source/StevesUEHelpers/Public/StevesUI/UiTheme.h create mode 100644 Source/StevesUEHelpers/StevesUEHelpers.Build.cs create mode 100644 StevesUEHelpers.uplugin diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0911590 --- /dev/null +++ b/.gitignore @@ -0,0 +1,8 @@ + +Binaries/* +Intermediate/* +Plugins/*/Intermediate/* + +# Cache files for the editor to use +DerivedDataCache/* + diff --git a/License.txt b/License.txt new file mode 100644 index 0000000..9a2ca36 --- /dev/null +++ b/License.txt @@ -0,0 +1,8 @@ +The MIT License (MIT) +Copyright © 2020 Steve Streeting + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/ReadMe.md b/ReadMe.md new file mode 100644 index 0000000..6c07823 --- /dev/null +++ b/ReadMe.md @@ -0,0 +1,183 @@ +# Steve's UE Helper Plugin Library + +## Introduction + +This is a helper plugin library for [Unreal Engine 4](https://www.unrealengine.com) +which makes a bunch of things better: + +* UI Improvements + * FocusableButton: button which uses Hover style to highlight when it has focus (keyboard / gamepad) + * FocusablePanel: which ensure a widget is focussed when gamepad is activated so navigation is reliable + * Also remembers last focussed widget so it can be restored when used in context stacks + * FocusableUserWidget: A hack to allow UserWidgets to delegate their focus requests to a child item (required to make focus work reliably with compound widgets) + * InputImage: Image which will change itself to an image representing a button / key based on an input action + * (It changes dynamically when the input method changes e.g. when player moves a gamepad stick) + * Includes use of a UiTheme data asset which maps FKeys to Sprite images of buttons + * MenuStack/MenuBase: a context stack of widgets so you can easily create menu sequences, implement "back" navigation + * OptionWidgetBase: a widget which implements the "choose an item" concept but adapts between mouse and keyboard/gamepad + style navigation depending on what the currently used input method is +* Input Improvements + * Tracks last used input method (keyboard / mouse / gamepad) per player + * Events raised whenever a player uses a different input method (in game, and in UI) + (Actually reliable and not dependent on vagaries of input mappings / differences between UI and game input) + +## Installing this plugin + +### Cloning + +The best way is to clone this repository as a submodule; that way you can contribute +pull requests if you want. + +``` +> cd YourProject\Plugins +> git submodule add https://github.com/sinbad/StevesUEHelpers +> git add ../.gitmodules +> git commit +``` + +Alternatively you can download the ZIP of this repo and place it in +`YourProject/Plugins/StevesUEHelpers`. + +### Referencing in C++ + +Edit YourProject.Build.cs and do something similar to this: + +```csharp +public class YourProject : ModuleRules +{ + private string PluginsPath + { + get { return Path.GetFullPath( Path.Combine( ModuleDirectory, "../../Plugins/" ) ); } + } + + public YourProject(ReadOnlyTargetRules Target) : base(Target) + { + // Your existing rules + // ... + + + AddStevesUEHelpers(); + } + + protected void AddStevesUEHelpers() { + // Linker + PrivateDependencyModuleNames.AddRange(new string[] { "StevesUEHelpers" }); + // Headers + PublicIncludePaths.Add(Path.Combine( PluginsPath, "StevesUEHelpers", "Source", "StevesUEHelpers", "Public")); + } + +``` + +You can use most of the features without doing anything else, but certain features +require some additional setup, see below. + +## Usage + +### Widgets + +Many features are contained in new widget types, which can be created directly in +UMG Design mode. + +TODO: specific tutorials on new widget types. + +### Game instance subsystem + +In order to track stateful things like the current input mode for each player, +there is a custom `GameInstanceSubsystem` called `StevesGameSubsystem`, which +you can tap into anywhere in Blueprints by searchign for it: + +![Game Instance Subsystem](./Resources/gameinstance.png) + +Once you have access to this you can do things like tie events into the input mode +changing: + +![Game Instance Subsystem](./Resources/bpexample.png) + +To access this in C++, just do this: + +```c++ +#include "StevesUEHelpers.h" + +... +auto GS = GetStevesGameSubsystem(GetWorld()); +if (GS) +{ + // get current mode (first player assumed) + EInputMode CurrentInputMode = GS->GetLastInputModeUsed(); + // Subscribe to input mode changes (remember this must be a UFUNCTION) + GS->OnInputModeChanged.AddUniqueDynamic(this, &AMyActor::OnInputModeChanged); +} + +``` + +# Additional Configuration + +## UiTheme + +Some features of this plugin such as InputImage need a `UUiTheme` asset, which is just a Data Asset +based on the `UUiTheme` class which references other resources like button images. There is one in the Examples project as reference. + +### Create a UiTheme: + + +1. Click Add New > Miscellaneous > Data Asset +1. Select "UiTheme" as the class +1. Save the new asset with your chosen name + +### Create a Primary Asset Label + +UiThemes are a new kind of primary asset, loaded at runtime. To ensure this +asset is included when packaging, create a Primary Asset Label in the same folder: + +1. Click Add New > Miscellaneous > Data Asset +1. Select "Primary Asset Label" as the class +1. Name it however you like +1. Double-click to edit +1. Under "Explicit Assets", add an entry and pick the UiTheme you created above +1. Save the changes + +This just ensures that the packaging system knows to include your UiTheme, since +it won't be directly referenced by any other primary asset. + +### Create button sprite data + +The UiTheme wants to reference DataTables which contain links between the input +keys and button sprites. So the first job is to create the button sprites. + +The Example project includes some button sprites already; contained in a packed +sprite sheet. I created these using TexturePacker and imported into UE which created +the sprites, but you can create them however you like. However, we do require sprites +rather than plain textures. + +This means you must have the Paper2D plugin enabled in your project. + +### Linking input keys to button sprites +Once you have a set of button sprites, you need to create DataTables which map +input FKeys (which can be keys, or mouse buttons, or gamepad buttons / sticks) +to these sprites, so that for example InputImage can be told to display the action +"Fire", and then display either say the left mouse button or a gamepad trigger +depending on what's being used. + +Personally I did this using a CSV file for ease of use, for example: + +```csv +Name,Key,Sprite +Gamepad_LeftX,Gamepad_LeftX,"PaperSprite'/Game/Textures/UI/Sprites/Frames/XboxOne_Left_Stick'" +Gamepad_FaceButton_Bottom,Gamepad_FaceButton_Bottom,"PaperSprite'/Game/Textures/UI/Sprites/Frames/XboxOne_A'" +``` + +You should import this as a DataTable based on the KeySprite type. A separate +one is needed for keyboard / mouse and gamepad. Once you've created them, or +copied the ones from the examples, you should update the UiTheme asset you +created to point at these data tables. + +# License + +The MIT License (MIT) +Copyright © 2020 Steve Streeting + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/Resources/Icon.afphoto b/Resources/Icon.afphoto new file mode 100644 index 0000000000000000000000000000000000000000..701850965d71182950c4c1e540be0945a815be0e GIT binary patch literal 42219 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 literal 0 HcmV?d00001 diff --git a/Resources/Icon128.png b/Resources/Icon128.png new file mode 100644 index 0000000000000000000000000000000000000000..611f835e860693b375bede2a2ad5bd022d5ff135 GIT binary patch literal 5284 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 Mdu+^an))31A8gjoIsgCw literal 0 HcmV?d00001 diff --git a/Resources/bpexample.png b/Resources/bpexample.png new file mode 100644 index 0000000000000000000000000000000000000000..44199bbe308c066a10655cf812ff0758cb0180ba GIT binary patch literal 121075 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 ZNz1U#6Xd24=u8FwbhS_6Gc~RJ{ttb1w!Q!W literal 0 HcmV?d00001 diff --git a/Source/StevesUEHelpers/Private/StevesGameSubsystem.cpp b/Source/StevesUEHelpers/Private/StevesGameSubsystem.cpp new file mode 100644 index 0000000..fd9c182 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesGameSubsystem.cpp @@ -0,0 +1,184 @@ +#include "StevesGameSubsystem.h" +#include "StevesGameViewportClientBase.h" +#include "StevesUEHelpers.h" +#include "Engine/AssetManager.h" +#include "Engine/GameInstance.h" +#include "Framework/Application/SlateApplication.h" +#include "GameFramework/PlayerController.h" + +//PRAGMA_DISABLE_OPTIMIZATION + +void UStevesGameSubsystem::Initialize(FSubsystemCollectionBase& Collection) +{ + Super::Initialize(Collection); + CreateInputDetector(); + InitTheme(); + + auto GI = GetGameInstance(); + auto VC = Cast(GI->GetGameViewportClient()); + if (!VC) + UE_LOG(LogStevesUEHelpers, Warning, TEXT("Your GameViewportClient needs to be set to a subclass of UStevesGameViewportClientBase if you want full functionality!")) + +} + +void UStevesGameSubsystem::Deinitialize() +{ + Super::Deinitialize(); + DestroyInputDetector(); +} + + +void UStevesGameSubsystem::CreateInputDetector() +{ + if (!InputDetector.IsValid()) + { + InputDetector = MakeShareable(new FInputModeDetector()); + FSlateApplication::Get().RegisterInputPreProcessor(InputDetector); + + InputDetector->OnInputModeChanged.BindUObject(this, &UStevesGameSubsystem::OnInputDetectorModeChanged); + } + +} + +void UStevesGameSubsystem::DestroyInputDetector() +{ + if (InputDetector.IsValid()) + { + FSlateApplication::Get().UnregisterInputPreProcessor(InputDetector); + InputDetector.Reset(); + } +} + +void UStevesGameSubsystem::InitTheme() +{ + DefaultUiTheme = LoadObject(nullptr, *DefaultUiThemePath, nullptr); +} + +void UStevesGameSubsystem::OnInputDetectorModeChanged(int PlayerIndex, EInputMode NewMode) +{ + auto GI = GetGameInstance(); + auto VC = GI->GetGameViewportClient(); + auto SVC = Cast(VC); + if (VC) + { + if (NewMode == EInputMode::Gamepad) + { + // First move mouse pointer out of the way because it still generates mouse hits (unless we make source changes to Slate, ugh) + auto PC = GI->GetFirstLocalPlayerController(); + FVector2D Sz; + VC->GetViewportSize(Sz); + // -1 because if you move cursor outside window when captured, Slate blows up when you press Return, ughghh + PC->SetMouseLocation(Sz.X-1,Sz.Y-1); + + // Now hide it + // I've seen people use PC->bShowMouseCursor but this messes with capturing when you switch back & forth + // especially when pausing in the editor + + // instead, I'm using a separate flag to suppress it, see UiFixGameViewportClient for usage + if (SVC) + SVC->SetSuppressMouseCursor(true); + } + else if (NewMode == EInputMode::Mouse) + { + if (SVC) + SVC->SetSuppressMouseCursor(false); + } + } + OnInputModeChanged.Broadcast(PlayerIndex, NewMode); +} + +UStevesGameSubsystem::FInputModeDetector::FInputModeDetector() +{ + // 4 local players should be plenty usually (will expand if necessary) + LastInputModeByPlayer.Init(EInputMode::Mouse, 4); +} + +bool UStevesGameSubsystem::FInputModeDetector::HandleKeyDownEvent(FSlateApplication& SlateApp, const FKeyEvent& InKeyEvent) +{ + // Key down also registers for gamepad buttons + ProcessKeyOrButton(InKeyEvent.GetUserIndex(), InKeyEvent.GetKey()); + + // Don't consume + return false; +} + +bool UStevesGameSubsystem::FInputModeDetector::HandleAnalogInputEvent(FSlateApplication& SlateApp, + const FAnalogInputEvent& InAnalogInputEvent) +{ + if (InAnalogInputEvent.GetAnalogValue() > GamepadAxisThreshold) + SetMode(InAnalogInputEvent.GetUserIndex(), EInputMode::Gamepad); + // Don't consume + return false; +} + +bool UStevesGameSubsystem::FInputModeDetector::HandleMouseMoveEvent(FSlateApplication& SlateApp, const FPointerEvent& MouseEvent) +{ + FVector2D Dist = MouseEvent.GetScreenSpacePosition() - MouseEvent.GetLastScreenSpacePosition(); + if (FMath::Abs(Dist.X) > MouseMoveThreshold || FMath::Abs(Dist.Y) > MouseMoveThreshold) + { + SetMode(MouseEvent.GetUserIndex(), EInputMode::Mouse); + } + // Don't consume + return false; +} + +bool UStevesGameSubsystem::FInputModeDetector::HandleMouseButtonDownEvent(FSlateApplication& SlateApp, const FPointerEvent& MouseEvent) +{ + // We don't care which button + SetMode(MouseEvent.GetUserIndex(), EInputMode::Mouse); + // Don't consume + return false; +} + +bool UStevesGameSubsystem::FInputModeDetector::HandleMouseWheelOrGestureEvent(FSlateApplication& SlateApp, const FPointerEvent& InWheelEvent, + const FPointerEvent* InGestureEvent) +{ + SetMode(InWheelEvent.GetUserIndex(), EInputMode::Mouse); + // Don't consume + return false; +} + +EInputMode UStevesGameSubsystem::FInputModeDetector::GetLastInputMode(int PlayerIndex) +{ + if (PlayerIndex >= 0 && PlayerIndex < LastInputModeByPlayer.Num()) + return LastInputModeByPlayer[PlayerIndex]; + + // Assume default if never told + return DefaultInputMode; +} + + +void UStevesGameSubsystem::FInputModeDetector::ProcessKeyOrButton(int PlayerIndex, FKey Key) +{ + if (Key.IsGamepadKey()) + { + SetMode(PlayerIndex, EInputMode::Gamepad); + } + else if (Key.IsMouseButton()) + { + // Assuming mice don't have analog buttons! + SetMode(PlayerIndex, EInputMode::Mouse); + } + else + { + // We assume anything that's not mouse and not gamepad is a keyboard + // Assuming keyboards don't have analog buttons! + SetMode(PlayerIndex, EInputMode::Keyboard); + } + +} + +void UStevesGameSubsystem::FInputModeDetector::SetMode(int PlayerIndex, EInputMode NewMode) +{ + if (NewMode != EInputMode::Unknown && NewMode != GetLastInputMode(PlayerIndex)) + { + if (PlayerIndex >= LastInputModeByPlayer.Num()) + LastInputModeByPlayer.SetNum(PlayerIndex + 1); + + LastInputModeByPlayer[PlayerIndex] = NewMode; + OnInputModeChanged.ExecuteIfBound(PlayerIndex, NewMode); + UE_LOG(LogTemp, Warning, TEXT("Input mode for player %d changed: %s"), PlayerIndex, *UEnum::GetValueAsString(NewMode)); + } +} + +//PRAGMA_ENABLE_OPTIMIZATION \ No newline at end of file diff --git a/Source/StevesUEHelpers/Private/StevesGameViewportClientBase.cpp b/Source/StevesUEHelpers/Private/StevesGameViewportClientBase.cpp new file mode 100644 index 0000000..9c5a9f6 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesGameViewportClientBase.cpp @@ -0,0 +1,29 @@ +#include "StevesGameViewportClientBase.h" + + +#include "Engine/Console.h" +#include "Engine/GameInstance.h" +#include "Framework/Application/SlateApplication.h" + +void UStevesGameViewportClientBase::Init(FWorldContext& WorldContext, UGameInstance* OwningGameInstance, + bool bCreateNewAudioDevice) +{ + Super::Init(WorldContext, OwningGameInstance, bCreateNewAudioDevice); + + bSuppressMouseCursor = false; +} + +EMouseCursor::Type UStevesGameViewportClientBase::GetCursor(FViewport* InViewport, int32 X, int32 Y) +{ + if (FSlateApplication::Get().IsActive() && bSuppressMouseCursor) + return EMouseCursor::None; + + return Super::GetCursor(InViewport, X, Y); +} + +void UStevesGameViewportClientBase::SetSuppressMouseCursor(bool bSuppress) +{ + bSuppressMouseCursor = bSuppress; + FSlateApplication::Get().OnCursorSet(); // necessary to make slate wake up + +} diff --git a/Source/StevesUEHelpers/Private/StevesUEHelpers.cpp b/Source/StevesUEHelpers/Private/StevesUEHelpers.cpp new file mode 100644 index 0000000..9245b1e --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUEHelpers.cpp @@ -0,0 +1,22 @@ +#include "StevesUEHelpers.h" + +#define LOCTEXT_NAMESPACE "FStevesUEHelpers" + +DEFINE_LOG_CATEGORY(LogStevesUEHelpers) + +void FStevesUEHelpers::StartupModule() +{ + // This code will execute after your module is loaded into memory; the exact timing is specified in the .uplugin file per-module + UE_LOG(LogStevesUEHelpers, Log, TEXT("Steve's UE Helpers Module Started")) +} + +void FStevesUEHelpers::ShutdownModule() +{ + // This function may be called during shutdown to clean up your module. For modules that support dynamic reloading, + // we call this function before unloading the module. + UE_LOG(LogStevesUEHelpers, Log, TEXT("Steve's UE Helpers Module Stopped")) +} + +#undef LOCTEXT_NAMESPACE + +IMPLEMENT_MODULE(FStevesUEHelpers, StevesUEHelpers) diff --git a/Source/StevesUEHelpers/Private/StevesUI/FocusableButton.cpp b/Source/StevesUEHelpers/Private/StevesUI/FocusableButton.cpp new file mode 100644 index 0000000..7af4838 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/FocusableButton.cpp @@ -0,0 +1,82 @@ +#include "StevesUI/FocusableButton.h" +#include "StevesUI/SFocusableButton.h" +#include "Components/ButtonSlot.h" + +UFocusableButton::UFocusableButton(const FObjectInitializer& ObjectInitializer) + : Super(ObjectInitializer) +{ +} + +TSharedRef UFocusableButton::RebuildWidget() +{ + MyButton = SNew(SFocusableButton) + // This part is standard button behaviour + .OnClicked(BIND_UOBJECT_DELEGATE(FOnClicked, SlateHandleClicked)) + .OnPressed(BIND_UOBJECT_DELEGATE(FSimpleDelegate, SlateHandlePressed)) + .OnReleased(BIND_UOBJECT_DELEGATE(FSimpleDelegate, SlateHandleReleased)) + .OnHovered_UObject( this, &ThisClass::SlateHandleHovered ) + .OnUnhovered_UObject( this, &ThisClass::SlateHandleUnhovered ) + .ButtonStyle(&WidgetStyle) + .ClickMethod(ClickMethod) + .TouchMethod(TouchMethod) + .PressMethod(PressMethod) + .IsFocusable(IsFocusable) + // Our new events + .OnFocusReceived(BIND_UOBJECT_DELEGATE(FSimpleDelegate, SlateHandleFocusReceived)) + .OnFocusLost(BIND_UOBJECT_DELEGATE(FSimpleDelegate, SlateHandleFocusLost)) + ; + + if ( GetChildrenCount() > 0 ) + { + Cast(GetContentSlot())->BuildSlot(MyButton.ToSharedRef()); + } + + // Copy Widget style but make normal same as hovered + FocussedStyle = WidgetStyle; + FocussedStyle.Normal = FocussedStyle.Hovered; + + return MyButton.ToSharedRef(); +} + +void UFocusableButton::SlateHandleFocusReceived() +{ + ApplyFocusStyle(); + OnFocusReceived.Broadcast(); +} + +void UFocusableButton::SlateHandleFocusLost() +{ + UndoFocusStyle(); + OnFocusLost.Broadcast(); +} + + +void UFocusableButton::ApplyFocusStyle() +{ + if (MyButton.IsValid() && bUseHoverStyleWhenFocussed) + { + MyButton->SetButtonStyle(&FocussedStyle); + } +} + +void UFocusableButton::UndoFocusStyle() +{ + if (MyButton.IsValid()) + { + MyButton->SetButtonStyle(&WidgetStyle); + } +} + +void UFocusableButton::SlateHandleHovered() +{ + if (bTakeFocusOnHover) + { + SetFocus(); + } + OnHovered.Broadcast(); +} + +void UFocusableButton::SlateHandleUnhovered() +{ + OnUnhovered.Broadcast(); +} diff --git a/Source/StevesUEHelpers/Private/StevesUI/FocusablePanel.cpp b/Source/StevesUEHelpers/Private/StevesUI/FocusablePanel.cpp new file mode 100644 index 0000000..32c29de --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/FocusablePanel.cpp @@ -0,0 +1,68 @@ +#include "StevesUI/FocusablePanel.h" + + +#include "StevesUI.h" +#include "Blueprint/WidgetTree.h" +#include "Framework/Application/SlateApplication.h" + +void UFocusablePanel::NativeConstruct() +{ + Super::NativeConstruct(); + + // Find focus widget + if (!InitialFocusWidgetName.IsNone()) + { + InitialFocusWidget = WidgetTree->FindWidget(InitialFocusWidgetName); + } + +} + +void UFocusablePanel::NativeDestruct() +{ + Super::NativeDestruct(); + + InitialFocusWidget.Reset(); +} + +bool UFocusablePanel::SetFocusToInitialWidget() const +{ + if (InitialFocusWidget.IsValid()) + { + SetWidgetFocusProperly(InitialFocusWidget.Get()); + return true; + } + return false; +} + + +bool UFocusablePanel::RestorePreviousFocus() const +{ + if (PreviousFocusWidget.IsValid()) + { + SetWidgetFocusProperly(PreviousFocusWidget.Get()); + return true; + } + return false; +} + +bool UFocusablePanel::SavePreviousFocus() +{ + const auto SW = FSlateApplication::Get().GetUserFocusedWidget(0); + if (SW) + { + PreviousFocusWidget = FindWidgetFromSlate(SW.Get(), this); + return true; + } + else + { + PreviousFocusWidget.Reset(); + return false; + } +} + +void UFocusablePanel::SetFocusProperly_Implementation() +{ + if (!RestorePreviousFocus()) + SetFocusToInitialWidget(); +} + diff --git a/Source/StevesUEHelpers/Private/StevesUI/FocusableUserWidget.cpp b/Source/StevesUEHelpers/Private/StevesUI/FocusableUserWidget.cpp new file mode 100644 index 0000000..f5669c5 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/FocusableUserWidget.cpp @@ -0,0 +1,7 @@ +#include "StevesUI/FocusableUserWidget.h" + +void UFocusableUserWidget::SetFocusProperly_Implementation() +{ + // Default is to call normal + SetFocus(); +} diff --git a/Source/StevesUEHelpers/Private/StevesUI/InputImage.cpp b/Source/StevesUEHelpers/Private/StevesUI/InputImage.cpp new file mode 100644 index 0000000..522067f --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/InputImage.cpp @@ -0,0 +1,165 @@ +#include "StevesUI/InputImage.h" +#include "StevesUI.h" +#include "StevesUI/KeySprite.h" +#include "StevesGameSubsystem.h" +#include "StevesUEHelpers.h" +#include "Blueprint/WidgetTree.h" +#include "Engine/AssetManager.h" +#include "GameFramework/InputSettings.h" + +TSharedRef UInputImage::RebuildWidget() +{ + auto Ret = Super::RebuildWidget(); + + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + { + GS->OnInputModeChanged.AddUniqueDynamic(this, &UInputImage::OnInputModeChanged); + CurrentInputMode = GS->GetLastInputModeUsed(); + UpdateImage(); + } + + return Ret; +} + +void UInputImage::OnInputModeChanged(int PlayerIndex, EInputMode InputMode) +{ + CurrentInputMode = InputMode; + UpdateImage(); +} + +void UInputImage::SetCustomTheme(UUiTheme* Theme) +{ + CustomTheme = Theme; + UpdateImage(); +} + +void UInputImage::BeginDestroy() +{ + Super::BeginDestroy(); + + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + { + GS->OnInputModeChanged.RemoveAll(this); + } +} + +void UInputImage::SetFromAction(FName Name) +{ + BindingType = EInputBindingType::Action; + ActionOrAxisName = Name; + UpdateImage(); +} + +void UInputImage::SetFromAxis(FName Name) +{ + BindingType = EInputBindingType::Axis; + ActionOrAxisName = Name; + UpdateImage(); +} + +void UInputImage::SetFromKey(FKey K) +{ + BindingType = EInputBindingType::Key; + Key = K; + UpdateImage(); +} + +void UInputImage::UpdateImage() +{ + switch(BindingType) + { + case EInputBindingType::Action: + UpdateImageFromAction(ActionOrAxisName); + break; + case EInputBindingType::Axis: + UpdateImageFromAxis(ActionOrAxisName); + break; + case EInputBindingType::Key: + UpdateImageFromKey(Key); + break; + default: ; + } + +} +TArray TempActionMap; +TArray TempAxisMap; + +void UInputImage::UpdateImageFromAction(const FName& Name) +{ + // Look up the key for this action + UInputSettings* Settings = UInputSettings::GetInputSettings(); + TempActionMap.Empty(); + Settings->GetActionMappingByName(Name, TempActionMap); + const bool WantGamepad = CurrentInputMode == EInputMode::Gamepad; + for (auto && ActionMap : TempActionMap) + { + if (ActionMap.Key.IsGamepadKey() == WantGamepad) + { + UpdateImageFromKey(ActionMap.Key); + return; + } + } + // if we fell through, didn't find a mapping which matched our gamepad preference + if (TempActionMap.Num()) + { + UpdateImageFromKey(TempActionMap[0].Key); + } +} + +void UInputImage::UpdateImageFromAxis(const FName& Name) +{ + // Look up the key for this axis + UInputSettings* Settings = UInputSettings::GetInputSettings(); + TempAxisMap.Empty(); + Settings->GetAxisMappingByName(Name, TempAxisMap); + const bool WantGamepad = CurrentInputMode == EInputMode::Gamepad; + for (auto && AxisMap : TempAxisMap) + { + if (AxisMap.Key.IsGamepadKey() == WantGamepad) + { + UpdateImageFromKey(AxisMap.Key); + return; + } + } + // if we fell through, didn't find a mapping which matched our gamepad preference + if (TempAxisMap.Num()) + { + UpdateImageFromKey(TempAxisMap[0].Key); + } +} + +void UInputImage::UpdateImageFromKey(const FKey& InKey) +{ + auto T = GetTheme(); + if (T) + { + if (InKey.IsGamepadKey()) + UpdateImageFromTable(InKey, T->XboxControllerImages); + else + UpdateImageFromTable(InKey, T->KeyboardMouseImages); + } +} + +void UInputImage::UpdateImageFromTable(const FKey& InKey, const TSoftObjectPtr& Asset) +{ + // Sync load for simplicity for now + const auto Table = Asset.LoadSynchronous(); + // Rows are named the same as the key name + const auto SpriteRow = Table->FindRow(InKey.GetFName(), "Find Key Image"); + if (SpriteRow) + SetBrushFromAtlasInterface(SpriteRow->Sprite); +} + +UUiTheme* UInputImage::GetTheme() +{ + if (IsValid(CustomTheme)) + return CustomTheme; + + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + return GS->GetDefaultUiTheme(); + + return nullptr; +} diff --git a/Source/StevesUEHelpers/Private/StevesUI/MenuBase.cpp b/Source/StevesUEHelpers/Private/StevesUI/MenuBase.cpp new file mode 100644 index 0000000..3bea507 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/MenuBase.cpp @@ -0,0 +1,99 @@ +#include "StevesUI/MenuBase.h" + +#include "StevesUI.h" +#include "StevesGameSubsystem.h" +#include "StevesUEHelpers.h" +#include "StevesUI/MenuStack.h" +#include "Components/ContentWidget.h" + +void UMenuBase::Close(bool bWasCancel) +{ + // Deliberately raise before parent so stack is always last in event sequence + OnClosed.Broadcast(this, bWasCancel); + if (ParentStack.IsValid()) + { + ParentStack->PopMenuIfTop(this, bWasCancel); + } +} + +void UMenuBase::AddedToStack(UMenuStack* Parent) +{ + ParentStack = MakeWeakObjectPtr(Parent); + if (bEmbedInParentContainer) + EmbedInParent(); + else + AddToViewport(); + SetVisibility(ESlateVisibility::Visible); + + auto GS = GetStevesGameSubsystem(GetWorld()); + if (bRequestFocus && + GS && (GS->GetLastInputModeUsed() != EInputMode::Gamepad || GS->GetLastInputModeUsed() != EInputMode::Keyboard)) + { + SetFocusProperly(); + } + + +} + + +void UMenuBase::InputModeChanged(EInputMode OldMode, EInputMode NewMode) +{ + if (OldMode == EInputMode::Mouse && + (NewMode == EInputMode::Gamepad || NewMode == EInputMode::Keyboard)) + { + if (bRequestFocus) + SetFocusProperly(); + } + else if ((OldMode == EInputMode::Gamepad || OldMode == EInputMode::Keyboard) && + NewMode == EInputMode::Mouse) + { + SavePreviousFocus(); + } +} + +void UMenuBase::RemovedFromStack(UMenuStack* Parent) +{ + // This works whether embedded or not + RemoveFromParent(); + PreviousFocusWidget.Reset(); +} + +void UMenuBase::SupercededInStack() +{ + SavePreviousFocus(); + + if (bEmbedInParentContainer) + RemoveFromParent(); + else + { + if (bHideWhenSuperceded) + SetVisibility(ESlateVisibility::Collapsed); + } +} + +void UMenuBase::RegainedFocusInStack() +{ + if (bEmbedInParentContainer) + EmbedInParent(); + else + AddToViewport(); + SetVisibility(ESlateVisibility::Visible); + + if (bRequestFocus) + { + SetFocusProperly(); + } + +} + +void UMenuBase::EmbedInParent() +{ + if (ParentStack.IsValid() && + ParentStack->MenuContainer != nullptr) + { + ParentStack->MenuContainer->SetContent(this); + } + else + UE_LOG(LogCustomUI, Error, TEXT("Cannot embed %s in parent, missing container"), *this->GetName()) + +} diff --git a/Source/StevesUEHelpers/Private/StevesUI/MenuStack.cpp b/Source/StevesUEHelpers/Private/StevesUI/MenuStack.cpp new file mode 100644 index 0000000..5e0c132 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/MenuStack.cpp @@ -0,0 +1,152 @@ +#include "StevesUI/MenuStack.h" + +#include "StevesUI.h" +#include "StevesGameSubsystem.h" +#include "StevesUEHelpers.h" +#include "StevesUI/MenuBase.h" +#include "Framework/Application/SlateApplication.h" + + +void UMenuStack::NativeConstruct() +{ + Super::NativeConstruct(); + + if (!InputPreprocessor.IsValid()) + { + InputPreprocessor = MakeShareable(new FUiInputPreprocessor()); + InputPreprocessor->OnUiKeyDown.BindUObject(this, &UMenuStack::HandleKeyDownEvent); + } + FSlateApplication::Get().RegisterInputPreProcessor(InputPreprocessor); + + // We could technically do input change detection in our own input processor, but since this already does it nicely... + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + { + GS->OnInputModeChanged.AddDynamic(this, &UMenuStack::InputModeChanged); + LastInputMode = GS->GetLastInputModeUsed(); + } +} + +void UMenuStack::NativeDestruct() +{ + Super::NativeDestruct(); + FSlateApplication::Get().UnregisterInputPreProcessor(InputPreprocessor); + + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + GS->OnInputModeChanged.RemoveDynamic(this, &UMenuStack::InputModeChanged); + + +} + +bool UMenuStack::HandleKeyDownEvent(const FKeyEvent& InKeyEvent) +{ + // Hardcoding the Back / Exit menu navigation inputs because input mappings can't be trusted in UMG + // This is probably OK though, no-one redefines menu controls, right? + FKey Key = InKeyEvent.GetKey(); + if (Key == EKeys::Escape || Key == EKeys::Gamepad_FaceButton_Right) + { + // This is "Back" + PopMenu(true); + return true; + } + else if (Key == EKeys::Gamepad_Special_Right) + { + // Shortcut to exit all menus + CloseAll(true); + return true; + } + + return false; +} + + +void UMenuStack::InputModeChanged(int PlayerIndex, EInputMode NewMode) +{ + if (Menus.Num()) + { + Menus.Last()->InputModeChanged(LastInputMode, NewMode); + } + LastInputMode = NewMode; +} + +UMenuBase* UMenuStack::PushMenuByClass(TSubclassOf MenuClass) +{ + const FName Name = MakeUniqueObjectName(this->GetOuter(), MenuClass, FName("Menu")); + TSubclassOf BaseClass = MenuClass; + const auto NewMenu = Cast(CreateWidgetInstance(*this, BaseClass, Name)); + PushMenuByObject(NewMenu); + + return NewMenu; +} + +void UMenuStack::PushMenuByObject(UMenuBase* NewMenu) +{ + if (Menus.Num() > 0) + { + auto Top = Menus.Last(); + Top->SupercededInStack(); + // We keep this allocated, to restore later on back + } + Menus.Add(NewMenu); + NewMenu->AddedToStack(this); +} + +void UMenuStack::PopMenu(bool bWasCancel) +{ + if (Menus.Num() > 0) + { + auto Top = Menus.Last(); + Top->RemovedFromStack(this); + Menus.Pop(); + // No explicit destroy in UMG, let GC do it + // we could try to re-use but probably not worth it vs complexity of reset for now + + if (Menus.Num() == 0) + { + LastMenuClosed(bWasCancel); + } + else + { + auto NewTop = Menus.Last(); + NewTop->RegainedFocusInStack(); + } + } + +} + +void UMenuStack::PopMenuIfTop(UMenuBase* UiMenuBase, bool bWasCancel) +{ + if (Menus.Last() == UiMenuBase) + { + PopMenu(bWasCancel); + } + else + { + UE_LOG(LogCustomUI, Error, TEXT("Tried to pop menu %s but it wasn't the top level"), *UiMenuBase->GetName()); + } +} + +void UMenuStack::LastMenuClosed(bool bWasCancel) +{ + RemoveFromParent(); + OnClosed.Broadcast(this, bWasCancel); +} + +void UMenuStack::CloseAll(bool bWasCancel) +{ + // We don't go through normal pop sequence, this is a shot circuit + for (int i = Menus.Num() - 1; i >= 0; --i) + { + Menus[i]->RemovedFromStack(this); + } + Menus.Empty(); + LastMenuClosed(bWasCancel); +} + +void UMenuStack::SetFocusProperly_Implementation() +{ + // Delegate to top menu + if (Menus.Num() > 0) + Menus.Last()->SetFocusProperly(); +} diff --git a/Source/StevesUEHelpers/Private/StevesUI/OptionWidgetBase.cpp b/Source/StevesUEHelpers/Private/StevesUI/OptionWidgetBase.cpp new file mode 100644 index 0000000..a1263c7 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/OptionWidgetBase.cpp @@ -0,0 +1,252 @@ +#include "StevesUI/OptionWidgetBase.h" + +#include "StevesUI.h" +#include "StevesGameSubsystem.h" +#include "StevesUEHelpers.h" +#include "Components/Button.h" +#include "Components/Image.h" +#include "Components/TextBlock.h" + +void UOptionWidgetBase::NativeConstruct() +{ + Super::NativeConstruct(); + + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + { + GS->OnInputModeChanged.AddDynamic(this, &UOptionWidgetBase::InputModeChanged); + UpdateFromInputMode(GS->GetLastInputModeUsed()); + ClearOptions(); + } + else + UE_LOG(LogCustomUI, Error, TEXT("StevesGameSubsystem is missing!")); + + // Check we can bind everything we need, bind click + if (!MouseVersion) + UE_LOG(LogCustomUI, Error, TEXT("%s should have a MouseVersion instance."), *this->GetClass()->GetName()); + if (!GamepadVersion) + UE_LOG(LogCustomUI, Error, TEXT("%s should have a GamepadVersion instance."), *this->GetClass()->GetName()); + if (MouseUpButton) + MouseUpButton->OnClicked.AddDynamic(this, &UOptionWidgetBase::MouseUpClicked); + else + UE_LOG(LogCustomUI, Error, TEXT("%s should have a MouseUpButton instance."), *this->GetClass()->GetName()); + if (MouseDownButton) + MouseDownButton->OnClicked.AddDynamic(this, &UOptionWidgetBase::MouseDownClicked); + else + UE_LOG(LogCustomUI, Error, TEXT("%s should have a MouseDownButton instance."), *this->GetClass()->GetName()); + if (!MouseUpImage) + UE_LOG(LogCustomUI, Error, TEXT("%s should have a MouseUpImage instance."), *this->GetClass()->GetName()); + if (!MouseDownImage) + UE_LOG(LogCustomUI, Error, TEXT("%s should have a MouseDownImage instance."), *this->GetClass()->GetName()); + if (!GamepadUpImage) + UE_LOG(LogCustomUI, Error, TEXT("%s should have a GamepadUpImage instance."), *this->GetClass()->GetName()); + if (!GamepadDownImage) + UE_LOG(LogCustomUI, Error, TEXT("%s should have a GamepadDownImage instance."), *this->GetClass()->GetName()); + + +} + + +void UOptionWidgetBase::NativeDestruct() +{ + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + { + GS->OnInputModeChanged.RemoveAll(this); + } + + if (MouseUpButton) + MouseUpButton->OnClicked.RemoveAll(this); + if (MouseDownButton) + MouseDownButton->OnClicked.RemoveAll(this); + +} + +void UOptionWidgetBase::ChangeOption(int Delta) +{ + SetSelectedIndex(FMath::Clamp(SelectedIndex + Delta, 0, Options.Num() - 1)); +} + + +void UOptionWidgetBase::MouseUpClicked() +{ + ChangeOption(1); +} + +void UOptionWidgetBase::MouseDownClicked() +{ + ChangeOption(-1); +} + +void UOptionWidgetBase::ClearOptions() +{ + Options.Empty(); + SetSelectedIndex(-1); +} + +void UOptionWidgetBase::UpdateFromInputMode(EInputMode Mode) +{ + switch (Mode) + { + case EInputMode::Mouse: + SetMouseMode(); + break; + case EInputMode::Keyboard: + case EInputMode::Gamepad: + SetButtonMode(); + break; + case EInputMode::Unknown: + default: + break; + } +} + +void UOptionWidgetBase::InputModeChanged(int PlayerIndex, EInputMode NewMode) +{ + UpdateFromInputMode(NewMode); +} + +void UOptionWidgetBase::SynchronizeProperties() +{ + Super::SynchronizeProperties(); + + SyncButtonProperties(MouseUpButton); + SyncButtonProperties(MouseDownButton); + SyncButtonProperties(GamepadVersion); + + SyncTextProperties(MouseText); + SyncTextProperties(GamepadText); + + SyncButtonImageProperties(MouseUpImage); + SyncButtonImageProperties(MouseDownImage); + SyncButtonImageProperties(GamepadUpImage); + SyncButtonImageProperties(GamepadDownImage); +} + +void UOptionWidgetBase::SyncButtonProperties(UButton* Button) const +{ + if (Button) + { + Button->SetStyle(ButtonStyle); + } +} + +void UOptionWidgetBase::SyncButtonImageProperties(UImage* Img) const +{ + if (Img) + { + Img->SetBrush(ButtonImage); + Img->SetColorAndOpacity(ButtonImageColour); + } +} + +void UOptionWidgetBase::SyncTextProperties(UTextBlock* Txt) const +{ + if (Txt) + { + Txt->SetFont(Font); + Txt->SetColorAndOpacity(TextColour); + Txt->SetStrikeBrush(TextStrikeBrush); + Txt->SetShadowOffset(TextShadowOffset); + Txt->SetShadowColorAndOpacity(TextShadowColor); + } +} + + +void UOptionWidgetBase::SetMouseMode() +{ + if (!MouseVersion) + return; + + bool bHadFocus = false; + if (GamepadVersion) + { + bHadFocus = GamepadVersion->HasKeyboardFocus(); + GamepadVersion->SetVisibility(ESlateVisibility::Hidden); + } + + MouseVersion->SetVisibility(ESlateVisibility::Visible); + if (bHadFocus) + SetFocusProperly(); + +} + +void UOptionWidgetBase::SetButtonMode() +{ + if (!GamepadVersion) + return; + const bool bHadFocus = (MouseUpButton && MouseUpButton->HasKeyboardFocus()) || (MouseDownButton && MouseDownButton->HasKeyboardFocus()); + + if (MouseVersion) + MouseVersion->SetVisibility(ESlateVisibility::Hidden); + + GamepadVersion->SetVisibility(ESlateVisibility::Visible); + if (bHadFocus) + SetFocusProperly(); + +} + +void UOptionWidgetBase::SetFocusProperly_Implementation() +{ + if (GamepadVersion && GamepadVersion->IsVisible()) + GamepadVersion->SetFocus(); + else if (MouseUpButton && MouseDownButton) + MouseUpButton->GetIsEnabled() ? MouseUpButton->SetFocus() : MouseDownButton->SetFocus(); +} + +void UOptionWidgetBase::SetSelectedIndex(int NewIndex) +{ + const bool bRaiseEvent = SelectedIndex != NewIndex; + + SelectedIndex = NewIndex; + + const FText NewText = GetSelectedOption(); + if (MouseText) + MouseText->SetText(NewText); + if (GamepadText) + GamepadText->SetText(NewText); + + const bool CanDecrease = SelectedIndex > 0; + const bool CanIncrease = SelectedIndex < Options.Num() - 1; + if (MouseDownButton) + MouseDownButton->SetIsEnabled(CanDecrease); + if (MouseUpButton) + MouseUpButton->SetIsEnabled(CanIncrease); + if (GamepadDownImage) + GamepadDownImage->SetVisibility(CanDecrease ? ESlateVisibility::Visible : ESlateVisibility::Hidden); + if (GamepadUpImage) + GamepadUpImage->SetVisibility(CanIncrease ? ESlateVisibility::Visible : ESlateVisibility::Hidden); + + if (bRaiseEvent) + OnSelectedOptionChanged.Broadcast(this, SelectedIndex); + +} + +int UOptionWidgetBase::AddOption(FText Option) +{ + return Options.Add(Option); +} + +void UOptionWidgetBase::SetOptions(const TArray& InOptions, int NewSelectedIndex) +{ + Options = InOptions; + SetSelectedIndex(NewSelectedIndex); +} + +FText UOptionWidgetBase::GetSelectedOption() const +{ + if (Options.IsValidIndex(SelectedIndex)) + return Options[SelectedIndex]; + + return FText(); +} + +EInputMode UOptionWidgetBase::GetCurrentInputMode() const +{ + auto GS = GetStevesGameSubsystem(GetWorld()); + if (GS) + return GS->GetLastInputModeUsed(); + + return EInputMode::Unknown; +} + diff --git a/Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.cpp b/Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.cpp new file mode 100644 index 0000000..b662ccb --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.cpp @@ -0,0 +1,75 @@ +#include "StevesUI/SFocusableButton.h" + +void SFocusableButton::Construct(const FArguments& InArgs) +{ + // Call SButton construct and pass through + SButton::Construct(SButton::FArguments() + .ButtonStyle(InArgs._ButtonStyle) + .ClickMethod(InArgs._ClickMethod) + .ContentPadding(InArgs._ContentPadding) + .ContentScale(InArgs._ContentScale) + .FlowDirectionPreference(InArgs._FlowDirectionPreference) + .ForegroundColor(InArgs._ForegroundColor) + .HAlign(InArgs._HAlign) + .VAlign(InArgs._VAlign) + .IsFocusable(InArgs._IsFocusable) + .OnClicked(InArgs._OnClicked) + .OnHovered(InArgs._OnHovered) + .OnPressed(InArgs._OnPressed) + .OnReleased(InArgs._OnReleased) + .OnUnhovered(InArgs._OnUnhovered) + .PressMethod(InArgs._PressMethod) + .TouchMethod(InArgs._TouchMethod) + .DesiredSizeScale(InArgs._DesiredSizeScale) + .HoveredSoundOverride(InArgs._HoveredSoundOverride) + .PressedSoundOverride(InArgs._PressedSoundOverride) + .ButtonColorAndOpacity(InArgs._ButtonColorAndOpacity) + .TextFlowDirection(InArgs._TextFlowDirection) + .TextShapingMethod(InArgs._TextShapingMethod) + .Clipping(InArgs._Clipping) + .Cursor(InArgs._Cursor) + .Tag(InArgs._Tag) + .Visibility(InArgs._Visibility) + .AccessibleParams(InArgs._AccessibleParams) + .AccessibleText(InArgs._AccessibleText) + .ForceVolatile(InArgs._ForceVolatile) + .IsEnabled(InArgs._IsEnabled) + .RenderOpacity(InArgs._RenderOpacity) + .RenderTransform(InArgs._RenderTransform) + .RenderTransformPivot(InArgs._RenderTransformPivot) + .Text(InArgs._Text) + .TextStyle(InArgs._TextStyle) + .ToolTip(InArgs._ToolTip) + .ToolTipText(InArgs._ToolTipText) + ); + + OnFocusReceivedDelegate = InArgs._OnFocusReceived; + OnFocusLostDelegate = InArgs._OnFocusLost; +} + +FReply SFocusableButton::OnFocusReceived(const FGeometry& MyGeometry, const FFocusEvent& InFocusEvent) +{ + auto Ret = SButton::OnFocusReceived(MyGeometry, InFocusEvent); + + OnFocusReceivedDelegate.ExecuteIfBound(); + + return Ret; +} + +void SFocusableButton::OnFocusLost(const FFocusEvent& InFocusEvent) +{ + SButton::OnFocusLost(InFocusEvent); + + OnFocusLostDelegate.ExecuteIfBound(); +} + +void SFocusableButton::SetOnFocusReceived(FSimpleDelegate InOnFocusReceived) +{ + OnFocusReceivedDelegate = InOnFocusReceived; +} + +void SFocusableButton::SetOnFocusLost(FSimpleDelegate InOnFocusLost) +{ + OnFocusLostDelegate = InOnFocusLost; +} + diff --git a/Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.h b/Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.h new file mode 100644 index 0000000..0f2357a --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/SFocusableButton.h @@ -0,0 +1,116 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Widgets/Input/SButton.h" + +class SFocusableButton : public SButton +{ + // Seems in slate we have to duplicate all the args from superclass + SLATE_BEGIN_ARGS(SFocusableButton) + : _Content() + , _ButtonStyle( &FCoreStyle::Get().GetWidgetStyle< FButtonStyle >( "Button" ) ) + , _TextStyle( &FCoreStyle::Get().GetWidgetStyle< FTextBlockStyle >("NormalText") ) + , _HAlign( HAlign_Fill ) + , _VAlign( VAlign_Fill ) + , _ContentPadding(FMargin(4.0, 2.0)) + , _Text() + , _ClickMethod( EButtonClickMethod::DownAndUp ) + , _TouchMethod( EButtonTouchMethod::DownAndUp ) + , _PressMethod( EButtonPressMethod::DownAndUp ) + , _DesiredSizeScale( FVector2D(1,1) ) + , _ContentScale( FVector2D(1,1) ) + , _ButtonColorAndOpacity(FLinearColor::White) + , _ForegroundColor( FCoreStyle::Get().GetSlateColor( "InvertedForeground" ) ) + , _IsFocusable( true ) + { + } + + /** Slot for this button's content (optional) */ + SLATE_DEFAULT_SLOT( FArguments, Content ) + + /** The visual style of the button */ + SLATE_STYLE_ARGUMENT( FButtonStyle, ButtonStyle ) + + /** The text style of the button */ + SLATE_STYLE_ARGUMENT( FTextBlockStyle, TextStyle ) + + /** Horizontal alignment */ + SLATE_ARGUMENT( EHorizontalAlignment, HAlign ) + + /** Vertical alignment */ + SLATE_ARGUMENT( EVerticalAlignment, VAlign ) + + /** Spacing between button's border and the content. */ + SLATE_ATTRIBUTE( FMargin, ContentPadding ) + + /** The text to display in this button, if no custom content is specified */ + SLATE_ATTRIBUTE( FText, Text ) + + /** Called when the button is clicked */ + SLATE_EVENT( FOnClicked, OnClicked ) + + /** Called when the button is pressed */ + SLATE_EVENT( FSimpleDelegate, OnPressed ) + + /** Called when the button is released */ + SLATE_EVENT( FSimpleDelegate, OnReleased ) + + SLATE_EVENT( FSimpleDelegate, OnHovered ) + + SLATE_EVENT( FSimpleDelegate, OnUnhovered ) + + /** Sets the rules to use for determining whether the button was clicked. This is an advanced setting and generally should be left as the default. */ + SLATE_ARGUMENT( EButtonClickMethod::Type, ClickMethod ) + + /** How should the button be clicked with touch events? */ + SLATE_ARGUMENT( EButtonTouchMethod::Type, TouchMethod ) + + /** How should the button be clicked with keyboard/controller button events? */ + SLATE_ARGUMENT( EButtonPressMethod::Type, PressMethod ) + + SLATE_ATTRIBUTE( FVector2D, DesiredSizeScale ) + + SLATE_ATTRIBUTE( FVector2D, ContentScale ) + + SLATE_ATTRIBUTE( FSlateColor, ButtonColorAndOpacity ) + + SLATE_ATTRIBUTE( FSlateColor, ForegroundColor ) + + /** Sometimes a button should only be mouse-clickable and never keyboard focusable. */ + SLATE_ARGUMENT( bool, IsFocusable ) + + /** The sound to play when the button is pressed */ + SLATE_ARGUMENT( TOptional, PressedSoundOverride ) + + /** The sound to play when the button is hovered */ + SLATE_ARGUMENT( TOptional, HoveredSoundOverride ) + + /** Which text shaping method should we use? (unset to use the default returned by GetDefaultTextShapingMethod) */ + SLATE_ARGUMENT( TOptional, TextShapingMethod ) + + /** Which text flow direction should we use? (unset to use the default returned by GetDefaultTextFlowDirection) */ + SLATE_ARGUMENT( TOptional, TextFlowDirection ) + + // This is the bit we're adding + SLATE_EVENT( FSimpleDelegate, OnFocusReceived ) + SLATE_EVENT( FSimpleDelegate, OnFocusLost ) + + SLATE_END_ARGS() + +public: + + void Construct( const FArguments& InArgs ); + + virtual FReply OnFocusReceived(const FGeometry& MyGeometry, const FFocusEvent& InFocusEvent) override; + virtual void OnFocusLost(const FFocusEvent& InFocusEvent) override; + + void SetOnFocusReceived(FSimpleDelegate InOnFocusReceived); + void SetOnFocusLost(FSimpleDelegate InOnFocusLost); + +protected: + FSimpleDelegate OnFocusReceivedDelegate; + FSimpleDelegate OnFocusLostDelegate; + +}; + + diff --git a/Source/StevesUEHelpers/Private/StevesUI/StevesUI.cpp b/Source/StevesUEHelpers/Private/StevesUI/StevesUI.cpp new file mode 100644 index 0000000..3a8b6f3 --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/StevesUI.cpp @@ -0,0 +1,51 @@ +#include "StevesUI.h" + + + +#include "StevesUI/FocusableUserWidget.h" +#include "Blueprint/WidgetTree.h" +#include "Components/PanelWidget.h" +#include "Components/Widget.h" + +DEFINE_LOG_CATEGORY(LogCustomUI); + +UWidget* FindWidgetFromSlate(SWidget* SW, UWidget* Parent) +{ + if (!Parent) + return nullptr; + + if (Parent->GetCachedWidget().Get() == SW) + return Parent; + + auto PW = Cast(Parent); + if (PW) + { + for (int i = 0; i < PW->GetChildrenCount(); ++i) + { + const auto Found = FindWidgetFromSlate(SW, PW->GetChildAt(i)); + if (Found) + return Found; + } + } + else + { + // User widgets aren't panels but can have their own tree + auto UW = Cast(Parent); + if (UW) + { + return FindWidgetFromSlate(SW, UW->WidgetTree->RootWidget); + } + + } + return nullptr; +} + +void SetWidgetFocusProperly(UWidget* Widget) +{ + auto FW = Cast(Widget); + if (FW) + FW->SetFocusProperly(); + else + Widget->SetFocus(); + +} diff --git a/Source/StevesUEHelpers/Private/StevesUI/StevesUI.h b/Source/StevesUEHelpers/Private/StevesUI/StevesUI.h new file mode 100644 index 0000000..ea5c45d --- /dev/null +++ b/Source/StevesUEHelpers/Private/StevesUI/StevesUI.h @@ -0,0 +1,26 @@ +#pragma once + +#include "CoreMinimal.h" + +class UWidget; +class SWidget; + +DECLARE_LOG_CATEGORY_EXTERN(LogCustomUI, Warning, Warning) + + +/** + * @brief Tries to locate a UMG widget which is using the speficied Slate widget as its native implementation + * @param SW Slate widget + * @param Parent Parent widget under which the UMG widget should be found + * @return The UMG widget if found, otherwise nullptr + */ +UWidget* FindWidgetFromSlate(SWidget* SW, UWidget* Parent); + +/** + * @brief Set the focus to a given widget "properly", which means that if this is a widget derived + * from UFocusableWidget, it calls SetFocusProperly on it which allows a customised implementation. + * This is done because SetFocus() is not virtual and cannot be changed, and bIsFocusable seems to get + * reset by Slate code even if I try to set it and then override Native methods. + * @param Widget A UWidget + */ +void SetWidgetFocusProperly(UWidget* Widget); diff --git a/Source/StevesUEHelpers/Public/StevesGameSubsystem.h b/Source/StevesUEHelpers/Public/StevesGameSubsystem.h new file mode 100644 index 0000000..bd2fdda --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesGameSubsystem.h @@ -0,0 +1,123 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Subsystems/GameInstanceSubsystem.h" +#include "InputCoreTypes.h" +#include "Framework/Application/IInputProcessor.h" +#include "StevesHelperCommon.h" +#include "StevesUI/UiTheme.h" + +#include "StevesGameSubsystem.generated.h" + +DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnInputModeChanged, int, PlayerIndex, EInputMode, InputMode); + +UCLASS(Config=Game) +class STEVESUEHELPERS_API UStevesGameSubsystem : public UGameInstanceSubsystem +{ + GENERATED_BODY() + +protected: + /// The default UiTheme path, the theme to use if controls don't specifically link to one. + /// Customise this in DefaultGame.ini + /// [/Script/StevesUEHelpers.StevesGameSubsystem] + /// DefaultUiThemePath="/Game/Some/Other/UiTheme.UiTheme" + /// Regardless, remember to register this file as a Primary Asset in Project Settings, + /// as described in https://docs.unrealengine.com/en-US/Engine/Basics/AssetsAndPackages/AssetManagement/index.html + /// so that it's included when packaging + UPROPERTY(Config) + FString DefaultUiThemePath; + + +public: + virtual void Initialize(FSubsystemCollectionBase& Collection) override; + virtual void Deinitialize() override; + + +protected: + DECLARE_DELEGATE_TwoParams(FInternalInputModeChanged, int /* PlayerIndex */, EInputMode) + /** + * We seem to need a separate non-UObject for an IInputProcessor, my attempt to combine the 2 fails. + * So this class just acts as a safe relay between Slate and UInputHelper + * + * This class should be registered as an input processor in order to capture all input events & detect + * what kind of devices are being used. We can't use PlayerController to do this reliably because in UMG + * mode, all the mouse move events are consumed by Slate and you never see them, so it's not possible to + * detect when the user moved a mouse. + * + * This class should be instantiated and used from some UObject of your choice, e.g. your GameInstance class, + * something like this: + * + * InputDetector = MakeShareable(new FInputModeDetector()); + * FSlateApplication::Get().RegisterInputPreProcessor(InputDetector); + * InputDetector->OnInputModeChanged.BindUObject(this, &UMyGameInstance::OnInputDetectorModeChanged); + * + * Note how the OnInputModeChanged on this object is a simple delegate, not a dynamic multicast etc, because + * this is not a UObject. You should relay the input mode event changed through the owner if you want to distribute + * the information further. + */ + class FInputModeDetector : public IInputProcessor, public TSharedFromThis + { + protected: + TArray LastInputModeByPlayer; + + const EInputMode DefaultInputMode = EInputMode::Mouse; + const float MouseMoveThreshold = 1; + const float GamepadAxisThreshold = 0.2; + public: + + // Single delegate caller, owner should propagate if they want (this isn't a UObject) + FInternalInputModeChanged OnInputModeChanged; + + + FInputModeDetector(); + + virtual bool HandleKeyDownEvent(FSlateApplication& SlateApp, const FKeyEvent& InKeyEvent) override; + virtual bool + HandleAnalogInputEvent(FSlateApplication& SlateApp, const FAnalogInputEvent& InAnalogInputEvent) override; + virtual bool HandleMouseMoveEvent(FSlateApplication& SlateApp, const FPointerEvent& MouseEvent) override; + virtual bool HandleMouseButtonDownEvent(FSlateApplication& SlateApp, const FPointerEvent& MouseEvent) override; + virtual bool HandleMouseWheelOrGestureEvent(FSlateApplication& SlateApp, const FPointerEvent& InWheelEvent, + const FPointerEvent* InGestureEvent) override; + + EInputMode GetLastInputMode(int PlayerIndex = 0); + + // Needed but unused + virtual void Tick(const float DeltaTime, FSlateApplication& SlateApp, TSharedRef Cursor) override {} + + protected: + void ProcessKeyOrButton(int PlayerIndex, FKey Key); + void SetMode(int PlayerIndex, EInputMode NewMode); + }; + +protected: + TSharedPtr InputDetector; + + UPROPERTY(BlueprintReadWrite) + UUiTheme* DefaultUiTheme; + + void CreateInputDetector(); + void DestroyInputDetector(); + void InitTheme(); + + // Called by detector + void OnInputDetectorModeChanged(int PlayerIndex, EInputMode NewMode); + +public: + + /// Event raised when input mode changed between gamepad and keyboard / mouse + UPROPERTY(BlueprintAssignable) + FOnInputModeChanged OnInputModeChanged; + + UFUNCTION(BlueprintCallable) + EInputMode GetLastInputModeUsed(int PlayerIndex = 0) const { return InputDetector->GetLastInputMode(PlayerIndex); } + + UFUNCTION(BlueprintCallable) + bool LastInputWasGamePad(int PlayerIndex = 0) const { return GetLastInputModeUsed(PlayerIndex) == EInputMode::Gamepad; } + + /// Gets the default UI theme object (defaults to our own) + /// You can override this if you want + UUiTheme* GetDefaultUiTheme() { return DefaultUiTheme; }; + + /// Changes the default theme to a different one + void SetDefaultUiTheme(UUiTheme* NewTheme) { DefaultUiTheme = NewTheme; } +}; diff --git a/Source/StevesUEHelpers/Public/StevesGameViewportClientBase.h b/Source/StevesUEHelpers/Public/StevesGameViewportClientBase.h new file mode 100644 index 0000000..b3b0229 --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesGameViewportClientBase.h @@ -0,0 +1,24 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Engine/GameViewportClient.h" + +#include "StevesGameViewportClientBase.generated.h" + +UCLASS() +class STEVESUEHELPERS_API UStevesGameViewportClientBase : public UGameViewportClient +{ + GENERATED_BODY() + + protected: + bool bSuppressMouseCursor; + + public: + + + virtual void Init(FWorldContext& WorldContext, UGameInstance* OwningGameInstance, + bool bCreateNewAudioDevice) override; + virtual EMouseCursor::Type GetCursor(FViewport* Viewport, int32 X, int32 Y) override; + + virtual void SetSuppressMouseCursor(bool bSuppress); +}; diff --git a/Source/StevesUEHelpers/Public/StevesHelperCommon.h b/Source/StevesUEHelpers/Public/StevesHelperCommon.h new file mode 100644 index 0000000..e3f8f02 --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesHelperCommon.h @@ -0,0 +1,12 @@ +#pragma once +#include "UObject/ObjectMacros.h" + +UENUM(BlueprintType) +enum class EInputMode : uint8 +{ + Mouse, + Keyboard, + Gamepad, + Unknown +}; + diff --git a/Source/StevesUEHelpers/Public/StevesUEHelpers.h b/Source/StevesUEHelpers/Public/StevesUEHelpers.h new file mode 100644 index 0000000..279050c --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUEHelpers.h @@ -0,0 +1,29 @@ +#pragma once + +#include "CoreMinimal.h" + + +#include "StevesGameSubsystem.h" +#include "Modules/ModuleManager.h" +#include "Engine/World.h" + +DECLARE_LOG_CATEGORY_EXTERN(LogStevesUEHelpers, Verbose, Verbose); + +class FStevesUEHelpers : public IModuleInterface +{ +public: + + /** IModuleInterface implementation */ + virtual void StartupModule() override; + virtual void ShutdownModule() override; +}; + +inline UStevesGameSubsystem* GetStevesGameSubsystem(UWorld* WorldContext) +{ + if (IsValid(WorldContext) && IsValid(WorldContext->GetGameInstance())) + { + return WorldContext->GetGameInstance()->GetSubsystem(); + } + + return nullptr; +} \ No newline at end of file diff --git a/Source/StevesUEHelpers/Public/StevesUI/FocusableButton.h b/Source/StevesUEHelpers/Public/StevesUI/FocusableButton.h new file mode 100644 index 0000000..14a7070 --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/FocusableButton.h @@ -0,0 +1,54 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Components/Button.h" +#include "UObject/ObjectMacros.h" +#include "Styling/SlateTypes.h" +#include "Widgets/SWidget.h" + +#include "FocusableButton.generated.h" + +class SFocusableButton; + +DECLARE_DYNAMIC_MULTICAST_DELEGATE(FOnButtonFocusReceivedEvent); +DECLARE_DYNAMIC_MULTICAST_DELEGATE(FOnButtonFocusLostEvent); + +/** +* This is a simple subclass of UButton to provide some missing features +* +* * Focus events +* * Focus style based on hover style +* * Assign focus to self on hover to prevent double-highlighting +*/ +UCLASS() +class STEVESUEHELPERS_API UFocusableButton : public UButton +{ + GENERATED_UCLASS_BODY() + +public: + UPROPERTY(BlueprintReadWrite, EditAnywhere) + bool bUseHoverStyleWhenFocussed = true; + + UPROPERTY(BlueprintAssignable, Category="Button|Event") + FOnButtonFocusReceivedEvent OnFocusReceived; + + UPROPERTY(BlueprintAssignable, Category="Button|Event") + FOnButtonFocusLostEvent OnFocusLost; + + UPROPERTY(BlueprintReadWrite, EditAnywhere) + bool bTakeFocusOnHover = true; + + +protected: + FButtonStyle FocussedStyle; + + void SlateHandleFocusReceived(); + void SlateHandleFocusLost(); + + void ApplyFocusStyle(); + void UndoFocusStyle(); + void SlateHandleHovered(); + void SlateHandleUnhovered(); + + virtual TSharedRef RebuildWidget() override; +}; \ No newline at end of file diff --git a/Source/StevesUEHelpers/Public/StevesUI/FocusablePanel.h b/Source/StevesUEHelpers/Public/StevesUI/FocusablePanel.h new file mode 100644 index 0000000..75b0446 --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/FocusablePanel.h @@ -0,0 +1,62 @@ +#pragma once + +#include "CoreMinimal.h" +#include "FocusableUserWidget.h" + +#include "FocusablePanel.generated.h" + +/// Base class for a UI Panel which has the concept of having focus, delegated to one of its children. +/// When told, it can initialise focus to a default widget. It can also remember which of its children +/// are currently focussed and restore that later. +/// Calling SetFocusProperly does the default behaviour of preferring previous but falling back on the default. +UCLASS() +class STEVESUEHELPERS_API UFocusablePanel : public UFocusableUserWidget +{ + GENERATED_BODY() + + +public: + /// The name of the widget which will be initially focussed by default + /// This is a name because we can't link directly at edit time + UPROPERTY(EditAnywhere, BlueprintReadWrite) + FName InitialFocusWidgetName; + + // I'd love to make the above a drop-down but it's a lot of faff + // See Engine\Source\Editor\UMGEditor\Private\Customizations\WidgetNavigationCustomization.cpp + // Specifically OnGenerateWidgetList + + /** + * @brief Set the current focus to the initial focus widget + * @return Whether the focus was successfully set + */ + bool SetFocusToInitialWidget() const; + + /** + * @brief Try to restore focus to the previously focussed child + * @return Whether the focus was successfully set + */ + bool RestorePreviousFocus() const; + + /** + * @brief Try to save the currently focussed child as something that can be restored later. + * @return Whether focus was saved + */ + bool SavePreviousFocus(); + + + /// When SetFocusProperly is called, either restores previous selection or gives it to the initial selection + virtual void SetFocusProperly_Implementation() override; +protected: + + /// The widget that should get the focus on init if in keyboard / gamepad mode + /// Looked up at runtime from the FName + TWeakObjectPtr InitialFocusWidget; + + /// Previously focussed child which can be restored + TWeakObjectPtr PreviousFocusWidget; + + virtual void NativeConstruct() override; + virtual void NativeDestruct() override; + + +}; diff --git a/Source/StevesUEHelpers/Public/StevesUI/FocusableUserWidget.h b/Source/StevesUEHelpers/Public/StevesUI/FocusableUserWidget.h new file mode 100644 index 0000000..4bff758 --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/FocusableUserWidget.h @@ -0,0 +1,20 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Blueprint/UserWidget.h" + +#include "FocusableUserWidget.generated.h" + +// Hacky intermediate type for UUserWidget so that we can have focusable child widgets via SetFocusProperly +UCLASS() +class STEVESUEHELPERS_API UFocusableUserWidget : public UUserWidget +{ + GENERATED_BODY() + +public: + /// UWidget::SetFocus is not virtual FFS. This does the same as SetFocus by default but can be overridden, + /// e.g. to delegate focus to specific children + UFUNCTION(BlueprintNativeEvent) + void SetFocusProperly(); + +}; diff --git a/Source/StevesUEHelpers/Public/StevesUI/InputImage.h b/Source/StevesUEHelpers/Public/StevesUI/InputImage.h new file mode 100644 index 0000000..760ef9e --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/InputImage.h @@ -0,0 +1,93 @@ +#pragma once + +#include "CoreMinimal.h" + +#include "UiTheme.h" +#include "Components/Image.h" +#include "StevesHelperCommon.h" +#include "InputImage.generated.h" + +UENUM(BlueprintType) +enum class EInputBindingType : uint8 +{ + /// A button action, will be looked up based on input mappings + Action = 0, + /// An axis action, will be looked up based on input mappings + Axis = 1, + /// A manually specified FKey (which can be key, button, axis) + Key = 2 +}; + + +/// A special widget containing an image which populates itself based on an input action / axis and can dynamically +/// change based on the active input method. +UCLASS() +class STEVESUEHELPERS_API UInputImage : public UImage +{ + GENERATED_BODY() + +protected: + /// What type of an input binding this image should look up + UPROPERTY(EditAnywhere) + EInputBindingType BindingType; + + /// If BindingType is Action/Axis, the name of it + UPROPERTY(EditAnywhere) + FName ActionOrAxisName; + + /// If BindingType is Key, the key + UPROPERTY(EditAnywhere) + FKey Key; + + /// Custom theme to use for this input image set; if not supplied will use UStevesGameSubsystem::DefaultUiTheme + UPROPERTY(EditAnywhere) + UUiTheme* CustomTheme; + + EInputMode CurrentInputMode; + +public: + + /// Tell this image to display the bound action for the current input method + UFUNCTION(BlueprintCallable) + virtual void SetFromAction(FName Name); + + /// Tell this image to display the bound axis for the current input method + UFUNCTION(BlueprintCallable) + virtual void SetFromAxis(FName Name); + + /// Tell this image to display a specific key image + UFUNCTION(BlueprintCallable) + virtual void SetFromKey(FKey K); + + /// Get the binding type that we'll use to populate the image + UFUNCTION(BlueprintCallable) + virtual EInputBindingType GetBindingType() const { return BindingType; } + + /// If BindingType is Action/Axis, get the name of the action or axis to look up the image for + UFUNCTION(BlueprintCallable) + virtual FName GetActionOrAxisName() const { return ActionOrAxisName; }; + + /// If BindingType is Key, get the key + UFUNCTION(BlueprintCallable) + virtual FKey GetKey() const { return Key; } + + /// Get the custom theme, if any + virtual UUiTheme* GetCustomTheme() const { return CustomTheme; } + /// Change the custom theme for this image + virtual void SetCustomTheme(UUiTheme* Theme); + + virtual void BeginDestroy() override; +protected: + + virtual TSharedRef RebuildWidget() override; + void UpdateImageFromAction(const FName& Name); + void UpdateImageFromAxis(const FName& Name); + void UpdateImageFromTable(const FKey& Key, const TSoftObjectPtr& Asset); + void UpdateImageFromKey(const FKey& Key); + virtual void UpdateImage(); + virtual UUiTheme* GetTheme(); + + UFUNCTION() + void OnInputModeChanged(int PlayerIndex, EInputMode InputMode); + +}; diff --git a/Source/StevesUEHelpers/Public/StevesUI/KeySprite.h b/Source/StevesUEHelpers/Public/StevesUI/KeySprite.h new file mode 100644 index 0000000..f58ea8c --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/KeySprite.h @@ -0,0 +1,33 @@ +#pragma once + +#include "CoreMinimal.h" + +#include "InputCoreTypes.h" +#include "Engine/DataTable.h" +#include "PaperSprite.h" +#include "KeySprite.generated.h" + +/// Struct for the rows of a DataTable which will hold the mapping from an FKey to a Paper Sprite which represents it +/// Used for on-screen prompts +USTRUCT(BlueprintType) +struct STEVESUEHELPERS_API FKeySprite : public FTableRowBase +{ + GENERATED_USTRUCT_BODY() + + // Import a DataTable using this struct by creating a CSV file like this: + // + // Name,Key,Sprite + // 1,Enter,"PaperSprite'/Game/Textures/UI/Frames/Keyboard_Black_Enter'" + // 2,SpaceBar,"PaperSprite'/Game/Textures/UI/Frames/Keyboard_Black_Space'" + // + // Key is just the latter part of EKeys::Name + // Sprite is the path to the Paper2D sprite (most likely from a shared sprite sheet) + +public: + + UPROPERTY(EditAnywhere, BlueprintReadOnly) + FKey Key; + + UPROPERTY(EditAnywhere, BlueprintReadOnly) + UPaperSprite* Sprite; +}; \ No newline at end of file diff --git a/Source/StevesUEHelpers/Public/StevesUI/MenuBase.h b/Source/StevesUEHelpers/Public/StevesUI/MenuBase.h new file mode 100644 index 0000000..fafc78b --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/MenuBase.h @@ -0,0 +1,59 @@ +#pragma once + +#include "CoreMinimal.h" + +#include "MenuStack.h" +#include "FocusablePanel.h" +#include "Blueprint/UserWidget.h" + +#include "MenuBase.generated.h" + + +DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnMenuClosed, UMenuBase*, Menu, bool, bWasCancelled); +/// This class is one element of the UUiMenuStack and represents one level in the chain of +/// an assumed modal stack. It is responsible for implementing how it gets added +/// to the viewport or parent container, and removed again, and what it does when receiving +/// focus. +UCLASS(Abstract, BlueprintType) +class STEVESUEHELPERS_API UMenuBase : public UFocusablePanel +{ + GENERATED_BODY() +public: + UPROPERTY(BlueprintAssignable) + FOnMenuClosed OnClosed; + +protected: + UPROPERTY(BlueprintReadOnly) + TWeakObjectPtr ParentStack; + + /// Whether this menu should request focus when it is displayed + /// The widget which is focussed will either be the InitialFocusWidget on newly displayed, or + /// the previously selected widget if regaining focus + UPROPERTY(EditAnywhere, BlueprintReadWrite) + bool bRequestFocus = true; + + /// Set this property to true if you want this menu to embed itself in the parent UUiMenuStack's MenuContainer + /// If false, this Menu will be added to the viewport independently and can float over other menus in the stack + UPROPERTY(EditAnywhere, BlueprintReadWrite) + bool bEmbedInParentContainer = true; + + /// Whether to hide this menu when it's superceded by another in the stack. This property is only relevant + /// when bEmbedInParentContainer = false, since only one menu can be embedded at once. + UPROPERTY(EditAnywhere, BlueprintReadWrite) + bool bHideWhenSuperceded = true; + + void EmbedInParent(); + +public: + /// Close this menu level + UFUNCTION(BlueprintCallable) + void Close(bool bWasCancel); + + TWeakObjectPtr GetParentStack() const { return ParentStack; }; + + void AddedToStack(UMenuStack* Parent); + void RemovedFromStack(UMenuStack* Parent); + void SupercededInStack(); + void RegainedFocusInStack(); + void InputModeChanged(EInputMode OldMode, EInputMode NewMode); +}; diff --git a/Source/StevesUEHelpers/Public/StevesUI/MenuStack.h b/Source/StevesUEHelpers/Public/StevesUI/MenuStack.h new file mode 100644 index 0000000..05cd6bc --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/MenuStack.h @@ -0,0 +1,100 @@ +#pragma once + +#include "CoreMinimal.h" + +#include "FocusableUserWidget.h" +#include "Framework/Application/IInputProcessor.h" +#include "StevesHelperCommon.h" +#include "UObject/ObjectMacros.h" + + +#include "MenuStack.generated.h" + +class UContentWidget; +class UMenuBase; + +DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnMenuStackClosed, class UMenuStack*, Stack, bool, bWasCancel); + +/// Represents a modal stack of menus which take focus and have a concept of "Back" +/// Each level is a MenuBase +/// You can style this widget to be the general surrounds in which all MenuBase levels live inside +/// Create a Blueprint subclass of this and make sure you include a UContentWidget with the name +/// "MenuContainer" somewhere in the tree, which is where the menu contents will be placed. +UCLASS(Abstract, BlueprintType) +class STEVESUEHELPERS_API UMenuStack : public UFocusableUserWidget +{ + GENERATED_BODY() + + // Nested class which we'll use to poke into input events before anything else eats them + // Without this it seems impossible to pick up e.g. Gamepad "B" button with UMG up + // It means we hardcode the controls for menus but that's OK in practice + class FUiInputPreprocessor : public IInputProcessor, public TSharedFromThis + { + public: + DECLARE_DELEGATE_RetVal_OneParam(bool, FOnUiKeyDown, const FKeyEvent&); + FOnUiKeyDown OnUiKeyDown; + + virtual bool HandleKeyDownEvent(FSlateApplication& SlateApp, const FKeyEvent& InKeyEvent) override + { + return OnUiKeyDown.Execute(InKeyEvent); + } + // Required by IInputProcessor but we don't need + virtual void Tick(const float DeltaTime, FSlateApplication& SlateApp, TSharedRef Crs) override{} + }; + +protected: + EInputMode LastInputMode; + + TArray Menus; + + TSharedPtr InputPreprocessor; + + void LastMenuClosed(bool bWasCancel); + + virtual void NativeConstruct() override; + virtual void NativeDestruct() override; + UFUNCTION() + bool HandleKeyDownEvent(const FKeyEvent& InKeyEvent); + UFUNCTION() + void InputModeChanged(int PlayerIndex, EInputMode NewMode); + +public: + /// This property will bind to a blueprint variable of the same name to contain the actual menu content + /// If not set, or the UiMenuBase is set to not use this container, levels are added independently to viewport + /// Use a NamedSlot for this most of the time, it gives you the most layout flexibility. + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UContentWidget* MenuContainer; + + /// Event raised when the stack is closed for any reason. If bWasCancel, the menu stack was closed because the + /// last item was cancelled. + UPROPERTY(BlueprintAssignable) + FOnMenuStackClosed OnClosed; + + /// Push a new menu level by class. This will instantiate the new menu, display it, and inform the previous menu that it's + /// been superceded. Use the returned instance if you want to cache it + UFUNCTION(BlueprintCallable) + UMenuBase* PushMenuByClass(TSubclassOf MenuClass); + + /// Push a new menu level by instance on to the stack. This will display the new menu and inform the previous menu that it's + /// been superceded, which will most likely mean it will be hidden (but will retain its state) + UFUNCTION(BlueprintCallable) + void PushMenuByObject(UMenuBase* NewMenu); + + /// Pop the top level of the menu stack. This *destroys* the top level menu, meaning it will lose all of its state. + /// You won't need to call this manually most of the time, because calling Close() on the MenuBase will do it. + UFUNCTION(BlueprintCallable) + void PopMenu(bool bWasCancel); + + /// Get the number of active levels in the menu + UFUNCTION(BlueprintCallable) + int Count() const { return Menus.Num(); } + + /// Close the entire stack at once. This does not give any of the menus chance to do anything before close, so if you + /// want them to do that, use PopMenu() until Count() == 0 instead + UFUNCTION(BlueprintCallable) + void CloseAll(bool bWasCancel); + + + virtual void SetFocusProperly_Implementation() override; + void PopMenuIfTop(UMenuBase* UiMenuBase, bool bWasCancel); +}; diff --git a/Source/StevesUEHelpers/Public/StevesUI/OptionWidgetBase.h b/Source/StevesUEHelpers/Public/StevesUI/OptionWidgetBase.h new file mode 100644 index 0000000..0794e1d --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/OptionWidgetBase.h @@ -0,0 +1,150 @@ +#pragma once + +#include "CoreMinimal.h" +#include "FocusableUserWidget.h" +#include "Styling/SlateTypes.h" +#include "StevesHelperCommon.h" +#include "OptionWidgetBase.generated.h" + +class UTextBlock; +class UImage; +class UButton; + +DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnSelectedOptionChanged, class UOptionWidgetBase*, Widget, int, NewIndex); + +UCLASS(Abstract, BlueprintType) +class STEVESUEHELPERS_API UOptionWidgetBase : public UFocusableUserWidget +{ + GENERATED_BODY() + + +public: + + // -- Properties we replicate to child widgets + UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Appearance") + FButtonStyle ButtonStyle; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FSlateBrush ButtonImage; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FLinearColor ButtonImageColour = FLinearColor::White; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FSlateFontInfo Font; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FLinearColor TextColour = FLinearColor::White; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FSlateBrush TextStrikeBrush; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FVector2D TextShadowOffset; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Appearance") + FLinearColor TextShadowColor; + + // -- Properties automatically bound to Blueprint widget + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UWidget* MouseVersion; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UButton* MouseUpButton; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UButton* MouseDownButton; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UImage* MouseUpImage; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UImage* MouseDownImage; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UTextBlock* MouseText; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UButton* GamepadVersion; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UImage* GamepadUpImage; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UImage* GamepadDownImage; + + UPROPERTY(EditAnywhere, BlueprintReadOnly, meta = (BindWidget)) + UTextBlock* GamepadText; + + /// Event raised when the selected option changes + FOnSelectedOptionChanged OnSelectedOptionChanged; + + virtual void SynchronizeProperties() override; + + UFUNCTION(BlueprintCallable) + /// Remove all options + virtual void ClearOptions(); + + /** + * @brief Adds a new option + * @param Option The text for the new option + * @return The index for the new option + */ + UFUNCTION(BlueprintCallable) + virtual int AddOption(FText Option); + + + /** + * @brief Sets all of the options available for this control + * @param Options All options to be available + * @param NewSelectedIndex Which of the options to select by default + */ + UFUNCTION(BlueprintCallable) + virtual void SetOptions(const TArray& Options, int NewSelectedIndex = 0); + + UFUNCTION(BlueprintPure) + virtual int GetSelectedIndex() const { return SelectedIndex; } + + UFUNCTION(BlueprintPure) + virtual FText GetSelectedOption() const; + /** + * @brief Change the selected index option + * @param NewIndex The new index to set, can be -1 for no selection + */ + UFUNCTION(BlueprintCallable) + virtual void SetSelectedIndex(int NewIndex); + + virtual void SetFocusProperly_Implementation() override; + +protected: + + TArray Options; + int SelectedIndex; + + virtual void SyncButtonProperties(UButton* Button) const; + virtual void SyncButtonImageProperties(UImage* Img) const; + virtual void SyncTextProperties(UTextBlock* Txt) const; + + UFUNCTION(BlueprintCallable) + virtual void SetMouseMode(); + UFUNCTION(BlueprintCallable) + virtual void SetButtonMode(); + + UFUNCTION(BlueprintCallable) + virtual void UpdateFromInputMode(EInputMode Mode); + virtual void NativeConstruct() override; + virtual void NativeDestruct() override; + UFUNCTION(BlueprintCallable) + virtual void ChangeOption(int Delta); + UFUNCTION(BlueprintCallable) + virtual EInputMode GetCurrentInputMode() const; + + +protected: + UFUNCTION() + void InputModeChanged(int PlayerIndex, EInputMode NewMode); + UFUNCTION() + void MouseUpClicked(); + UFUNCTION() + void MouseDownClicked(); +}; diff --git a/Source/StevesUEHelpers/Public/StevesUI/UiTheme.h b/Source/StevesUEHelpers/Public/StevesUI/UiTheme.h new file mode 100644 index 0000000..207fe88 --- /dev/null +++ b/Source/StevesUEHelpers/Public/StevesUI/UiTheme.h @@ -0,0 +1,25 @@ +#pragma once + +#include "CoreMinimal.h" +#include "Engine/DataAsset.h" +#include "Engine/DataTable.h" + + +#include "UiTheme.generated.h" + +/// Custom asset to conveniently hold theme information for the UI +/// Currently only lightly used to provide simple access to button images, but I intend to use +/// this more extensively later +UCLASS(Blueprintable) +class STEVESUEHELPERS_API UUiTheme : public UPrimaryDataAsset +{ + GENERATED_BODY() + +public: + + UPROPERTY(EditDefaultsOnly) + TSoftObjectPtr KeyboardMouseImages; + UPROPERTY(EditDefaultsOnly) + TSoftObjectPtr XboxControllerImages; + +}; diff --git a/Source/StevesUEHelpers/StevesUEHelpers.Build.cs b/Source/StevesUEHelpers/StevesUEHelpers.Build.cs new file mode 100644 index 0000000..5cef21c --- /dev/null +++ b/Source/StevesUEHelpers/StevesUEHelpers.Build.cs @@ -0,0 +1,49 @@ +using UnrealBuildTool; +using System.IO; + +public class StevesUEHelpers : ModuleRules +{ + public StevesUEHelpers(ReadOnlyTargetRules Target) : base(Target) + { + PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs; + + PublicIncludePaths.AddRange( + new string[] { + } + ); + + + PrivateIncludePaths.AddRange( + new string[] { + } + ); + + PublicDependencyModuleNames.AddRange( + new string[] + { + "Core", + "CoreUObject", + "Engine", + "InputCore", + "Slate", + "SlateCore", + "UMG", + "Paper2D" + } + ); + + + PrivateDependencyModuleNames.AddRange( + new string[] + { + } + ); + + + DynamicallyLoadedModuleNames.AddRange( + new string[] + { + } + ); + } +} diff --git a/StevesUEHelpers.uplugin b/StevesUEHelpers.uplugin new file mode 100644 index 0000000..4084248 --- /dev/null +++ b/StevesUEHelpers.uplugin @@ -0,0 +1,31 @@ +{ + "FileVersion" : 3, + "Version" : 1, + "VersionName" : "1.0", + "FriendlyName" : "Steve's UE4 Helpers", + "Description" : "A set of common helper classes for UE4 projects by Steve Streeing", + "Category" : "Code Utilities", + "CreatedBy" : "Steve Streeting", + "CreatedByURL" : "https://www.stevestreeting.com", + "DocsURL" : "", + "MarketplaceURL" : "", + "SupportURL" : "", + "EnabledByDefault" : true, + "CanContainContent" : false, + "IsBetaVersion" : true, + "Installed" : false, + "Modules" : + [ + { + "Name" : "StevesUEHelpers", + "Type" : "Runtime", + "LoadingPhase" : "Default" + } + ], + "Plugins": [ + { + "Name": "Paper2D", + "Enabled": true + } + ] +} \ No newline at end of file