Package Custom Scenes into Executable
When you finish modifying a custom scene as described in Customize Scenes Using Simulink and Unreal Editor, you can package the project file containing this scene into an executable. You can then configure your model to simulate from this executable by using the Simulation 3D Scene Configuration block. Executable files can improve simulation performance and do not require opening the Unreal® Editor to simulate your scene. Instead, the scene runs by using the Unreal Engine® that comes installed with Aerospace Blockset™.
Package Scene into Executable Using Unreal Editor
Open the project containing the scene in the Unreal Editor. You must open the project from a Simulink® model that is configured to co-simulate with the Unreal Editor.
In the Unreal Editor toolbar, select Settings > Project Settings to open the Project Settings window.
In the left pane, in the Project section, click Packaging.
In the Packaging section, set or verify the options in the table. If you do not see all these options, at the bottom of the Packaging section, click the Show Advanced expander .
Packaging Option Enable or Disable Use Pak File Enable Cook everything in the project content directory (ignore list of maps below) Disable Cook only maps (this only affects cookall) Enable Create compressed cooked packages Enable Exclude editor content while cooking Enable
If you create a new scene outside the scenes provided in the support package, specify the scene from the project that you want to package into an executable.
In the List of maps to include in a packaged build option, click the Adds Element button .
Specify the path to the scene that you want to include in the executable. By default, the Unreal Editor saves maps to the
/Game/Mapsfolder. For example, if the
/Game/Mapsfolder has a scene named
myScenethat you want to include in the executable, enter
Add or remove additional scenes as needed.
If you have any required asset directories to include in the executable which are not in the MathWorks® plugins, then specify them under Additional Asset Directories to Cook.
Rebuild the lighting in your scenes. If you do not rebuild the lighting, the shadows from the light source in your executable file are incorrect and a warning about rebuilding the lighting displays during simulation. In the Unreal Editor toolbar, select Build > Build Lighting Only.
In the left pane, in the Game section, click Asset Manager.
Expand Primary Asset Types to Scan, and under it expand elements 0 and 1. For both array elements, clear the Is Editor Only check box
Close the Project Settings window.
In the top-left menu of the editor, select File > Package Project > Windows (64-bit). Select a local folder in which to save the executable, such as to the root of the project file (for example,
Packaging a project into an executable can take several minutes. The more scenes that you include in the executable, the longer the packaging takes.
Once packaging is complete, the folder where you saved the package contains a
WindowsNoEditorfolder that includes the executable file. This file has the same name as the project file.
If you repackage a project into the same folder, the new executable folder overwrites the old one.
Suppose you package a scene that is from the
myProject.uprojectfile and save the executable to the
C:/Local/myProjectfolder. The editor creates a file named
myProject.exewith this path:
Simulate Scene from Executable in Simulink
To improve co-simulation performance, consider configuring the Simulation 3D Scene Configuration block to co-simulate with the project executable.
In the Simulation 3D Scene Configuration block of your Simulink model, set the Scene source parameter to
Set the File name parameter to the name of your Unreal Editor executable file. You can either browse for the file or specify the full path to the file by using backslashes. For example:
Set the Scene parameter to the name of a scene from within the executable file. For example:
Run the simulation. The model simulates in the custom scene that you created.
If you are simulating a scene from a project that is not based on the
AutoVtrlEnv project, then the scene simulates in full screen mode. To
use the same window size as the default scenes, copy the
DefaultGameUserSettings.ini file from the support package installation
folder to your custom project folder. For example, copy
Then, package scenes from the project into an executable again and retry the simulation.