Документация

Требования к программному обеспечению

Минимальные требования к оборудованию

3D среда симуляции также требует:

Установите пакет поддержки

Сконфигурируйте индивидуальную настройку сцены Используя пакет поддержки

Пакет поддержки включает:

Чтобы скопировать проект в локальную папку и плагин к вашей Нереальной установке Редактора, выполните эти одноразовые шаги. Используйте Код, Который Конфигурирует Настройку Сцены (Шаги 1-4).

Код, который конфигурирует настройку сцены (шаги 1-4)

%% STEP1
% Specify the location of the support package project files and a local folder destination
% Note:  Only one path is supported. Select latest download path.
dest_root = "C:\Local";
src_root = fullfile(matlabshared.supportpkg.getSupportPackageRoot, ...
    "toolbox", "shared", "sim3dprojects", "automotive");

%% STEP2
% Specify the location of the Unreal Engine installation.
ueInstFolder = "C:\Program Files\Epic Games\UE_4.23";

%% STEP3
% Copy the MathWorksSimulation plugin to the Unreal Engine plugin folder.
mwPluginName = "MathWorksSimulation";
mwPluginFolder = fullfile(src_root, "PluginResources", "UE423"); % choose UE version
uePluginFolder = fullfile(ueInstFolder, "Engine", "Plugins");
uePluginDst = fullfile(uePluginFolder, "Marketplace", "MathWorks");

cd(uePluginFolder)
foundPlugins = dir("**/" + mwPluginName + ".uplugin");

if ~isempty(foundPlugins)
    numPlugins = size(foundPlugins, 1);
    msg2 = cell(1, numPlugins);
    pluginCell = struct2cell(foundPlugins);

    msg1 = "Plugin(s) already exist here:" + newline + newline;
    for n = 1:numPlugins
        msg2{n} = "    " + pluginCell{2,n} + newline;
    end
    msg3 = newline + "Please remove plugin folder(s) and try again.";
    msg  = msg1 + msg2 + msg3;
    warning(msg);
else
    copyfile(mwPluginFolder, uePluginDst);
    disp("Successfully copied MathWorksSimulation plugin to UE4 engine plugins!")
end

%% STEP4
% Copy the support package folder that contains the AutoVrtlEnv.uproject
% files to the local folder destination.
projFolderName = "AutoVrtlEnv";
projSrcFolder = fullfile(src_root, projFolderName);
projDstFolder = fullfile(dest_root, projFolderName);
if ~exist(projDstFolder, "dir")
    copyfile(projSrcFolder, projDstFolder);
end

Открытый AutoVrtlEnv Проект, содержащий предварительно созданные сцены

Открыть AutoVrtlEnv.uproject файл, который был скопирован с Интерфейса Vehicle Dynamics Blockset для Нереального Engine 4 пакета поддержки Проектов, задает путь туда, где вы скопировали этот проект. Например, если вы скопировали AutoVrtlEnv.uproject к C:/Local/AutoVrtlEnv, как показано в предыдущем разделе, используйте этот код:

path = fullfile('C:','Local','AutoVrtlEnv','AutoVrtlEnv.uproject');
editor = sim3d.Editor(path);
open(editor);

Редактор открывает AutoVrtlEnv.uproject файл. По умолчанию проект отображает сцену Straight Road.

Откройте пользовательский проект

Чтобы открыть проект, что вы разработали использование предшествующего релиза пакета поддержки, смотрите, Перемещают Проекты, Разработанные Используя Предшествующие Пакеты Поддержки.

Чтобы открыть ваш собственный проект, используйте те же команды, используемые, чтобы открыть AutoVrtlEnv.uproject файл. Обновите path переменная с путем к вашему .uproject файл. Например, если у вас есть проект, сохраненный в C:/Local папка, используйте этот код:

path = fullfile('C:','Local','myProject','myProject.uproject');
editor = sim3d.Editor(path);
open(editor);

Если это - ваш первый раз, открывающий пользовательский проект в Нереальном Редакторе 4.23, вы, возможно, должны сопоставить, или reparent, этот проект с проектом уровня Sim3dLevelScriptActor, используемым в Vehicle Dynamics Blockset. level blueprint управляет, как объекты взаимодействуют когда-то помещенные в в Нереальной среде. Если вы не повторно порождаете проект к этому проекту уровня, симуляция возвращает ошибку.

