程序化内容生成框架节点参考

基于布尔属性选择两个输入之一以转至单个输出。这用于控制图表中的执行流程，以便根据特定情况（某个事项是否存在、运行的平台等等）执行图表的一些不同部分。

根据提供的曲线将点数据中每个点的密度重新映射到其他密度值。这可以用于吻合一些情况下的密度，获得更合适的梯度，或在下游执行更复杂的处理。由于这依赖单独的数据对象，因此更容易从PCG外部更改。

最终密度 = 曲线重新映射(输入密度)

将线性变换应用于点密度。这可以选择设置为不影响输入范围之外的值。

D' = (Out_Max - Out_Min) * (D - In_min) / (In_max - In_min) + Out_Min

基于密度和提供的筛选器范围筛选点。

取所有输入，生成保存所有输入数据的单个集合。主要用于整理。

包含序列执行的 仅依赖项（Dependency Only） 引脚，用于它很重要的情况（例如，World Ray Hit Query与给定图表中生成的内容）。请注意，并非提供给此引脚的所有数据都会传递到输出。

将Alembic文件加载到PCG点数据中。此节点用于导入Alembic文件并将其处理为点数据格式。虽然Alembic文件中不仅仅包含点，但此节点当前不支持其他类型。此节点不应该在正在迭代的图表中运行。请改用EUW来执行此转换，并将Alembic存储到PCG资产一次，以便提高效率。

需要 程序化内容生成（PCG）外部数据交互操作（Procedural Content Generation (PCG) External Data Interop） 插件。

在提供的属性集表（匹配数据）中选择一个条目，并将其值复制到输入数据（点数据或属性集）。这会取代Point Match and Set节点。

选择通过将输入数据（输入属性）上的属性（匹配属性）与匹配数据（匹配属性）上的属性相匹配来驱动，以便在其值一致时仅从匹配数据中的条目复制值。

数据不匹配属性时，匹配数据中的所有条目都会被视为有效匹配项。此外，还有一个选项可保留或丢弃不匹配"匹配数据"中的任何内容的条目。

在匹配数据中有多个潜在匹配项的情况下，可以对其加权（匹配权重属性），或随机选择一个。可以使用"使用输入权重属性（Use Input Weight Attribute）"和"输入权重属性（Input Weight Attribute）"字段，将输入数据中的某个[0 - 1]值关联到匹配数据中的规格化权重。这允许从之前计算的空间噪点驱动随机选择。

最后，匹配属性时，如果没有相等值，可以按照最接近的值进行匹配。还可以有一个进行匹配的最大距离阈值，但这仅限于有合理距离指标的连续值类型。

匹配运算期间使用的属性不会被传播到输出数据，因此匹配数据中的匹配属性和/或权重属性不会被复制到输出。

此节点非常灵活，可将数据注入点和属性集，并允许按其匹配值的能力构建复杂的数据集。它是数据驱动型图表的基石，这些图表中的一个节点可以加载一系列数据表或数据资产，然后在单个操作中轻松将恰当的数据复制到点。

使用 匹配和设置类型（Match And Set Type） 选项，基于选择标准查找每个点的匹配项，然后将值应用于属性。

一种常见用例是在带有 By Attribute 选择器的 Static Mesh Spawner 节点中选择要在下游使用的网格体。

计算小数数学运算的值。取一个输入值，返回该值的小数部分。

例如，对于输入值X，结果是X减去X的向下取整值。输出值的范围从0到1，含0，不含1。

计算"符号"数学运算的值，并将结果写入属性。对一个输入值求值，指示它是正数、负数还是刚好为零。

• 如果输入为负数，此节点输出-1。
• 如果输入刚好为0，此节点输出0。
• 如果输入为正数，此节点输出1。

从保存PCG组件的Actor（或对象层级中更高的地方）检索属性的内容。

默认情况下，它会查看Actor级别的属性（适合蓝图变量），但也可以使用 选择组件（Select Component） 选项查看组件属性。

此属性可以保存"扁平"结构体（例如没有数组的结构体），或成为有效支持类型的数组。对于数组的情况，输出将是带有多个条目的属性集。

此节点很适合用于从世界中的Actor（自身或其他方式）检索数据，允许使用与Get Actor Data相同的接口在图表中按实例进行控制。举例来说，这可以保存一系列静态网格体以生成材质，等等。

使用基本随机规则更改点变换（就地更改，或通过 应用于属性（Apply to Attribute） 更改为属性）。 变换的每个组件（平移、旋转、缩放）可以设置为绝对而不是相对，以允许更多控制。

它包含以下选项：

统一缩放（Uniform Scale） ：将点数据缩放到相同的X、Y、Z比率。

