# 工作流插件 | Blender-D5实时同步插件

## 功能介绍

在 Blender 中编辑模型、材质等数据过程中，与D5渲染器实时同步，无需手动点击更新按钮。配合视角联动功能，方案设计同时沉浸体验实时渲染效果。

---

## 下载与安装

### 安装环境和版本支持

- D5渲染器 2.5 版本及以上
- Blender 3.4及以上版本

### 下载exe

[点击下载](https://www.d5render.cn/download/)

### 安装

与 Blender 同步插件一致，支持三种安装方式。详细步骤请参考[工作流插件 | Blender-D5同步插件](./introduction.md#下载与安装)。

- 默认安装
- 自定义路径安装
- 便携模式（Portable mode）安装

---

## 功能说明

### 连接到D5渲染器

点击 "同步/Sync" 按钮，一键启动D5渲染器建立连接，并将当前 Blender 内打开的项目（模型与材质）全量同步至D5场景中。

- 首次同步将完整发送场景中的所有网格对象与材质数据
- 再次点击 "停止同步/Stop Sync" 可断开与D5渲染器的连接

### 实时同步

模型的任何修改将自动实时同步到D5渲染器，无需手动触发更新。适合希望无缝集成工作流程的用户。

### 单次发送

连接建立后，当在 Blender 中修改模型或材质，变更内容会被插件自动记录在同步队列中。点击同步按钮后，插件将仅同步发生变化的数据至D5渲染器，保留已在D5中调整好的材质和场景参数。

- 对象变更（Objects changed）：对象的位置、旋转、缩放等变换操作
- 网格变更（Meshes changed）：网格几何数据的修改（如编辑模式中的操作）
- 材质变更（Materials changed）：材质参数或节点连接的修改

### 发送相机（同步场景）

连接建立后，点击发送相机按钮，可一键同步 Blender 中的摄像机列表至D5渲染器场景列表中。同步的相机参数包括：

- 名称：相机对象的名称
- 位置：相机在场景中的位置
- 方向：相机朝向（视线方向与上方向向量）
- FOV：相机视场角

### 发送灯光

连接建立后，点击发送灯光按钮，可以将 Blender 中的灯光同步至D5渲染器中。对应的光源类型及同步的灯光参数：

| Blender | D5 | 支持的灯光参数 |
| --- | --- | --- |
| 点光 | 点光源 | 名称、位置、亮度、颜色 |
| 日光 | 聚光灯 | 名称、位置、亮度、颜色 |
| 聚光 | 聚光灯 | 名称、位置、亮度、颜色 |
| 面光 | 区域光 | 名称、位置、亮度、颜色、尺寸、形状 |

- 若面光形状为方形（正方形/矩形），映射到 D5 中为区域光；
- 若面光形状为圆盘（碟形/椭圆形），映射到 D5 中为圆盘灯

### 视角联动

连接建立后，点击 "视角同步/View Sync" 按钮，可在任意视角上保持 Blender 与D5渲染器的视口一致，实现D5视角与 Blender 的实时同步。

- 同时支持透视和正交两种视角模式
- 支持一键开启或关闭视角联动

### 同步相机动画（同步相机帧范围）

连接建立后，选中 Blender 中带有动画数据的相机对象，点击"发送相机帧范围"按钮，可将相机的运动轨迹动画同步至D5渲染器，用于在D5中直接预览或生成动画漫游视频。

### 导出.d5a

支持将模型转为 .d5a 文件后直接导入D5渲染器。

- 支持仅导出选中对象或整体文件导出
- 组结构导出：默认导出一层组结构，最多支持导出两层组结构

### 卸载

- 从开始菜单选择"卸载程序-卸载 D5 Livesync for Blender"一键卸载。