Visual Dataprep概述

Visual Dataprep系统的工作原理以及UI用法。

Windows
MacOS
Linux

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

启用Visual Dataprep

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

  • DataPrep编辑器

  • Datasmith导入器

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

若从 建筑、工程和施工(Architecture, Engineering, and Construction)汽车、产品设计和制造(Automotive, Product Design, and Manufacturing) 类别中的模板启动了项目,可能这些插件已启用。

Visual Dataprep资产

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

要创建新Dataprep资产,在内容浏览器中右键单击,从上下文菜单中选择 Dataprep > Dataprep资产(Dataprep Asset)

Create a Dataprep Asset

Dataprep编辑器UI

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

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

编号

名称

说明

1

工具栏(Toolbar)

Dataprep工作流中最重要用户操作的快捷方式,包括 导入(Import)执行(Execute)提交(Commit) 操作。

2

内容浏览器预览(Content Browser Preview)

列示已从输入文件中导入的所有资产。这是 提交 图表时,Visual Dataprep系统将在 内容浏览器 中创建的资产的预览。

3

视口预览(Viewport Preview)

显示已从输入文件中导入的3D场景的视觉预览。

4

世界大纲视图预览(World Outliner Preview)

列示已从输入文件中导入的3D场景中的所有Actor。这是Visual Dataprep系统将在关卡中创建的Actor以及将在关卡的 世界大纲视图(World Outliner) 中创建的场景层级的预览。

5

设置面板(Settings Panel)

使用此面板指定要从中导入3D场景的输入文件,以及在项目的 内容浏览器 中将资产创建在何处。

若您在Dataprep图表中公开了参数,以便在Dataprep的资产 实例 中重载,则您还将在 参数化(Parameterization) 分段中看到此处列出的参数。欲知细节,请参见使用Dataprep实例

6

控制板(Palette)

提供可拖动到Dataprep图表编辑器中的构建模块,用于构建导入方式。

7

Dataprep图表编辑器(Dataprep Graph Editor)

可在其中制备Dataprep方法,并让Dataprep系统从左到右执行方法的步骤,以制作输入内容,在虚幻引擎中实现实时可视化。

8

细节面板(Details Panel)

类似于主关卡编辑器的 细节(Details) 面板,显示 世界大纲视图预览(World Outliner Preview) 中已选定的任何Actor的相关信息。请注意,这些设置只读。这些设置仅供参考,便于评估Dataprep图表对Actor的效果。

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 ByOperations 节点拖动到Dataprep图表编辑器中,并按执行顺序连接Action节点。见下文的Dataprep图表

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

  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节点。

与蓝图图表不同的是,蓝图图表允许条件分支,而Dataprep图表始终按照从左到右的单一线性方式执行逻辑。此外,彼此相连的Action节点并不会传递数据流。所有Action节点都使用相同的上下文:从指定输入文件导入的一组资产和Actor。

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

Operations、Filters和Transform

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

  • 操作(Operations) 会按照某种预先定义的方式对资产或Actor执行修改。例如,上面所示的 Set MaterialCompact Scene GraphSet 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程序集部件上设置新材质。此节点执行一系列步骤,通过过滤器和操作的堆栈从上到下处理数据。

Sample Action node

步骤编号

名称

块类型

说明

1

输入引脚

N/A

所有Action的所有数据都是从临时世界获取的,包括在导入文件中找到的所有资产和Actor,然后Action会将这些对象传递给位于堆栈顶部的块。

2

按标签过滤

过滤器

此过滤器仅保留拥有"Metal"标签的Actor,并将此Actor列表传递给下一个块。

3

按Actor标签过滤

过滤器

此过滤器仅保留名称包含"Mechanical"的Actor,并传递给下一个块。

4

设置简单碰撞

运算

此运算会找到上方过滤器传递的所有Actor,然后找到这些Actor引用的所有静态网格体资产并为其设置立方体碰撞。然后将Actor列表传递给下一个块。

5

设置材质

运算

最后一个运算,它会找到上方过滤器传递的所有Actor,然后找到这些Actor的所有静态网格体组件的所有材质,并将这些材质替换成块的 材质(Material) 设置中指定的材质。

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

使用过滤器

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

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

过滤器操作子菜单

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

反转过滤逻辑

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

预览过滤器结果

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

所选过滤器匹配对象的预览

一次只能预览一个过滤器或一组选定的过滤器。若您开始预览其它过滤器或其它一组过滤器,则当前过滤器会停止预览。

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback