Here is how to run your Unreal C++ code asynchronously to avoid bottlenecks.
A thread ๐งต๐๐ผ
A little bit of context:
I am working on integrating @Tolgee_i18n localization tools inside Unreal Engine.
One of problem I've encountered is the performance hit coming from refreshing the Localization Manager resources.
A single call would take 450ms and drop the FPS to 2.
1. Investigating & diagnosing the issue
The first step we need to take is to add as many TRACE_CPUPROFILER_EVENT_SCOPE in performance-heavy code. This will measure the impact of the function's execution.
As a general rule of thumb, when in doubt, always add more.
2. Evaluating if the code can run async
Certain functions can only be executed on the main thread (e.g.: Creating UObjects).
In most cases, Unreal's code marks these portions with: check(IsInGameThread()).
This is a clear sign the function should NOT be ran async.
3. Converting to async
All we have to do is to wrap our code in a lambda and call AsyncTask.
The first parameter is the thread type. We will go with AnyHiPriThreadHiPriTask because we want our work to get prioritized.
The second parameter is the lambda with our code inside.
4. Re-evaluating performance
When running our latest changes we can see the calls to our functions get spread across multiple threads depending on the workload and priority.
5. Checking result
The execution still takes 450ms, but it's no longer blocking our main thread so the player can enjoy a smooth experience.
All the FPS spikes are gone by writing just 3 lines of code.
That's all for today!
If you learned something new:
1. Follow me @OutoftheboxP for more of these 2. Retweet the tweet below to share it with your fellow developer friends.
Here is how to create your own editor mode inside Unreal Engine.
Extend the editor with custom tools like the Landscape mode tailor to your own project.
A thread ๐งต๐๐ผ
1/4 Create the EdMode subclass
The EdMode subclass is responsible for registering and initializing the mode. It provides access to crucial virtual functions such as UEdMode::Enter & UEdMode::Exit which are triggered selecting and leaving the edit mode.
2/4 Create the ModeToolkit subclass
The Toolkit is responsible for creating the UI panel. It allows you to fully customize the panel with custom widgets are leverage the built-in DetailsView panels.
Here is how you can run custom logic during the engine initialization from your own modules.
A thread ๐งต๐๐ผ
Registering callbacks is usually straight forward:
You get a reference to an object, access the delegate and add your callback.
However things can get tricky when it comes to engine initialization.
The main problem is you risk registering your custom logic too late - after the delegate has been fired.
To avoid this kind of problems, Unreal has FDelayedAutoRegisterHelper which gives access to a bunch of critical delegates and automatically registers the callback.
How to write and refactor code without introducing any bugs.
Write your first Unreal Engine test today in 6 steps using Rider.
A thread ๐งต๐๐ผ
First off, let's discuss what automation tests are and what their purpose is:
Automated Tests are a controlled environment where you can verify the outcome of a piece of code against the expected result. They ensure our code behaves as expected while developing/refactoring it.
Step 1: Create the test class
1. Navigate to the module you want to add the test file to inside Rider. 2. Right-click the module project 3. Go to Add โ Unreal Test Class