BL/README_light_path.md

光学系统光路可视化

本项目提供了多种方式来可视化光学系统的光路数据，使用 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：使用运行脚本（推荐）

基础版本

python run_light_path.py

增强版本

python run_light_path_advanced.py

方法 2：直接在 Blender 中运行

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

方法 3：命令行运行

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

   # macOS (使用Homebrew)
   brew install --cask blender
   
   # Ubuntu/Debian
   sudo apt update
   sudo apt install blender
   
   # Windows
   # 从官网下载安装包
   

2. 验证安装

   blender --version
   

3. 运行脚本

   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 列表：

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

调整光路粗细

修改 thickness 参数：

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

更改渲染质量

修改采样数量：

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

技术细节

数据格式

光路数据采用 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
• 发送邮件至项目维护者

---

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