入门

在UNIGINE中创建应用程序时，它由项目表示。 项目是应用程序的代码，内容和元数据的“容器”。

一个项目可以包含一个或几个复杂的3D场景，这些场景称为 worlds 。

所有项目都通过 UNIGINE SDK浏览器进行管理。

基于UNIGINE的虚拟 世界 是3D场景，其中包含一组不同的场景图 节点 （例如静态网格物体，灯光，照相机等）放置到指定位置，并应用全局设置（渲染，物理等）整个场景。

UNIGINE中的场景图是节点的多根树（层次结构）。

每个世界都由一个扩展名为.world的XML文件表示。

通过SDK浏览器创建新的项目时，还会创建一个与您的项目同名的新世界。

要编辑现有世界并创建新世界，请使用 UnigineEditor 。您可以根据需要创建和使用任意多个世界。

在UnigineEditor中查看了带有节点的世界

就UNIGINE而言，添加到场景中的所有对象都称为节点。节点可以是不同类型，可以确定其视觉表示和行为。

有一组丰富的内置节点类型。尽管该集合涵盖了几乎所有必需的情况，但用户可以手动对其进行扩展。

您还可以通过向其添加 components 来扩展任何节点的基本功能。

每个节点都有一个变换矩阵，该矩阵对世界上该节点的位置，旋转和比例进行编码。

有一些直观显示的节点类型：对象，贴图和效果。其他节点类型（光源，播放器等）是不可见的。

节点参数通常存储在.world文件中，但也可以保存到扩展名为.node的单独XML文件中（以后可以通过称为.world file via the special nodes called Node References, which is used for node instancing）。

目的#

网格是定义对象几何形状的多边形的集合。它具有以下属性：

• 每个网格具有一个或多个曲面。
• 每个表面的最大多边形数量为 2,147,483,647 （ObjectMeshStatic，ObjectMeshSkinned）或 65,535 （ObjectMeshDynamic）。
• 有2个UV纹理通道。
• 网格支持顶点颜色。

UNIGINE中的动画可以通过皮肤网格物体（基于骨骼），变形目标（关键帧）或动态网格物体（代码为

在运行时，网格以专有的UNIGINE 格式存储，扩展名为.mesh（静态网格+可选动画数据）和.anim（外部动画数据）。

将FBX模型导入到引擎时，它会自动转换为.mesh格式。

注意

如果希望对象的各个部分具有不同的材质（例如，透明/不透明，有光泽的金属/人体皮肤），则应将网格划分为多个表面。但是，如果要使几何图形的各个部分分开运动（例如汽车的旋转车轮），则需要几个单独的网格。

表面是对象几何体（即对象网格）的命名的不重叠子集。每个表面可以分配自己的材质或属性。也可以彼此独立地启用/禁用表面。

可以在网格中的层次结构中组织表面（可用于 LOD 切换）。

在下面的图片中，一个士兵3D网格由4个表面组成：眼睛，皮肤，包（防弹衣，收音机，包）和身体（工作服，鞋子，安全帽，手套）。

就UNIGINE而言， 材料 是一个规则，用于定义表面的外观：其与灯光，反射参数等的交互。它基于：

• 顶点，片段和几何形状着色器，它们根据不同的条件实际绘制材质。
• 用户定义的纹理传递给着色器。
• 状态，用于指定条件，并根据这些条件应用适当的着色器。
• 参数，用于定义如何使用着色器。

UNIGINE提供了一组丰富的 内置基础材料 。推荐的方法是从基础材料继承并调整新的用户材料。您还可以使用UUSL（Unified UNIGINE Shader Language）或HLSL / GLSL创建自定义着色器，但在后一种情况下，您需要自己随每个SDK版本一起迁移自定义着色器。

除了在某些表面上应用常规材料外，还有一种特殊类型的材料称为 后期材料 ，它们会应用到最终屏幕组成之上（例如夜间或热视觉效果）。您还可以使用自定义后期材质和自定义着色器创建自己的后效果。

物质层次#

属性 是应用程序逻辑的“材料”。它指定对象的行为方式以及与其他对象和场景环境交互的方式。属性可以具有各种类型的参数-从代表角色命中点的简单 integer 到节点，材质，文件（用于纹理，网格，声音等），或属性，可简化对各种资源的访问。

