前言

本文的主要内容是基于 ReferenceIntersector 的一个应用。ReferenceIntersector 的主要作用是找到一条与给定射线相交的各个元素。

内容

ReferenceIntersector

namespace Autodesk.Revit.DB
{
    public class ReferenceIntersector : IDisposable
    {
        public ReferenceIntersector(View3D view3d);
        public ReferenceIntersector(ElementFilter filter, FindReferenceTarget targetType, View3D view3d);
        public ReferenceIntersector(ICollection<ElementId> targetElementIds, FindReferenceTarget targetType, View3D view3d);
        public ReferenceIntersector(ElementId targetElementId, FindReferenceTarget targetType, View3D view3d);
        ~ReferenceIntersector();
        public bool FindReferencesInRevitLinks { get; set; }
        public bool IsValidObject { get; }
        public FindReferenceTarget TargetType { get; set; }
        public ElementId ViewId { get; set; }
        public sealed override void Dispose();
        public IList<ReferenceWithContext> Find(XYZ origin, XYZ direction);
        public ReferenceWithContext FindNearest(XYZ origin, XYZ direction);
        public ElementFilter GetFilter();
        public ICollection<ElementId> GetTargetElementIds();
        public void SetFilter(ElementFilter filter);
        public void SetTargetElementIds(ICollection<ElementId> elementIds);
        [HandleProcessCorruptedStateExceptions]
        protected virtual void Dispose(bool A_0);
        protected virtual void ReleaseUnmanagedResources(bool disposing);
    }
}

ReferenceIntersector 的关键点：

1. 查找某条射线上的元素的接口

   IList<ReferenceWithContext> Find(XYZ origin, XYZ direction)
   ReferenceWithContext FindNearest(XYZ origin, XYZ direction);
   

2. 可以在构造函数或者通过设置属性的方式设置索引目标类型，FindReferenceTarget

    public enum FindReferenceTarget
    {
        Element = 1,
        Mesh = 2,
        Edge = 4,
        Curve = 8,
        Face = 16,
        All = 31
    }
   

3. 可以在构造函数或者通过接口自定义过滤器，对可以查找的元素进行过滤。

4. 可以在构造函数或者通过接口，在查找之前，设置可供查找的元素的几何。

例子效果及主要流程

效果如下图所示，可以找到和墙相交的各个柱子。图中有弧线墙，而接口只支持射线，例子中用多条射线来模拟弧线，从本质上来说不够严谨，仅能作为示例。

主要流程如下：

结论

该例子可以让用户通过API来处理直线的几何求交问题，可以胜任一些简单的case，对于复杂的情况还有待观察。