# Dagor Pivot Painter Vegetation Tool
## 安装
[安装脚本](installation.md) 按照提供的说明进行作。
```{important}
此脚本需要 3ds Max 2015 或更高版本才能运行。
```
## 访问Pivot Painter Vegetation Tool
1. 导航至**Gaijin Tools > Pivot Painter Vegetation Tool**。这将打开 Dagor Pivot Painter Tool 的主窗口。
2. 要验证脚本的版本{bdg-dark-line}`3`，请前往 **Gaijin Tools** {bdg-dark-line}`1` **> About** {bdg-dark-line}`2`。**About**窗口将显示当前版本。定期检查以确保您的脚本是最新的，这一点很重要。
```{note}
确保插件版本至少为 `1.4`。
```
## 使用 Pivot Painter Vegetation Tool
首先，导航到 **Gaijin Tools > Pivot Painter Vegetation Tool**，打开 **Pivot Painter Vegetation Tool**。
下载以下测试场景：
{download}`tree_oak_test_2021.max <_examples/tree_oak_test_2021.zip>`.
```{important}
- 此场景需要 3ds Max 2021 或更高版本。
- 确保安装的 GrowFX 不低于`2.0.1`版本。
```
工具窗口将显示如下：
### 主要功能和控制
1. **Pick** {bdg-dark-line}`1`: 选择将用作树的所有其他元素的父元素的 GrowFX 对象。
2. **Texture Save Path** {bdg-dark-line}`2`: 选择将保存 Generated Position 和 Rotation 纹理的目录。
3. **Final Object Name** {bdg-dark-line}`3`: 为生成的对象指定自定义名称。默认情况下，该工具会指定选定对象的名称。
4. **Start Creation** {bdg-dark-line}`4`: 启动工具的操作。
5. **Open Local Documentation** {bdg-dark-line}`5`: 指向此文档的链接。
6. **Contact with Developer** {bdg-dark-line}`6`: 如果需要帮助，请为开发人员提供联系信息。
7. **Group by Path Color** {bdg-dark-line}`7`: 如果 GrowFX 对象中的层次结构级别数超过 4，则应启用此复选框。此外，在 GrowFX 中，使 Paths 的颜色不超过 4 倍。将根据指定的颜色生成层次结构。
```{seealso}
有关其工作原理的更多信息，请参阅 GrowFX 文档：
[Wire color](https://exlevel.com/growfx2-manual/Node_Path.html).
```
8. **Save Settings** {bdg-dark-line}`7`: 将当前设置保存到`..base/GJ_Dagor2ppainter.ini` 文件。如果您想重置为默认值，请删除此文件。
### 工作流示例
1. 使用按钮 {bdg-dark-line}`2` 指定生成的 `.dds` 纹理的输出路径。按下 **START CREATION** 按钮 {bdg-dark-line}`4` 生成纹理 `pivot_pos.dds` 和 `pivot_dir.dds`，以及一个新的 **WIND** 图层，其中包含具有指定名称的已完成对象。
2. 生成纹理后，一切都完成了。
```{important}
- **脚本限制**。与 Houdini 图形版本不同，此脚本在 GrowFX 中最多限制为 4 个层次结构级别。因此，允许的链接数限制为 4 倍。在 Houdini 中，任何超出第 4 个级别都将被合并到最后一个级别，而此脚本将丢弃且不显示它们。
- **对象限制**。此脚本和 Houdini 都施加了 2048 个对象的限制，这些对象源自允许的最大纹理大小。任何超过此限制的对象都将被脚本忽略，Houdini 也会忽略它们。
```