RevitAPI：关于Curve.Distance(XYZ)方法

今天有客户问道Line.Distance(XYZ)方法有问题，返回的点到直线的距离不正确。

例如下面的图中，点到直线的距离应该是10，但是结果返回的却是14.142135623731

他的代码是这样：

var p1 = new XYZ(0, 0, 0);
var p2 = new XYZ(10, 0, 0);
var p3 = new XYZ(20, 10, 0);
Line line = Line.CreateBound(p1, p2);
StringBuilder sb = new StringBuilder();
sb.AppendLine("p3 to Line: " + line.Distance(p3));
TaskDialog.Show("distance", sb.ToString());

确实运行的结果是：

  p3 to Line: 14.142135623731

为什么不是10呢？

答案：点到直线的距离确实是10，但是这里的Line是Bound Line，也就是线段，而这里Distance()返回的距离是点到线段的距离，也就是14.14，如下图所示：

要得到正确的结果我们可以调用Line.MakeUnbound(),先把线变成Unbound，再求结果，代码如下：

    var p1 = new XYZ(0, 0, 0);
    var p2 = new XYZ(10, 0, 0);
    var p3 = new XYZ(20, 10, 0);
    Line line = Line.CreateBound(p1, p2);
    line.MakeUnbound();
    StringBuilder sb = new StringBuilder();
    sb.AppendLine("p3 to Line: " + line.Distance(p3));
    TaskDialog.Show("distance", sb.ToString());

如此就能返回正确的结果了。