UnrealLink is under intense development, so this page might change in the future. Please contact us at [email protected] if you encounter any difficulties.
UnrealLink is a window in LightAct where you can set up most of LightAct's integration with Unreal Engine. Once we set up the UE Editor path, we will describe every section of UnrealLink window one by one.
UE Editor path: this is where you set up the path to UE4Editor.exe or UE5Editor.exe. You can find the UE Editor path under Preferences.
Choosing the UEEditor path also determines which version of Unreal Engine LightAct is going to launch when launching .uproject Unreal assets.
- Send timecode to UE: this enables or disables sending of LightAct's TC to Unreal.
- Lock UE to dropdown determines whether you want to enable Genlocking of Unreal to LightAct and if yes, whether it should be to every LightAct's frame or every second, every third etc. In most cases, you'll want to enable Every frame.
Good to know: If Unreal Engine cannot keep up with LightAct's framerate, you might want to lower LightAct's FPS in Project Settings.
- Wait for UE texture: this checkbox enables/disables LightAct's sub-frame latency feature.
LightAct's management of nDisplay follows these steps:
- 1.import some Unreal Assets,
- 2.create an .ndisplay configuration file,
- 3.generate launch command,
- 4.launch nDisplay,
- 5.kill nDisplay (optional).
To use UnrealLink you need at least one Unreal asset. Unreal asset can be either an executable of a packaged game or, more commonly, a .uproject file of Unreal Engine project.
To import an Unreal Asset, simply drag .exe or .uproject file into LightAct's window.
Once you've imported them, they will appear as radio buttons in UnrealLink window. Select one of them before proceeding.
To create an .ndisplay config file you need to have at least one thrower or project in the Viewport which has nDisplay checkbox enabled. This means it will get used as a template for nDisplay viewport.
Click on ... button and select or create an .ndisplay file.
Don't forget to click on Generate config file button in order to generate it.
The simple way to launch nDisplay is to click on Generate command button.
After this, the command will appear in the textbox below.
Then, you can click on Launch nDisplay button.
If you have enabled Every frame in the Lock UE to dropdown, then a few seconds after you've clicked on Launch nDisplay button, you will see real-time stats of Unreal Engine instance.
The stats won't appear if you haven't installed, enabled and set up LightAct plugin correctly.
There are 2 textboxes above the Generate command button:
- Exec cmd line Args: this adds additional command line arguments to the launch command. For example, if you add -trace , Unreal Engine instance will immediately try to connect to UnrealInsights tool.
- Custom ExecCmds: this passes additional console commands
If you enable Show advanced settings, you can adjust additional settings of your nDisplay instance. A lot of these are taken from Unreal's default settings, so we won't describe them in detail here.
However, the ones we should explain in a bit more detail are:
- Render offscreen: this prevents Unreal to create windows and instead renders the content off screen.
- Enable mGPU: enable this if you use multiple GPUs and want some or all of the nDisplay viewports to render on a different GPU than the one LightAct is rendering on.
There are 2 textboxes above the Generate command button where you can add additional command line arguments or Custom ExecCmds. See Unreal's user docs for more information.
You need an NVidia card with NVLink to enable multiple GPU rendering with Unreal Engine.
To kill an nDisplay instance, just press Kill nDisplay button.
nDisplay instances that were launched by LightAct are also killed when you exit LightAct