如何将Forge SectionBox映射回Revit

你提到的Revit 3D视图裁剪需要用BoundingBoxXYZ而非直接定义平面，这个说法是正确的。Revit的裁剪盒本质是带自定义变换的轴对齐边界盒：通过Transform属性定义盒的空间朝向，Min和Max定义局部坐标系下的范围。

反向转换实现思路 #

要将Forge的6个裁剪平面还原为Revit的BoundingBoxXYZ，需完成以下核心步骤：

• 单位转换：Forge使用米作为单位，Revit内部使用英尺，需将平面参数转换回英尺（转换系数为1 / 0.3048）。
• 提取坐标系：从6个平面中分离出X/Y/Z三个轴的方向向量（对应平面的法向量），构建裁剪盒的变换矩阵。
• 计算边界范围：针对每个轴方向，计算两个平行平面到原点的距离，得到局部坐标系下的Min和Max值。
• 确定变换原点：通过求解三个相邻平面的交点，得到裁剪盒局部坐标系在世界空间中的原点。

代码实现 #

private BoundingBoxXYZ GetBoundingBoxFromCutPlanes(List<double[]> forgePlanes)
{
    // 单位转换系数：米转英尺
    const double metersToFeet = 1 / 0.3048;

    // 提取Forge传入的6个平面，对应X-min, X-max, Y-min, Y-max, Z-min, Z-max
    double[] xMinPlane = forgePlanes[0];
    double[] xMaxPlane = forgePlanes[1];
    double[] yMinPlane = forgePlanes[2];
    double[] yMaxPlane = forgePlanes[3];
    double[] zMinPlane = forgePlanes[4];
    double[] zMaxPlane = forgePlanes[5];

    // 还原轴方向（原转换代码对法向量取反，此处需反向处理）
    XYZ xAxis = new XYZ(-xMinPlane[0], -xMinPlane[1], -xMinPlane[2]).Normalize();
    XYZ yAxis = new XYZ(-yMinPlane[0], -yMinPlane[1], -yMinPlane[2]).Normalize();
    XYZ zAxis = new XYZ(-zMinPlane[0], -zMinPlane[1], -zMinPlane[2]).Normalize();

    // 构建线性方程组，求解X-min/Y-min/Z-min三个平面的交点（裁剪盒局部原点的世界坐标）
    double[,] matrix = new double[3, 3]
    {
        {xMinPlane[0], xMinPlane[1], xMinPlane[2]},
        {yMinPlane[0], yMinPlane[1], yMinPlane[2]},
        {zMinPlane[0], zMinPlane[1], zMinPlane[2]}
    };
    double[] constants = new double[3]
    {
        -xMinPlane[3],
        -yMinPlane[3],
        -zMinPlane[3]
    };

    // 克莱姆法则求解线性方程组（因平面正交，矩阵必可逆）
    double det = matrix[0,0]*(matrix[1,1]*matrix[2,2]-matrix[1,2]*matrix[2,1]) 
               - matrix[0,1]*(matrix[1,0]*matrix[2,2]-matrix[1,2]*matrix[2,0]) 
               + matrix[0,2]*(matrix[1,0]*matrix[2,1]-matrix[1,1]*matrix[2,0]);

    double detX = constants[0]*(matrix[1,1]*matrix[2,2]-matrix[1,2]*matrix[2,1]) 
                - matrix[0,1]*(constants[1]*matrix[2,2]-matrix[1,2]*constants[2]) 
                + matrix[0,2]*(constants[1]*matrix[2,1]-matrix[1,1]*constants[2]);

    double detY = matrix[0,0]*(constants[1]*matrix[2,2]-matrix[1,2]*constants[2]) 
                - constants[0]*(matrix[1,0]*matrix[2,2]-matrix[1,2]*matrix[2,0]) 
                + matrix[0,2]*(matrix[1,0]*constants[2]-constants[1]*matrix[2,0]);

    double detZ = matrix[0,0]*(matrix[1,1]*constants[2]-constants[1]*matrix[2,1]) 
                - matrix[0,1]*(matrix[1,0]*constants[2]-constants[1]*matrix[2,0]) 
                + constants[0]*(matrix[1,0]*matrix[2,1]-matrix[1,1]*matrix[2,0]);

    // 转换为英尺单位的世界坐标原点
    XYZ origin = new XYZ(detX/det * metersToFeet, detY/det * metersToFeet, detZ/det * metersToFeet);

    // 构建裁剪盒的变换矩阵
    Transform transform = Transform.Identity;
    transform.Origin = origin;
    transform.BasisX = xAxis;
    transform.BasisY = yAxis;
    transform.BasisZ = zAxis;

    // 计算局部坐标系下的Min/Max值
    double localXMin = (-xMinPlane[3] * metersToFeet) - xAxis.DotProduct(origin);
    double localXMax = (-xMaxPlane[3] * metersToFeet) - xAxis.DotProduct(origin);
    double localYMin = (-yMinPlane[3] * metersToFeet) - yAxis.DotProduct(origin);
    double localYMax = (-yMaxPlane[3] * metersToFeet) - yAxis.DotProduct(origin);
    double localZMin = (-zMinPlane[3] * metersToFeet) - zAxis.DotProduct(origin);
    double localZMax = (-zMaxPlane[3] * metersToFeet) - zAxis.DotProduct(origin);

    // 确保Min为较小值，Max为较大值
    XYZ minLocal = new XYZ(Math.Min(localXMin, localXMax), Math.Min(localYMin, localYMax), Math.Min(localZMin, localZMax));
    XYZ maxLocal = new XYZ(Math.Max(localXMin, localXMax), Math.Max(localYMin, localYMax), Math.Max(localZMin, localZMax));

    // 创建并返回Revit BoundingBoxXYZ
    BoundingBoxXYZ bbox = new BoundingBoxXYZ();
    bbox.Transform = transform;
    bbox.Min = minLocal;
    bbox.Max = maxLocal;

    return bbox;
}

关键注意事项 #

• 输入的Forge平面必须是正交且成对平行的，这是Revit BoundingBoxXYZ的硬性要求（Revit不支持非正交的斜切裁剪盒）。
• 严格遵守单位转换规则：Revit API所有几何参数默认使用英尺，即使项目显示单位为米，也必须转换为英尺计算。
• 代码中使用克莱姆法则求解平面交点，因Forge SectionBox的平面是正交的，不会出现行列式为0的异常情况。

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