属性可用于构建 组件 以扩展节点的功能。

属性（如材料）在具有参数继承的层次结构中进行组织。但是，与材料不同，它们可以每个表面或每个节点应用。

UnigineEditor 允许您组装虚拟世界：导入和设置节点，为其分配材质和属性，设置照明，调整全局设置（物理，渲染等）等等。它具有所见即所得方法：您可以立即以最终质量（在运行时）看到场景。

观看以下教程，了解如何将3D模型导入UNIGINE：

您的世界中的灯光是通过放置光源创建的。这些节点包含确定各种灯光特征（例如亮度，颜色等）的参数。您还可以使用基于物理的参数（例如色温和照度）来设置灯光。

有不同种类的灯，它们以不同的方式发光。例如，灯泡向各个方向发光-在UNIGINE中，它由 全方位照明 表示。投影仪或汽车前灯在特定方向上发出锥形光束- 投射光 。来自太阳的光束看起来是平行的，因为它们的光源太远了。为了在UNIGINE中模拟这种类型的照明，使用了 世界照明 。

要了解有关UNIGINE中照明的更多信息，请参见 Lighting Video Tutorial 。

UNIGINE结合了完整的延迟渲染器和正向渲染技术：

• 所有不透明（非透明）几何图形均以递延遍历呈现。
• 透明几何体在前进通道中呈现。

要了解有关应用的渲染技术的更多信息，请参见 Rendering Sequence 文章。

在 UnigineEditor 中，可以通过 Rendering Settings 部分，并保存到*.render文件中以备后用。每个新项目都包含低，中，高和超质量预设的设置，以及为实现VR最佳性能而优化的设置。现在，您只需在资产浏览器中双击其中的任何一个即可应用相应的设置。

要为对象分配一些物理属性，使其可以参与对象之间的相互作用或外部物理力，它应具有 body 。主体有几种类型：Rigid, Rag Doll, Fracture, Rope, Cloth, Water, Path。

几乎像在现实世界中一样，人体的虚拟物理学遵循速度，力，质量，密度等的概念。

虽然 body 模拟各种类型的物理行为，但形状表示刚性的体积（球体，胶囊，圆柱体，盒子，凸包）身体占据了空间。物理模拟的对象通常具有单个主体和一个或多个形状，这些形状允许对象彼此碰撞。

碰撞检测#

接头 用于相对于质量平衡连接多个对象，并表示消除某些自由度的约束。关节有多种类型：Fixed, Hinge, Ball, Prismatic, Cylindrical, Wheel。

有全局物理设置（重力，穿透因子等）会影响世界上存在的所有物理对象。

要在UNIGINE中实现项目的逻辑，可以使用以下编程语言：

• C＃在速度和易用性之间取得良好的平衡。推荐的方法是C# (.NET Core) API。它允许使用默认情况下启用并集成到UnigineEditor中的 C＃组件系统。这是在组件中实现应用程序逻辑并将它们分配给要执行的任何节点的最简单方法。此外，.NET Core API是跨平台的，与仅Windows支持的.NET Framework不同。
• C ++ ，以实现最佳性能并与现有代码库无缝集成。
• UnigineScript ，一种​​快速迭代的脚本语言，具有即时编译和数千个有用的功能。

注意

数据文件夹中的所有*.usc和*.h文件都是UnigineScript语言的脚本（它们不需要编译）。

所有 API都是统一的：每个类，方法和常量都可以通过任何API访问。但是，特定于语言的差异很小。

要了解更多信息，请参见以下用法示例文章：

• UnigineScript API，C ++ API和C＃API使用示例
• 使用C ++ API的UnigineScript扩展示例
• 使用C＃API的UnigineScript扩展示例

混合语言#

每个基于UNIGINE的应用程序都有其生命周期，它由某些阶段组成，其中某些阶段执行一次，其他阶段每帧重复一次。简而言之，这些阶段如下：

UNIGINE具有三个主要逻辑组件，它们每个都有一组功能（名为 init（）， update（）， postUpdate（）等），其中包含要在引擎工作周期的相应阶段执行的操作。这些组件是：

