检查器面板
检查器面板是项目视图中的右侧面板。它提供场景的详细信息,并允许你编辑生成的室内场景的各个方面。面板包含两个标签页:场景 和 检查器。
场景标签页
场景标签页是管理项目内场景的入口。
场景列表
项目中所有场景的可滚动列表。每条记录显示:
- 场景的 缩略图预览
- 场景名称和创建日期
- 点击场景即可在 3D 查看器中加载
户型图预览
场景列表下方会显示原始上传户型图的预览。这有助于你在 3D 编辑过程中参考 2D 布局。
项目信息
基本的项目元数据:
- 项目名称和描述
- 创建日期
- 当前风格预设
纹理选择器
按类别(地板、墙面、天花板)组织的纹理视觉网格。点击纹理可预览,或通过 检查器标签页 将其分配到表面。
检查器标签页
检查器标签页展示了定义 3D 场景的完整 HomeSceneJSON 数据结构,按可折叠分区组织。
分区
每个分区对应场景 JSON 中的一个顶层键:
| 分区 | 内容 |
|---|---|
| Objects | 场景中放置的家具和装饰物品 |
| Rooms | 房间定义,包括尺寸和位置 |
| Walls | 墙体线段,包括高度、厚度和连接的房间 |
| Openings | 门窗,包括宽度、高度和墙体引用 |
| Materials | 纹理分配和材质属性 |
| Lights | 光源(类型、位置、颜色、强度) |
| Cameras | 已保存的相机位置和方向 |
可折叠标题
每个分区标题可以点击展开或折叠。标题上的 数量徽标 显示该分区中有多少项(如 "Objects (12)")。
可视卡片与 JSON 编辑器
每个分区提供两种查看模式,通过分区顶部的 JSON 开关 切换:
-
可视卡片(默认)-- 每个项目以卡片形式显示,包含带标签的可编辑字段:
- 数字输入框,用于尺寸(宽、高、深)
- Vec3 输入框,用于位置、旋转和缩放(X、Y、Z 字段)
- 色板,用于材质颜色和灯光颜色
- 下拉选择器,用于枚举值(灯光类型、材质预设等)
-
JSON 编辑器 -- 一个内联的 CodeMirror 原始编辑器,显示该分区的 JSON 数据。适合批量编辑或尚未在可视卡片中暴露的字段。
信息
在可视卡片和 JSON 之间切换不会丢失你的编辑。两种视图反映的是同一份底层数据。
双向编辑
检查器和 3D 查看器是紧密联动的:
- 在检查器中编辑(修改位置值、更换颜色)会立即更新 3D 视图。
- 在 3D 视图中编辑(在 编辑模式 下使用 TransformControls 移动物体)会立即更新检查器中对应的字段。
这种双向同步意味着你可以根据具体任务选择更方便的界面。
解析质量徽标
在检查器标签页顶部,解析质量徽标 总结了户型图的解析效果,包含以下进度条:
- 房间检测 -- 成功识别的房间百分比
- 墙体精度 -- 提取的墙体与原始图纸的吻合程度
- 开口检测 -- 找到的门窗百分比
分数越高通常意味着 3D 生成越准确。如果分数较低,建议上传更高分辨率的户型图图片。