Namespace: Autodesk.Revit.DB Class: Plane

Plane.CreateByThreePoints

Method

Description:
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).

Syntax

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

Public Shared Function CreateByThreePoints ( 
	point1 As XYZ,
	point2 As XYZ,
	point3 As XYZ
) As Plane

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

static member CreateByThreePoints : 
        point1 : XYZ * 
        point2 : XYZ * 
        point3 : XYZ -> Plane

Parameters

Parameter	Type	Description
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.