Revit Family API 添加对齐

没测试成功，留待以后研究。

[TransactionAttribute(Autodesk.Revit.Attributes.TransactionMode.Manual)]
public  class cmdAddAlignment : IExternalCommand
{
     // 创建对齐，把一个面对齐到参考面。
     void AddAlignment_ReferencePlane(Application app, Document doc, Extrusion pSolid, XYZ normal,  string nameRefPlane)
    {
        View pViewPlan = Util.findElement(doc,  typeof(ViewPlan),  " Lower Ref. Level ")  as View;
        ReferencePlane refPlane = Util.findElement(doc,  typeof(ReferencePlane), nameRefPlane)  as ReferencePlane;
        PlanarFace pFace = findFace(app, pSolid, normal, refPlane);
        doc.FamilyCreate.NewAlignment(pViewPlan, refPlane.Reference, pFace.Reference);
    }
     // 对齐到楼层
     void AddAlignment_Level(Document doc, Extrusion pSolid, XYZ normal,  string nameLevel)
    {
        View pView = Util.findElement(doc,  typeof(View),  " Front ")  as View;
        Level pLevel = Util.findElement(doc,  typeof(Level), nameLevel)  as Level;
        PlanarFace pFace = Util.findFace(pSolid, normal);
        doc.FamilyCreate.NewAlignment(pView, pLevel.PlaneReference, pFace.Reference);
    }
     void AddAlignments(Application app, Document doc, Extrusion pSolid)
    {
        AddAlignment_Level(doc, pSolid,  new XYZ( 0.0,  0.0,  1.0),  " Upper Ref Level ");
        AddAlignment_Level(doc, pSolid,  new XYZ( 0.0,  0.0, - 1.0),  " Lower Ref. Level ");
        AddAlignment_ReferencePlane(app, doc, pSolid,  new XYZ( 1.0,  0.0,  0.0),  " Right ");
        AddAlignment_ReferencePlane(app, doc, pSolid,  new XYZ(- 1.0,  0.0,  0.0),  " Left ");
        AddAlignment_ReferencePlane(app, doc, pSolid,  new XYZ( 0.0, - 1.0,  0.0),  " Front ");
        AddAlignment_ReferencePlane(app, doc, pSolid,  new XYZ( 0.0,  1.0,  0.0),  " Back ");
        AddAlignment_ReferencePlane(app, doc, pSolid,  new XYZ( 1.0,  0.0,  0.0),  " OffsetV ");
        AddAlignment_ReferencePlane(app, doc, pSolid,  new XYZ( 0.0,  1.0,  0.0),  " OffsetH ");
    }
     //  ===============================================================
     //  helper function: given a solid, find a planar 
     // Extrusion实体，给一个实体，给一个方向，找到与此方向一致的面。
     //  face with the given normal (version 2)
     //  this is a slightly enhaced version of the previous 
     //  version and checks if the face is on the given reference plane.
     //  ===============================================================
    PlanarFace findFace(Application app, Extrusion pBox, XYZ normal, ReferencePlane refPlane)
    {
         //  get the geometry object of the given element
         //
        Options op =  new Options();
        op.ComputeReferences =  true;
        GeometryObjectArray geomObjs = pBox.get_Geometry(op).Objects;

         //  loop through the array and find a face with the given normal
         //
         foreach (GeometryObject geomObj  in geomObjs)
        {
             if (geomObj  is Solid)   //  solid is what we are interested in.
            {
                Solid pSolid = geomObj  as Solid;
                FaceArray faces = pSolid.Faces;
                 foreach (Face pFace  in faces)
                {
                    PlanarFace pPlanarFace = (PlanarFace)pFace;
                     //  check to see if they have same normal
                     // face.Normal是面的向量。IsAlmostEqualTo();
                     if ((pPlanarFace !=  null) && pPlanarFace.Normal.IsAlmostEqualTo(normal))
                    {
                         //  additionally, we want to check if the face is on the reference plane
                         // 还要判断面是否在参考平面上。
                        XYZ p0 = refPlane.BubbleEnd; // 终点?
                        XYZ p1 = refPlane.FreeEnd; // 起点?
                        Line pCurve = app.Create.NewLineBound(p0, p1);
                         if (pPlanarFace.Intersect(pCurve) == SetComparisonResult.Subset) // 子集
                        {
                             return pPlanarFace;  //  we found the face
                        }
                    }
                }
            }

             //  will come back later as needed.
             //
             // else if (geomObj is Instance)
             // {
             // }
             // else if (geomObj is Curve)
             // {
             // }
             // else if (geomObj is Mesh)
             // {
             // }
        }

         //  if we come here, we did not find any.
         return  null;
    }
     public Result Execute(ExternalCommandData commandData,  ref  string messages, ElementSet elements)
    {
        UIApplication app = commandData.Application;
        Document doc = app.ActiveUIDocument.Document;

        Transaction ts =  new Transaction(doc,  " http://revit.5d6d.com ");
        ts.Start();

         //
        Extrusion pSolid = CreateSolid(app.Application, doc);
        AddAlignments(app.Application, doc, pSolid);

        ts.Commit();

         return Result.Succeeded;
    }
     // 创建封闭曲线
    CurveArrArray createProfileLShape(Application _rvtApp)
    {
         //
         //  define a simple L-shape profile
         //
         //   5 tw 4
         //    +-+
         //    | | 3          h = height
         //  d | +---+ 2
         //    +-----+ td
         //   0        1
         //   6  w
         //

         //  sizes (hard coded for simplicity)
         //  note: these need to match reference plane. otherwise, alignment won't work.
         //  as an exercise, try changing those values and see how it behaves.
         //
         double w = Util.mmToFeet( 600.0);  //  those are hard coded for simplicity here. in practice, you may want to find out from the references)
         double d = Util.mmToFeet( 600.0);
         double tw = Util.mmToFeet( 150.0);  //  thickness added for Lab2
         double td = Util.mmToFeet( 150.0);

         //  define vertices
         //
         const  int nVerts =  6;  //  the number of vertices

        XYZ[] pts =  new XYZ[] {
new XYZ(-w /  2.0, -d /  2.0,  0.0),
new XYZ(w /  2.0, -d /  2.0,  0.0),
new XYZ(w /  2.0, (-d /  2.0) + td,  0.0),
new XYZ((-w /  2.0) + tw, (-d /  2.0) + td,  0.0),
new XYZ((-w /  2.0) + tw, d /  2.0,  0.0),
new XYZ(-w /  2.0, d /  2.0,  0.0),
new XYZ(-w /  2.0, -d /  2.0,  0.0) };   //  the last one is to make the loop simple

         //  define a loop. define individual edges and put them in a curveArray
         //
        CurveArray pLoop = _rvtApp.Create.NewCurveArray();
         for ( int i =  0; i < nVerts; ++i)
        {
            Line line = _rvtApp.Create.NewLineBound(pts[i], pts[i +  1]);
            pLoop.Append(line);
        }

         //  then, put the loop in the curveArrArray as a profile
         //
        CurveArrArray pProfile = _rvtApp.Create.NewCurveArrArray();
        pProfile.Append(pLoop);
         //  if we come here, we have a profile now.

         return pProfile;
    }
    Extrusion CreateSolid(Application app, Document doc)
    {
        CurveArrArray pProfile = createProfileLShape(app);
         // 这个参考平面模板中没有，可以切换到Front立面，自己画一个。
        ReferencePlane pRefPlane = Util.findElement(doc,  typeof(ReferencePlane),  " Reference Plane ")  as ReferencePlane;
        SketchPlane pSketchPlane = doc.FamilyCreate.NewSketchPlane(pRefPlane.Plane);
         double dHeight = Util.mmToFeet( 4000);
         bool bIsSolid =  true;
        Extrusion pSolid = doc.FamilyCreate.NewExtrusion(bIsSolid, pProfile, pSketchPlane, dHeight);
         return pSolid;
    }
}
public  class Util
{
     // Revit内部单位feet转化为mm即毫米
     public  static  double mmToFeet( double val) {  return val /  304.8; }
     public  static  double feetToMm( double val) {  return val *  304.8; }
     // 通过类型与名称找Element
     public  static Element findElement(Document _rvtDoc, Type targetType,  string targetName)
    {
         //  get the elements of the given type
         //
        FilteredElementCollector collector =  new FilteredElementCollector(_rvtDoc);
        collector.WherePasses( new ElementClassFilter(targetType));

         //  parse the collection for the given name
         //  using LINQ query here. 
         //  
         var targetElems =  from element  in collector  where element.Name.Equals(targetName)  select element;
        List<Element> elems = targetElems.ToList<Element>();

         if (elems.Count >  0)
        {   //  we should have only one with the given name. 
             return elems[ 0];
        }

         //  cannot find it.
         return  null;
    }
     //  =============================================================
     //    helper function: find a planar face with the given normal
     //  =============================================================
     public  static PlanarFace findFace(Extrusion pBox, XYZ normal)
    {
         //  get the geometry object of the given element
         //
        Options op =  new Options();
        op.ComputeReferences =  true;
        GeometryObjectArray geomObjs = pBox.get_Geometry(op).Objects;

         //  loop through the array and find a face with the given normal
         //
         foreach (GeometryObject geomObj  in geomObjs)
        {
             if (geomObj  is Solid)   //  solid is what we are interested in.
            {
                Solid pSolid = geomObj  as Solid;
                FaceArray faces = pSolid.Faces;
                 foreach (Face pFace  in faces)
                {
                    PlanarFace pPlanarFace = (PlanarFace)pFace;
                     if ((pPlanarFace !=  null) && pPlanarFace.Normal.IsAlmostEqualTo(normal))  //  we found the face
                    {
                         return pPlanarFace;
                    }
                }
            }
             //  will come back later as needed.
             //
             // else if (geomObj is Instance)
             // {
             // }
             // else if (geomObj is Curve)
             // {
             // }
             // else if (geomObj is Mesh)
             // {
             // }
        }

         //  if we come here, we did not find any.
         return  null;
    }
     #region Formatting and message handlers
     public  const  string Caption =  " Revit Family API Labs ";

     ///   <summary>
     ///  MessageBox wrapper for informational message.
     ///   </summary>
     public  static  void InfoMsg( string msg)
    {

        System.Diagnostics.Debug.WriteLine(msg);
        WinForm.MessageBox.Show(msg, Caption, WinForm.MessageBoxButtons.OK, WinForm.MessageBoxIcon.Information);
    }

     ///   <summary>
     ///  MessageBox wrapper for error message.
     ///   </summary>
     public  static  void ErrorMsg( string msg)
    {
        WinForm.MessageBox.Show(msg, Caption, WinForm.MessageBoxButtons.OK, WinForm.MessageBoxIcon.Error);
    }
     #endregion  //  Formatting and message handlers
}

url: http://greatverve.cnblogs.com/p/revit-family-api-add-alignment.html