Visual Dataprep操作参考

详细介绍可应用于Visual Dataprep系统中选定场景元素的操作。

Windows
MacOS
Linux

本页介绍可在Visual Dataprep系统中修改资源和场景元素的各个 操作(Operations) 块。

每种类型的 操作块(Operations block) 都封装了虚幻编辑器可对3D数据执行的一种特定修改。Visual Dataprep系统在Dataprep图表中执行各项作业时,会对所有匹配 Select By 块所设定条件的资源或Actor执行该项作业中已定义的各个操作。更多背景信息请参见Visual Dataprep概述

On Actor

On Actor 操作仅应用于与相关步骤所设的 Select By 条件匹配的Actor。这表示仅可看到Dataprep预览UI右侧 世界大纲视图预览(World Outliner Preview) 面板中列示的项目。若 Select By 条件匹配其他场景元素,比如Dataprep预览UI左侧 内容浏览器预览(Content Browser Preview) 面板中列示的纹理、材质和静态网格体资源,则 On Actor 操作对这些元素无效。

添加标签

此操作会将你指定的标签数组添加给所有些符合此步骤中 选择依据(Select By) 条件的Actor。

添加标签

完成该块后,在 世界大纲视图预览(World Outliner Preview) 中选择Actor,在 细节(Details) 面板中查找,可找到标签列表。在 Actor 类别下,展开高级选项,然后查找 标签(Tags) 设置。

添加后的Actor标签

紧凑场景图表

对于每个与此步骤所设的 Select By 条件匹配的静态网格体Actor,若该Actor在场景中无任何视觉效果,或其在场景层级中的所有后代在场景中都无任何视觉效果,则此操作会删除该Actor。效果是汰除场景层级中的不必要元素,而不影响场景中的视觉对象。

Compact Scene Graph

创建代理模型

此操作从所有与此步骤所设的 Select By 条件匹配的静态网格体Actor中采集几何体,并使用代理几何体工具 将几何体合并到新网格体中。

Create Proxy Mesh

设置

说明

新Actor标签(New Actor Label)

指定根据合并几何体创建的新Actor的名称。

质量(Quality)

已生成的代理模型的几何体质量水平。值越小,详细程度越低,但渲染效率会变高。值越大,详细程度越高,越贴近原始几何体,但渲染效率会降低。

合并

此操作会找出所有符合 Select By 条件的静态网格体Actor并获取它们的几何体,然后将这些几何体合并到一个新的网格体中。

Merge

设置

说明

新Actor标签(New Actor Label)

指定根据合并几何体创建的新Actor的名称。

以零为枢轴点(Pivot Point at Zero)

若要合并网格体,以将其枢轴点设为世界原点,可启用此设置。若禁用,枢轴将位于第一个合并的组件上。

随机偏移变换

此操作会对所有符合此步骤中设置的 选择依据(Select By) 条件的Actor的3D位置、旋转或缩放应用随机偏移效果。若场景中存在一些临时放置的元素,则可使用此操作将这些元素分散开来,或为元素设定不同的大小和旋转度。

举例而言,室外建筑场景可能包含一些临时放置的对象,用于表示树木或灌木丛等建筑配景对象。在Dataprep图表中,您可能需要将全部这类临时对象替换为已经导入到项目中的其他自定义3D资产。但这样可能生成一排外观完全相同的树木,会显得不够真实。通过对树木的位置、旋转度和缩放应用随机偏移,可快速创建更多样化和逼真的结果,而无需手动调整对象。

随机偏移变换

设置

说明

变换类型(Transform Type)

每个 随机偏移变换(Random Offset Transform) 块只能将偏移应用于下述其中一种属性:

  • 位置(Location),用于调整对象在3D空间中的位置。

  • 旋转(Rotation),用于调整对象的朝向。

  • 缩放(Scale),用于调整对象的大小。

参考系(Reference Frame)

确定使用哪个参考系解释 最小值(Min)最大值(Max) 设置中的轴:

  • 全局(Global) 使用世界空间来解释 最小值(Min)最大值(Max),偏移效果相对的是全局空间中的3D轴。

  • 相对(Relative) 使用局部空间来解释 最小值(Min)最大值(Max),偏移效果相对的是对象自身的枢轴点。

最小值(Min)最大值(Max)

沿3D空间的三个轴分别设置随机偏移范围。针对此块处理的每个Actor,其将生成一个处于 最小值(Min)最大值(Max) 之间的随机数字。

替换资产引用

