226 lines
6.0 KiB
Markdown
226 lines
6.0 KiB
Markdown
# 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. 复制错误信息用于问题报告
|
||
|
||
### 测试安装
|
||
运行测试脚本：
|
||
```python
|
||
# 在 Blender 的文本编辑器中运行
|
||
exec(open("test_installation.py").read())
|
||
```
|
||
|
||
### 联系支持
|
||
- 在 GitHub 上提交 Issue
|
||
- 提供详细的错误信息
|
||
- 包含 Blender 版本和系统信息
|
||
|
||
## 🔄 更新插件
|
||
|
||
### 更新步骤
|
||
1. **备份当前设置**
|
||
- 导出插件设置（如果有）
|
||
2. **卸载旧版本**
|
||
- 在插件设置中禁用插件
|
||
- 删除旧版本文件
|
||
3. **安装新版本**
|
||
- 按照安装步骤安装新版本
|
||
4. **恢复设置**
|
||
- 重新配置插件设置
|
||
|
||
### 版本兼容性
|
||
- 插件支持 Blender 3.0+ 版本
|
||
- 建议使用最新的 Blender 版本
|
||
- 主要版本更新可能需要重新安装
|
||
|
||
---
|
||
|
||
**安装完成后，您就可以开始使用 SUWood 进行专业的家具设计了！** 🎉 |