如何通过Revit API判断点(X,Y,Z)是否处于FamilyInstance内部？

之前用get_BoundingBox的轴对齐外包盒判断，在构件倾斜时会误判，因为外包盒会覆盖构件实际范围外的区域。要准确判断点是否在FamilyInstance内部，核心是基于构件的**实际几何实体（Solid）**做检测，以下是具体实现思路和方法：

核心方法：基于实体的点-in-实体判断 #

Revit API提供了BooleanOperationsUtils.PointInSolid方法，可直接判断点是否位于Solid内部。步骤如下：

1. 获取构件的几何实体
   通过FamilyInstance.get_Geometry(Options)方法获取构件的几何元素，注意配置Options参数：

   • 设置DetailLevel = ViewDetailLevel.Fine，确保拿到完整的精细几何；
   • 开启ComputeReferences = true，保证几何对象的参考有效。

2. 过滤有效Solid
   遍历几何元素，筛选出体积大于0的Solid（排除空的或非实体的几何，比如线、面）。如果是嵌套族，还需要递归处理GeometryInstance类型的嵌套几何。

3. 坐标转换
   FamilyInstance的几何实体是基于自身局部坐标系的，需要将待判断的项目坐标系下的点，转换为构件局部坐标系下的点，再传入PointInSolid方法。

4. 执行判断
   对每个有效Solid执行点-in-实体检测，只要有一个Solid包含该点，即判定点在构件内部。

代码示例（C#） #

public bool IsPointInsideFamilyInstance(FamilyInstance familyInst, XYZ projectPoint)
{
    // 配置几何获取选项
    Options geoOptions = new Options
    {
        DetailLevel = ViewDetailLevel.Fine,
        ComputeReferences = true
    };

    GeometryElement geoElement = familyInst.get_Geometry(geoOptions);
    Transform familyTransform = familyInst.GetTransform();

    foreach (GeometryObject geoObj in geoElement)
    {
        // 处理直接的Solid
        if (geoObj is Solid solid && solid.Volume > 0)
        {
            XYZ localPoint = familyTransform.Inverse.OfPoint(projectPoint);
            if (BooleanOperationsUtils.PointInSolid(solid, localPoint))
            {
                return true;
            }
        }
        // 处理嵌套族的几何实例
        else if (geoObj is GeometryInstance geoInst)
        {
            Transform instTransform = geoInst.Transform;
            GeometryElement instGeo = geoInst.GetInstanceGeometry();
            
            foreach (GeometryObject instObj in instGeo)
            {
                if (instObj is Solid instSolid && instSolid.Volume > 0)
                {
                    // 先转构件局部坐标，再转嵌套实例的局部坐标
                    XYZ familyLocalPoint = familyTransform.Inverse.OfPoint(projectPoint);
                    XYZ instLocalPoint = instTransform.Inverse.OfPoint(familyLocalPoint);
                    
                    if (BooleanOperationsUtils.PointInSolid(instSolid, instLocalPoint))
                    {
                        return true;
                    }
                }
            }
        }
    }

    return false;
}

注意事项 #

• 嵌套族处理：如果FamilyInstance包含嵌套族，必须递归遍历GeometryInstance中的几何实体，避免遗漏嵌套部分的判断。
• 性能优化：频繁调用时，建议缓存构件的几何实体，避免重复获取几何数据，提升效率。
• 坐标系校验：确保点和Solid处于同一坐标系，转换时注意Transform.Inverse.OfPoint的正确使用。

内容的提问来源于stack exchange，提问作者黃衍齊