从虚幻引擎迁移到UNIGINE

Unreal Editor Viewports and Editor Viewports in UnigineEditor are very much alike. You can use as many Editor Viewports as you need.UnigineEditor中的Unreal Editor Viewports和Editor Viewports非常相似。您可以根据需要将多个Editor视口用作。

By default, an Editor Viewport renders its own Editor Camera view, and you can switch to another camera present in the scene and control it the same way as you pilot a CameraActor in UE.默认情况下，Editor视口会渲染其自己的Editor Camera视图，您可以切换到场景中存在的另一个摄像机，并以与在UE中导航CameraActor相同的方式对其进行控制。

Navigation inside Editor Viewports is pretty much the same as in UE Viewports. However, get familiar with Scene Navigation so as not to miss details.编辑器视口中的导航与UE视口中的导航几乎相同。但是，请熟悉场景导航，以免丢失细节。

Unreal Editor Viewport	UNIGINE Editor Viewport

You can use:您可以使用：

• Camera panel to switch between cameras and configure the current one.Camera panel可以在摄像机之间切换并配置当前摄像机。
• Rendering Debug to display the contents of rendering buffers the same way as using the Buffer Visualization Mode in UE4.Rendering Debug以显示渲染缓冲区的内容，与在UE4中使用Buffer Visualization Mode相同。
• Navigation panel to quickly set up and switch between camera speed presets and change the camera position.Navigation panel可快速设置并在摄像机速度预设之间切换并更改摄像机位置。
• ViewCube to switch between the perspective/orthographic projections and control orientation of the camera.ViewCube可以在透视 / 正投影投影和相机的控制方向之间切换。

Also, a set of switchers is available globally in the top toolbar:此外，顶部工具栏中的全局设置有一组切换器：

• Helpers panel provides quick access to auxiliary visualizers, such as icons, gizmos and wireframes. Helpers面板可快速访问辅助可视化工具，例如图标， gizmos 和线框。
• Precompile All Shaders toggle is used for Forced Shaders Compilation Precompile All Shaders切换用于强制着色器编译
• Animation toggle 动画 切换
• Physics toggle 物理 切换
• Audio toggle 音频 切换

You are accustomed that Unreal Editor has the Play In Editor (PIE) mode launching the game in the current Viewport and being representative of your final build. You can also play in other modes and use the Simulate In Editor (SIE) mode to preview blueprints logic, animation and physics simulation.您习惯于Unreal Editor具有Play In Editor (PIE)模式，该模式在当前视口中启动游戏并代表最终版本。您也可以在其他模式下播放，并使用Simulate In Editor (SIE)模式预览蓝图逻辑，动画和物理模拟。

In UNIGINE, you can enable animation and physics simulation using the toggles in the top toolbar. You can open the Engine viewport (menu: Windows -> Engine Viewport) where you can pilot the current Main Player.在UNIGINE中，您可以使用顶部工具栏中的切换启用动画和物理模拟。您可以打开Engine视口（菜单：Windows -> Engine Viewport），在此可以引导当前Main Player。

To check application logic you will need to run an instance of the current compiled binary of the application via any of the following ways:要检查应用程序逻辑，您将需要通过以下任意一种方式来运行应用程序当前已编译二进制文件的实例：

• Via SDK Browser by clicking Run:

  

  You can also run the application with custom settings by clicking an ellipsis under the Run button (e.g. choose the Debug binaries).You can also run the application with custom settings by clicking an ellipsis under the Run button (e.g. choose the Debug binaries).

  You can also run the application with custom settings by clicking an ellipsis under the Run button (e.g. choose the Debug binaries). Via SDK Browser by clicking Run:

  

  You can also run the application with custom settings by clicking an ellipsis under the Run button (e.g. choose the Debug binaries).您也可以通过单击“ Run”按钮下的省略号来使用自定义设置运行应用程序（例如，选择“调试”二进制文件）。

• By using the corresponding launcher created by default in the project folder:
  • launch_debug — the launcher of the project's debug version. launch_debug — the launcher of the project's debug version.
  • launch_release — the launcher of the project's release version. launch_release — the launcher of the project's release version.
  launch_debug — the launcher of the project's debug version. launch_release — the launcher of the project's release version. 通过使用默认在项目文件夹中创建的launcher：
  • launch_debug — the launcher of the project's debug version. _ launch_debug —项目的调试版本的启动器。
  • launch_release — the launcher of the project's release version. _ launch_release —项目发行版本的启动器。
