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

前言

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

程序逻辑

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

选择模型线

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

参数生成

对话框中的参数会根据选择的模型线而有所不同。
Revit SDK 介绍:API Sketched Winder Stairs 创建扇形踏步楼梯_第1张图片
代码: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 继承了两个接口, IUpdaterIExternalEventHandler
IUpdater 用于动态更新。
最终,还是要调用这个 API:

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

总结

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

你可能感兴趣的:(Revit,SDK,介绍)