如何通过C#自定义命令在Hexagon Smart 3D中创建圆形楼梯？

原生的Stair类仅支持创建直梯，没有直接提供弧形或螺旋楼梯的API接口。要实现这类楼梯，主要有两种可行方案：

方案一：使用自定义SmartPart/符号（推荐） #

这是Smart 3D中实现非标构件最便捷的方式：

• 先在Smart 3D客户端中创建弧形/螺旋楼梯的SmartPart或符号（Symbol），定义好可配置参数（比如楼梯半径、旋转角度、踏板数、宽度、总高度等）。
• 通过.NET API实例化这个自定义部件，传入对应的参数值即可。

示例代码：

// 获取自定义螺旋楼梯的SmartPart定义
SmartPartDefinition stairDef = SmartPartDefinitionManager.GetSmartPartDefinition("CustomSpiralStair");

// 创建SmartPart实例，指定系统、所属部件、位置等参数
SmartPartInstance spiralStair = new SmartPartInstance(system, parentPart, insertionPoint, stairDef);

// 设置自定义参数（比如半径、旋转角度）
spiralStair.SetPropertyValue("Radius", 2.5); // 单位根据项目设置调整
spiralStair.SetPropertyValue("RotationAngle", 360);
spiralStair.SetPropertyValue("TotalHeight", 3.0);

方案二：手动构建几何元素 #

如果不想依赖预定义的SmartPart，可以通过API直接创建三维几何来组装弧形/螺旋楼梯：

• 计算每个踏板的位置：基于圆心坐标、半径、角度增量，逐个计算每个踏板的旋转角度和高度偏移。
• 创建踏板、梯段、栏杆的几何实体（比如用ExtrudedAreaSolid创建踏板的弧形实体）。
• 将所有几何元素组合到同一个部件下。

示例代码片段（核心逻辑）：

double radius = 2.5;
double totalHeight = 3.0;
int stepCount = 12;
double stepHeight = totalHeight / stepCount;
double anglePerStep = 360.0 / stepCount;

for (int i = 0; i < stepCount; i++)
{
    // 计算当前踏板的角度和高度
    double currentAngle = i * anglePerStep;
    double currentHeight = i * stepHeight;

    // 创建弧形踏板的轮廓（简化示例）
    Arc arc = new Arc(Point3D.Origin, radius, currentAngle.DegreesToRadians(), (currentAngle + anglePerStep).DegreesToRadians());
    Profile profile = Profile.CreateFromCurve(arc);

    // 拉伸生成踏板实体
    ExtrudedAreaSolid stepSolid = new ExtrudedAreaSolid(profile, Vector3D.ZAxis, 0.3); // 0.3为踏板厚度

    // 设置踏板位置
    stepSolid.Transform = Transform3D.CreateTranslation(new Vector3D(0, 0, currentHeight));

    // 将踏板添加到部件
    parentPart.Geometry.Add(stepSolid);
}

注意事项 #

• 手动构建几何需要处理大量坐标计算，还要考虑栏杆的路径生成、梯段的连接等细节，复杂度较高。
• 自定义SmartPart的方式更易维护，也符合Smart 3D的构件管理逻辑，建议优先采用。

内容的提问来源于stack exchange，提问作者kingpin