﻿# 如何使用项目合并组件？

「D5组件」是基于D5渲染器简洁的本体之上，用于实现高级功能延伸的一系列扩展模块。在“菜单” -> “偏好设置” -> “组件”中，可以查看当前已有的组件。在2.11及以上版本中，项目合并组件默认开启，不再显示开关按钮。

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1758188535603/5490fd22a1d89854499406393bf52ed2.png)

为方便团队协作，满足多个模型同步渲染的需求，“项目合并”功能应运而生，可支持 10 个项目文件的同时合并。合并项目时，需要添加至少两个项目，分别设置项目中需要合并的模型、灯光或场景镜头等选项，再选择生成合并项目的文件的位置。

## 入口

项目合并功能有三个入口：

1\. 从“D5启动器” -> “项目”中，点击右上角图标进入；

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1758190034708/image.png)

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1758534368294/5.png)

2\. 在“项目”的列表中，选择项目右键菜单中的“合并项目”；

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1758534592454/5-1.png)

3\. 场景编辑中，点击“菜单” -> “文件”，打开“合并项目”功能。

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/b2b089df-cb81-4043-b79c-df8b2dc9bba1/1661743700844/%E5%85%A5%E5%8F%A3c.png)

---

## 合并条件

1\. 项目文件均需保存完好

2\. 选择的项目文件版本一致

3\. 存档文件版本须为2.1（含）之后版本，支持项目合并功能

4\. 合并后的存档所在盘符的磁盘剩余可用空间须>所有待合并存档之合

---

## 合并顺序

项目合并会按照添加项目的顺序进行，位于首位的项目为主项目，除第一种直接进入合并页面的方式外，后两种从项目中进入的方式，会直接将当前选择的项目作为主项目，添加到合并项目页面的第一个位置。 

---

## 合并方式

合并项目时，需要添加至少两个项目，合并前须勾选设置项，分别设置项目中需要合并的模型、灯光或场景镜头等选项。勾选的设置项，会在合并结果中保留；未勾选的会被丢弃。

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1758534917802/5-3.png)

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1758534927267/5-2.png)

若多个项目同时勾选同一个选项，场景中完全相同的部分，只保留一份，后续添加的项目，会依次向前进行合并，覆盖前一个项目的参数。

如：两项目中都存在相同的灯光，如合并选项中都勾选了灯光，后添加项目中灯光的参数，会将前一个项目中的灯光参数进行覆盖。 若多个项目同时勾选同一个选项，场景中不同的部分，则会自动添加。 

---

## 常见问题

### 为什么项目合并失败了？

可能有以下原因：

  1. 项目文件已损坏 
  2. 当前选择的文件版本低于或高于已添加版本 
  3. 项目文件版本不支持 
  4. 磁盘空间不足 
  5. 文件/文件夹拷贝失败 
  6. 合并项目位置中包含同名文件 
  7. 合并项目位置不可用

### 项目合并前需要检查什么？

  1. 项目文件均需保存完好 
  2. 选择的项目文件版本一致 
  3. 存档文件版本须为2.1（含）之后版本，支持项目合并功能 
  4. 合并后的存档所在盘符的磁盘剩余可用空间须>所有待合并存档之合
