Synopsis
This design defines a 3D wireframe ellipse in the host CAD system. The start and end angles are relative to the the startVector input of the ellipse, which defaults to the x axis of the local frame. All angles are positive and there is no requirement that the start angle be less than the end angle. The ellipse is always traced counterclockwise relative to the normal (right-hand rule in right-handed coordinate system).
For now, Ellipse cannot be used with solid-modeling operations - it is strictly a "wireframe" entity. This restriction will be lifted in a future release.
Mixins
CurveMixin
InkStrokedMixin
Canonicals
| Name | Type | Description |
|---|---|---|
| majorLength | number | Length in xDirection. |
| minorLength | number | Length in yDirection. |
Parameters
| Name | Type | Description |
|---|---|---|
| xDirection | vector | X direction vector of the new localFrame. By default this is the 1,0,0 vector in the referenceFrame of this part. |
| yDirection | vector | Y direction vector of the new localFrame. By default this is the 0,1,0 vector in the referenceFrame of this part. |
| leftFocus | point | |
| rightFocus | point | |
| center | point | Center point of the ellipse. |
| leftVertex | point | Vertex at minimum x. |
| rightVertex | point | Vertex at maximum x. |
| bottomVertex | point | Vertex at minimum y. |
| topVertex | point | Vertex at maximum y. |
| startAngle | number | Angle from the local X axis to the start of the ellipse. The value can range between 360 and -360 degrees. |
| endAngle | number | Angle from the local X axis to the end of the ellipse. The value can range between 360 and -360 degrees and does not have to be greater than startAngle |
| nDisplaySegments | integer | Controls the default number of segments over the entire Ellipse. The default is 48. Applies to Hoops host only. |
| nSegments | integer | Controls the number of segments over the actual section being displayed. It defaults to a fraction of nDisplaySegments corresponding to the fraction being shown. Applies to Hoops host only. |
Rules
| Name | Type | Description |
|---|---|---|
| distToFocus | number | |
| eccentricity | number | |
| widthAtFocus | number | |
| startPoint | point | Point at the startAngle of the ellipse. |
| endPoint | point | Point at the endAngle of the ellipse. |
| isClosed? | boolean | True if the end point of the ellipse is coincident with the start point. |
| isPeriodic? | boolean | True if the ellipse is closed - the start and end tangent vectors are the same. |
| length | number | Length from start to the end of the curve. |
Methods
arcLength( p1 As Point, p2 As Point ) As Number
curvature( p As Point ) As Number
pointAtLength( len As Number ) As Point
tangent( p As Point ) As Vector
Group Rules
<center> Creates the local frame of the ellipse from the parent frame, and places at this center
<majorLength minorLength leftFocus> Positions the ellipse using the ellipse dimensions and leftFocus
<majorLength minorLength rightFocus> Positions the ellipse using the ellipse dimensions and leftFocus
Example 1
| Name: | ellipse_Ex01 |
| Design: | acDrawingDocument |
| Child Name: | Ellipse | |
| Child Design: | Ellipse | |
| Name | Type | Supplied |
| majorLength | number | 5.0 |
| minorLength | any | 3.0 |
| center | point | origin |