Creates a new geometric ellipse or elliptical arc object.
Namespace: Autodesk.Revit.DBAssembly: RevitAPI (in RevitAPI.dll) Version: 23.0.0.0 (23.1.0.0)
Since: 2017_subscription_update
Syntax
C# |
---|
public static Curve CreateCurve( XYZ center, double xRadius, double yRadius, XYZ xAxis, XYZ yAxis, double startParameter, double endParameter ) |
Visual Basic |
---|
Public Shared Function CreateCurve ( _ center As XYZ, _ xRadius As Double, _ yRadius As Double, _ xAxis As XYZ, _ yAxis As XYZ, _ startParameter As Double, _ endParameter As Double _ ) As Curve |
Visual C++ |
---|
public: static Curve^ CreateCurve( XYZ^ center, double xRadius, double yRadius, XYZ^ xAxis, XYZ^ yAxis, double startParameter, double endParameter ) |
Parameters
- center
- Type: Autodesk.Revit.DB..::..XYZ
The center.
- xRadius
- Type: System..::..Double
The x vector radius of the ellipse.
- yRadius
- Type: System..::..Double
The y vector radius of the ellipse.
- xAxis
- Type: Autodesk.Revit.DB..::..XYZ
The x axis to define the ellipse plane. Must be normalized.
- yAxis
- Type: Autodesk.Revit.DB..::..XYZ
The y axis to define the ellipse plane. Must be normalized.
- startParameter
- Type: System..::..Double
The raw parameter value at the start of the ellipse.
- endParameter
- Type: System..::..Double
The raw parameter value at the end of the ellipse.
Return Value
The new ellipse or elliptical arc.
Remarks
If the angle range is equal to or greater than 2 * PI, the curve will be
automatically converted to an unbounded ellipse.
If xRadius and yRadius are almost equal, the curve will be
returned as an arc.
Exceptions
Exception | Condition |
---|---|
Autodesk.Revit.Exceptions..::..ArgumentNullException | A non-optional argument was NULL |
Autodesk.Revit.Exceptions..::..ArgumentOutOfRangeException | The given value for xRadius must be greater than 0 and no more than 30000 feet. -or- The given value for yRadius must be greater than 0 and no more than 30000 feet. -or- xAxis is not length 1.0. -or- yAxis is not length 1.0. |
Autodesk.Revit.Exceptions..::..ArgumentsInconsistentException | The vectors xAxis and yAxis are not perpendicular. -or- Start parameter must be less than end parameter. -or- Curve length is too small for Revit's tolerance (as identified by Application.ShortCurveTolerance). |