Revit API: Roof 屋顶

前言

在构件中，屋顶的在几何形体上，作为单体几乎是最复杂的，也是最变化多端的。迹线屋顶、拉伸屋顶和面屋顶，统称为屋顶，但他们的造型形式差异很大。另外屋檐的变化也很多，封檐带、檐底板、檐沟，这些都导致了屋顶的变化有很多。

内容

Revit 屋顶示例文件
Revit 可以创建如下图这样的组合屋顶。

组合屋顶
示例模型使用了屋顶图元组合以构成总屋顶。 可以分别选择和编辑每个屋顶图元。

1. 使用了屋顶连接工具以将不同屋顶图元与老虎窗图元连接在一起。
2. 使用了“老虎窗洞口”工具以在主屋顶上剪切老虎窗洞口。
3. 结合使用了坡度箭头与屋顶边，从而创建带有共享屋檐线的老虎窗。
4. 较大老虎窗上的屋顶边由内建空心图元剪切而成。
5. “荷兰式山墙屋顶”通过 2个屋顶图元生成。构成较低部分的第一个屋顶使用“截断标高”属性和“截断偏移”创建，第二个屋顶则创建并放置在第一个屋顶的“截断标高”处。就位后，2个屋顶图元会连接在一起。

屋顶的 API：

迹线屋顶

官方按迹线创建屋顶的方法

迹线屋顶有几个特点：

1. 它是由水平的一个闭合轮廓组成
2. 每条边可以设置坡度
3. 每条边可以设置与屋顶的基准偏移

创建迹线屋顶的 API:

// Autodesk.Revit.Creation::Document
public FootPrintRoof NewFootPrintRoof(
	CurveArray footPrint,
	Level level,
	RoofType roofType,
	out ModelCurveArray footPrintToModelCurvesMapping
)

设定迹线屋顶的倾斜角度、偏移和与屋顶的基准偏移：

// FootPrintRoof::DefinesSlope
public bool this[
	ModelCurve pCurve
] { get; set; }

// FootPrintRoof::Offset
public double this[
	ModelCurve pCurve
] { get; set; }

// FootPrintRoof::Overhang
public double this[
	ModelCurve pCurve
] { get; set; }

拉伸屋顶

拉伸屋顶本质上是通过线来定义的，而这些线都在一个竖直平面上。
创建拉伸屋顶的 API:

// Autodesk.Revit.Creation::Document
public ExtrusionRoof NewExtrusionRoof(
	CurveArray profile, 		// 拉伸的轮廓线
	ReferencePlane refPlane, 	// 竖直的参考平面
	Level level, 				// 楼层
	RoofType roofType, 			// 屋顶的类型
	double extrusionStart, 		// 拉伸的起点
	double extrusionEnd  		// 拉伸的终点
)

面屋顶

Revit 没有暴露创建面屋顶的 API，因此面屋顶会显示成 RoofBase。