Revit二次开发：关于Face的一些常用属性和方法介绍

最近在做高程点标注的时候，抛出异常，提示spot的放置点不在reference上面。摸不着头脑，只能去翻看face的具体api了。

这里做个记录（以PlanarFace平面为例）：

PlanarFace在API中是这样定义的：

Planar faces are defined by planes bounded by edge loops. 
The planes provide natural UV parameterization to the faces. 
S(u, v) = Origin + u*Vector[0] + v*Vector[1]

PlanarFace是有边界的平面，数学表达式如上。其中Origin是平面的原点，u和v对应了两个方向向量。

1.方法GetBoundingBox()，返回值为BoundingBoxUV，它的最大UV和最小UV值。

public BoundingBoxUV GetBoundingBox()

 

2.方法Evaluate()，参数为UV类型，返回值为一个点，可以计算出给定u和v值处的坐标点。

public XYZ Evaluate(UV params)

比如我们需要计算BoundingBoxUV.Max处的坐标点，可以使用Evaluate（BoundingBoxUV.Max）来得出。

3.IsInside()，可以判断某个uv值的点，是否在该有界平面内。

public bool IsInside(
	UV point,
	out IntersectionResult result
)

4.Project(),将一个指定的坐标点投影到该平面上。返回值为IntersectionResult类型，通过这个值，我们可以进一步获取投影点的具体XYZ坐标、该坐标在该平面上的UV值、以及该点到该平面的距离，显然：

public IntersectionResult Project(
	XYZ point
)

IntersectionResult result = topFace.Project(p0);
XYZ point = result.XYZPoint;
UV uvpoint = result.UVPoint;
double dis = result.Distance;

1.如果p0本身就在有界平面内，那么得到的point就是其本身；uvpoint是其对应的uv值；dis为0；

2.如果p0在这个平面上，但是不在边界内，那么point、uvpoint为Null;

3.如果p0在有界平面内（假设该平面为xy平面）,那么我们将p0沿着z轴方向平移1个单位，即p1=p0+new XYZ(0,0,1)，此时，获取topFace.Project(p1)，那么point和uvpoint值应该是等于p0时候的情况，但是dis等于1。

注意，拿墙Wall为例，我们取到了顶面topFace，该面的origin不一定还在该面的边界范围内，猜测可能是因为和其他构件产生了剪切操作。