跳到主要内容

检查器面板

检查器面板是项目视图中的右侧面板。它提供场景的详细信息,并允许你编辑生成的室内场景的各个方面。面板包含两个标签页:场景检查器

场景标签页

场景标签页是管理项目内场景的入口。

场景列表

项目中所有场景的可滚动列表。每条记录显示:

  • 场景的 缩略图预览
  • 场景名称和创建日期
  • 点击场景即可在 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 生成越准确。如果分数较低,建议上传更高分辨率的户型图图片。