SUWood - 智能家具设计插件

📋 插件简介

SUWood 是一个专为 Blender 设计的智能家具设计插件，提供完整的柜体创建、分割、轮廓设计等功能。该插件从 SketchUp 平台移植而来，为 Blender 用户提供专业的木工设计工具。

🚀 主要功能

🛠️ 核心工具

• 点击创体工具 - 通过点击创建柜体单元
• 选面创体工具 - 在选中的面上创建柜体
• 删除柜体功能 - 删除选中的柜体单元
• 六面切割工具 - 六方向区域分割功能
• 轮廓创建工具 - 创建和编辑轮廓

🎯 智能功能

• 智能选择管理 - 自动管理对象选择状态
• 实时状态显示 - 实时显示操作状态和提示
• 多视图支持 - 支持前、右、顶等多个视图
• 参数化设计 - 精确的尺寸和参数控制

📦 安装方法

方法一：直接安装（推荐）

1. 下载插件

   • 将整个 blenderpython 文件夹下载到本地

2. 安装到 Blender

   • 打开 Blender
   • 进入 Edit > Preferences > Add-ons
   • 点击 Install... 按钮
   • 选择 blenderpython 文件夹
   • 点击 Install Add-on

3. 启用插件

   • 在插件列表中找到 SUWood - 智能家具设计
   • 勾选启用插件

方法二：手动安装

1. 复制文件

   # 将 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 - 让家具设计更简单！ 🏠✨