Revit SDK 介绍：API Sketched Winder Stairs 创建扇形踏步楼梯

前言

SDK 里面一个复杂的创建楼梯的例子。

程序逻辑

1. 选择模型线，如果是两条，这是L行的楼梯，如果选中三条，则是U行的楼梯；
2. 将 UI 界面的参数转化为内部的参数
3. 创建扇形踏步楼梯

选择模型线

入口：Revit.SDK.Samples.WinderStairs.CS.Command.Execute
运行命令前，请先选择模型线。

参数生成

对话框中的参数会根据选择的模型线而有所不同。

代码：Revit 2020.1 SDK\Samples\WinderStairs\CS\Command.cs
以 L 行楼梯为例，参数的初始化：

// Generate the winder creation parameters from selected elements.
IList<XYZ> controlPoints = WinderUtil.CalculateControlPoints(rvtDoc, selectedIds);
double runWidth = 0, treadDepth = 0;
GetStairsData(rvtDoc, out runWidth, out treadDepth);
IList<uint> maxCount = WinderUtil.CalculateMaxStepsCount(controlPoints, runWidth, treadDepth);
uint numStepsInCorner = 3;

组合成 LWinderOptions：

options.NumStepsAtStart = maxCount[0];
options.NumStepsAtEnd = maxCount[1];
options.NumStepsInCorner = numStepsInCorner;
options.RunWidth = runWidth;
options.CenterOffsetE = centerOffset;
options.CenterOffsetF = centerOffset;

创建楼梯

LWinder 是一个数据结构，提供数据供 Revit API 使用，真正工作的是在 WinderUpdater 中进行：

LWinder lwinder = new LWinder();
lwinder.NumStepsAtStart = options.NumStepsAtStart;
lwinder.NumStepsInCorner = options.NumStepsInCorner;
lwinder.NumStepsAtEnd = options.NumStepsAtEnd;
lwinder.RunWidth = options.RunWidth;
lwinder.TreadDepth = treadDepth;
lwinder.CenterOffsetE = options.CenterOffsetE;
lwinder.CenterOffsetF = options.CenterOffsetF;
AddInId activeid = options.DMU ? commandData.Application.ActiveAddInId : null;
WinderUpdater lwinderDMU = new WinderUpdater(lwinder, selectedIds, rvtDoc, activeid, options.Sketch);

WinderUpdater 继承了两个接口， IUpdater 和 IExternalEventHandler
IUpdater 用于动态更新。
最终，还是要调用这个 API：

StairsRun run = StairsRun.CreateSketchedRun(rvtDoc, stairsId, actualElevation, boundarys, RiserLines, CenterWalkpath);

总结

IUpdater 动态更新可以用在很多地方，如果能和其它逻辑联动，威力无穷。创建草图楼梯，需要自己先计算好。 很多种情况下，都创建不出来，而且没有解释为什么会创建不出来。而 API 又是黑盒，一旦出错，很难找到解决方案。