• By running the project directly from the IDE used.通过直接从所使用的IDE运行项目。

By default, the mouse cursor is grabbed when clicked at run time, providing camera movement control, press Esc to free the cursor. There are two ways to setup default Input Bindings (key states and the mouse behaviour):默认情况下，在运行时单击鼠标时会抓住鼠标光标，以提供相机移动控制，按Esc释放光标。有两种方法可以设置默认的输入绑定（键状态和鼠标行为）：

• In the Controls settings of the Editor.在编辑器的控件设置中。
• Via code.通过代码。

As well as UE4, UNIGINE has the Console used for standard input, output and error logging. A set of console commands is provided.与UE4一样，UNIGINE的控制台也用于标准输入，输出和错误记录。提供了一组控制台命令。

It is available both in UnigineEditor and a running application. To open the Console window in the Editor, go to Windows -> Console menu:它在UnigineEditor和正在运行的应用程序中均可用。要在编辑器中打开控制台窗口，请转到Windows -> Console菜单：

A built-in console is called by pressing the grave accent (`) key:按下grave accent (`)键可以调用内置控制台：

You can use it to print user messages from code.您可以使用它从代码中打印用户消息。

In Unreal Engine, you got used to building your projects via the Editor. In UNIGINE, building a project is also done via UnigineEditor.在Unreal Engine中，您习惯于通过编辑器来构建项目。在UNIGINE中，建立项目也通过UnigineEditor完成。

A project in UNIGINE, just like a UE project, is stored in its own folder, project settings are stored in the *.project file. There are various subfolders inside the project's folder, where your content and source files as well as various configuration files and binaries are stored. The most important are the data and source sub-folders.就像UE项目一样，UNIGINE中的项目存储在其自己的文件夹中，项目设置存储在*.project文件中。项目文件夹中有多个子文件夹，其中存储了内容和源文件以及各种配置文件和二进制文件。最重要的是data和source子文件夹。

In UNIGINE, each project has a data folder. Similar to a UE project's Content folder, this is where your project's assets are stored. To import assets into your project, simply drop files into your project's data directory and they will be automatically imported and appear in the Asset Browser. The assets in the editor will update automatically as you make changes to the files using an external program.在UNIGINE中，每个项目都有一个data文件夹。类似于UE项目的Content文件夹，这是项目资产的存储位置。要将资产导入项目，只需将文件拖放到项目的data目录中，它们就会被自动导入并显示在资产浏览器中。当您使用外部程序对文件进行更改时，编辑器中的资产将自动更新。

Relationship between the contents of the data folder in your project's root on your computer, and the Project folder in the Asset Browser window计算机上项目根目录中的data文件夹的内容与Asset Browser窗口中的Project文件夹之间的关系

The core folder contains the built-in core assets. These assets are read-only and available for every project by default.core文件夹包含内置核心资产。这些资产是只读的，默认情况下可用于每个项目。

UNIGINE, like UE, supports the most commonly used file types and some specific ones:UNIGINE与UE一样，支持最常用的文件类型和某些特定的文件类型：

Unreal Engine assets (.uasset) are not supported for import by UNIGINE. Use the source content files you have used in your UE projects or export assets in one of formats supported by UNIGINE.UNIGINE不支持导入Unreal Engine资产（.uasset）。使用您在UE项目中使用的源内容文件或以UNIGINE支持的格式之一导出资产。

Meshes网格

You can import assets you used in UE to UNIGINE: export your mesh as an FBX model and import it to UNIGINE checking the required import options depending on the model.您可以将在UE中使用的资产导入到UNIGINE：将网格导出为FBX模型，然后导入到UNIGINE，根据模型检查所需的导入选项。

注意

Make note that the primary unit of measurement is one meter in UNIGINE, while UE4 operates on centimeters. It's recommended to scale down the geometry by 100 times by setting the geometry Scale multiplier to 0.01 value when importing.请注意，主要计量单位在UNIGINE中为1米，而UE4以厘米为单位。建议在导入时将几何Scale乘数设置为0.01值，以将几何按比例缩小100倍。

Materials材料

