Plane.CreateByThreePoints
Description:
Creates a Plane object passing through three points supplied as arguments.
Creates a Plane object passing through three points supplied as arguments.
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).
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).
-
point1First of the three points that define a unique plane. The created Plane object will pass through these points.
-
point2Second of the three points that define a unique plane.
-
point3Third of the three points that define a unique plane.
Return Value
Plane
-
The input point lies outside of Revit design limits.
-
A non-optional argument was null
-
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.