• System Logic是在整个应用程序生命周期中运行的代码（即使在世界之间切换时，其范围也存在）。

  • 对于使用UnigineScript编写的应用程序，系统逻辑将写入系统脚本文件（unigine.usc）。
  • 对于使用C ++的应用程序，将创建AppSystemLogic.cpp，对于C＃应用程序，将创建AppSystemLogic.cs。该文件存储在项目的source/文件夹中。它具有已实现的方法将逻辑代码放入其中。

• World Logic是虚拟世界的逻辑。该逻辑仅在加载世界后才生效。

  • 对于使用UnigineScript编写的应用程序，世界逻辑将写入 world脚本文件（以您的项目命名的*.usc），并与相应的世界一起加载和卸载。
  • 对于使用C ++的应用程序，将创建AppWorldLogic.cpp，对于C＃应用程序，将创建AppWorldLogic.cs。该文件存储在项目的source/文件夹中，并在整个引擎运行时保持加载状态。它具有已实现的方法将逻辑代码放入其中。

• Editor Logic是编辑器的逻辑。该逻辑仅在加载UnigineEditor时有效。

  • 您应该创建一个编辑器逻辑文件，以将逻辑代码放入其中，并使用命令行参数将其添加。

强烈建议您熟悉执行顺序以了解详细信息，包括多线程模式。

组件系统#

UNIGINE具有快速的 交叉点检测算法。它可用于射线投射，计算视线（LOS）或地势高度（HOT）等。

也可以在节点的边界体积和另一个具有指定大小的边界体积之间找到交点。

UNIGINE提供了丰富的内置示例和 demo项目，涵盖了使用引擎的基本原理（使用内置节点进行操作，输出呈现， GUI设置等）。三种编程语言中的每一种都有不同的示例。所有示例均附带完整的源代码。要检查它们，请转到SDK browser -> Samples。

其中还包含一组扩展的 艺术样本 ，以方便您说明使用内容的各个方面：您可以学习如何使用 UNIGINE内置的在具有不同设置的对象中，设置 LOD 和材质，调整渲染设置，或使用植被。这些艺术品示例可以通过 UNIGINE SDK浏览器作为演示获得：转到Samples -> Demos并安装Art Samples演示。

平滑的alpha混合细节级别（LOD）用于降低3D对象的几何复杂度，当这些对象远离相机时，可以减轻渲染器上的负担。

通常，LOD用于：

• 将网格的高多边形曲面切换为低多边形的曲面。
• 将具有复杂材质的曲面切换为具有简化的优化材质的曲面。
• 将多个高多边形曲面切换到单个简化的曲面。
• 将一种 node 类型切换为另一种类型（例如，将高多边形网格切换为广告牌，即始终面向摄像机的两个多边形对象）。

在LOD之间切换不仅取决于距相机的距离，还取决于距特定物体的距离。

UNIGINE提供了两种 LOD 切换机制：

• 禁用一个LOD，并在由两个值定义的指定 distance 启用另一个LOD：第一个LOD的最大可见距离（Max Visibility）和第二个LOD的最小可见距离（Min Visibility）。

  

• 以两个值定义的指定间隔将一个LOD平滑地淡入到另一个LOD：第一个LOD的最小淡入距离（Min Fade）和第一个LOD的最大淡入距离/第二个LOD的最小淡入距离（Max Fade ）。

  

有关详细信息，请参见设置对象LODs文章。

位掩码定义两个实体是否相互影响。它可以用于：

• 渲染一些对象到视口，而不渲染其他对象。
• 将碰撞应用于某些物体，而不应用于其他物体。
• 为某些对象渲染阴影，而不为其他对象渲染。
• 对某些对象应用物理相互作用，而对另一些对象忽略。

位掩码 算法使用二进制运算符和比较两个节点中每个节点的32位掩码。如果蒙版匹配，则一个对象将影响另一对象；如果不这样做，对象将不会交互。

如果两个掩码具有至少一个匹配位，则掩码匹配。例如。以下两个掩码匹配，因为它们具有 4 个匹配位：