RhinoCommon documentation has a new look. The old site can still be found here.

/

/

Circle

Circle struct

Represents a circle in 3D. The values used are a radius and an orthonormal frame of the plane containing the circle, with origin at the center. The circle is parameterized by radians from 0 to 2 Pi given by t -> center + cos(t)*radius*xaxis + sin(t)*radius*yaxis where center, xaxis and yaxis define the orthonormal frame of the circle plane.

>An IsValid circle has positive radius and an IsValid plane defining the frame.

Namespace: Rhino.Geometry
Circle: references

Constructors (7)

Circle(Arc arc)

Initializes a circle from an arc.

Circle(double radius)

Initializes a circle with center (0,0,0) in the world XY plane.

Circle(Plane plane, double radius)

Initializes a circle on a plane with a given radius.

Circle(Plane plane, Point3d center, double radius)

Initializes a circle parallel to a given plane with given center and radius.

Circle(Point3d center, double radius)

Initializes a circle parallel to the world XY plane with given center and radius.

Circle(Point3d point1, Point3d point2, Point3d point3)

Initializes a circle through three 3d points.

Circle(Point3d startPoint, Vector3d tangentAtP, Point3d pointOnCircle)

Initializes a circle from two 3d points and a tangent at the first point. The start/end of the circle is at point "startPoint".

Properties (9)

BoundingBox

Gets the circle's 3d axis aligned bounding box.

Center

Gets or sets the center point of this circle.

Circumference

Gets or sets the circumference of this circle.

Diameter

Gets or sets the diameter (radius * 2.0) of this circle. Diameters should be positive values.

IsValid

A valid circle has radius larger than 0.0 and a base plane which is must also be valid.

Normal

Gets the normal vector for this circle.

Plane

Gets or sets the plane of the circle.

Radius

Gets or sets the radius of this circle. Radii should be positive values.

Unset

Gets a circle with Unset components.

Methods (20)

ClosestParameter(Point3d testPoint,Double t)

Gets the parameter on the circle which is closest to a test point.

ClosestPoint(Point3d testPoint)

Gets the point on the circle which is closest to a test point.

DerivativeAt(Int32 derivative,Double t)

Determines the value of the Nth derivative at a parameter.

EpsilonEquals(Circle other,Double epsilon)

Check that all values in other are within epsilon of the values in this

IsInPlane(Plane plane,Double tolerance)

Evaluates whether or not this circle is co-planar with a given plane.

PointAt(Double t)

Circles use trigonometric parameterization: t -> center + cos(t)*radius*xaxis + sin(t)*radius*yaxis.

Reverse()

Reverse the orientation of the circle. Changes the domain from [a,b] to [-b,-a].

Rotate(Double angle, Vector3d axis, Point3d point)

Rotates the circle through a given angle.

Rotate(Double angle, Vector3d axis)

Rotates the circle through a given angle.

Rotate(Double sinAngle,Double cosAngle, Vector3d axis, Point3d point)

Rotates the circle around an axis that starts at the provided point.

Rotate(Double sinAngle,Double cosAngle, Vector3d axis)

Rotates the circle around an axis that starts at the base plane origin.

TangentAt(Double t)

Circles use trigonometric parameterization: t -> center + cos(t)*radius*xaxis + sin(t)*radius*yaxis.

ToNurbsCurve()

Constructs a nurbs curve representation of this circle. This amounts to the same as calling NurbsCurve.CreateFromCircle().

ToNurbsCurve(Int32 degree,Int32 cvCount)

Create a uniform non-rational cubic NURBS approximation of a circle.

Transform(Transform xform)

Transforms this circle using an transformation matrix.

Translate(Vector3d delta)

Moves the circle.

TryFitCircleToPoints(IEnumerable<Point3d> points, out Circle circle)

Attempt to fit a circle through a set of points.

TryFitCircleTT(Curve c1, Curve c2,Double t1,Double t2)

Try to fit a circle to two curves using tangent relationships.

TryFitCircleTTT(Curve c1, Curve c2, Curve c3,Double t1,Double t2,Double t3)

Try to fit a circle to three curves using tangent relationships.

TrySmallestEnclosingCircle(IEnumerable<Point2d> points,Double tolerance, out Circle circle,Int32[] indicesOnCircle)

Attempt to create the smallest circle enclosing a set of planar points.

Nothing found