从虚幻引擎迁移到UNIGINE：内容创建

Geometry Brush is the most basic tool for level construction in Unreal Engine. They are useful for rapid prototyping of levels and objects.Geometry Brush是Unreal Engine中进行关卡构建的最基本工具。它们对于快速创建关卡和对象的原型很有用。

Brush blocking in UE4UE4中的笔刷阻塞

In UNIGINE, you can use primitives for this kind of task. Go to the Create -> Primitives menu and select the desired type.在UNIGINE中，您可以使用原语为此任务。转到Create -> Primitives菜单，然后选择所需的类型。

Creating a primitive in UNIGINE在UNIGINE中创建基本体

Blocking in UNIGINE在UNIGINE中屏蔽

As well as in Unreal Engine, mesh is the main graphics primitive in UNIGINE.与Unreal Engine一样，网格也是UNIGINE中的主要图形基元。

In UE4, all data stored in the FBX model (meshes, skeletal data, animation sequences, materials and embedded textures) is imported as a set of separate assets linked to the source file (useful for updating the assets when changing the source model). Static Mesh assets can be edited in a separate window.在UE4中，将存储在FBX模型中的所有数据（网格，星座数据，动画序列，材质和嵌入的纹理）作为链接到源文件的一组单独资源导入（在更改源模型时可用于更新资源）。可以在单独的窗口中编辑Static Mesh资源。

Configuring a Static Mesh asset in UE在UE中配置Static Mesh资源

Both meshes and read-only materials appear as components of the asset.网格和只读材质均显示为资源的组件。

In UNIGINE, an imported FBX asset appears as a container for all meshes it stores in the Asset Browser. The link to the original file isn't created, the file is copied to the project data folder when imported. You can access the contents by right-clicking the asset and choosing Open:在UNIGINE中，导入的FBX资源显示为它存储在Asset Browser中的所有网格的容器。原始文件的链接未创建，导入时文件被复制到项目data文件夹中。您可以通过右键单击资源并选择Open来访问内容：

Meshes within an FBX asset in UNIGINE在UNIGINE的FBX资源内划分网格

Every separate object in the FBX model is represented by a .mesh runtime asset. Materials (if there are any, provided the Import Materials option was enabled) are generated in the materials folder next to the asset. To adjust import settings, select the FBX asset and proceed to the Parameters window.FBX模型中的每个单独对象都由.mesh运行时资源表示。材质（如果有的话，只要启用了Import Materials选项）就会在资源旁边的materials文件夹中生成。调整导入设置，选择FBX资源，然后进入Parameters窗口。

To create a node that uses the mesh or FBX asset you can simply drag it to the UnigineEditor viewport the same way you would do in Unreal Editor. In UNIGINE, this will add a Static Mesh object to the world hierarchy.至创建一个节点使用网格或FBX资源的用户，只需将其拖动到UnigineEditor视口中，就像在Unreal Editor中一样。在UNIGINE中，这会将Static Mesh对象添加到世界层次结构中。

Object nodes are major building blocks that construct the world. Most of them represent visible geometry of the scene. For example, it is best to use a Static Mesh object for objects that are not intended to change their geometry the same way as Static Mesh actor in UE4.目的节点是构成世界的主要构件。它们中的大多数代表场景的可见几何体。例如，对于不打算以与UE4中的Static Mesh actor相同的方式更改其几何形状的对象，最好使用Static Mesh对象。

On the picture below similar UI elements for static mesh parameters are color-coded for both editors:在下面的图片中，两个编辑器的静态网格物体参数的相似UI元素均用颜色编码：

Static Mesh parameters in Unreal Editor and UnigineEditorUnreal Editor和UnigineEditor中的Static Mesh参数

Here Surface come into play. They are pretty close to Elements of a Static Mesh in Unreal Engine, but a surface encapsulates a sub-mesh having a certain material assigned (in third-party 3D editors) and has the name according to that material. For convenience, surfaces can be rearranged in a hierarchy and toggled on and off. Some settings you would set for the whole Static Mesh actor, such as visibility and contribution to lighting, are available for each surface separately.这里表面参加进来。它们非常接近Unreal Engine中的Static Mesh元素，但是表面封装了已分配了某种材质的子网格（在第三方3D编辑器中），并具有根据该材质命名的名称。为了方便起见，表面可以是在层次结构中重新排列并打开和关闭。您可以为整个Static Mesh actor进行设置的某些设置（例如可见性和对照明的贡献）是可用的对于每个表面分别地。

