从虚幻引擎迁移到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 F1 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, packing a final build 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.不论类型如何，添加到场景中的所有场景对象都称为节点。