# Surface Scatter

## 简短描述

一个用于在表面上散布植被、碎片等对象的工具。

## 描述

Surface Scatter 工具使用户能够高效地在选定表面上散布各种对象，例如植被、碎片和其他资源。它允许对散布参数进行详细自定义，以根据表面特性实现实例的逼真分布和对齐。

## 属性

### 基本属性

* **表面**：要在其上散布对象的网格（或样条/曲线）
* **散布**：在输入表面上散布的网格
* **密度**：散布密度。值越高，散布的网格越多
* **统一缩放**：如果值大于 0.0，则会忽略最小/最大值，所有散布对象将按该值进行统一缩放。
* **最小缩放**：散布网格的最小缩放
* **最大缩放**：散布网格的最大缩放
* **衰减**：在缩放对象时创建衰减/渐变。这依赖于最小缩放和最大缩放。
* **表面对齐**：调整对象向下方表面对齐的程度。例如在散布树木时，你可能不希望有任何表面对齐
* **下沉**：将实例对象向下推进，这对树木非常实用
* **下沉随机化**：下沉值将在每个对象上以 (0, Sink) 范围内随机化，而不是对所有对象统一设置相同值。
* **随机种子**：随机化散布的结果

### 特征遮罩

* **角度遮罩**：根据对象下方区域的表面角度对对象进行遮罩
* **最小高度遮罩**：应将对象限定的最小高度
* **最大高度遮罩**：应将对象限定的最大高度
* **添加遮罩**：将对象添加到遮罩中
* **移除遮罩**：随机移除对象，忽略任何先前的遮罩
* **聚簇遮罩**：从散布对象中创建较小的聚簇遮罩
* **聚簇半径**：聚簇的半径
* **投影**：仅保留位于这些输入对象之上并与之相交的散布对象
* **使用表面法线**：在光线投射网格时使用表面法线，否则使用世界向上方向

### 接近度遮罩

* **对象**：你可以传入网格、曲线甚至实例器来将它们用作遮罩
* **距离**：对象接近度遮罩的距离
* **采样**：更高的值会带来更精确的接近度遮罩，但成本更高（尤其是当你的接近对象为散布实例时）
* **宽度**：接近度遮罩的宽度。允许你的遮罩在散布设置中创建笔触/切片。

### 噪声遮罩

* **分裂**：控制噪声/分裂的强度。
* **分裂缩放**：噪声遮罩的频率。这基本上控制噪声的尺度
* **噪声平滑度**：此值控制噪声遮罩的锋利/柔和程度
* **扭曲噪声**：变形噪声遮罩，这可能产生一些非常有趣的旋涡状遮罩形状
* **噪声缩放倍增器**:
* **噪声缩放 X**:
* **噪声缩放 Y**:
* **噪声缩放 Z**:

### 接近度遮罩 2

* **对象**：你可以传入网格、曲线甚至实例器来将它们用作遮罩
* **距离**：对象接近度遮罩的距离
* **采样**：更高的值会带来更精确的接近度遮罩，但成本更高（尤其是当你的接近对象为散布实例时）
* **宽度**：接近度遮罩的宽度。允许你的遮罩在散布设置中创建笔触/切片。

### 接近度遮罩 3

* **对象**：你可以传入网格、曲线甚至实例器来将它们用作遮罩
* **距离**：对象接近度遮罩的距离
* **采样**：更高的值会带来更精确的接近度遮罩，但成本更高（尤其是当你的接近对象为散布实例时）
* **宽度**：接近度遮罩的宽度。允许你的遮罩在散布设置中创建笔触/切片。

### 对象遮罩

* **对象**：对接近网格的对象进行采样。与接近度遮罩不同，此项使用射线追踪进行正确的网格接近遮罩，成本更高，且仅对网格有效。
* **距离**：控制我们为内部遮罩添加的填充距离
* **保持内部**：设置为 True 时，确保我们只保留网格内部的内容。这在将网格用作实例阻挡器时很有用
* **针对曲线优化**：如果设置为 True，使用曲线进行遮罩会使散布速度更快，但会牺牲纹理和顶点颜色遮罩
* **投影三角形**：当使用曲线作为遮罩时，此项控制我们从曲线生成的投影几何体要使用的三角形数量

### 边界遮罩

* **边界偏移**：沿表面边界对散布对象进行遮罩。
* **边界最小值**：与边界遮罩值的最小距离偏移
* **边界最大值**：与边界遮罩值的最大距离偏移
* **边界噪声**：在边界遮罩上应用噪声
* **边界采样**：更高的值会带来更精确的边界遮罩，但成本更高

### 边缘分裂