Levels of Detail (LOD)

细节等级（LOD）#

In Unreal Editor, you are likely to be used to configuring LODs for a Static Mesh asset using the Static Mesh Editor. You usually import additional FBX files for all LODs and specify the screen size for each one. The active LOD is defined by the threshold based on the ratio of the mesh's screen-space size to the total screen height.在Unreal Editor中，您可能习惯于使用Static Mesh Editor为静态网格物体资源配置LOD。通常，您会为所有LOD导入其他FBX文件，并为每个LOD指定屏幕尺寸。根据网格的屏幕空间大小与总屏幕高度之比，由阈值定义活动LOD。

Configuring LODS in Static Mesh Editor在Static Mesh Editor中配置LODS

In UNIGINE, it is much more handy to store all LODs in a single .fbx model, in this case a Static Mesh created based on the asset will have several surfaces corresponing to LODs. Levels of detail are defined based on distances — in a more low-level manner to make fine tuning available. Surfaces have visibility settings for this purpose. You can set the minimum and maximum visibility distances from the camera for each surface. For Cross Fading use the Minimum Fade and Maximum Fade values.在UNIGINE中，将所有LOD存储在单个.fbx模型中更为方便，在这种情况下，基于资源创建的Static Mesh将具有与LOD对应的多个曲面。细节级别是基于距离定义的-以更底层的方式进行微调。表面有可见性设置以此目的。您可以为每个表面设置距相机的最小和最大可见距离。对于交叉淡入淡出，请使用Minimum Fade和Maximum Fade值。

Configuring LODs in UNIGINE在UNIGINE中配置LOD

注意

Note the -inf value in one of the fields. You can use inf (Infinity) and -inf (-Infinity) values for parameters supporting this format to define the lowest and highest possible values respectively.注意其中一个字段中的-inf值。您可以将inf（Infinity）和-inf（-Infinity）值用于支持此格式的参数，以分别定义最低和最高值。

Automatic generation of LODs is not provided in UNIGINE, but automatic LODs setup when importing a model is described in the FBX Import Guide. For more details on configuring LODs refer to the dedicated article.在UNIGINE中未提供LOD的自动生成，但是在导入模型时介绍了自动LOD设置。 FBX导入指南。有关配置LOD的更多详细信息，请参阅专用文章。

Bone-Based Animation

基于骨骼的动画#

FBX models containing bone-animated skinned meshes create animation clips when imported in both engines. In UNIGINE, such clips are represented by .anim assets.包含骨骼动画蒙皮网格物体的FBX模型在两个引擎中导入时都会创建动画剪辑。在UNIGINE中，此类剪辑由.anim资源表示。

Animation sequence in UE4 and .anim asset in UNIGINEUNIGINE中的UE4和.anim资源中的动画序列

注意

当前，每个网格仅支持一个动画剪辑。要对多个动画剪辑进行操作，您需要为每个动画导出一个单独的FBX。

Skinned Mesh object acts the same way as Skeletal Mesh Actor in UE4 used for handling bone animations.Skinned Mesh对象的行为与用于处理骨骼动画的UE4中的Skeletal Mesh Actor相同。

There is no skeleton concept as a special type of asset in UNIGINE. The skinned animation system is focused on operating animation layers: you can configure multiple layers with various animation clips and perform blending between them by using API methods.在UNIGINE中，没有skeleton概念是一种特殊的资源。外观动画系统专注于操作动画层：您可以使用各种动画剪辑配置多个层，并使用API方法在它们之间执行混合。

Example of animation using two layers使用两层动画的示例

For more details refer to the following articles:有关更多详细信息，请参阅以下文章：

• ObjectMeshSkinned class API referenceObjectMeshSkinned类API参考
• Animation section of C# Component Samples的动画部分C＃组件样本

Blend Shapes

混合形状#

The same way Skinned Mesh object supports morphing. If a mesh has blend shapes (sometimes referred to as morph targets) assigned in a third-party 3D modelling software, they will be available internally as surface morph targets (provided the Import Morph Targets option was enabled for the imported asset).Skinned Mesh对象支持变形的方式相同。如果网格在第三方3D建模软件中分配了blend shapes（有时称为morph targets），则它们将在内部以表面变形目标（前提是已为导入的资源启用了Import Morph Targets选项）。

