虚幻引擎5文档已被迁移至 Epic开发者社区

此页面介绍了Datasmith如何将Autodesk Revit中的场景导入虚幻编辑器。它遵循 Datasmith概述 和 关于Datasmith导入流程 中描述的基本流程，但加入了一些专为Revit设计的转换行为。如果您计划用Datasmith将Revit中的场景导入虚幻编辑器，阅读此页面可以帮助您理解自己的场景是如何被转换的，以及您该如何操作虚幻编辑器里的结果。

Revit工作流

Datasmith针对Revit时使用导出插件工作流。这意味着使用Datasmith将Revit内容导入虚幻引擎时需要执行以下操作：

1. 安装针对Revit的插件。请参阅 为Revit安装Datasmith Exporter插件 。

   在虚幻引擎的每个新版本中，Epic都会发布新版的虚幻Datasmith Revit导出器插件。如果要改用其他版本的虚幻引擎，请确保下载并安装了对应版本的插件。

2. 将Revit内容导入一个 .udatasmith 文件。参见 从Revit导出Datasmith内容 。

3. 如尚未安装，需要为项目启用 导入器（Importers） > Datasmith导入器（Datasmith Importer） 插件。

4. 使用虚幻编辑器的工具栏上的 **Datasmith* 导入器将 *.udatasmith* 文件导入。请参见 将Datasmith内容导入虚幻引擎4 。

控制被导出的内容

必须在Revit中选择一个活跃的3D视图才能使用Datasmith Exporter插件导出场景。该3D视图的可视性设置将定义来自Revit文件的哪些元素将包含在导出的 .udatasmith 文件中。可利用此行为在Revit中对导出至虚幻引擎的内容进行完全控制。

可以使用Revit文件中已有的任何3D视图。然而如果希望完全控制导入虚幻引擎的对象，我们建议在Revit中设置一个新的3D视图，并设置此视图只显示实时展示中所需要的对象。

Revit提供了诸多工具和技术来控制3D视图中对象的可视性。举例而言：

• 可使用 图形（Graphics） > 可视性/图形覆盖（Visibility/Graphics Overrides） 来控制关卡中不同对象和对象类目的可视性。

  点击查看全图。

• 可使用一个 分段框 来剪切导出的几何体。只有分段框中的对象将被导出到虚幻引擎。注意：当一个对象跨过分段框的边界时（如下图中的墙壁、地板和家具），其几何体将被截断。在虚幻引擎中，代表导出对象的静态网格体资源只包含处于分段框中的几何体。

  点击查看全图。

• 将遵守Revit中的 临时隐藏和隔离（Temporary Hide and Isolate） 设置。

• 只有当前3D视图中可见的几何体对象将被导出。非几何对象将被无视。

欲知控制Revit 3D视图中可视性的更多信息，还可参阅Revit帮助部分中的 项目视图中的可见性和图形显示 。

几何体

总体而言，可在Revit场景中单独选择的每个元素都将作为单独的静态网格体资源转译到虚幻引擎中。部分元素由更小的部分组成时（如轨道），其可能会被进一步拆分为更小的静态网格体。

在所有情况中，每个静态网格体资源的几何体被设为匹配导入文件时Revit对象的尺寸。参数设置和约束不会转入虚幻引擎。举例而言，在虚幻编辑器中上下移动一处地面时，不会拉伸或收缩墙壁高度来匹配Revit中的新位置。

实例化

如果两个对象属于相同族系，且如果其拥有完全相同的参数值，则两个对象都将在Datasmith场景中呈现为同一静态网格体资源的实例。

曲面细分

Datasmith依赖Revit的内置曲面细分服务从场景几何体创建三角形网格体。在大多数情况下，这会产生足够的几何体供在虚幻引擎中使用。但若您发现这些表面在项目中会带来问题，可尝试使用Unreal编辑器提供的工具简化这些网格体，例如 代理几何体工具 。

链接模块

若Revit场景包含任何 链接模块 ，即对其他Revit文件的引用，Datasmith将尝试用Revit文件中保存的路径查找计算机上的链接文件。Datasmith包括它能够在Datasmith场景中找到的所有链接文件的数据，同时Datasmith场景也是它在虚幻引擎中创建的。

材质和纹理

Datasmith将针对Revit场景中每种不同类型的表面在虚幻引擎项目中新建材质资源，并放置在Datasmith场景资源旁的 Materials 文件夹中。这些材质的目标是遵守设置表面在Revit中查看的方式，并公开一套完全复刻Revit中所使用属性的属性。

Datasmith当前支持将漫反射贴图和颜色、透明度、剪切和凹凸设置从Revit转译到其生成的虚幻引擎材质中。

在虚幻编辑器中修改材质的方法：

1. 在 内容浏览器 中对其进行双击。或在使用需要修改材质的关卡中选择一个actor，然后在细节面板中双击材质。

2. 如上图所示，材质编辑器将打开，可在细节面板顶部的 参数分组 部分中修改这些参数。也可修改虚幻渲染器公开的其他内置参数。

3. 如需覆盖任意属性的默认值，首先勾选其命名左边的框，在材质中激活属性。然后设置希望属性使用的值。

纹理和UV包裹

Datasmith将把Revit材质中使用的纹理导入到资源中，然后将其放置在Datasmith场景资源旁边的Textures文件夹中。

