# 融合光学系统脚本

这个脚本将 `toModel.py` 和 `light_path_simple.py` 两个脚本的功能融合在一起，在一个场景中同时显示光学系统的几何体和光路可视化。

## 功能特点

- 🔧 **光学系统几何体**: 创建平面、抛物面、双曲面等光学元件
- 💡 **光路可视化**: 显示发光的光路曲线
- 🎨 **材质系统**: 金属、透明、发光等不同材质
- 📁 **文件组织**: 使用集合（Collection）组织不同类型的对象
- 📤 **多格式导出**: 支持 OBJ、GLB、Blend 文件导出
- 🖼️ **高质量渲染**: 使用 Cycles 渲染引擎

## 文件结构

```
├── fused_optical_system.py    # 主要的融合脚本
├── run_fused_system.py        # 运行辅助脚本
├── README_fused_system.md     # 本说明文件
├── e8caffb4622e03b1495bbc1ed13fce13.json  # 光学系统数据
└── miao_light_path_tsingtao.json           # 光路数据
```

## 使用方法

### 方法 1: 使用运行辅助脚本（推荐）

```bash
python3 run_fused_system.py
```

这个脚本会自动：

- 检测 Blender 安装
- 检查必要的 JSON 文件
- 运行融合脚本
- 显示执行结果

### 方法 2: 直接使用 Blender 命令

```bash
blender --background --python fused_optical_system.py -- [optical_json_path] [light_path_json_path]
```

参数说明：

- `optical_json_path`: 光学系统 JSON 文件路径（可选，默认：`./e8caffb4622e03b1495bbc1ed13fce13.json`）
- `light_path_json_path`: 光路 JSON 文件路径（可选，默认：`./miao_light_path_tsingtao.json`）

### 方法 3: 在 Blender 中运行

1. 打开 Blender
2. 切换到 Scripting 工作区
3. 打开 `fused_optical_system.py` 文件
4. 点击运行按钮

## 输出文件

脚本执行完成后会生成以下文件：

- **`fused_optical_system.blend`** - Blender 工程文件，包含完整的场景
- **`fused_optical_system.glb`** - Web 友好的 3D 模型格式
- **`fused_optical_system.obj`** - 通用的 3D 模型格式
- **`fused_optical_system_render.png`** - 高质量渲染图像

## 场景组织

融合后的场景使用集合（Collection）来组织对象：

- **OpticalSystem**: 包含所有光学系统几何体
- **LightPaths**: 包含所有光路可视化对象

## 材质系统

- **金属材质**: 用于光学元件表面
- **透明材质**: 用于"nothing"类型的对象
- **发光材质**: 用于特殊发光对象
- **光路材质**: 用于光路曲线，具有发光效果

## 光路可视化

- 支持多种颜色方案（红、绿、蓝、黄、紫、青、橙、粉）
- 发光强度增强，确保在场景中清晰可见
- 自动限制光路数量（最多 20 条）以避免场景过于复杂
- 曲线厚度适中，既清晰又不会遮挡几何体

## 相机和灯光设置

- **相机位置**: (20, -20, 15)，角度适合观察整个系统
- **主灯光**: 太阳光，提供主要照明
- **环境光**: 区域光，提供柔和的环境照明
- **背景**: 深蓝色背景，突出光路效果

## 渲染设置

- **渲染引擎**: Cycles（提供更好的材质和光照效果）
- **分辨率**: 1920x1080（全高清）
- **输出格式**: PNG

## 故障排除

### 常见问题

1. **找不到 Blender**

   - 确保 Blender 已安装
   - 将 Blender 添加到系统 PATH 中
   - 或手动指定 Blender 安装路径

2. **缺少 JSON 文件**

   - 确保 `e8caffb4622e03b1495bbc1ed13fce13.json` 存在
   - 确保 `miao_light_path_tsingtao.json` 存在

3. **脚本执行失败**

   - 检查 JSON 文件格式是否正确
   - 查看错误输出信息
   - 确保有足够的磁盘空间

4. **渲染失败**
   - 检查是否有足够的系统内存
   - 确保输出目录可写
   - 检查 Blender 版本兼容性

### 调试模式

如果需要调试，可以在 Blender 中直接运行脚本，这样可以看到更详细的错误信息。

## 性能优化

- 光路数量限制在 20 条以内
- 使用适当的几何体分辨率
- 优化材质节点设置
- 合理的灯光配置

## 扩展功能

可以基于这个融合脚本进一步扩展：

- 添加动画效果
- 支持更多几何体类型
- 自定义材质和纹理
- 添加交互式控制
- 支持实时渲染

## 技术细节

- **Python 版本**: 3.7+
- **Blender 版本**: 2.80+
- **依赖库**: bpy, json, mathutils, bmesh, numpy
- **渲染引擎**: Cycles
- **文件格式**: 支持 OBJ、GLB、Blend

## 许可证

本脚本遵循与原始脚本相同的许可证条款。