In UNIGINE, multiple animation morph targets (i.e. morph layers) are created based on the available surface morph targets and blended manually using weights via API methods.在UNIGINE中，根据可用的表面变形目标创建多个动画变形目标（即变形层），并使用权重通过API方法。

Follow the related tutorial for more details:请遵循相关教程以获取更多详细信息：

• Adding Morph Targets

Similar to Unreal Engine, UNIGINE primarily works with PBR materials. Additionally, UNIGINE supports legacy Specular workflow.与Unreal Engine类似，UNIGINE主要用于PBR材质。此外，UNIGINE支持旧版Specular工作流程。

In UE4, you are accustomed to create materials and edit them using a node-based Material Editor visually. Each node represents a snippet of HLSL code, so, basically, you create a shader through visual scripting. To avoid time-consuming rebuilding of the material when tweaking parameters, you can use Material Instances.在UE4中，您习惯于创建材质并使用基于节点的材质编辑器直观地对其进行编辑。每个节点代表一小段HLSL代码，因此，基本上，您是通过可视脚本创建着色器的。为了避免在调整参数时耗时的材质重建，可以使用Material Instances 。

In UNIGINE, material system is formed by base materials and user materials inherited from them. A node-based Material Editor is also available in UNIGINE enabling you to create custom complex materials without coding required.在UNIGINE中，物料系统由基础材质以及从中继承的用户资料。

Materials in the UNIGINE rendering pipelineUNIGINE渲染管道中的材质

A base material is a set of read-only material properties (basically flags, parameters and textures) referring to fragment, vertex and geometry shaders. Base material can be assigned to nodes (or surfaces) of the type it is bound to. UNIGINE provides a rich out-of-the-box library of base materials and standard shaders that can be used to create almost any appearance for all the types of nodes available in the engine.基础材质是一组只读的材质属性（基本上是标志，参数和纹理），它们涉及片段，顶点和几何着色器。可以将基础材质分配给其绑定类型的节点（或表面）。 UNIGINE提供了丰富的开箱即用的基础材质库以及可用于为引擎中所有可用节点类型创建几乎任何外观的标准着色器。

注意

All materials are listed in the Materials window (menu: Windows -> Materials Hierarchy).所有材质都在Materials窗口中列出（菜单：Windows -> Materials Hierarchy）。

The mesh_base is the base PBR material in UNIGINE used for mesh surfaces. Right here you can inherit a new material from it and start setting it up by tweaking the parameters and assigning textures in the Parameters window.mesh_base是UNIGINE中用于网格曲面的基础PBR材质。在这里，您可以从中继承新材质并开始设置它通过调整参数并在Parameters窗口中分配纹理。

Parameters of the mesh_base materialmesh_base材质的参数

We create user materials by inheriting them from base materials to override some properties passed to shaders on rendering. When creating a material in the Asset Browser, we choose the base material to inherit from, thus defining the type of objects the new material will support.我们创造用户资料通过从基础材质继承它们，以覆盖渲染时传递给着色器的某些属性。在Asset Browser中创建材质时，我们选择要继承的基础材质，从而定义了新材质将支持的对象类型。

Create Material windowCreate Material窗口

Furthermore, user materials can form a hierarchy for convenience. So, when parameters of the parent material are changed, overridden parameters of its children remain the same.此外，用户资料可以形成等级制度为了方便。因此，更改父材质的参数时，其子材质的覆盖参数保持不变。

Materials Hierarchy windowMaterials Hierarchy窗口

You can create a custom base material via the visual Material Editor or manually, in this case you will need to create and edit a .basemat file in a text editor. The format of Base Material asset has a quite straight structure. As for shaders, HLSL syntax is supported for DirectX. Also, UUSL, the built-in UNIGINE shader language is provided as a universal one.请注意，UNIGINE中未提供基于节点的材质编辑器（当前正在研究此功能），因此，要创建自定义基础材质，您将需要在文本编辑器中手动创建和编辑.basemat文件。这基本物料资源的格式具有很直的结构。至于着色器，DirectX支持HLSL系统。同样，内置的UNIGINE着色器语言UUSL作为通用语言提供。

See also:也可以看看：

• Video Tutorial: Materials.视频教程：材质。

• Materials content sample.材质内容样本。

  

Shader Compilation

着色器编译#

