Revit二次开发用API创建拉伸体
一、Revit拉伸介绍
拉伸是最容易创建的形状。可以在工作平而上绘制形状的二维轮廓，然后拉伸该轮廓使其与绘制它的平面垂直。根据描述，拉伸操作需要三个输入：
①工作平面；
②工作平面上的二维轮廊（必须闭合）；
③拉伸的长度。
在界面上，如要拉伸墙到弧形屋顶，操作的大体步骤如下图。
①：选择工作平面
②：选择一个绘制屋顶的视图
③：切换至北立面，确定绘制标高为“标高2”，无偏移。
④：用“起点-终点-半径弧”工具创建拉伸屋顶的轮廓，最后“完成编辑模式”。
在Revit API需要这三个输人来创建拉伸图元。创建拉伸图元的函数如下：
Autodesk.Revit.Creation.FamilyltemFactory 类：Extrusion NewExtrusion( bool isSolid，CurveArrArray profile，SketchPlanesketchPlane，double end)。
参数说明：
• isSolid:说明该拉伸是实体还是剪切体
• profile: —个平面上的二维轮廓(必须闭合）
• sketchPlane：工作平面
• end:拉伸长度
注意：
① 拉伸的方向由工作平面的法向量确定。
② API中，并不要求二维轮廊一定要在sketchPlane工作平面上（大多数情况下，二维轮廓是在工作平面上的），它们之间必须满足的是二维轮廓所在在平面和工作平面一定要平行。
代码：创建拉伸体。
private Autodesk.Revit.ApplicationServices.Application m_revit;
private Document m_familyDocument; // 已获得族文档的实例
// 创建工作平面的函数，输入为平面的原点和法向量
internal SketchPlane CreateSketchPlane(Autodesk.Revit.DB.XYZ normal, Autodesk.Revit.DB.XYZ origin)
{
// 首先创建几何平面
Plane geometryPlane = m_revit.Create.NewPlane(normal, origin);
if (null == geometryPlane)
{
return null;
}
// 根绝几何平面创建工作平面
SketchPlane plane = SketchPlane.Create(m_familyDocument, geometryPlane);
if (null == plane)
{
return null;
}
return plane;
}
// 创建用于拉伸的轮廓线
private CurveArrArray CreateExtrusionProfile()
{
// 轮廓线可以包括一个或者多个闭合的轮廓，所以最后返回是CurveArrArray
CurveArrArray curveArrArray = new CurveArrArray();
CurveArray curveArray1 = new CurveArray();
// 创建一个正方体的轮廓线，先创建点，再创建线，最后组合成轮廓。
Autodesk.Revit.DB.XYZ p0 = Autodesk.Revit.DB.XYZ.Zero;
Autodesk.Revit.DB.XYZ p1 = new Autodesk.Revit.DB.XYZ(10, 0, 0);
Autodesk.Revit.DB.XYZ p2 = new Autodesk.Revit.DB.XYZ(10, 10, 0);
Autodesk.Revit.DB.XYZ p3 = new Autodesk.Revit.DB.XYZ(0, 10, 0);
Line line1 = Line.CreateBound(p0, p1);
Line line2 = Line.CreateBound(p1, p2);
Line line3 = Line.CreateBound(p2, p3);
Line line4 = Line.CreateBound(p3, p0);
curveArray1.Append(line1);
curveArray1.Append(line2);
curveArray1.Append(line3);
curveArray1.Append(line4);
curveArrArray.Append(curveArray1);
return curveArrArray;
}
private void CreateExtrusion(Autodesk.Revit.Creation.FamilyItemFactory familyCreator)
{
// 调用函数创建拉伸的轮廓线和工作平面
CurveArrArray curveArrArray = CreateExtrusionProfile();
SketchPlane sketchPlane = CreateSketchPlane(XYZ.BasisZ, XYZ.Zero);
// 调用API创建拉伸（实心正方体）
Extrusion rectExtrusion = familyCreator.NewExtrusion(true, curveArrArray, sketchPlane, 10);
// 可能我们会希望把拉伸体移动到希望的位置上
XYZ transPoint1 = new XYZ(-16, 0, 0);
ElementTransformUtils.MoveElement(m_familyDocument, rectExtrusion.Id, transPoint1);
}1) 拉伸属性 ① IsSolid属性:该拉伸是实体还是剪切体。
② Sketch属性:拉伸的草图，包括拉伸的二维轮廓线和工作平面。
③ StartOffset和EndOffset:拉伸相对于工作平面的起始和终止偏移。
2) 草图（Sketch 类）
在Revit中，有一些图元是使用草图模式创建的，例如，工程文件中的楼板、天花板和族文件中的拉伸等。而草图模式是指Revit中的一种环境，使用该环境可绘制其尺寸或形状不能自动确定的图元。Sketch类就是用来访问它创建的草图，包括草图模式中绘制形状和工作平面。
Sketch类属性（只读）：
① Profile:用来获取草图中的轮廊线。
② SketchPlane••用来获取草图中的工作平面。
=========【更多高级应用请关注公众号】========
==================================