liss
/
blenderpython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
blenderpython/INSTALL.md

6.0 KiB
Raw Permalink Blame History

SUWood Blender 插件安装指南

📋 安装前准备

系统要求

  • Blender 版本: 3.0 或更高版本（推荐 4.2+）
  • 操作系统: Windows 10+, macOS 10.15+, Linux
  • Python: 3.7+ (Blender 内置)
  • 内存: 建议 8GB 或更多
  • 显卡: 支持 OpenGL 3.3 或更高

下载插件

  1. 下载 blenderpython 文件夹
  2. 确保文件夹包含以下文件： 
    blenderpython/
├── __init__.py
├── suw_core/
├── suw_menu.py
├── suw_unit_point_tool.py
├── suw_unit_face_tool.py
├── suw_unit_cont_tool.py
├── suw_zone_div1_tool.py
├── suw_observer.py
├── suw_client.py
├── suw_constants.py
├── suw_load.py
├── README.md
└── test_installation.py

🚀 安装方法

方法一：通过 Blender 界面安装（推荐）

Windows 用户

  1. 打开 Blender
  2. 进入插件设置
    • 点击菜单 Edit → Preferences
    • 选择 Add-ons 标签页
  3. 安装插件
    • 点击 Install... 按钮
    • 选择 blenderpython 文件夹
    • 点击 Install Add-on
  4. 启用插件
    • 在搜索框中输入 "SUWood"
    • 找到 SUWood - 智能家具设计
    • 勾选启用插件

macOS 用户

  1. 打开 Blender
  2. 进入插件设置
    • 点击菜单 Blender → Preferences
    • 选择 Add-ons 标签页
  3. 安装插件
    • 点击 Install... 按钮
    • 选择 blenderpython 文件夹
    • 点击 Install Add-on
  4. 启用插件
    • 在搜索框中输入 "SUWood"
    • 找到 SUWood - 智能家具设计
    • 勾选启用插件

Linux 用户

  1. 打开 Blender
  2. 进入插件设置
    • 点击菜单 Edit → Preferences
    • 选择 Add-ons 标签页
  3. 安装插件
    • 点击 Install... 按钮
    • 选择 blenderpython 文件夹
    • 点击 Install Add-on
  4. 启用插件
    • 在搜索框中输入 "SUWood"
    • 找到 SUWood - 智能家具设计
    • 勾选启用插件

方法二：手动安装

Windows 手动安装

  1. 找到 Blender 插件目录 
    %APPDATA%\Blender Foundation\Blender\4.2\scripts\addons\
  2. 复制插件文件
    • 将 blenderpython 文件夹复制到上述目录
  3. 重启 Blender
    • 完全关闭 Blender
    • 重新打开 Blender
  4. 启用插件
    • 进入 Edit → Preferences → Add-ons
    • 搜索 "SUWood" 并启用

macOS 手动安装

  1. 找到 Blender 插件目录 
    ~/Library/Application Support/Blender/4.2/scripts/addons/
  2. 复制插件文件
    • 将 blenderpython 文件夹复制到上述目录
  3. 重启 Blender
    • 完全关闭 Blender
    • 重新打开 Blender
  4. 启用插件
    • 进入 Blender → Preferences → Add-ons
    • 搜索 "SUWood" 并启用

Linux 手动安装

  1. 找到 Blender 插件目录 
    ~/.config/blender/4.2/scripts/addons/
  2. 复制插件文件
    • 将 blenderpython 文件夹复制到上述目录
  3. 重启 Blender
    • 完全关闭 Blender
    • 重新打开 Blender
  4. 启用插件
    • 进入 Edit → Preferences → Add-ons
    • 搜索 "SUWood" 并启用

✅ 安装验证

1. 检查插件状态

  1. 进入 Edit → Preferences → Add-ons
  2. 搜索 "SUWood"
  3. 确认插件已启用（复选框已勾选）

2. 检查面板显示

  1. 打开 3D 视图
  2. 按 N 键打开侧边栏
  3. 查看是否有 SUWood 标签页
  4. 点击标签页查看工具按钮

3. 运行测试脚本

  1. 在 Blender 中打开文本编辑器
  2. 加载 test_installation.py 文件
  3. 运行脚本查看测试结果

🐛 常见问题解决

问题 1：插件无法安装

症状: 点击 Install 后没有反应或报错

解决方案:

  1. 确保 Blender 版本为 3.0 或更高
  2. 检查 blenderpython 文件夹是否完整
  3. 确保文件夹包含 __init__.py 文件
  4. 尝试重启 Blender 后重新安装

问题 2：插件安装后无法启用

症状: 插件出现在列表中但无法勾选启用

解决方案:

  1. 检查控制台错误信息
  2. 确保所有依赖模块可用
  3. 尝试手动安装方法
  4. 检查文件权限

问题 3：面板不显示

症状: 插件已启用但侧边栏中没有 SUWood 标签

解决方案:

  1. 确保在 3D 视图中查看
  2. 按 N 键确保侧边栏已打开
  3. 检查是否有其他插件冲突
  4. 重启 Blender

问题 4：工具按钮无响应

症状: 点击工具按钮没有反应

解决方案:

  1. 确保在 3D 视图中操作
  2. 检查是否有选中的对象
  3. 查看控制台错误信息
  4. 确认 SUWood 服务器是否运行

问题 5：性能问题

症状: 插件运行缓慢或卡顿

解决方案:

  1. 关闭不必要的 Blender 功能
  2. 减少场景中的对象数量
  3. 更新显卡驱动
  4. 增加系统内存

📞 获取帮助

查看日志

  1. 打开 Window → Toggle System Console
  2. 查看错误和警告信息
  3. 复制错误信息用于问题报告

测试安装

运行测试脚本：

# 在 Blender 的文本编辑器中运行
exec(open("test_installation.py").read())

联系支持

  • 在 GitHub 上提交 Issue
  • 提供详细的错误信息
  • 包含 Blender 版本和系统信息

🔄 更新插件

更新步骤

  1. 备份当前设置
    • 导出插件设置（如果有）
  2. 卸载旧版本
    • 在插件设置中禁用插件
    • 删除旧版本文件
  3. 安装新版本
    • 按照安装步骤安装新版本
  4. 恢复设置
    • 重新配置插件设置

版本兼容性

  • 插件支持 Blender 3.0+ 版本
  • 建议使用最新的 Blender 版本
  • 主要版本更新可能需要重新安装

安装完成后，您就可以开始使用 SUWood 进行专业的家具设计了！ 🎉