重新计算种子（Recompute Seed） ：强制点种子根据新世界位置进行更新。

示例（Example） ：使用绝对旋转和旋转Z为0的Transform Points节点，将确保点在Z轴上半部。这可确保点在从地形取样后向上。

此节点适合用于通过控制输入点数据来生成空间变体。它是生成看起来自然的数据的图表的主要部分。

对指定静态网格体上的点取样。请注意，此运算开销高昂。

需要 PCG几何体脚本交互操作（PCG Geometry Script Interop） 插件和 几何体脚本（Geometry Script） 插件。

使用样条线作为源材质，对点取样。在样条线上取样是指直接在样条线曲线上，而 水平（Horizontal） 、 垂直（Vertical） 和 体积（Volume） 选项在样条线体积（由Y/Z轴中的控制点的半径驱动）上取样。

在样条线内取样需要样条线是闭合的。

在常规网格模式中，对表面数据上的点取样。此节点包含以下选项：

• 点范围（Point Extents） ：定义表面上的基本网格单元大小。
• 松散度（Looseness） ：定义允许变化的单元大小。在实践中，单元大小是点范围 * (1 + 松散度)。
• 每平方米点数（Points Per Square Meter） ：计算保留的单元的比率。此属性可在网格很大时避免过度拥挤。

根据输入点数据创建样条线。包含创建以下内容的选项：

• 创建组件或仅创建数据
• 闭合或线性样条线
• 根据属性名称应用自定义输入和输出切线

根据 闭合 样条线创建隐式表面。之后此表面可以像其他表面一样用于表面取样器、差集、交集等。

针对差值的并集输出每个源的差值的结果。 此节点有以下选项：

密度函数（Density Function） ：控制在运算完成后使用哪个密度函数。包含以下选项：

• 最小值（Minimum） ：最终密度等于源的密度减去所有差值的最大密度。
• 受限制的减法（Clamped Subtraction） ：最终密度等于源的密度减去所有差值的密度总和。此值限制在0到1之间。
• 二元（Binary） ：如果密度差值大于0，最终密度等于0。否则，最终密度等于源的密度。

模式（Mode） ：控制存在具体空间数据与连续数据时的差值行为（其他类型，更接近分布函数）。请注意，在我们需要选择具体元素的一些情况下，这应该设置为"离散（Discrete）"，否则生成的密度函数无法为扁平。包含以下选项：

• 推断（Inferred） ：源或差值为点则为离散，否则为连续。
• 连续（Continuous） ：不折叠密度函数。
• 离散（Discrete） ：折叠密度函数，意味着将数据转换为点数据。

Get … Data节点的通用版本。 使用Actor筛选器和模式从Actor读取数据。

它包含以下选项：

Actor筛选器（Actor Filter） ：确定在获取Actor数据时要考虑哪些Actor。

包含子项（Include Children） ：确定是否考虑输入的子Actor。

模式（Mode） ：包含以下选项：

• 解析Actor组件（Parse Actor Components） ：根据Actor上的组件构建PCG数据。
• 获取单个点（Get Single Point） ：返回一个点数据，其中针对每个Actor包含一个点，带有其变换和本地边界。可根据需要使用MergeSinglePointData选项。
• Get Data from PCG Component ：返回另一个Actor的PCG执行的结果。请注意，只有传递到Output节点的数据会存储在PCG组件上，并且仅支持一些类型（点数据和属性集），将相应进行查询。PCG将确保在完成远程Actor的执行后继续执行。请注意，它需要数据已经生成（或当前正在生成），并且不能位于它执行的组件所在的相同Actor上。
• 从PCG组件获取数据或解析Actor组件（Get Data from PCG component or Parse Actor components） ：首先返回PCG输出（如果存在）。然后根据需要解析Actor。

获取PCG数据时的额外选项：

• 预期引脚（Expected Pins） ：如果你获取PCG数据，还可以提供匹配生成该数据的PCG图表的输出节点的预期引脚列表。
• 获取所有网格上的数据（Get Data On All Grids） ：从目标组件上的每个网格大小获取数据。
• • 允许的网格（Allowed Grids） ：如果不使用"获取所有网格上的数据（Get Data On All Grids）"，选择可以从中提取数据的一组网格大小。
• • 组件必须自重叠（Components Must Overlap Self） ：仅从与源组件边界重叠的组件获取数据。这是可选的优化，可避免获取可能与你的组件不相关的数据。

此节点是从PCG访问数据的最常见方式，尤其是在根图表中。

计算提供给节点的所有数据之间的内相交，而不管其引脚。

示例 ： 输入[A, B, C]

