澄清创建参考面函数参数含义

萧闫子

用API创建族的时候，常常用到创建参考面，可以用 Autodesk.Create.Document.FamilyCreate.NewReferencePlane()方法和NewReferencePlane2() 方法创建. 这里我们只谈第一个函数。因为它有一个向量参数的含义比较模糊。方法二需要指定参考面上的三个点即可。

NewReferencePlane定义如下：

1. 
   
2. 
   
3. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">[c-sharp] view plaincopy</span>
   
4. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">public ReferencePlane NewReferencePlane(  </span>
   
5. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    XYZ bubbleEnd,  </span>
   
6. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    XYZ freeEnd,  </span>
   
7. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    XYZ cutVec,  </span>
   
8. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    View pView  </span>
   
9. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">)  </span>
   

复制代码

他可以用两个点外加一个向量在指定的视图上创建参考面。



这里第三个参数的向量在RevitAPI.chm中的解释是：The cut vector apply to reference plane, should perpendicular to the vector (bubbleEnd-freeEnd).    cut vector 的含义好像不是一个专有名词，无法找到解释。这个cutVec向量参数的含义是这个向量必须在需要创建的参考平面的里面，相当于切线向量吧。而不是需要创建参考面的法向量。这一点最容易误解。



知道这个含义就简单了。



例如我们想创建一个水平面上45度斜参考平面。如下参考面。





可以用下面的代码。

1. 
   
2. 
   
3. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">[c-sharp] view plaincopy</span>
   
4. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using System;  </span>
   
5. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using System.Collections.Generic;  </span>
   
6. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using System.Text;  </span>
   
7. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using System.Windows.Forms;  </span>
   
8. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
   
9. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using  Autodesk.Revit .DB;  </span>
   
10. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using Autodesk.Revit.UI;  </span>
    
11. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using Autodesk.Revit .ApplicationServices;  </span>
    
12. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">using Autodesk.Revit.Attributes ;  </span>
    
13. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
14. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
15. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
16. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  [TransactionAttribute(Autodesk.Revit.Attributes.TransactionMode.Manual)]  </span>
    
17. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  [RegenerationAttribute(Autodesk.Revit.Attributes.RegenerationOption.Manual)]  </span>
    
18. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">public class RevitCommand : IExternalCommand  </span>
    
19. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">{  </span>
    
20. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    public Result Execute(ExternalCommandData commandData, ref string messages, ElementSet elements)  </span>
    
21. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    {  </span>
    
22. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
23. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      UIApplication app = commandData.Application;  </span>
    
24. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      Document doc = app.ActiveUIDocument.Document;  </span>
    
25. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      Transaction trans = new Transaction(doc, "ExComm");  </span>
    
26. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      trans.Start();  </span>
    
27. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
28. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
29. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      // create the reference plane.  </span>
    
30. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      XYZ bubbleEnd = new XYZ(5,10,0);  </span>
    
31. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      XYZ freeEnd = new XYZ(10,5,0);  </span>
    
32. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">        </span>
    
33. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      XYZ cutNorm = new XYZ(0,0,1);  </span>
    
34. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
35. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
36. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      ReferencePlane rp1 = doc.FamilyCreate.NewReferencePlane(bubbleEnd, freeEnd, cutNorm, doc.ActiveView);  </span>
    
37. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      rp1.Name = "my test43";  </span>
    
38. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">  </span>
    
39. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      trans.Commit();  </span>
    
40. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">      </span>
    
41. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">        return Result.Succeeded ;  </span>
    
42. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">    }  </span>
    
43. <span style="color: rgb(105, 105, 105); font-family: 'Microsoft Yahei', Simsun; ">}  </span>

复制代码

转自：http://blog.csdn.net/joexiongjin/article/details/6202804 作者：叶雄进

宇航员

(*^__^*) 嘻嘻……

木鬼

(*^__^*) 嘻嘻……

萧闫子

(*^__^*) 嘻嘻……

野风

顶起来…………

长风

顶!!!!!!!!!!

龙龙..!

顶！！！！！！！！！！！！

爬爬``PA

谢谢老师…

We晕晕

了解下BIM..... ]

矮矮

谢谢BIM大神…

茶神idg

谢谢BIM大神…

大洪p1938

非常感谢！！

AK47

谢谢！！！
帮顶……

风吹枫落

顶!!!!!!!!!!

苦田辛君

谢谢BIM大神…

飞天舞

顶！！！！！！！！！！！！