说明添加
This commit is contained in:
libtxixi
parent
ef5bc0760d
commit
3ee3183b90
143
README.md
143
README.md
|
|
@ -0,0 +1,143 @@
|
|||
# Isometric Room Generator (IRG) - Blender插件
|
||||
|
||||
一个用于Blender的等轴测房间生成插件，支持快速创建各种类型的房间场景，包括窗户、拱门、门等道具。
|
||||
|
||||
## 🎯 功能特性
|
||||
|
||||
### 核心功能
|
||||
- **等轴测房间生成** - 快速创建等轴测视角的房间
|
||||
- **多种道具支持** - 窗户、拱门、门等建筑元素
|
||||
- **灵活尺寸设置** - 自定义房间长、宽、高
|
||||
- **智能相机定位** - 自动计算最佳相机位置和角度
|
||||
- **高质量渲染** - 支持EEVEE渲染引擎
|
||||
|
||||
### 道具类型
|
||||
- **无道具** - 纯净的房间空间
|
||||
- **落地窗** - 使用archimesh插件创建的大型窗户
|
||||
- **拱门** - 内置拱门生成功能
|
||||
- **门** - 使用archimesh插件创建的门
|
||||
|
||||
### 视图模式
|
||||
- **正视图** - 正面观察房间
|
||||
- **侧视图** - 侧面观察房间，支持角度调整
|
||||
|
||||
## 🎮 安装方法
|
||||
|
||||
### 方法一：手动安装
|
||||
1. 下载插件文件
|
||||
2. 打开Blender，进入 `Edit > Preferences > Add-ons`
|
||||
3. 点击 `Install...` 选择插件文件
|
||||
4. 启用插件
|
||||
|
||||
### 方法二：自动安装
|
||||
```bash
|
||||
# 复制插件到Blender插件目录
|
||||
cp -r isometric_room_gen ~/.config/blender/4.2/scripts/addons/
|
||||
```
|
||||
|
||||
## 🎮 使用方法
|
||||
|
||||
### 基本操作
|
||||
1. 在Blender中启用插件
|
||||
2. 在3D视图中按 `N` 打开侧边栏
|
||||
3. 找到 `Isometric Room Generator` 面板
|
||||
4. 设置房间参数
|
||||
5. 点击 `Generate Room` 按钮
|
||||
|
||||
### 参数说明
|
||||
|
||||
#### 房间设置
|
||||
- **Room Width** - 房间宽度（X轴）
|
||||
- **Room Depth** - 房间深度（Y轴）
|
||||
- **Room Height** - 房间高度（Z轴）
|
||||
- **Wall Thickness** - 墙体厚度
|
||||
|
||||
#### 窗户设置
|
||||
- **Windows** - 窗户类型选择
|
||||
- `NONE` - 无窗户
|
||||
- `BACK` - 后墙窗户
|
||||
- `SIDE` - 侧墙窗户
|
||||
- `BOTH` - 两面墙都有窗户
|
||||
|
||||
#### 拱门设置
|
||||
- **Arch Settings** - 启用拱门设置
|
||||
- **Arch Placement** - 拱门位置
|
||||
- `NONE` - 无拱门
|
||||
- `BACK` - 后墙拱门
|
||||
- **Arch Width** - 拱门宽度
|
||||
- **Arch Height** - 拱门高度
|
||||
- **Arch Thickness** - 拱门厚度
|
||||
|
||||
#### 房间样式
|
||||
- **Style** - 房间样式
|
||||
- `Square` - 方形房间
|
||||
- `L-Shape` - L形房间
|
||||
- `U-Shape` - U形房间
|
||||
|
||||
## 🔧 API服务
|
||||
|
||||
插件还提供了REST API服务，支持远程调用：
|
||||
|
||||
### 启动API服务
|
||||
```bash
|
||||
cd Isometquick-server
|
||||
./irg.sh start
|
||||
```
|
||||
|
||||
### API端点
|
||||
- `POST /render` - 创建渲染任务
|
||||
- `GET /render/{task_id}` - 获取任务状态
|
||||
- `GET /render/{task_id}/download` - 下载渲染结果
|
||||
- `GET /health` - 健康检查
|
||||
|
||||
### API示例
|
||||
```python
|
||||
import requests
|
||||
|
||||
# 创建渲染任务
|
||||
request_data = {
|
||||
"room": {
|
||||
"length": 7.0, # 房间长度
|
||||
"width": 4.0, # 房间宽度
|
||||
"height": 3.0, # 房间高度
|
||||
"prop_type": 1 # 道具类型：1=落地窗
|
||||
},
|
||||
"camera": {
|
||||
"height": 1.3, # 相机高度
|
||||
"view_type": 2, # 视图类型：2=侧视图
|
||||
"rotation_angle": 45.0
|
||||
},
|
||||
"render": {
|
||||
"resolution_x": 1080,
|
||||
"resolution_y": 2400,
|
||||
"engine": "eevee"
|
||||
}
|
||||
}
|
||||
|
||||
response = requests.post("http://localhost:8003/render", json=request_data)
|
||||
print(response.json())
|
||||
```
|
||||
|
||||
## 🎨 渲染设置
|
||||
|
||||
### 渲染引擎
|
||||
- **EEVEE** - 实时渲染引擎，速度快
|
||||
- 支持透明背景
|
||||
- 启用屏幕空间反射
|
||||
- 启用环境光遮蔽
|
||||
|
||||
### 相机设置
|
||||
- **透视投影** - 35mm焦距
|
||||
- **自动定位** - 根据房间尺寸自动计算位置
|
||||
- **智能旋转** - 根据视图类型自动设置角度
|
||||
|
||||
### 照明设置
|
||||
- **环境光** - 柔和的环境照明
|
||||
- **阴影** - 启用柔和阴影
|
||||
- **材质** - 优化的材质设置
|
||||
|
||||
## 📁 文件结构
|
||||
```
|
||||
isometric_room_gen/
|
||||
├── __init__.py
|
||||
```
|
||||
Loading…
Reference in New Issue