Повторно порождать проект уровня:

Открытая сцена

В Нереальном Редакторе сцены в рамках проекта упоминаются как levels, и определенный тип уровня для этих сцен известен как maps.

Открыть предварительно созданную сцену из AutoVrtlEnv.uproject файл, в панели Content Browser ниже окна редактора, перешел к папке Content> Maps. Затем выберите карту, которая соответствует сцене, которую вы хотите изменить.

Чтобы открыть сцену в рамках вашего собственного проекта, в панели Content Browser, перешли к папке, которая содержит ваши сцены.

Отправьте данные в сцену

Блок Simulation 3D Message Get получает данные от Нереального Engine 3D среда визуализации. Чтобы использовать блок, необходимо сконфигурировать сцены в Нереальной среде Engine, чтобы отправить данные в модель Simulink.

Для получения дальнейшей информации об использовании блока, чтобы настроить сцены, смотрите файл пакета поддержки QuickStart_Message_Get_Set и документация Simulation 3D Message Get.

Получите данные из сцены

Блок Simulation 3D Message Set отправляет данные в Нереальный Engine 3D среда визуализации. Чтобы использовать блок, необходимо сконфигурировать сцены в Нереальной среде Engine, чтобы получить данные из модели Simulink.

Для получения дальнейшей информации об использовании блока, чтобы настроить сцены, смотрите файл пакета поддержки QuickStart_Message_Get_Set и документация Simulation 3D Message Set.

Создайте новую сцену

Чтобы создать сцену в вашем проекте, из главного меню редактора, выбирают File> New Level.

В качестве альтернативы можно создать сцену из существующей. Этот метод полезен, например, если вы хотите использовать одну из предварительно созданных сцен в AutoVtrlEnv проект как начальная точка для создания вашей собственной сцены. Чтобы сохранить версию в настоящее время открытой сцены к вашему проекту, из главного меню редактора, выбирают File> Save Current As. Новая сцена сохранена в то же местоположение как существующая сцена.

Измените сцену

Можно изменить сцены в проекте путем перетаскивания объектов сцены в Нереальном Редакторе. В качестве альтернативы можно выбрать объект сцены в окне редактора и затем изменить его свойства в панели Details справа. Например, чтобы сменить положение, ориентация или размер объекта, в панели Details, использует опции в разделе Transform.

Нереальный Редактор использует левый Z - система координат, где Y - ось указывает направо. При расположении объектов в сцену помните об этом различии в системе координат.

Дополнительные сведения об изменении сцен в Нереальном Редакторе см. в Нереальной документации Engine 4.

Добавьте объекты в сцену

Чтобы добавить объекты в сцену, можно просмотреть или искать объекты в панели Content Browser в нижней части и перетащить их в окно редактора.

При добавлении объектов в сцену в AutoVrtlEnv проект (или сцена в проекте, который базировался от этого проекта), можно выбрать из библиотеки связанных с управлением объектов. Эти объекты, известные как static meshes, начинаются с префиксного sm_. Ищите эти объекты в панели Content Browser в нижней части.

Например, чтобы добавить конус трафика в сцену в AutoVrtlEnv проект:

Переместить эти объекты, также известные как assets, от AutoVrtlEnv- основанный проект в ваш собственный файл проекта, смотрите Мигрирующие Активы в Нереальной документации Engine.

Сцена пакета в исполняемый файл Используя нереальный редактор

Симулируйте сцену из исполняемого файла в Simulink

Чтобы улучшать производительность co-симуляции, рассмотрите конфигурирование блока Simulation 3D Scene Configuration к co-simulate с исполняемым файлом проекта.

Запустите предупреждение

Если при запуске Нереальный двигатель, не выполняя шаги в Открытом Нереальном Редакторе от Сцены MATLAB and Co-Симулэйта в Нереальном Редакторе и Simulink, можно получить предупреждение, которое читает: Warning: Integration with MATLAB/Simulink is not active. Нереальный Engine может отказать, если вы затем продолжаете работать с Нереальным Редактором.

Ошибка, создающая исполняемый файл проекта

Создать исполняемый файл проекта, MathWorksSimulation плагин должен быть расположен в Нереальной папке плагина Engine. Проверяйте что MathWorksSimulation плагин не находится в AutoVrtlEnv папка или подпапки. Настройте среду путем выполнения шагов в Открытом Нереальном Редакторе из MATLAB.