Similar to other engines, UNIGINE works with PBR materials. Moreover, UNIGINE supports both Metalness and Specular workflows and has a rich out-of-the-box library of materials that can be used to create almost any material. Therefore, materials created for the model in UE can be re-created in UNIGINE using mesh_base material, the base material in UNIGINE used for physically based materials.与其他引擎类似，UNIGINE使用 PBR材料。此外，UNIGINE同时支持 Metalness和Specular工作流程，并具有丰富的现成材料库，可用于创建几乎所有材料。因此，可以使用 mesh_base 材料在UNIGINE中重新创建在UE中为模型创建的材料，UNIGINE中的基础材料用于基于物理的材料。

Textures纹理

Textures can be imported as a part of a model or separately and then applied to a mesh. To import textures, you might have to do some adjustments in advance. For example, the Shading texture in UNIGINE stores the metalness, roughness, specular, and microfiber maps in its corresponding channels (RGBA), so you need to modify the texture using third-party software, such as GIMP or Photoshop, and then import it to UNIGINE.可以将纹理作为模型的一部分或单独导入，然后将其应用于网格。要导入纹理，您可能需要事先进行一些调整。例如，UNIGINE中的Shading纹理将金属性，粗糙度，镜面和微纤维贴图存储在其相应的通道（RGBA）中，因此您需要使用第三方软件（例如GIMP或Photoshop）修改纹理，然后将其导入到UNIGINE。

Normal texture used in UE is compatible with UNIGINE, therefore you can import your normal textures to UNIGINE without any changes.UE中使用的Normal纹理与UNIGINE兼容，因此您可以将常规纹理导入UNIGINE，而无需进行任何更改。

Animations动画

If you want to import a bone-animated model, export it from UE as an FBX file and enable the Import Animations option during the import to UNIGINE. You will also have additional options to finetune the import.如果要导入骨骼动画模型，请从UE将其导出为FBX文件，并在导入UNIGINE的过程中启用Import Animations选项。您还可以使用其他选项来微调导入。

For more details, see import recommendations.有关更多详细信息，请参见导入建议。

This section gives a brief description of basic scene objects in both engines as well as their basic similarities and differences.本节简要介绍了两个引擎中的基本场景对象，以及它们的基本异同。

Unreal Engine

UNIGINE

World Outliner世界大纲 Basic scene object — Actor.基本场景对象-Actor。 It is the base object that can be placed in or spawned into the world.它是可以放置或生成到世界中的基础对象。 Actors can be organized into a hierarchy (parent-child relation).可以将演员组织成一个层次结构（父子关系）。 Actor is a container for Components that define its functionality.Actor是Components的容器，用于定义其功能。 The Actor's position, rotation and scale are stored in a Scene Component. Usually Actors have a root component, which can be any subclass of Scene Component, by default.Actor的位置，旋转和比例存储在Scene Component中。通常，默认情况下Actors 具有根组件，该组件可以是Scene Component的任何子类。 Programmers can inherit from the default UActorComponent to create a custom component using C++ or Blueprint Script.程序员可以从默认的 UActorComponent 继承来使用C ++或Blueprint Script创建自定义组件。

World Hierarchy window世界层次结构窗口 Node is a basic type from which all types of scene objects are inherited. Some of them appear visually: Objects, Decals, and Effects — they all have surfaces to represent their geometry (mesh), while others (Light Sources, Players, etc.) are invisible.Node是一种基本类型，从该基本类型可以继承所有类型的场景对象。其中一些可视化显示：对象，贴图和效果-它们都具有表面来表示其几何形状（网格），而其他（光源，播放器等）不可见。 Nodes can be organized into a hierarchy (parent-child relation).节点可以组织成一个层次结构（父子关系）。 Basic functionality of a node is determined by its type. Additional functionality can be added using properties and the component system.节点的基本功能由其类型决定。可以使用属性和组件系统添加其他功能。 Each node has a transformation matrix, which encodes its position, rotation, and scale in the world.每个节点都有一个转换矩阵，该矩阵对其在世界上的位置，旋转和比例进行编码。 注意 All scene objects added to the scene regardless of their type are called nodes.不论类型如何，添加到场景中的所有场景对象都称为节点。

Blueprint Classes蓝图类#

How to Collaborate?如何合作？#

Cameras, the entities essential for rendering, are treated slightly differently in both engines.渲染必需的实体相机在两个引擎中的处理方式略有不同。

In UE4, the CameraComponent is responsible for capturing a view and sending it to render. You usually set a Pawn actor with a CameraComponent attached as a default character by specifying it in a GameMode settings.在UE4中，CameraComponent负责捕获视图并将其发送给渲染。通常，您可以通过在GameMode设置中指定Pawn actor并附加一个CameraComponent作为默认字符。