The same way as in UE4, lighting in UNIGINE can be considered as either realtime or precomputed. A set of objects and tools enables you to get benefit from the both approaches.与UE4中的方式相同，可以将UNIGINE中的光照视为实时或预先计算的。一组对象和工具使您可以从两种方法中受益。

Light Sources

光源#

In UE4, light sources are represented by several Light actors. UNIGINE provides several types of light sources similar to the ones of Unreal Engine. The following table lists all possible way to add lighting in both engines.在UE4中，光源由几个Light actor表示。 UNIGINE提供了几种类型的光源与Unreal Engine类似。下表列出了在两个引擎中添加照明的所有可能方法。

Light Source	Unreal Engine	UNIGINE
A light source located at a point and sending light out in all directions equally位于一个点上的光源，可以均匀地向所有方向发射光	Point Light	Light Omni
A light source type providing a cone-shaped region of illumination提供锥形照明区域的光源类型	Spot Light	Light Projected
A type simulating an infinitely distant light source and casting parallel beams onto the scene 一种模拟无限远的光源并将平行光束投射到场景上的类型	Directional Light	Light World
An area light that illuminates objects in different directions at once 区域照明一次照亮不同方向上的物体	Area Light: Rectangle and Disc shape区域光：矩形和圆盘形状	Shape Type: Sphere, Capsule and Rectangle形状类型：球体，胶囊和矩形
Emissive objects emitting light across their surface area 发光物体在其表面积上发光	Emissive materials发光材质	Emission排放
Flat ambient lighting 平面环境照明	Sky light with a cubemap specified指定了立方体贴图的天光	Environment Ambient Lighting, Environment Probe环境环境照明，Environment Probe

Shadows

暗影#

In UE4, light sources can be Static, Stationary, actors have the same modes. When it comes to light baking (including shadows), UE4 workflow implies using Lightmaps.在UE4中，光源可以是Static，Stationary ，actor具有相同的模式。对于轻度烘焙（包括阴影），UE4工作流程意味着使用光照贴图。

Considering the concept of realtime and precomputed shadows, UNIGINE provides both types of shadows from light sources.考虑到实时阴影和预先计算的阴影的概念，UNIGINE提供了两种类型的光源阴影。

Shadows are cast using a commonly used technique called Shadow Mapping. All light sources can be either in Dynamic or Static mode according to which it is decided if shadow maps are computed in real time or saved in an asset, thus significantly reducing the number of polygons rendered each frame. Apparently, moving lights should be Dynamic, we can't precompute shadows cast from a moving light source.使用称为Shadow Mapping的常用技术投射阴影。所有光源都可以位于动态或静态确定阴影图是实时计算还是保存在资源中的模式，从而显着减少了每帧渲染的多边形数量。显然，移动光源应该是Dynamic ，我们无法预先计算从移动光源投射的阴影。

The Mixed or Static Shadow Casting Mode of a light source filters the surfaces that cast shadows from it. By using the Mixed mode you can combine baked shadows from static geometry and realtime shadows cast by certain dynamic meshes. Use the Shadow Mode to decide whether the surface is static or dynamic.光源的“混合”或“静态Shadow Casting Mode”会过滤从其投射阴影的表面。通过使用“混合”模式，您可以将静态几何图形中的烘焙阴影与某些动态网格物体所投射的实时阴影进行组合。使用Shadow Mode可以确定曲面是静态的还是动态的。

You don't have to bake shadows to achieve the soft shadows effect. This is controlled by the Penumbra Mode and Filtering Mode parameters per each light source.您无需烘烤阴影即可获得柔和的阴影效果。这由每个光源的Penumbra Mode和Filtering Mode参数控制。

World light source uses an advanced shadow mapping technique called Parallel-Split Shadow Mapping to handle shadows at large distances, it is pretty close to the Cascaded Shadow Maps technique the Directional light source uses in Unreal Engine. The shadow settings are available per each light source.世界光源使用一种称为Parallel-Split Shadow Mapping的高级阴影映射技术来处理远距离的阴影，它非常接近定向光源在Unreal Engine中使用的级联阴影贴图技术。这阴影设置每个光源可用。

To learn more about configuring different types of shadows, follow the dedicated links:要了解有关配置不同类型阴影的更多信息，请访问专用链接：

• Global Shadows settings.全球的暗影设置。
• Video tutorial: Lighting.影片教学：灯光。
• Video tutorial: Cached Shadows.影片教学：缓存的阴影。

