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

 

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

NewReferencePlane定义如下：

public ReferencePlane NewReferencePlane( XYZ bubbleEnd, XYZ freeEnd, XYZ cutVec, View pView )

 

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

 

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

 

知道这个含义就简单了。

 

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

 

可以用下面的代码。

 

using System; using System.Collections.Generic; using System.Text; using System.Windows.Forms; using Autodesk.Revit .DB; using Autodesk.Revit.UI; using Autodesk.Revit .ApplicationServices; using Autodesk.Revit.Attributes ; [TransactionAttribute(Autodesk.Revit.Attributes.TransactionMode.Manual)] [RegenerationAttribute(Autodesk.Revit.Attributes.RegenerationOption.Manual)] public class RevitCommand : IExternalCommand { public Result Execute(ExternalCommandData commandData, ref string messages, ElementSet elements) { UIApplication app = commandData.Application; Document doc = app.ActiveUIDocument.Document; Transaction trans = new Transaction(doc, "ExComm"); trans.Start(); // create the reference plane. XYZ bubbleEnd = new XYZ(5,10,0); XYZ freeEnd = new XYZ(10,5,0); XYZ cutNorm = new XYZ(0,0,1); ReferencePlane rp1 = doc.FamilyCreate.NewReferencePlane(bubbleEnd, freeEnd, cutNorm, doc.ActiveView); rp1.Name = "my test43"; trans.Commit(); return Result.Succeeded ; } }