## 概述

dag2riRes 工具用于以下目的：

- 转换 `.dag` 文件为 `.composit.blk` 文件。
- 从单个`.dag`文件中的对象生成多个`.dag`文件。

该工具使用两个关键文件：

- `dag2riRes-dev.exe`
- `dag2riRes-dev.pdb`

## 使用建议

为方便使用，建议创建一个单独的目录来拷贝工具。避免将该目录放置在项目资源中，因为临时文件可能会在此堆积，从而可能干扰构建过程并在编辑器日志中产生错误。虽然这些问题通常不大，可以通过日常清理解决，但在研究或迭代测试等需要频繁导出、测试和删除文件的情况下，最好将工具放在专用目录中。在创建的目录中，复制 `.exe` 和 `.pdb` 文件。

## 生成 `.composit.blk` 文件

生成 `.composit.blk` 文件:

1. 在 3ds Max 或 Blender 中，创建新对象（如果该对象在资源数据库中尚不可用），或者从现有的`.dag`文件中导入该对象。
2. 以从中导入几何的原始 `.dag` 文件或要使用 dag2riRes 从对象生成的 `.dag` 文件命名对象。
3. 添加一个三位数的后缀，例如 `_000`。
4. 如果将后缀`_origin`分配给场景中的任何对象，则其枢轴点将用作生成的合成文件中的零坐标。

   ```{note}
   如果使用 dag2riRes 处理的`.dag`文件缺少名为`*_origin`的节点，则生成的复合文件中的枢轴将与原始`.dag`的枢轴不匹配，而是偏移。
   ```

5. 建议克隆场景中的类似几何体作为参考（或实例）。
6. 将`.dag`场景导出到包含 dag2riRes 工具的目录。
7. 复合文件将在根目录中生成，位于可执行文件旁边。

```{seealso}
有关复合文件的更多信息，请参阅
[.composit.blk](../../assets/all-about-blk/composit_blk.md)文件。
```

## 生成单个`.dag`文件的规则

生成单个`.dag`文件时：

- 将根据相似的名称创建`.dag`文件。对于场景中一组名称相似的对象，将仅根据数字顺序中的第一个对象生成一个`.dag`文件。

  例如，从对象 `test_geometry_001`, `test_geometry_127`, 和  `test_geometry_origin` 中，将只创建一个基于第一个对象 (`test_geometry_001`)的 `.dag`文件，命名为 `test_geometry`。

- `.dag` 文件将自动分配一个 `.lod00` 后缀;不支持其他后缀。

- `.dag`文件将位于 `/simple_dags/p_RendInst` 目录中。

- `.rendinst.blk`文件将与`.dag`文件一起生成，但它们通常没有用。

## 运行 dag2riRes

要运行 `dag2riRes-dev.exe`，建议使用 FAR。启动后，日志将显示一个简短的说明：

<img src="_images/dag2rires_01.png" alt="Running the dag2riRes" align="center" width="">

在命令行中输入命令。您至少需要指定要处理的`.dag`文件的名称和目标目录。例如：

```text
dag2riRes-dev.exe -s:test.dag -d:simple_dags
```

所有其他参数都是可选的。