PrimSample2D(2D采样)

## **节点作用**

2D对应图片路径。该节点可以根据物体的UV属性数值去采样图片上相对应vec3数据，并将数据存储到多边形的targetChannel指定的属性中。(一般存储于clr属性中。)

## **节点算法**

$$x = \frac{uvChannel - remapMin}{remapMax - remapMin}(x为image的采样数值。)$$

## **节点样式**

![](/media/202301/primsample2D_1672991197.png)

## **端口用途**

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

| 端口名称 | 端口用途 |
| --- | --- |
| prim | 指定需要采样的多边形物体。 |
| image | 指定需要输入ReadImageFile节点，根据ReadImageFile节点读取的rgb信息进行采样。 |
| uvChannel | 指定多边形上的vec3f源属性。（一般指定uv属性，根据uv属性进行采样Image颜色信息。） |
| targeChannel | 指定多边形物体采样后数据的存储属性名称。 |
| remapMin | 指定源属性数值重映射的最小值。 |
| remapMax | 指定源属性数值重映射的最大值。 |
| wrap | 选择多边形物体的uvChannel属性值超过1值的处理方式。 |
|  | **REPEAT**：重复纹理图像。 |
|  | **CLAMP_TO_EDGE**：纹理坐标会被约束在0到1之间，超出的部分会重复纹理坐标的边缘，产生一种边缘被拉伸的效果。 |
|  | **CLAMP_TO_BORDER**：超出的坐标为用户指定的边缘颜色（borderColor）。 |
| borderColor | 当wrap选择CLAMP_TO_BORDER时起作用，指定超出边界值填充的颜色值。 |
| SRC | 影响解算先后顺序的端口。另一个节点A与该端口连接表示在执行本节点运算前先执行节点A。 |

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

| 端口名称 | 端口用途 |
| --- | --- |
| outPrim | 输出采样后的多边形物体。 |
| DST | 影响解算先后顺序的端口。另一个节点A与该端口相连表示在本节点运算后执行节点A。 |

## **特征描述**

**·**wrap效果。

|  | <center>节点连接方式<center/> | <center>返回结果<center/> |
| --- | --- | --- |
| <center>REPEAT<center/> |  <center><img src="/media/202301/01_01_1672996874.png"  width="260" /></center>  | <center class="half"><img src="/media/202301/01_02_1672996934.png" width="450"/></center> |
| <center><center>CLAMP_TO_EDGE<center/> |  <center><img src="/media/202301/02_01_1672997518.png"  width="260" /></center>  | <center class="half"><img src="/media/202301/02_02_1672996785.png" width="450"/></center> |
| <center><center><center>CLAMP_TO_BORDER<center/> |  <center><img src="/media/202301/03_01_1672996987.png"  width="260" /></center>  | <center class="half"><img src="/media/202301/03_02_1672997141.png" width="450"/></center> |

## **相关节点**

[PrimSample1D(1D采样)](http://doc.zenustech.com/project-5/doc-310/ "PrimSample1D(1D采样)")