xml-elliptical-arc
This is a non-composite and composite builder that constructs an elliptical arc geometry. The following elliptical arc definition is supported:
- An elliptical arc defined by a circle’s center, start and end point, primary-radius, secondary-radius, direction, rotation, and rotation-direction.
builder type: non-composite/composite, accepts point geometries in composite mode
geometry constructed: arc geometry
data parameters:
Data Name |
Value |
Required/ |
---|---|---|
data-string |
The coordinate data may be received as point geometries. These control points can be named or unnamed. The named point geometries can also be received in any order: their names must be one of “center”, “start” or “end”, or any of their equivalents (see below). If the point geometries are unnamed, then the order of the points is significant, the first point received is assumed as the center point, the next point as the start point, and the last point as the end point of the arc. Equivalent control point names: The following names may be substituted for “center”, “start” and “end”:
Range: String |
Optional if the control points are to be passed in as point geometries; otherwise Required |
primary-radius |
The length of the primary axis for the ellipse the arc is based upon. Range: A positive real number. Default: There are no default values. |
Required |
secondary-radius |
The length of the secondary axis for the ellipse the arc is based upon. Range: A positive real number. Default: There are no default values. |
Required |
direction |
Specifies the traversal direction from the start to the end point the elliptical arc. Range: cw | ccw Default: There are no default values. |
Required |
rotation |
The rotation of the ellipse that defines the arc. The rotation angle specifies the angle in degrees from the horizontal axis to the primary axis in the direction specified by the rotation-direction data parameter. Range: A positive real number. Default: 0.0 |
Optional |
rotation-direction |
Specifies the rotation direction. See the rotation data parameter. Range: cw | ccw Default: ccw |
Required |
axis-order |
Indicates the axis for a coordinate. Range: A permutation of the numbers 1..N, where N is the number of dimensions. Each number is separated by a comma “,”. Default: “1,2,...,N” |
Optional, used only if data-string is specified |
dimension |
The dimension of the coordinates. Range: String representing a positive integer, or the “implicit” literal, which forces the dimension to be automatically determined even if axis-order is specified. Default: When not specified the dimension will be automatically determined. |
Optional, used only if data-string is specified |
axis-separator |
The string separating each axis of a coordinate in the Range: String | “whitespace” – this includes the tab, newline, and space characters. Default: “,” |
Optional, used only if data-string is specified |
coord-separator |
The string separating each coordinate in the Range: String Default: “whitespace” – this includes the tab, newline, and space characters. |
Optional, used only if data-string is specified |
decimal |
The string representing the decimal point for each real number in the data-string. Range: String Default: “.” |
Optional, used only if data-string is specified |
coordinate-system |
Specifies the coordinate system name. If the expression sequence for the coordinate-system evaluates to the empty string, then the coordinate system for the feature being built will not be set. Range: String |
Optional |
demote-incomplete-geometry |
This optional data parameter allows the xml-elliptical-arc geometry builder to return a non-geometrical object when no data-string is given or when the value of the data-string is the empty string. Range: false | true Default: false |
Optional |
incomplete-geometry-traits |
This optional data parameter takes effect only when the Range: whitespace separated list of arc data parameter names Default: There are no default values. |
Optional |
name |
Specifies the geometry’s name. Range: String |
Optional |