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

根据提供的曲线，将点数据中的每个点的密度重新映射到其他密度值。

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

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

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

使用几何体脚本函数测试点是否在标记的Actor的静态网格体中。

需要 程序化生成框架（PCG）几何体脚本交互操作（Procedural Generation Framework (PCG) Geometry Script Interop） 插件。

加载Alembic文件到PCG点数据。

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

使用 匹配和设置类型（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） 选项查看组件属性。

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

需要 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） ：折叠密度函数，意味着将数据转换为点数据。

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

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

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

它包含以下选项：

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

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

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

• 解析Actor组件（Parse Actor Components） ：根据Actor上的组件构建PCG数据。
• 获取单个点（Get Single Point） ：返回一个点数据，其中针对每个Actor包含一个点，带有其变换和本地边界。请注意，在大部分情况下，会在此节点后使用一个Merge或Union节点。
• Get Data from PCG Component ：返回另一个Actor的PCG执行的结果。请注意，只有传递到Output节点的数据会存储在PCG组件上，并且仅支持一些类型（点数据和属性集），将相应进行查询。PCG将确保在完成远程Actor的执行后继续执行。
• 从PCG组件获取数据或解析Actor组件（Get Data from PCG component or Parse Actor components） ：首先返回PCG输出（如果存在）。然后根据需要解析Actor。
• 预期引脚（Expected Pins） ：返回自定义输出节点引脚上的数据。

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

示例 ： 输入[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

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

它包含以下选项：

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

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

示例（Example） ：使用带有绝对旋转且旋转Z为0的Transform Points节点，将确保点在Z中向上指。这会确保点在从地形取样后向上。

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

密度函数（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。

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

静态网格体选项添加到网格体条目数组，并使用每个条目的 权重（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） ：在点上查找属性以选择类别，然后基于权重选择一个条目。