* **边界距离**：控制边缘分裂距离
* **边界扩散**：控制边缘分裂的扩散程度
* **边界缩放**：控制边缘分裂的平铺图案缩放

### 方向性遮罩

* **灯光**：提供灯光/Actor 对象以用于遮罩。其前向将被用作用于遮罩散布的方向。
* **光线角度遮罩**：基于角度，更多或更少地考虑面向光源的对象部分
* **地面移除**：逐渐移除面向向上的散布对象
* **使用阴影**：使用灯光投射的阴影作为散布区域，例如树下的苔藓
* **阴影随机化**：随机化阴影遮罩

### 旋转属性

* **覆盖旋转**：如果设置为 True，则旋转将被下面的值覆盖
* **X 轴覆盖**：覆盖 X 轴方向的旋转
* **Y 轴覆盖**：覆盖 Y 轴方向的旋转
* **Z 轴覆盖**：覆盖 Z 轴方向的旋转
* **增量旋转**：以整数或浮点数输入增量值，使用空格分隔。例如：0 90 180
* **排序增量**：如果设置为 True，增量值将按顺序应用，而不是随机应用
* **随机角度**：这确保所有实例具有随机角度/自转，从而保证出色的旋转变化
* **统一角度**：调整实例的角度/自转。默认情况下，它们都有随机自转
* **X 轴抖动**：随机化 X 轴方向的旋转
* **Y 轴抖动**：随机化 Y 轴方向的旋转
* **Z 轴抖动**：随机化 Z 轴方向的旋转

### 缩放属性

* **噪声缩放**：如果值大于 0.0，则将随机缩放切换为基于 simplex 噪声的缩放。
* **缩放倍增器**：对缩放值应用缩放倍增器。
* **使用自定义缩放**：如果勾选，基础属性中的最小和最大缩放值将被忽略，转而使用下面更细粒度的缩放选项
* **缩放排序**：如果设置为 True，对象将根据其缩放进行排列，而不是随机排列。这在使用衰减时尤其明显
* **缩放排序抖动**：在使用基于缩放的对象排序时，此项会对不同对象通道进行抖动，使外观更自然
* **衰减锐度**：控制缩放衰减的锐利程度
* **Xmin 缩放**：X 轴上的最小缩放
* **Ymin 缩放**：Y 轴上的最小缩放
* **Zmin 缩放**：Z 轴上的最小缩放
* **Xmax 缩放**：X 轴上的最大缩放
* **Ymax 缩放**：Y 轴上的最大缩放
* **Zmax 缩放**：Z 轴上的最大缩放

### 基于对象的缩放

* **对象**：添加网格或曲线以影响散布对象的缩放
* **距离**：控制缩放影响的强度
* **倍增器**：控制影响应用所需与输入的距离
* **衰减**:

### 顶点颜色遮罩

* **混合模式**：用于所有顶点颜色遮罩的混合模式
* **红色通道**：如果勾选，下方的混合模式下拉将考虑该顶点通道。
* **绿色通道**：如果勾选，下方的混合模式下拉将考虑该顶点通道。
* **蓝色通道**：如果勾选，下方的混合模式下拉将考虑该顶点通道。
* **阈值**：控制顶点颜色遮罩的阈值。较高的值可以使遮罩超出顶点颜色，并包含最接近具有顶点颜色区域的散布点。

### 景观图层遮罩

* **图层名称 1**：用于遮罩的景观图层名称
* **图层强度 1**：景观图层遮罩的强度
* **图层名称 2**：用于遮罩的景观图层名称
* **图层强度 2**：景观图层遮罩的强度
* **图层名称 3**：用于遮罩的景观图层名称
* **图层强度 3**：景观图层遮罩的强度

### 纹理遮罩

* **纹理路径**：当提供纹理时，这允许你按纹理对对象进行遮罩
* **纹理通道**：选择要从纹理中使用的通道
* **颜色阈值**：定义一个范围从 0.0 到 1.0 的阈值。低于此阈值的纹理颜色将在纹理采样过程中被丢弃。
* **纹理平铺**：控制纹理的平铺

### 其他设置

* **最大数量**：你可以散布的对象/实例的最大数量。值越高，实例越多。
* **随机散布**：如果设置为 true，散布算法将默认使用白噪声模式，而不是默认的蓝噪声。
* **结束裁剪距离**：每个实例完全淡出时与相机的距离
* **接收贴花**：如果设置为 true，实例将接收贴花
* **启用碰撞**：如果为 True - 碰撞设置为 “启用（查询和物理）”，如果为 False - “无碰撞”


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.polygonflow.io/dash-documentation-zh/dash-gong-ju/surfacescatter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