此块将识别传入对象列表中的 第一个 资产。然后,尝试将输入列表中 其他 资产的所有引用替换为第一个资产的引用。

举例而言,假设输入列表中的第一个对象是名为 椅子 的静态网格体资产。该块将浏览输入列表中的所有其他对象,以查找其他静态网格体资产,例如 桌子长凳梳妆台。然后,将在导入场景中找到的所有 桌子长凳梳妆台 引用替换为 椅子 引用, 完全删除 桌子长凳梳妆台 资产。

替换资产引用

设置网格体

对于每个与此步骤所设的 Select By 条件匹配的静态网格体Actor,此操作将该Actor引用的所有静态网格体资源更改为你在设置中指定的不同静态网格体资源。

Set Mesh

设置

说明

静态网格体(Static Mesh)

要让Actor实例化的静态网格体资源,用以替代现有静态网格体。可以使用Dataprep编辑器的 内容浏览器预览(Content Browser Preview) 面板中的任何静态网格体替代,也可以使用项目中现存的任何静态网格体资源。

此操作对尚未引用静态网格体资源的Actor无效。例如,若场景层级中有一个不含静态网格体的空Actor,则将无法使用此操作向该Actor添加新静态网格体。

设置元数据

此操作会找到所有符合此步骤中的 选择依据(Select By) 条件的Actor,然后为其Datasmith元数据添加一个键值对数组。

设置元数据

执行完该块后,您可以在 世界大纲视图预览(World Outliner Preview) 中选中Actor,然后在 资产用户数据(Asset User Data) 类别的 细节(Details) 面板中找到元数据列表。

欲知更多信息,请参见使用Datasmith元数据

设置移动性

对于每个与此步骤所设的 Select By 条件匹配的Actor,此操作会设置该Actor的 移动性(Mobility) 的值。

移动性(Mobility) 设置对光源Actor的影响与对静态网格体Actor的影响略有不同。欲了解详细解释,参见Actor移动性

Set Mobility

设置

说明

移动性类型(Mobility Type)

要为Actor的 移动性(Mobility) 设置的值。

详细信息(Details) 面板中找到 移动性(Mobility) 设置:

Actor Mobility

在位置处生成Actor

针对每个符合此步骤所设的 选择依据(Select By) 条件的Actor,此操作会在相同的3D坐标处生成新Actor。新生成的Actor是您在 选定资产(Selected Asset) 设置中指定的资产的实例。

在位置处生成Actor

设置

说明

选定资产(Selected Asset)

要生成新实例的项目中的资产。

On Asset

On Asset 操作仅应用于那些符合您在相关步骤中所设置的 选择依据(Select By) 条件的资产。这表示仅可看到Dataprep预览UI左侧的 内容浏览器预览(Content Browser Preview) 面板中列出的项目。若 选择依据(Select By) 条件匹配其他场景元素,比如Dataprep预览UI右侧的 世界大纲视图预览(World Outliner Preview) 面板中列出的Actor,则 On Asset 操作对这些元素无效。

输出到文件夹

此操作会找到所有符合您在此步骤中所设的 选择依据(Select By) 条件的资产,然后将其移动到拥有指定名称的子文件夹中。提交Dataprep图表的结果后,您可以使用此块来自定义导入资产在项目内容浏览器中的组织方式。

执行Dataprep图表时,输出到文件夹(Output to Folder) 块的结果不会显示在Dataprep编辑器的 内容浏览器预览(Content Browser Preview) 面板中。提交Dataprep图表后,仅能在项目的 内容浏览器(Content Browser) 中看到结果。

输出到文件夹

设置

说明

文件夹名称(Folder Name)

提交Dataprep图表时,要放置所选资产的子文件夹的名称。

您可在Dataprep图表中使用任意数量的 输出到文件夹(Output to Folder) 块。若不同的块使用了相同的 文件夹名称(Folder Name) 设置,则由这些块处理的资产会被收集到同一个文件夹中。这样就能将不同操作中由不同过滤器产生的资产重定向到内容浏览器(Content Browser)中的同一文件夹中。通过将多个 输出到文件夹(Output to Folder) 块与不同的过滤器配对使用,您就能按照您的想法,在 内容浏览器(Content Browser) 中以任意方式组织资产。

举例而言,在这个例子中,在Dataprep编辑器右上角的设置面板中,设置的主文件夹为 /Content/Motorbike。此图表中的第一个操作将获取三角形少于1000个的所有静态网格体资产,并将其移动到名为 LowPoly 的子文件夹中。第二个操作将获取三角形多于1000个的所有其他静态网格体,并将其移至名为 HighPoly 的子文件夹中。最后两个操作将获取所有材质和所有材质实例,并将其移动到名为 表面(Surfaces) 的子文件夹中。

