Plane.CreateByThreePoints

Public Class

Creates a Plane object passing through three points supplied as arguments.

Namespace: Autodesk.Revit.DB

Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)

Syntax

public static Plane CreateByThreePoints(
  XYZ point1,
  XYZ point2,
  XYZ point3
)

Parameters

point1 XYZ

First of the three points that define a unique plane. The created Plane object will pass through these points.

point2 XYZ

Second of the three points that define a unique plane.

point3 XYZ

Third of the three points that define a unique plane.

Return Value

Plane

Exceptions

Exception

Condition

---

ArgumentException

The input point lies outside of Revit design limits.

---

ArgumentNullException

A non-optional argument was null

---

ArgumentsInconsistentException

Throws if the input points do not define a unique plane. This is typically caused by points being too close to each other, or all three points being on or close to a straight line.

---

Remarks

The points supplied as arguments must fully define a plane: they may not lie on a straight line or be too close to each other. The points must lie within the Revit design limits. This function does not guarantee a specific parameterization of the created Plane. Use Plane.Create(Frame) to enforce a specific parameterization of the created Plane object. All three points are expected to lie within the Revit design limits IsWithinLengthLimits(XYZ).