PrimMerge（合并图元）

## **节点作用**

将多边形列表中的全部多边形合并成为一个多边形。

## **节点样式**

![](/media/202307/merge_01_1690175478.png)

## **端口用途**

**Input【节点输入端口】（3个）**

| 端口名称 | 端口用途 |
| --- | --- |
| listPrim(图元列表) | 输入需要合并的基本体列表 |
| + Add Item | 添加合并端口。此接口可以将添加至listPrim的多边形物体自动添加端口。 |
| tagAttr | 添加标记属性，为空则不添加属性。 |
| SRC | 影响解算先后顺序的端口。另一个节点A与该端口连接表示在执行本节点运算前先执行节点A。 |

------------

**Output【节点输出端口】（2个）**

| 端口名称 | 端口用途 |
| --- | --- |
| prim | 输出合并后的图元物体。|
| DST | 影响解算先后顺序的端口。另一个节点A与该端口相连表示在本节点运算后执行节点A。 |

## **特征描述**
**·原地操作：**输入原语或列表对象不会就地修改，输入原语完全从头创建。

**·拓扑守恒：**输入的基本体的顶点、面将在合并后的基本体中依然保持连续，基本体的拓扑结构在其各自的连续范围内保持不变。

**·支持所有拓扑类型：**点、线、三角面、四边面都将合并，它们的属性也将也将保持不变。

**·属性保持不变：**输入基本体中的所有属性都将复制合并的基本体中。所有单个物体的属性都将整合到合并的、单个物体的属性中。默认情况下为0填充。

*填充数值0说明：a物体有10个顶点、b物体有20个顶点，合并后有30个顶点，这30个顶点上每个顶点都有clr、vel属性，原先顶点上有clr属性10的仍然保持10，合并后多出来的vel属性默认填充0。*

**·添加可选标记属性：**通常为空或指定的“tag”添加标记属性。如果tagAttr不是空字符串，则将使用int作为元素创建具有该名称的标记属性。指示其在primList中的索引，索引从0到n-1计数，其中n是primList的长度。此功能可以配合PrimMerge与PrimeUnmerge或PrimFilter一起工作，允许它在合并后找到基本体组件。标记属性将添加到两个顶点（both verts）、点（points）、线（lines）、三角形（tris）、四边形（quads）、多边形（polys）和循环（loops）。

## **案例演示**
**·** 自动创建合并端口。

![](/media/202307/primmerge_1690178707.gif)

------------

| <center>节点连接方式<center/> | <center>返回结果<center/> |
| --- | --- |
|  <center><img src="/media/202307/2023-07-24_132328_967472.png"  width="600" /></center>  | <center class="half"><img src="/media/202307/2023-07-24_132435_131821.png" width="750"/></center> |

------------

*假设图元1有三个点a、b、c，图元2有四个点d、e、f、g，图元3有两个点h、i，利用PrimMerge节点将三个图元结合成为一个图元，并在`tagAttr`中写入tag属性，那么在PrimMerge节点运算后，合并后图元的每一个点都将拥有“tag”属性，图元1的三个点的tag属性数值均为0，图元2的三个点的tag属性数值均为1，图元3的三个点的tag属性数值均为2，这样可以方便后面配合PrimFilter节点进行单个图元的查看。*

| <center>节点连接方式<center/> | <center>返回结果<center/> |
| --- | --- |
|  <center><img src="/media/202307/merge_03_1690183148.png"  width="285" /></center>  | <center class="half"><img src="/media/202307/merge_02_1690183213.png" width="750"/></center> |

------------

## **相关节点**

[PrimFilter（图元过滤）](http://doc.zenustech.com/project-5/doc-45/)