185 lines
5.0 KiB
Markdown
185 lines
5.0 KiB
Markdown
|
# SUWood - 智能家具设计插件
|
|||
|
|
|
|||
|
|
## 📋 插件简介
|
|||
|
|
|
|||
|
|
SUWood 是一个专为 Blender 设计的智能家具设计插件，提供完整的柜体创建、分割、轮廓设计等功能。该插件从 SketchUp 平台移植而来，为 Blender 用户提供专业的木工设计工具。
|
|||
|
|
|
|||
|
|
## 🚀 主要功能
|
|||
|
|
|
|||
|
|
### 🛠️ 核心工具
|
|||
|
|
- **点击创体工具** - 通过点击创建柜体单元
|
|||
|
|
- **选面创体工具** - 在选中的面上创建柜体
|
|||
|
|
- **删除柜体功能** - 删除选中的柜体单元
|
|||
|
|
- **六面切割工具** - 六方向区域分割功能
|
|||
|
|
- **轮廓创建工具** - 创建和编辑轮廓
|
|||
|
|
|
|||
|
|
### 🎯 智能功能
|
|||
|
|
- **智能选择管理** - 自动管理对象选择状态
|
|||
|
|
- **实时状态显示** - 实时显示操作状态和提示
|
|||
|
|
- **多视图支持** - 支持前、右、顶等多个视图
|
|||
|
|
- **参数化设计** - 精确的尺寸和参数控制
|
|||
|
|
|
|||
|
|
## 📦 安装方法
|
|||
|
|
|
|||
|
|
### 方法一：直接安装（推荐）
|
|||
|
|
|
|||
|
|
1. **下载插件**
|
|||
|
|
- 将整个 `blenderpython` 文件夹下载到本地
|
|||
|
|
|
|||
|
|
2. **安装到 Blender**
|
|||
|
|
- 打开 Blender
|
|||
|
|
- 进入 `Edit > Preferences > Add-ons`
|
|||
|
|
- 点击 `Install...` 按钮
|
|||
|
|
- 选择 `blenderpython` 文件夹
|
|||
|
|
- 点击 `Install Add-on`
|
|||
|
|
|
|||
|
|
3. **启用插件**
|
|||
|
|
- 在插件列表中找到 `SUWood - 智能家具设计`
|
|||
|
|
- 勾选启用插件
|
|||
|
|
|
|||
|
|
### 方法二：手动安装
|
|||
|
|
|
|||
|
|
1. **复制文件**
|
|||
|
|
```bash
|
|||
|
|
# 将 blenderpython 文件夹复制到 Blender 插件目录
|
|||
|
|
# Windows: %APPDATA%\Blender Foundation\Blender\4.2\scripts\addons\
|
|||
|
|
# macOS: ~/Library/Application Support/Blender/4.2/scripts/addons/
|
|||
|
|
# Linux: ~/.config/blender/4.2/scripts/addons/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **重启 Blender**
|
|||
|
|
- 重启 Blender 应用
|
|||
|
|
- 插件将自动加载
|
|||
|
|
|
|||
|
|
## 🎮 使用方法
|
|||
|
|
|
|||
|
|
### 1. 访问插件面板
|
|||
|
|
- 打开 3D 视图
|
|||
|
|
- 按 `N` 键打开侧边栏
|
|||
|
|
- 点击 `SUWood` 标签页
|
|||
|
|
|
|||
|
|
### 2. 使用工具
|
|||
|
|
|
|||
|
|
#### 点击创体工具
|
|||
|
|
1. 点击 `点击创体` 按钮
|
|||
|
|
2. 在 3D 视图中点击位置
|
|||
|
|
3. 输入柜体尺寸参数
|
|||
|
|
4. 完成创建
|
|||
|
|
|
|||
|
|
#### 选面创体工具
|
|||
|
|
1. 点击 `选面创体` 按钮
|
|||
|
|
2. 选择要创建柜体的面
|
|||
|
|
3. 输入尺寸参数
|
|||
|
|
4. 完成创建
|
|||
|
|
|
|||
|
|
#### 六面切割工具
|
|||
|
|
1. 点击 `六面切割` 按钮
|
|||
|
|
2. 选择要分割的区域
|
|||
|
|
3. 使用方向键选择分割方向
|
|||
|
|
4. 输入分割长度
|
|||
|
|
5. 完成分割
|
|||
|
|
|
|||
|
|
#### 删除柜体
|
|||
|
|
1. 选择要删除的柜体
|
|||
|
|
2. 点击 `删除柜体` 按钮
|
|||
|
|
3. 确认删除
|
|||
|
|
|
|||
|
|
### 3. 快捷键操作
|
|||
|
|
|
|||
|
|
#### 六面切割快捷键
|
|||
|
|
- `↑` - 上分割（普通模式）/ 后分割（前后模式）
|
|||
|
|
- `↓` - 下分割（普通模式）/ 前分割（前后模式）
|
|||
|
|
- `←` - 左分割（仅普通模式）
|
|||
|
|
- `→` - 右分割（仅普通模式）
|
|||
|
|
- `Ctrl` - 切换分割模式（普通/前后）
|
|||
|
|
|
|||
|
|
## 🔧 系统要求
|
|||
|
|
|
|||
|
|
- **Blender 版本**: 3.0 或更高版本
|
|||
|
|
- **操作系统**: Windows 10+, macOS 10.15+, Linux
|
|||
|
|
- **Python**: 3.7+ (Blender 内置)
|
|||
|
|
- **内存**: 建议 8GB 或更多
|
|||
|
|
|
|||
|
|
## 📁 文件结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
blenderpython/
|
|||
|
|
├── __init__.py # 插件主入口文件
|
|||
|
|
├── suw_core/ # 核心功能模块
|
|||
|
|
│ ├── __init__.py
|
|||
|
|
│ ├── selection_manager.py
|
|||
|
|
│ ├── data_manager.py
|
|||
|
|
│ └── ...
|
|||
|
|
├── 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 # 常量定义
|
|||
|
|
└── README.md # 说明文档
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🐛 故障排除
|
|||
|
|
|
|||
|
|
### 常见问题
|
|||
|
|
|
|||
|
|
#### 1. 插件无法安装
|
|||
|
|
- 确保 Blender 版本为 3.0 或更高
|
|||
|
|
- 检查文件权限
|
|||
|
|
- 尝试重启 Blender
|
|||
|
|
|
|||
|
|
#### 2. 工具按钮无响应
|
|||
|
|
- 确保在 3D 视图中操作
|
|||
|
|
- 检查是否有选中的对象
|
|||
|
|
- 查看控制台错误信息
|
|||
|
|
|
|||
|
|
#### 3. 网络功能不可用
|
|||
|
|
- 检查 SUWood 服务器是否运行
|
|||
|
|
- 确认网络连接正常
|
|||
|
|
- 检查防火墙设置
|
|||
|
|
|
|||
|
|
#### 4. 性能问题
|
|||
|
|
- 关闭不必要的 Blender 功能
|
|||
|
|
- 减少场景中的对象数量
|
|||
|
|
- 更新显卡驱动
|
|||
|
|
|
|||
|
|
### 日志查看
|
|||
|
|
- 打开 Blender 的 `Window > Toggle System Console`
|
|||
|
|
- 查看错误和警告信息
|
|||
|
|
|
|||
|
|
## 🔄 更新日志
|
|||
|
|
|
|||
|
|
### v1.0.0 (2024-01-XX)
|
|||
|
|
- ✅ 初始版本发布
|
|||
|
|
- ✅ 完整的工具集实现
|
|||
|
|
- ✅ Blender 4.2 兼容性
|
|||
|
|
- ✅ 中文界面支持
|
|||
|
|
- ✅ 双模式架构（Blender/存根）
|
|||
|
|
|
|||
|
|
## 🤝 技术支持
|
|||
|
|
|
|||
|
|
### 问题反馈
|
|||
|
|
- 在 GitHub 上提交 Issue
|
|||
|
|
- 提供详细的错误信息和复现步骤
|
|||
|
|
- 包含 Blender 版本和系统信息
|
|||
|
|
|
|||
|
|
### 功能建议
|
|||
|
|
- 欢迎提出新功能建议
|
|||
|
|
- 参与插件开发讨论
|
|||
|
|
- 贡献代码和文档
|
|||
|
|
|
|||
|
|
## 📄 许可证
|
|||
|
|
|
|||
|
|
本项目采用 MIT 许可证，详见 LICENSE 文件。
|
|||
|
|
|
|||
|
|
## 🙏 致谢
|
|||
|
|
|
|||
|
|
- 感谢 SketchUp 平台的原始设计
|
|||
|
|
- 感谢 Blender 社区的支持
|
|||
|
|
- 感谢所有贡献者的努力
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**SUWood - 让家具设计更简单！** 🏠✨
|