[page:Curve] →

[name]

Creates a 2d curve in the shape of an ellipse. Setting the [page:Number xRadius] equal to the [page:Number yRadius] will result in a circle.

Example


var curve = new THREE.EllipseCurve(
	0,  0,            // ax, aY
	10, 10,           // xRadius, yRadius
	0,  2 * Math.PI,  // aStartAngle, aEndAngle
	false,            // aClockwise
	0                 // aRotation
);

var points = curve.getPoints( 50 );
var geometry = new THREE.BufferGeometry().setFromPoints( points );

var material = new THREE.LineBasicMaterial( { color : 0xff0000 } );

// Create the final object to add to the scene
var ellipse = new THREE.Line( geometry, material );

Constructor

[name]( [param:Float aX], [param:Float aY], [param:Float xRadius], [param:Float yRadius], [param:Radians aStartAngle], [param:Radians aEndAngle], [param:Boolean aClockwise], [param:Radians aRotation] )

[page:Float aX] – The X center of the ellipse. Default is *0*.
[page:Float aY] – The Y center of the ellipse. Default is *0*.
[page:Float xRadius] – The radius of the ellipse in the x direction. Default is *1*.
[page:Float yRadius] – The radius of the ellipse in the y direction. Default is *1*.
[page:Radians aStartAngle] – The start angle of the curve in radians starting from the middle right side. Default is *0*.
[page:Radians aEndAngle] – The end angle of the curve in radians starting from the middle right side. Default is *2 x Math.PI*.
[page:Boolean aClockwise] – Whether the ellipse is drawn clockwise. Default is *false*.
[page:Radians aRotation] – The rotation angle of the ellipse in radians, counterclockwise from the positive X axis (optional). Default is *0*.

Note: When going clockwise it's best to set the start angle to (Math.PI * 2) and then work towards lower numbers.

Properties

See the base [page:Curve] class for common properties.

[property:Boolean isEllipseCurve]

Used to check whether this or derived classes are EllipseCurves. Default is *true*.

You should not change this, as it used internally for optimisation.

[property:Float aX]

The X center of the ellipse.

[property:Float aY]

The Y center of the ellipse.

[property:Radians xRadius]

The radius of the ellipse in the x direction.

[property:Radians yRadius]

The radius of the ellipse in the y direction.

[property:Float aStartAngle]

The start angle of the curve in radians starting from the middle right side.

[property:Float aEndAngle]

The end angle of the curve in radians starting from the middle right side.

[property:Boolean aClockwise]

Whether the ellipse is drawn clockwise.

[property:Float aRotation]

The rotation angle of the ellipse in radians, counterclockwise from the positive X axis (optional). Default is *0*.

Methods

See the base [page:Curve] class for common methods.

Source

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]