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

萧闫子

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

NewReferencePlane定义如下：

1. <p>
   
2. </p><p>[c-sharp] view plaincopy</p><p>public ReferencePlane NewReferencePlane(  </p><p>    XYZ bubbleEnd,  </p><p>    XYZ freeEnd,  </p><p>    XYZ cutVec,  </p><p>    View pView  </p><p>)  </p><p></p>

复制代码

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



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



知道这个含义就简单了。



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





可以用下面的代码。

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

复制代码

作者：叶雄进

文章来源：http://blog.csdn.net/joexiongjin/article/category/782739

AK47

顶...... 楼下跟上.....