基于RoomPlan SDK的墙体/门角点计算与绘制技术问询

核心参数的本质意义 #

RoomPlan返回的Surface对象里，**dimensions和transform**是空间定位的核心，先搞懂它们的作用：

• dimensions：是Surface在自身局部坐标系下的尺寸，顺序为[width, height, length]。局部坐标系是每个Surface自己的“专属坐标系”，原点通常在Surface的几何中心。
• transform：是一个4×4的齐次变换矩阵，核心作用是把局部坐标系下的点，转换到RoomPlan扫描出来的世界坐标系（全局空间）里。这个矩阵的结构很关键：
  • 第4列（索引为3的元素）：对应局部坐标系原点在世界坐标系中的位置（比如墙/门的中心点）。
  • 前3列：分别是局部坐标系的X（右）、Y（上）、Z（前/厚度方向）轴的单位方向向量，代表局部轴在世界空间中的朝向。

墙体角点的计算步骤 #

墙本质是一个带厚度的矩形几何体，我们先算正面（朝向房间内部的面）的四个角点，再扩展到整个墙体：

1. 确定局部坐标系下的角点：
   假设墙的局部原点在几何中心，那么正面的四个角点在局部坐标系中的坐标为：
   • 左上：(-width/2, height/2, 0)
   • 右上：(width/2, height/2, 0)
   • 右下：(width/2, -height/2, 0)
   • 左下：(-width/2, -height/2, 0)
     （注：length是墙的厚度，对应Z轴方向，背面的角点只需要把Z坐标换成length或-length即可，具体取决于局部Z轴的朝向）
2. 转换到世界坐标系：
   把每个局部坐标点转换成齐次坐标（添加第4个分量1，即(x, y, z, 1)），然后和transform矩阵做乘法运算，得到的结果就是该点在世界空间中的真实坐标。

门角点的计算逻辑（对应苹果官方代码） #

门的角点计算是基于“中心点+方向偏移”的思路，苹果官方给出的代码示例就是这个逻辑的实现：

upperLeftPoint = Point(centerPoint) 
upperLeftPoint = upperLeftPoint.translate(rightV.negate(), doorWidth/2) 
upperLeftPoint = upperLeftPoint.translate(upV, doorHeight/2)

拆解理论逻辑：

1. 获取门的世界中心点：
   门的transform矩阵第4列就是局部原点（门的几何中心）在世界坐标系中的位置，也就是代码里的centerPoint。
2. 提取局部方向向量：
   rightV是门局部坐标系的X轴方向向量（从transform的第一列提取），upV是局部Y轴方向向量（从第二列提取）。
3. 偏移得到角点：
   • 往rightV的反方向移动doorWidth/2：门的宽度对应局部X轴的长度，从中心往左（X负方向）移半宽，就能得到门的左边缘位置。
   • 往upV方向移动doorHeight/2：门的高度对应局部Y轴的长度，从中心往上（Y正方向）移半高，就能得到门的上边缘位置。
     按这个逻辑，你可以轻松推导出门的其他三个角点（比如右上角就是往rightV正方向移半宽，往上移半高）。

绘制墙体线条的思路 #

拿到世界坐标系下的所有角点后，只需要按顺序连接对应的点即可：

• 绘制单面墙的轮廓：按顺时针或逆时针顺序连接正面的四个角点，形成闭合的矩形线条。
• 绘制带厚度的墙体：同时计算正面和背面的四个角点，然后连接正面和背面对应的顶点（比如正面左上连背面左上），再连接正面/背面的四个角点，就能形成完整的墙体框架。

内容的提问来源于stack exchange，提问作者Qedrix