Autodesk.Revit.DB.CylindricalHelix

Autodesk.Revit.DB.CylindricalHelix 是Revit API中的一个类，用于实现沿着圆柱螺旋运动的轨迹。

构造函数

Autodesk.Revit.DB.CylindricalHelix 包含一个构造函数，用于创建轨迹对象，其参数如下：

public CylindricalHelix(Curve baseCurve, XYZ xVector, XYZ yVector, double pitch, double height)

• baseCurve: Curve类型，为轨迹的基础曲线，用于指定螺旋运动的中心线。
• xVector: XYZ类型，表示该曲线上的一个方向向量，用于确定沿着圆柱的螺距方向。
• yVector: XYZ类型，表示该曲线上的另一个方向向量，与 xVector 垂直。用于确定圆柱的横截面方向。
• pitch: double类型，表示圆柱螺旋的螺距（每周的运动次数）。
• height: double类型，表示圆柱螺旋运动的高度（即每周运动的距离）。

属性

Autodesk.Revit.DB.CylindricalHelix 还包含以下属性：

Length

Length 属性是一个double类型的只读属性，表示轨迹的总长度。

ParametersAtPoint

ParametersAtPoint 属性是一个返回 Dictionary<double, double> 类型的方法，用于计算某个点于轨迹的距离以及其对应的轨迹上的参数值。

示例代码

以下是创建 CylindricalHelix 实例并使用 ParametersAtPoint 方法计算参数的示例代码：

Curve baseCurve = Line.CreateBound(new XYZ(0, 0, 0), new XYZ(0, 0, 10));

XYZ xVector = XYZ.BasisX;
XYZ yVector = XYZ.BasisY;

double pitch = 2.0;
double height = 10.0;

CylindricalHelix helix = new CylindricalHelix(baseCurve, xVector, yVector, pitch, height);

Dictionary<double, double> parameters = helix.ParametersAtPoint(new XYZ(0, 0, 5));

double distance = parameters.Keys.First();
double parameter = parameters.Values.First();

TaskDialog.Show("Parameter Info", "The distance to the point is: " + distance + " and the parameter value is: " + parameter);

以上代码将创建一个 CylindricalHelix 实例，其基础曲线为一条垂直于Z轴的直线，沿着Y轴偏移10个单位。然后使用 ParametersAtPoint 方法计算距离 (0, 0, 5) 点最近的轨迹点的参数值。最后在 TaskDialog 中显示参数信息。

异常

在使用 CylindricalHelix 类时，可能会抛出以下异常：

• Autodesk.Revit.Exceptions.ArgumentOutOfRangeException: 当 pitch 或 height 参数为负数时抛出此异常。
• Autodesk.Revit.Exceptions.SystemException: 创建 CylindricalHelix 对象时发生未知的系统错误时抛出此异常。

总结

Autodesk.Revit.DB.CylindricalHelix 是一个在Revit API中实现沿着圆柱的螺旋运动的轨迹类。通过基础曲线、坐标轴向量、螺距和高度指定轨迹，可以使用该类的一些属性和方法计算轨迹的一些信息。但要注意，在使用此类时需要注意参数的正负性。