PrimFilter（图元过滤）

## **节点作用**
PrimFilter节点通常配合 PrimMerge 节点进行使用，通过 `tagAttr` 属性过滤出需要的 Prim 图元，`tagAttr `是一个 int 类型的属性。当然也可以使用自己定义的 int 类型的属性，prim 中的 `tagAttr `属性的值与 `tagValue` 的值相同的图元会被过滤出来。（method 目前只支持 verts）

## **节点样式**

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

## **端口用途**

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

| 端口名称 | 端口用途 |
| --- | --- |
| prim | 输入需要被过滤的图元，它必须包含一个int类型的属性。 |
| tagAttr | 输入用来过滤图元的 int 类型的属性的属性名称。 |
| revampAttrO |  |
| tagValue | 属性数值与tagValue数值相同的图元将会被过滤单独显示出来。 |
| isInversed | 若isInversed=0，则将过滤属性数值与tagValue数值相同的图元；若isInversed=1，则将过滤属性数值与tagValue数值不同的图元； |
| method | 当前只能使用verts，faces不可用。 |
| SRC | 影响解算先后顺序的端口。另一个节点A与该端口连接表示在执行本节点运算前先执行节点A。 |

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

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

## **案例演示**

[【附件】PrimFilter（图元过滤）.zip](/media/attachment/2022/06/PrimFilter%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4.zip)

1、新建CreateCube、CreateCone、CreatePlane节点，创建平面、正方体、圆锥体，并利用TransformPrimitive+NumericVec3节点将圆锥Cone向X轴偏移10个单位距离、将平面Plane向X轴偏移-10个单位距离。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_02.png)

2、利用MakeList+PrimMerge节点将平面、正方体、圆锥体合并成为一个图元。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_03.png)

3、在PrimMerge节点的tagAttr中为每一个图元都添加一个自定义属性，属性数值为0~n-1（n为合并前图元总个数）。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_04.png)

4、新建PrimFilter节点，将==PrimMerge==节点的`prim`与==PrimFilter==节点的`prim`进行相连，在==PrimFilter==节点的`tagAtter`中写入与==PrimMerge==节点的`tagAtter`相同的属性名称，这样就可以使得==PrimFilter==节点读取到自定义属性的数值。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_05.png)

5、通过在tagValue中输入0、1、2来对正方体、圆锥体、平面进行单独地过滤显示。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_06.png)

6、当前tagValue的数值为0，isInvesed的数值为1，则将除正方体以外其他图元进行的单独的显示。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_07.png)

7、当前method只能够选择verts。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_08.png)

8、这样再根据TransformPrimitive节点进行偏移操作的时候，就是对过滤后的平面+圆锥体进行操作了。

![](https://zenustech.oss-cn-beijing.aliyuncs.com/ch_NodeDocument/PrimFilter%EF%BC%88%E5%9B%BE%E5%85%83%E8%BF%87%E6%BB%A4%EF%BC%89/PrimFilter_09.png)