Unreal Engine (UE) is a third-party game engine that can be used to create 3D scenes. Unreal Engine projects can be adapted such that they create RenderStream output streams using disguise’s UE plugin. This plugin contains several components that enable both camera based mappings with tracking as well as non-camera based (2D) mappings (e.g. direct).
-
In order to communicate with disguise, Unreal Engine requires the installation of a plugin on the render node.
-
The RenderStream pre-packaged plugins for Unreal Engine are available in the disguise github.
-
For the most up to date plugin, you can compile the plugin from source code here
-
Place the plugin in this UE location on the render node: PROJECT_ROOT/Plugins/RenderStream-UE.
-
When adding a plugin to a UE/project, it is important that it is placed in the correct location and that the folder containing the plugin files is named correctly otherwise you may encounter unexpected errors.
Please note: Ensure the correct version of Disguise software is installed on all machines in network, including render nodes.
-
Launch Unreal Engine.
-
Create a new ‘Game’ project with default settings and ensure it is saved in: C:\Users\USERNAME\Documents\RenderStream Projects or D:\RenderStream Projects if using rx hardware.
-
Open the project folder and create a new folder called Plugins.
-
Place the plugin in the Plugins folder.
-
Restart Unreal Engine.
-
Search for Camera in the Place Actors panel.
-
Drag and drop a new Camera into the scene.
-
Optionally, position the Camera Actor accordingly.
-
Click the Add Component button from the Camera Actor's Details panel and add a RenderStream Channel Definition.
-
The name of the Channel in Disguise software will be the name of the camera actor, so name the camera accordingly.
-
The setting Default Visibility defines whether the camera will see most actors in the scene.
-
-
[Optional] Click the ‘Show Advanced’ dropdown arrow underneath Default Visibility and set the advanced render flags accord to your needs.
-
[Optional] Force the visibility of select Actors within the Camera’s Channel Definition (useful for splitting content between the front and backplates):
-
[r18.0] Add the “Render Stream Channel Visibility” component to your selected Actor/s from the Details panel. Then, set the visibility of the Actor per-channel definition created in the previous steps.
-
[r18.1+] The "RenderStream Channel Visibility" component was removed, so to change the visibility of a component, add your selected Actor/s to the visibility sets by clicking the '+' button on the set and then selecting the Actor/s from the dropdown of the newly added element.
If you wish to add multiple Actors to a visibility set at the same time, lock the current selection into the Details panel, select the Actors you wish to add either from within the scene or the Inspector panel, right-click the visibility set you wish to add the Actors to, and select “Add from Selection“.
-
-
[Optional] To make Unreal Engine run at full speed when out of focus go to Edit → Editor Preferences and untick “Use Less CPU when in Background” (search "cpu").
-
Save the project.
-
Close Unreal Engine.
Unreal Engine has several methods for saving a project. When making changes to a project for use with RenderStream, it is best to close the project before attempting to start a workload. This will prompt you to save all changes to your project. If your Unreal Engine project is not saved correctly, you may experience unexpected behaviour.
A helpful feature of the RenderStream plugin is the ability to show the status of the plugin in a widget
Here is how to setup the blueprint in the Unreal Engine project and add a status widget to the display:
-
Add a ‘Create Widget’ block
-
Change class to RenderStream Status Widget
-
Connect to an ‘Add to Viewport’ block by dragging off the return value of the status widget