结果 ： A ∩ B ∩ C

计算 主源（Primary Source） 引脚中提供的每个数据的外相交，其中结果是主源引脚上每个数据针对其他每个 源（Source） 引脚上的数据并集的一个相交。

示例 ： 主源1包含[A, B] 源1包含[C, D] 源2包含[E]。

结果 ： A ∩ (C ∪ D) ∩ E, B ∩ (C ∪ D) ∩ E

从分布函数角度，创建数据之间的逻辑并集。结果依赖于所选密度函数选项。

密度函数（Density Function） ：控制在运算完成后使用哪个密度函数。包含以下选项：

• 最大值（Maximum） ：最终密度等于源的最大密度。
• 受限制的加法（Clamped Addition） ：最终密度等于所有差值中的密度总和。此值限制在0到1之间。
• 二元（Binary） ：如果源的任何密度大于0，最终密度等于1。请注意，这基本上只在二元差值的情况下有用。

创建类似表面的数据，在物理世界中执行光线投射。它可以将数据传递到预期表面数据的节点。

默认情况下，光线的大小和方向由源组件的Actor属性（很可能是体积）驱动，但光线属性可以覆盖。 它包含以下选项：

应用地形中的元数据（Apply Metadata From Landscape） ：光线投射击中地形时，获取地形层值。请注意，这会带来较小的性能开销。

忽略PCG击中（Ignore PCG Hits） ：忽略PCG生成的所有资产。相较于在世界中创建数据的其他节点（或其他图表），没有强制实施顺序时很有用。

可以选择返回物理材质和Actor击中。

筛选元素用于精细控制，仅忽略或保留部分击中。

创建类似体积的数据，从物理世界收集点。它可以将数据传递到预期表面数据的节点。

"搜索重叠"检查控制是将重叠作为点范围，还是仅返回不与任何内容重叠的查询（受筛选影响）。

还可以选择返回在该体积中"找到"的Actor。

生成Actor的内容，或提供的输入数据中每个点的Actor的内容。根据设置，Actor由模板Actor类、实例化模板Actor或属性驱动。

它包含以下选项：

模板Actor类（Template Actor Class） ：项目中可用Actor的列表。

选项（Option） ：

• 折叠Actor（Collapse Actors） ：收集一些Actor组件（静态网格体组件和PCG组件）以及目标Actor中折叠的Actor。
• 仅合并PCG（Merge PCG only） ：生成的Actor有PCG组件时，每个点生成一个Actor，其输入捆绑为单个图表执行。
• 无合并（No Merging） ：每个点生成一个Actor。

在无合并情况下，可以通过"生成的Actor特性重载说明（Spawned Actor Property Override Descriptions）"将特性设置为点上的属性中的Actor。

附加（Attach） 模式：

• 未附加（Not attached） ：原始Actor（PCG组件的所有者）与创建的Actor之间不会存在引擎感知的关系。
• 已附加（Attached） ：创建的目标Actor将作为子项附加到拥有PCG组件的Actor上。请注意，这会影响启用世界分区的地图中上述创建的Actor的流送，例如，此Actor将随父项一起流送进来。
• 在文件夹中（In Folder） ：不会存在引擎感知的关系，但Actor将放置在根据拥有PCG组件的Actor命名的文件夹中，以更轻松地在场景大纲视图中可视化。不会影响流送。

此节点可以用于创建类似分区的Actor，并在可以在播放时恰当流送进来的Actor上收集构件（视觉和其他方面）。

在提供的点数据中每个点生成一个静态网格体。

静态网格体选项添加到网格体条目数组，并使用每个条目的 权重（Weight） 选择。具体做法是取所有权重值的总和，将其转换为每个条目的百分比。例如，如果数组中有四个条目，每个条目的值为1，则总和的值为4。每个条目的权重会除以总和，转换为百分比。这意味着每个条目有25%的机会生成。

静态网格体的选择是基于所选 网格体选择器类型（Mesh Selector Type） 选项使用变体完成的。

它包含以下选项：

• PCG网格体选择器加权（PCG Mesh Selector Weighted） ：基于条目的总权重选择一个条目。
• PCG网格体选择器（按属性）（PCG Mesh Selector By Attribute） ：基于网格体上存在的属性选择一个条目。
• PCG网格体选择器加权（按类别）（PCG Mesh Selector Weighted By Category） ：在点上查找属性以选择类别，然后基于权重选择一个条目。

选定网格体将被写入输出点数据上的属性，而且选定网格体的边界将被推送到点边界。

对于创建的每个网格体特性重载，可以在将生成它时选择一个属性，以应用于ISM的模板描述符上的特性目标。