Contact Shadows

接触阴影#

Contact Shadows are known as Screen-Space Shadows in UNIGINE. Settings for them are available per each light source.接触阴影在UNIGINE中称为Screen-Space Shadows。他们的设置每个光源可用。

Light Functions

灯光功能#

To filter a light's intensity Unreal Engine provides Light Functions.要过滤光的强度，Unreal Engine提供Light Functions。

In UNIGINE, you can use an arbitrary 2D diffuse or albedo texture in the Texture parameter of Light Projected. The same way you can apply texture modulation to a Light Omni by using a cubemap texture.在UNIGINE中，可以在Light Projected的Texture参数中使用任意2D漫反射或反照率纹理。您可以通过使用多维数据集贴图纹理将纹理调制应用于Light Omni的相同方法。

Modulation by texture通过纹理调制

Modulation by cubemap通过立方体贴图进行调制

This is the way IES Light Profiles can be simulated as well.这也是可以模拟IES灯光轮廓的方式。

Environment

环境#

In UE4, atmospheric lighting is usually represented by a set of actors: SkyLight, SkyAtmosphere, AtmosphericFog, and DirectionalLight.在UE4中，大气照明通常由一组角色表示：SkyLight, SkyAtmosphere, AtmosphericFog和DirectionalLight。

In UNIGINE, all Environment Settings are gathered in the Render Settings (choose Window -> Settings in the main menu, then in the Settings window go to Runtime -> World -> Render -> Environment).在UNIGINE中，所有环境设定在“渲染设置”中收集（在主菜单中选择Window -> Settings，然后在Settings窗口中转到Runtime -> World -> Render -> Environment）。

UNIGINE Environment SettingsUNIGINE环境设置

UNIGINE provides three environment presets, by configuring which you can create a smooth transition between different weather conditions. By default, the first preset is enabled only.通过配置，UNIGINE提供了三个环境预设，您可以在不同的天气条件之间创建平稳的过渡。默认情况下，仅启用第一个预设。

UNIGINE Environment SettingsUNIGINE环境设置

In order to achieve physically correct atmosphere rendering, UNIGINE environment system simulates Scattering by interpolating certain LUTs (Look-UP Textures). This system works in conjunction with the current enabled World light (the Scattering mode), so when configuring environment lighting you should consider all the settings combined. For more details visit the dedicated article.为了实现物理上正确的大气渲染，UNIGINE环境系统进行了模拟散射通过内插某些LUT（查找纹理）。该系统与当前启用的“世界”灯光（Scattering模式）配合使用，因此在配置环境照明时，应考虑所有设置的组合。有关更多详细信息，请访问专用文章。

You can set a cubemap texture as the Environment Texture for both sky color and reflections.您可以将天空图和反射图都设置为Environment Texture的立方体贴图纹理。

注意

If you need to change reflections locally, for example indoors, use an Environment Probe with a unique cubemap.如果需要在本地（例如在室内）更改反射，请使用具有唯一立方体贴图的Environment Probe。

In UNIGINE, you can use a Sky object recreating clouds and environment background in the scene. It can represent a hemisphere or a full sphere with a cubemap assigned, tiled with clouds texture to produce plausible and inexpensive dynamic clouds. 在UNIGINE中，可以使用Sky对象在场景中重新创建云和环境背景。它可以代表已分配了立方体贴图的半球或整个球体，并用云纹理平铺以生成合理且廉价的动态云。

注意

If your project requires simulating lifelike clouds, take a look at the Volumetric Clouds.如果您的项目需要模拟逼真的云，请看一下体积云。

Fog

多雾路段#

To simulate fog in Unreal Engine, you are accustomed to use different types of actors, such as AtmosphericFog, ExponentialHeightFog with the support for Volumetric Fog.要在Unreal Engine中模拟雾，您习惯于使用不同类型的actor，例如AtmosphericFog, ExponentialHeightFog并支持Volumetric Fog。

For the same purpose in UNIGINE you can use Environment Haze in the Solid mode or, if the difference between haze and fog is crucial for your project, use Volumetric Objects — they are great for simulating light beams and shafts, fog and shaped clouds.为了在UNIGINE中实现相同的目的，可以在Solid模式下使用Environment Haze，或者如果雾度和雾度之间的差异对于您的项目至关重要，则可以使用体积物体-它们非常适合模拟光束和轴，雾和异形云。