# 光学系统光路可视化

本项目提供了多种方式来可视化光学系统的光路数据，使用 Blender 生成高质量的 3D 光路模型。

## 文件说明

### 数据文件

- `miao_light_path_tsingtao.json` - 光路数据文件，包含多条光路的 3D 坐标点

### 可视化脚本

#### 基础版本

- `light_path_blender.py` - 基础版 Blender 光路可视化脚本
- `run_light_path.py` - 运行基础版脚本的启动器

#### 增强版本

- `light_path_advanced.py` - 增强版 Blender 光路可视化脚本
- `run_light_path_advanced.py` - 运行增强版脚本的启动器

#### 其他工具

- `linemodel.py` - 使用 matplotlib 的 2D/3D 光路可视化脚本

## 功能特点

### 基础版本功能

- ✅ 3D 光路曲线可视化
- ✅ 不同颜色区分光路
- ✅ 发光材质效果
- ✅ 自动相机调整
- ✅ 导出 GLB 和 Blend 文件
- ✅ 渲染高质量图像

### 增强版本功能

- ✅ 所有基础版本功能
- ✅ 光路起点和终点标记（绿色/红色球体）
- ✅ 光路密度体积可视化
- ✅ 更高质量的光照和材质
- ✅ 更精确的相机控制
- ✅ 更丰富的渲染选项

## 使用方法

### 方法 1：使用运行脚本（推荐）

#### 基础版本

```bash
python run_light_path.py
```

#### 增强版本

```bash
python run_light_path_advanced.py
```

### 方法 2：直接在 Blender 中运行

1. 打开 Blender
2. 切换到 Scripting 工作区
3. 打开 `light_path_blender.py` 或 `light_path_advanced.py`
4. 点击运行脚本

### 方法 3：命令行运行

```bash
blender --background --python light_path_blender.py
# 或
blender --background --python light_path_advanced.py
```

## 输出文件

### 基础版本输出

- `light_path_model.blend` - Blender 工程文件
- `light_path_model.glb` - Web 友好格式（可在浏览器中查看）
- `light_path_render.png` - 渲染图像

### 增强版本输出

- `light_path_advanced.blend` - Blender 工程文件
- `light_path_advanced.glb` - Web 友好格式
- `light_path_render.png` - 高质量渲染图像

## 系统要求

### 必需软件

- **Blender 3.0+** - 3D 建模和渲染软件
  - 下载地址：https://www.blender.org/download/
- **Python 3.7+** - 编程语言环境

### 推荐配置

- **操作系统**: Windows 10+, macOS 10.15+, Ubuntu 18.04+
- **内存**: 8GB+ RAM
- **显卡**: 支持 OpenGL 3.3+的显卡
- **存储**: 至少 2GB 可用空间

## 安装步骤

1. **安装 Blender**

   ```bash
   # macOS (使用Homebrew)
   brew install --cask blender

   # Ubuntu/Debian
   sudo apt update
   sudo apt install blender

   # Windows
   # 从官网下载安装包
   ```

2. **验证安装**

   ```bash
   blender --version
   ```

3. **运行脚本**
   ```bash
   python run_light_path.py
   ```

## 故障排除

### 常见问题

#### 1. 找不到 Blender

```
❌ 错误：未找到Blender安装
```

**解决方案**：

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

#### 2. 找不到数据文件

```
❌ 错误：未找到光路数据文件 miao_light_path_tsingtao.json
```

**解决方案**：

- 确保数据文件在当前目录
- 检查文件名是否正确

#### 3. 渲染失败

```
❌ 渲染失败
```

**解决方案**：

- 检查显卡驱动是否最新
- 降低渲染分辨率
- 使用 Eevee 渲染引擎替代 Cycles

#### 4. 内存不足

```
❌ 内存不足错误
```

**解决方案**：

- 关闭其他应用程序
- 减少光路数量（修改脚本）
- 增加系统虚拟内存

### 性能优化

#### 提高渲染速度

1. 使用 Eevee 渲染引擎
2. 降低采样数量
3. 减少光路数量
4. 使用 GPU 渲染

#### 减少内存使用

1. 分批处理光路
2. 简化几何体
3. 优化材质设置

## 自定义配置

### 修改光路颜色

在脚本中修改 `base_colors` 列表：

```python
base_colors = [
    (1.0, 0.2, 0.2, 1.0),  # 红色
    (0.2, 1.0, 0.2, 1.0),  # 绿色
    # 添加更多颜色...
]
```

### 调整光路粗细

修改 `thickness` 参数：

```python
obj = create_light_path_curve(path, f"light_path_{i}", thickness=0.05)
```

### 更改渲染质量

修改采样数量：

```python
scene.cycles.samples = 256  # 更高的采样数 = 更好的质量
```

## 技术细节

### 数据格式

光路数据采用 JSON 格式，结构如下：

```json
[
    [
        [x1, y1, z1],
        [x2, y2, z2],
        ...
    ],
    [
        [x1, y1, z1],
        [x2, y2, z2],
        ...
    ]
]
```

### 渲染引擎

- **Cycles**: 基于物理的渲染引擎，提供最真实的光照效果
- **Eevee**: 实时渲染引擎，速度更快但质量稍低

### 导出格式

- **GLB**: 二进制 GLTF 格式，适合 Web 展示
- **Blend**: Blender 原生格式，包含完整项目信息

## 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目！

## 联系方式

如有问题或建议，请通过以下方式联系：

- 提交 GitHub Issue
- 发送邮件至项目维护者

---

**注意**: 确保在运行脚本前备份重要文件，脚本会生成新的文件并可能覆盖同名文件。