输出到文件夹范例图表

提交Dataprep图表后,内容浏览器(Content Browser)将出现以下目录结构:

输出到文件夹范例结果

那些在Datasmith默认导入过程中创建的 几何体(Geometries)材质(Materials) 子文件夹仍会被创建,但在这种情况下,这些子文件夹将是空的。所有资产均已重新分配到新的 HighPolyLowPolySurfaces 子文件夹中。

On Mesh

On Mesh 操作仅应用于静态网格体资源。

  • Select By 条件与 内容浏览器预览(Content Browser Preview) 面板中 几何体(Geometries) 文件夹下列示的任何静态网格体资源匹配,此操作将应用于这些资源。

  • Select By 条件与 世界大纲视图预览(World Outliner Preview) 中任何引用静态网格体资源的Actor匹配,此操作还将应用于这些静态网格体资源。

  • Select By 条件与任何其他类型的场景元素匹配,比如Actor、纹理或材质,则 On Mesh 操作对这些元素无效。

Datasmith曲面细分

对于每个与此步骤所设的 Select By 条件匹配的静态网格体,若该网格体最初是从参数化曲面细分出来的,则此操作将用新设置对该网格体几何体重新进行曲面细分。

Datasmith Tessellation

设置

说明

弦公差(Chord Tolerance)

已生成的任意三角形和原始曲面之间的最大距离。

最大边长(Max Edge Length)

已生成的三角形中任意边的最大长度。

法线公差(Normal Tolerance)

相邻三角形之间的最大角度。

通常值越小,创建的三角形越多。有关这些参数的详细解释,参见结合使用Datasmith与CAD文件格式

翻转面

此操作会找到所有符合此步骤中 选择依据(Select By) 条件的静态网格体,并翻转网格体中所有三角形的朝向。

翻转面

该块有助于翻转在源应用程序中创建的网格体的朝向。这些应用程序在后向三角形可视性的规定上通常有所不同。但请注意,该操作并不具有选择性: 所有 三角形的朝向都将翻转。如果静态网格体中的三角形在朝向上有些不一致,有些可见,有些不可见,则您可能还需做一些其他更改,例如在静态网格体编辑器中手动翻转面,或使用已启用 双面(Two Sided) 选项的材质。

生成展开的UV

对于任何与此步骤所设的 Select By 条件匹配的静态网格体,此操作将网格体几何体展开成2D UV贴图并将该贴图保存到静态网格体资源的指定UV通道中。

Generate Unwrapped UVs

设置

说明

通道选择(Channel Selection)

确定生成的UV贴图保存到哪个UV通道。第一个空通道(First Empty Channel) 将展开的UV保存在第一个空UV通道。指定通道(Specify Channel) 将展开的UV保存在 UV通道(UV Channel) 设置所标识的通道内。

UV通道(UV Channel)

通道选择(Channel Selection) 设为 指定通道(Specify Channel) 时,使用此设置确定展开的UV保存到的UV通道的索引。

角度阈值(Angle Threshold)

确定两个相邻面在展开之后仍保持连接时的最大角度。增大此值会减少单独UV"岛状区"的数量,使更多相邻三角形保持连接,并减少会导致纹理贴图断开的接缝数量。但由于三角形可能需要在2D空间中更积极地调整大小,以保持与相邻三角形的连接,因此这也会导致展开的纹理更加失真。

设置凸包碰撞

对于每个与此步骤所设的 Select By 条件匹配的静态网格体,此操作将静态网格体的碰撞替换为由多个体积或 凸包 组成的新凸包分解。

Set Convex Collision

设置

说明

凸包数量(Hull Count)

要创建的凸包体积的最大数量。

凸包最大顶点数(Max Hull Verts)

任何已生成的凸包顶点最大数量。

凸包精确度(Hull Precision)

生成碰撞体积时要使用的体素数量。

设置LOD组

对于每个与此步骤所设的 Select By 条件匹配的静态网格体,此操作将该静态网格体的现有LOD替换为指定组的设置所设的新LOD。

这些LOD组与在静态网格体编辑器UI中启用自动LOD生成时可设置的LOD组相同。详情请查件设置自动LOD生成

Set LOD Group

设置

说明

LOGGroupName

LOD组的名称,该组定义此静态网格体要使用的设置。

设置LOD

