copyExampleSim3dProject

Copy support package files and plugins to specified folders

Since R2022b

Syntax

sim3d.utils.copyExampleSim3dProject(DestFldr)
sim3d.utils.copyExampleSim3dProject(DestFldr,Name=Value)


Description

sim3d.utils.copyExampleSim3dProject(DestFldr) copies the support package project files to the destination folder, DestFldr. By default, copyExampleSim3dProject copies the plugins to your Epic Games^® installation folder.

sim3d.utils.copyExampleSim3dProject(DestFldr,Name=Value) copies support package files to the destination with additional options specified by name-value arguments.

Running the sim3d.utils.copyExampleSim3dProject function configures your environment so that you can customize scenes. The support package contains these Automated Driving Toolbox™ Interface for Unreal Engine^® 4 Projects.

• An Unreal^® project, defined in AutoVrtlEnv.uproject, and its associated files. The project includes editable versions of the prebuilt 3D scenes that you can select from the Scene name parameter of the Simulation 3D Scene Configuration block.

• Three plugins, MathWorkSimulation: RoadRunnerMaterials, and MathWorksAutomotiveContent. These plugins establish the connection between MATLAB^® and the Unreal Editor and are required for co-simulation.

• A RoadRunner scene project defined in RRscene.uproject file, along with a WindowsPackage folder that contains supporting files and the executable RRscene.exe. This project contains the editable version of the scene and the executable with supporting files to co-simulate the Highway Lane Following with RoadRunner Scene example.

Input Arguments

DestFldr — Destination folder for Unreal project files

character vector

Destination folder name, specified as a character vector.

Running copyExampleSim3dProject copies the Unreal project, defined in AutoVrtlEnv.uproject, and its associated files to the destination folder.

Note

You must have write permission for the destination folder.

Example: C:\project

Data Types: char | string

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Source — Support package source folder

character vector

Support package source folder, specified as a character vector. The folder contains the downloaded support packages files.

By default, if you do not specify the source folder, copyExampleSim3dProject copies the file from the support package installation folder, matlabshared.supportpkg.getSupportPackageRoot().

Example: Source="shared\sim3dprojects\spkg\"

Data Types: char | string

PluginDestination — Option to change the plugin destination folder

character vector

Option to change the plugin destination folder, specified as a character vector.

By default, if you do not change the plugin installation folder location, copyExampleSim3dProject tries to copy the plugins to C:\Program Files\Epic Games\UE_4.27\Engine\Plugins\MathWorks.

Example: PluginDestination="C:\Program Files\Epic Games\UE_4.27\Engine\Plugins\MathWorks"

Data Types: char | string

VerboseOutput — Option to enable verbose logging

0 or false (default) | 1 or true

Option to enable verbose logging, specified as a logical 0 (false) or 1 (true). Verbose logging displays intermediate iteration information on the MATLAB command line.

Example: VerboseOutput=true

Data Types: logical

Examples

Copy Support Package Files to Destination Folder

Copy the support package files to C:\project.

sim3d.utils.copyExampleSim3dProject("C:\project");

Copy the support package files to C:\project with VerboseOutput set to true.

sim3d.utils.copyExampleSim3dProject("C:\project", VerboseOutput=true)

Copying ...\spkg\project\AutoVrtlEnv to C:\project\AutoVrtlEnv
Creating C:\project\AutoVrtlEnv\Plugins
Copying ...\spkg\plugins\mw_aerospace\MathWorksAerospace to C:\project\AutoVrtlEnv\Plugins\MathWorksAerospace
Copying ...\spkg\plugins\mw_automotive\MathWorksAutomotiveContent to C:\project\AutoVrtlEnv\Plugins\MathWorksAutomotiveContent
Copying ...\spkg\plugins\mw_simulation\MathWorksSimulation to C:\project\AutoVrtlEnv\Plugins\MathWorksSimulation
Copying ...\spkg\plugins\mw_uav\MathWorksUAVContent to C:\project\AutoVrtlEnv\Plugins\MathWorksUAVContent
Copying ...\spkg\plugins\rr_materials\RoadRunnerMaterials to C:\project\AutoVrtlEnv\Plugins\RoadRunnerMaterials
Ensuring C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject is writable
Enabling plugin MathWorksSimulation in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject
Enabling plugin MathWorksUAVContent in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject
Enabling plugin MathWorksAutomotiveContent in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject
Enabling plugin RoadRunnerMaterials in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject

Version History

Introduced in R2022b