﻿Curve.TryGetPlane Method (Plane)

Test a curve for planarity and return the plane.

Namespace:  Rhino.Geometry
Assembly:  RhinoCommon (in RhinoCommon.dll)
Since: 5.0
Syntax
```public bool TryGetPlane(
out Plane plane
)```

#### Parameters

plane
Type: Rhino.GeometryPlane
On success, the plane parameters are filled in.

#### Return Value

Type: Boolean
true if there is a plane such that the maximum distance from the curve to the plane is <= RhinoMath.ZeroTolerance.
Examples
```using System;

partial class Examples
{
public static Rhino.Commands.Result ConstrainedCopy(Rhino.RhinoDoc doc)
{
// Get a single planar closed curve
var go = new Rhino.Input.Custom.GetObject();
go.SetCommandPrompt("Select curve");
go.GeometryFilter = Rhino.DocObjects.ObjectType.Curve;
go.GeometryAttributeFilter = Rhino.Input.Custom.GeometryAttributeFilter.ClosedCurve;
go.Get();
if( go.CommandResult() != Rhino.Commands.Result.Success )
return go.CommandResult();
var objref = go.Object(0);
var base_curve = objref.Curve();
var first_point = objref.SelectionPoint();
if( base_curve==null || !first_point.IsValid )
return Rhino.Commands.Result.Cancel;

Rhino.Geometry.Plane plane;
if( !base_curve.TryGetPlane(out plane) )
return Rhino.Commands.Result.Cancel;

// Get a point constrained to a line passing through the initial selection
// point and parallel to the plane's normal
var gp = new Rhino.Input.Custom.GetPoint();
gp.SetCommandPrompt("Offset point");
gp.DrawLineFromPoint(first_point, true);
var line = new Rhino.Geometry.Line(first_point, first_point+plane.Normal);
gp.Constrain(line);
gp.Get();
if( gp.CommandResult() != Rhino.Commands.Result.Success )
return gp.CommandResult();
var second_point = gp.Point();
Rhino.Geometry.Vector3d vec = second_point - first_point;
if( vec.Length > 0.001 )
{
var xf = Rhino.Geometry.Transform.Translation(vec);
Guid id = doc.Objects.Transform(objref, xf, false);
if( id!=Guid.Empty )
{
doc.Views.Redraw();
return Rhino.Commands.Result.Success;
}
}
return Rhino.Commands.Result.Cancel;
}
}```
Python
```import Rhino
import scriptcontext

def constrainedcopy():
#get a single closed curve
go = Rhino.Input.Custom.GetObject()
go.SetCommandPrompt("Select curve")
go.GeometryFilter = Rhino.DocObjects.ObjectType.Curve
go.GeometryAttributeFilter = Rhino.Input.Custom.GeometryAttributeFilter.ClosedCurve
go.Get()
if go.CommandResult() != Rhino.Commands.Result.Success: return
objref = go.Object(0)
base_curve = objref.Curve()
first_point = objref.SelectionPoint()
if not base_curve or not first_point.IsValid:
return
isplanar, plane = base_curve.TryGetPlane()
if not isplanar: return

gp = Rhino.Input.Custom.GetPoint()
gp.SetCommandPrompt("Offset point")
gp.DrawLineFromPoint(first_point, True)
line = Rhino.Geometry.Line(first_point, first_point + plane.Normal)
gp.Constrain(line)
gp.Get()
if gp.CommandResult() != Rhino.Commands.Result.Success:
return
second_point = gp.Point()
vec = second_point - first_point
if vec.Length > 0.001:
xf = Rhino.Geometry.Transform.Translation(vec)
id = scriptcontext.doc.Objects.Transform(objref, xf, False)
scriptcontext.doc.Views.Redraw()
return id

if __name__=="__main__":
constrainedcopy()```