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

本页将对Visual Dataprep系统作简要介绍，带领您了解如何创建自定义导入方式，以便您为实时可视化项目筹备3D数据。

启用Visual Dataprep

请在项目中启用以下插件：

• DataPrep编辑器

• Datasmith导入器

• 若要从Datasmith支持的其他类型的源文件导入，可能需要启用其他导入器插件来支持这些文件类型。详见 将Datasmith内容导入到虚幻引擎4中 。

Visual Dataprep资产

Visual Dataprep系统基于一种名为 Dataprep 的新资产。此资产类似于蓝图，因为它能以可视化表现形式列出一系列步骤。但此Dataprep图表旨在转换从指定的一个或多个输入文件中读取的场景数据。

要创建新Dataprep资产，在内容浏览器中右键单击，从上下文菜单中选择 Dataprep > Dataprep资产（Dataprep Asset） 。

Dataprep编辑器UI

类似于蓝图类，Dataprep资产有自己的专用编辑器窗口。在 内容浏览器 中双击任意Dataprep资产即可打开此窗口。

Dataprep编辑器UI分为数个面板，适用于 Dataprep工作流 的不同阶段。

Dataprep工作流

设置Visual Dataprep资产的典型工作流包括以下步骤：

1. 指定输入文件 ：在右上角的 设置面板（Settings Panel） 中，为要导入的每个文件或每个输入文件文件夹创建一个新的输入内容制作者。您还可以自定义以下设置：

   • 文件夹（Folder） 可确定文件夹的名称，此文件夹将在项目的 内容浏览器（Content Browser） 中创建，用于保存导入的资产。默认情况下，Datasmith会根据类型将资产分配到该文件夹的子文件夹中：一个用于静态网格体资产，一个用于材质，一个用于纹理，等等。（在构建Dataprep图表时，可使用 输出到文件夹（Output to Folder） 操作重载此默认分布。）

   • 关卡名称（Level Name） 用于设置新建的关卡资产的名称，该关卡将用于保存你的场景。提交Dataprep图表的结果后，可添加子关卡将导入的场景添加到项目关卡中。

2. 初步导入 ：按工具栏中的 导入（Import） 按钮将源文件导入临时世界。

   您会看到，3D视口和其他预览面板在读取您的文件内容后，其显示内容会发生更新。这些读取内容尚未添加到项目中，只存在于Dataprep编辑器中的临时世界内。因此，在将最终结果保存到项目之前，您仍可以修改从输入文件中读取的资产和场景层级。

   此步骤在技术层面上是可选的，它的作用是让您在构建Dataprep图表时能更轻松地评估图表效果。

3. 构建Dataprep图表 ：从控制板中将 Select By 和 Operations 节点拖动到Dataprep图表编辑器中，并按执行顺序连接Action节点。见下文的 Dataprep图表 。

4. 测试图表 ：按工具栏中的 执行（Execute） 按钮，通过已构建的Dataprep图表运行从源文件中导入的数据。将看到预览面板更新并显示结果。

   你可以右键点击名称，并选择 禁用（Disable） 选项，从而禁用单个区块（block）或Action节点，以便进行调试。禁用的区块或动作会在图表中呈灰色状态。你可以通过再次打开菜单并点击 启用（Enable） 选项来启用它们。

5. 提交 ：根据从输入文件导入的3D数据制作图表，若效果令人满意，按工具栏中的 提交（Commit） 按钮完成导入流程。

   提交结果时，Visual Dataprep系统将 内容浏览器预览（Content Browser Preview） 中的资产保存到项目中的资产中。系统还将修改当前打开的关卡，添加 世界大纲视图预览（World Outliner Preview） 中显示的Actor的层级。

   若选择将Actor层级导入新关卡，在 设置（Settings） 面板中的 子关卡（Sub-Level） 设置中设置该关卡的名称。Visual Dataprep系统将用此名称新建一个关卡（若尚未存在），将Actor添加到该关卡，然后将该关卡添加为虚幻编辑器主窗口中当前已打开关卡的子关卡。

Dataprep图表

每个Dataprep资产的核心都是Dataprep图表：系统将对指定的任意一组输入文件执行的操作集合。

每个Dataprep图表都由名为 Action 节点的构建块（块的垂直堆栈）组成。例如，上面的图表包含三个Action节点。执行该Dataprep图表时，从左侧 Start 节点开始，然后从左到右依次执行各个Action节点。

每个Action节点都由包含一个或多个块的堆栈构成。Dataprep图表执行Action节点时，从上到下处理Action节点中的各个块。

Operations、Filters和Transform

在Dataprep中，Action节点有三种基本类型的块。

• 操作（Operations） 会按照某种预先定义的方式对资产或Actor执行修改。例如，上面所示的 Set Material 、 Compact Scene Graph 和 Set Simple Collision 块都是不同的操作类型。

  欲了解可在Dataprep图表中使用的所有不同操作，参见 Visual Dataprep操作参考 。

• 过滤器（Filters） ，也称 Select By 块，用于确定当前Action块中的操作应修改其下的哪些资产和Actor。任何Action步骤默认应用于根据输入文件构建的临时世界中包含的所有资产和Actor。可使用这些 Filter 块定义这些资产和Actor的子集，从而控制Actor节点将修改的对象。

  欲了解可在Dataprep图表中使用的所有不同过滤器，参见 Visual Dataprep选择参考 。

如需创建操作，可将左侧控制板中的块拖入图表编辑器，或者右键点击图表编辑器的背景，然后从情境控制板中选择块。

• 变换（Transforms） 的作用是调整当前资产和Actor的选中范围，而且其调整方式可能会很复杂。它们与过滤器非常类似。但是，过滤器块只能缩小传递给它的对象列表的范围。相反，变换块可将对象添加到当前的选择中。

  举例而言，您可能希望从场景层级中选择特定的对象树。为此，可使用过滤器块将整套场景元素缩减到少数特定父元素，然后使用变换块重新扩展选择范围，纳入所选元素的子项。

  欲知可用于扩展或修改操作中选定对象集的所有不同变换的细节，请参见 Visual Dataprep选择变换参考 。

Action示例

下图中的Action在CAD程序集部件上设置新材质。此节点执行一系列步骤，通过过滤器和操作的堆栈从上到下处理数据。

该操作中的所有块都执行完毕后，图表会执行下一个操作。等下个操作开始后，它会再次从临时世界中收集所有数据。所以之前放置的过滤器块都不会再被纳入考虑。但先前操作所做的场景更改会保留到下个操作中，例如更改材质、删除Actor等。

使用过滤器

所有过滤器块都提供一些额外选项，能让你在使用块操作资产和Actor时，更加轻松、精确地筛选出你所要的资产和资产列表，并验证过滤器是否符合预期效果。

要访问此类选项，请右键点击过滤器块，然后在情境菜单中查找 过滤器（Filter） 部分。

若要改变多个过滤器块，请按住 控制（Control） 键并左键点击所有块来完成选择。当所有要处理的块高亮显示后，右键点击任意高亮显示的块。

反转过滤逻辑

选择 过滤器（Filter）>反转过滤器选择（Inverse Filter(s) Selection） 来反转 选择依据（Select By） 块的选择逻辑，将其变成 排除依据（Exclude By） 块。执行此操作时，同一操作中的操作仅应用于 不 匹配所设条件的场景元素集合。

预览过滤器结果

选择 过滤器（Filter）>预览过滤器（Preview Filter(s)） ，使 内容浏览器预览（Content Browser Preview） 和 世界大纲视图预览（World Outliner Preview） 面板在过滤器选择的所有资产和Actor旁边显示一个勾选标记。