In UNIGINE, the Camera is a rendering-related object and implemented by the Player nodes in the world. There are several player types with different behaviour provided in order to simplify creation of the most commonly used cameras controlled via the input devices (keyboard, mouse, joystick):在UNIGINE中，Camera是与渲染相关的对象，并由世界上的Player节点实现。为了简化通过输入设备（键盘，鼠标，操纵杆）控制的最常用摄像机的创建，提供了几种具有不同行为的播放器类型：

• Dummy is a simple camera wrapper. You can use it for static cameras or enhance with custom logic. Dummy是一个简单的相机包装器。您可以将其用于静态摄像机或通过自定义逻辑进行增强。
• Spectator is a free flying camera. Spectator是一款自由飞行的相机。
• Persecutor is a flying camera that has the target and orbits it at the specified distance. It is a ready-to-use simple solution for a third-person camera. Persecutor是具有目标并围绕指定距离运行的飞行相机。它是适用于第三人称相机的简单易用的解决方案。
• Actor is a player that is capable of providing physical interaction with scenery. It has a rigid physical body, which is approximated with a capsule shape. It is a ready-to-use simple solution for a first-person character. Actor能够提供与风景的物理互动。它具有坚固的物理体，近似于胶囊形状。它是针对第一人称角色的即用型简单解决方案。

Only one player can be rendered into the viewport at a moment. To switch between cameras in the Editor Viewport of the UnigineEditor, use the Camera panel:一次只能将一个player渲染到视口中。要在UnigineEditor的Editor视口中的相机之间切换，请使用Camera面板：

By checking the Main Player flag of a player you set the default player, which will be rendered in the Editor's Engine viewport and on world startup when running the application.通过检查播放器的Main Player标志，可以设置默认播放器，它将在编辑器的Engine视口中以及运行应用程序时在世界启动时呈现。

You use Export and Import buttons in the project settings of the Unreal Editor to save the values of the settings to an external configuration file (.ini) and load them when necessary.您可以在Unreal Editor的项目设置中使用导出和导入按钮将设置的值保存到外部配置文件（.ini）中，并在必要时加载它们。

In UNIGINE, you can save and load general physics, sound and render settings the same way. The presets are stored as assets with the *.physics, *.sound and *.render extensions respectively. Use Load and Save .* asset buttons of the Settings window to work with presets of the corresponding settings section.在UNIGINE中，您可以保存和加载一般物理，声音和渲染设置。预设分别存储为资产，扩展名为*.physics，*.sound和*.render。使用Settings窗口的Load和Save .* asset按钮可使用相应设置部分的预设。

Saved assets appear in the Asset Browser. You can load the render settings by double-clicking the required .render asset.已保存的资产将显示在资产浏览器中。您可以通过双击所需的.render资产来加载渲染设置。

注意

By default, a UNIGINE project provides settings for low, medium, high, ultra and virtual reality quality presets stored in the data/template_render_settings folder.默认情况下，UNIGINE项目为存储在data/template_render_settings文件夹中的low, medium, high, ultra和virtual reality质量预设提供设置。

Presets are not an Editor-only feature in UNIGINE. You can use Physics, Sound and Render classes to manage presets for corresponding settings, for example, to switch between quality levels at run time.预设不是UNIGINE中的仅编辑器功能。您可以使用 物理 ， 声音 和 渲染 类来管理对应设置的预设，例如，在运行时在质量级别之间切换。

In UE4, settings for graphics quality are mostly gathered in the Engine - Rendering section.在UE4中，图形质量的设置大部分收集在Engine - Rendering部分中。

In UNIGINE, the rendering settings of the world can be found in the Render section of the Settings window. You can also toggle on and off the most common render features by using the Rendering menu:在UNIGINE中，世界的渲染设置可以在Settings窗口的Render部分中找到。您还可以使用Rendering菜单打开和关闭最常见的渲染功能：

There is no platform-dependent quiality adjustments in UNIGINE, you should write your own logic to control the quality levels. You can use Render Presets for this purpose.UNIGINE中没有依赖平台的质量调整，您应该编写自己的逻辑来控制质量水平。为此，您可以使用渲染预设。

Deferred and Forward Shading延迟和前向阴影#

Post Processing后期处理#