使用纹理资源的每个材质都会提供对Revit纹理编辑器的相似控制，以便控制纹理贴图在使用材质的3D对象表面上的应用方式。

1. Revit中的 位置（Position） > 偏移（Offset） 由每种贴图的 UVOffsetX 和 UVOffsetY 设置建模。

2. Revit中的 位置（Position） > 旋转（Rotation） 由每种贴图的 UVWAngle 设置建模。

3. Revit中的 标度 值基于真实世界维度，将转换为虚幻引擎材质中的一个标度乘数。增加这些缩放值的绝对值时，纹理在对象上将变小。

构建Datasmith场景层级

Datasmith Exporter插件在Datasmith场景中创建了一个父和子actor的层级，以便反映Revit中场景的整体组织。其目的是根据在用于Revit的概念来组织虚幻引擎关卡中的actor，以便于查找和操纵对象。

此场景层级根据以下规则构建：

• Revit中的每个 关卡 ——地面、Level 1、Level 2等均由Datasmith场景层级中的一个单独actor来反映。

• 在每个关卡中，可成为Revit中其他场景元素 宿主 的任意对象将变为其所拥有对象的父项。

• 在代表Revit关卡和宿主的父actor中可找到代表每个几何对象的静态网格体actor。

  举例而言，名为Level 1的actor包含代表每面墙的一个actor。而每个这些actor又由另一个父actor所代表（其拥有墙壁所拥有的每个几何对象的一个子项，即为每扇门、窗或墙壁部分）。

• 对于大多数"复合"Revit对象，例如幕墙或栏杆，场景层级仅包含一个展示复合对象的Actor。该Actor包含构成复合元素的每个子对象的静态网格体组件。

  例如，Revit中的幕墙通常作为单个Actor呈现在虚幻引擎中。对于构成幕墙的每个竖框和每个面板，该Actor都有一个单独的静态网格体组件。

光源

Datasmith从Revit场景将光源导入虚幻引擎，维持为其强度设置的物理单位。

相机

从Revit导入一个3D视图时，Datasmith可在虚幻编辑器关卡中创建一个单一的 CineCameraActor 。其将以相似的视野取代此相机在Revit 3D视图中的相机位置和朝向。如果在关卡视口或 世界大纲视图 中选择此CineCameraActor，其视口的预览应与导出 .udatasmith 文件时Revit 3D视图的裁剪区域高度匹配。

为实现最佳效果：

1. 将3D视图的 相机（Camera） > 投射模式（Projection Mode） 设置设为 透视 。

2. 设置Revit中3D视图的裁剪区域，使其聚焦于希望相机在虚幻引擎中拥有的视图。

3. 确保Revit中的相机目标点居中于裁剪区域中。将相机显示在其他平面和立面视图中即可进行验证。
   如透视发生移位，虚幻引擎中的结果则不会如预期般显示。

举例而言，下方的3D视图拥有带居中剪切区的透视相机，其将顺利平移：

然而，以下3D区域的裁剪区域为手动调整，将透视区域的一个边缘不均匀地向目标点移动。这样的平移不会顺畅。

类别

包含场景中至少一个对象的每个Revit类目将作为单独的层转入虚幻编辑器中。

可使用虚幻编辑器中的这些层来显示和隐藏类目，或查看和选择指定到它们的对象。

注意：由Revit SDK提供给导入器的信息不会固定将每个场景对象链接到一个类目。未在Revit中指定类目的对象将不会指定到虚幻编辑器中的任意层。

元数据

Datasmith导出关于Revit对象的元数据，并将该元数据附加到代表虚幻引擎中每个Revit对象的Actor。

将用于虚幻引擎中创建的运行时体验的多数元数据都将导入为Datasmith元数据。这包含在Revit中每个对象上的实例属性，以及为非空的类型属性。欲知导入属性的细节以及如何在编辑器资源准备脚本和运行时游戏性脚本中对其进行访问，请参见 使用Datasmith元数据 。

部分更多其他技术内部信息将附加到使用组件标签的每个actor。您可能会发现此信息适用于识别actor，使用蓝图或Python脚本来自动化虚幻编辑器中的数据准备时尤为如此。举例而言：

• Revit.Instance.Depth. - Revit场景层级中对象族系实例或族系符号的深度。

• Revit.Instance.Id. - Revit文档中对象族系实例或族系符号的ID。

• Revit.Host.Id. - 对象的族系实例被添加宿主后，此值将在Revit文档中给定族系实例宿主的ID。

RPC对象

Datasmith将Revit场景中丰富真实图形(RPC)对象引入虚幻引擎。对于Revit场景中每种类型的RPC对象，Datasmith将Revit中可见的几何体导入新的静态网格资源。对于在Revit场景中放置的每种RPC对象类型，Datasmith在虚幻引擎关卡创建新的静态网格体Actor，且其位置和方向与3D空间中相同。

查找已指定 Revit.RPC 组件标签的actor即可在虚幻引擎关卡中找到这些RPC对象：

若想要用一种更适合3D实时可视化的自动化方式来替代Revit中使用的占位符随从对象，这将非常有用。

测量点和基准点

若Revit场景包含 基准点或测量点 ，Datasmith会将这些点导入虚幻引擎关卡，同时利用不包含可见几何体的普通Actor加以表示。它在这些Actor上记录了Datasmith元数据中的相关测量点和基准点数据：

另参见上述 元数据 和 使用Datasmith元数据 。