对于每个与此步骤所设的 Select By 条件匹配的静态网格体,此操作将该静态网格体的现有LOD替换为指定降低设置所设的新LOD。

这些降低设置与在静态网格体编辑器UI中启用自动LOD生成时可设置的降低设置相同。详情参见设置自动LOD生成

Set LODs

设置

说明

自动调整屏幕大小(Auto Screen Size)

启用后,自动计算LOD切换时的屏幕大小。

降低设置(Reduction Settings)

一组降低设置,定义要创建的详细层级的数量,以及每个详细层级应包含的三角形百分比。

设置简单碰撞

对于每个与此步骤所设的 Select By 条件匹配的静态网格体,此操作将该静态网格体的现有碰撞替换为指定形状的简单碰撞体积。

Set Simple Collision

设置

说明

形状类型(Shape Type)

定义静态网格体要设置的碰撞体积的形状。

设置静态光照

对于每个与此步骤所设的 Select By 条件匹配的静态网格体,此操作设置各个选项,以控制静态网格体与烘焙照明的交互方式。

Setup Static Lighting

设置

说明

启用光照贴图UV生成(Enable Lightmap UV Generation)

启用后,操作生成静态网格体的光照贴图UV。

分辨率理想比率(Resolution Ideal Ratio)

静态网格几何体比例与用于静态网格体的光照贴图分辨率之间的比率。此值越低,光照贴图分辨率越高;这会提高烘焙照明的质量,但会增加内存需求。

On Object

On Object 操作应用于与 Select By 条件匹配的所有类型的场景元素。

删除对象

此操作删除所有与此步骤所设的 Select By 条件匹配的对象。

Delete Objects

删除未使用的资源

此操作删除所有与此步骤所设的 Select By 条件匹配的资源,以及所有未被其他资源或Actor引用的资源。

Delete Unused Assets

设置材质

对于每个与此步骤所设的 Select By 条件匹配的静态网格体或静态网格体Actor,此操作将所有现有材质替换为指定材质。

Set Material

设置

说明

材质(Material)

要用作所有现有材质替代品的材质。

替代材质

对于每个与此步骤所设的 Select By 条件匹配的静态网格体或静态网格体Actor,此操作将所有匹配条件的材质替换为指定替代材质。

Substitute Material

设置

说明

材质搜索(Material Search)

要替换的材质的名称或部分名称。

字符串匹配(String Match)

定义要在 Material Search 字符串上执行的匹配类型。这些选项的作用与 Select By 块中使用字符串过滤器相同。详情参见Visual Dataprep选择参考

材质替代(Material Substitute)

要作用代替品的材质,用于替代满足上述条件的材质。

按表格替代材质

对于每个与此步骤所设的 Select By 条件匹配的静态网格体或静态网格体Actor,此操作会根据数据表资源中提供的替代品表替换材质。

Substitute Material By Table

设置

说明

材质数据表(Material Data Table)

确定材质及其替代材质的数据表资源。

材质数据表(Material Data Table) 设置中提供的数据表必须使用 MaterialSubstitutionDataTable 的行结构。此行格式需要在创建数据表资源时在 选择行结构(Pick Row Structure) 对话框中设置。例如:

Select the MaterialSubstitutionDataTable Row Structure

在此行结构下,数据表中的每一行都会定义一种材质替换操作,会在每一个静态网格体Actor或资源上执行。

  • 行中的第一个值,行名称(Row Name),表示替代品名称。可自由设置此值。

  • 第二个值,搜索字符串(Search String),是要在此操作中被替换的材质的名称或部分名称。

  • 第三个值,字符串匹配(String Match),表示要在静态网格体资源和Actor中的材质与在该行第二个值中设置的搜索字符串之间比较的字符串类型。凡 Substitute Material 操作接受的值均可使用:Exact MatchContainsMatches Wildcard。这些选项的作用与 Select By 块中使用字符串过滤器相同。详情参见Visual Dataprep选择参考

  • 第四个值,材质替代品(Material Replacement),是材质资源替代品的全名,用于替换所有与搜索字符串匹配的材质。

    内容浏览器 中右键单击材质,从上下文菜单中选择 复制引用(Copy Reference),即可获取此值。

例如:

Select Skin
Light
Dark

欢迎来到全新虚幻引擎4文档站!

我们正在努力开发新功能,包括反馈系统,以便您能对我们的工作作出评价。但它目前还未正式上线。如果您对此页面有任何意见与在使用中遭遇任何问题,请前往文档反馈论坛告知我们。

新系统上线运行后,我们会及时通知您的。

发表反馈意见