xml-elliptical-arc

You are here: Popular Formats > XML (Extensible Markup Language) Reader/Writer > xfMap > Feature Mapping Rules > xml-elliptical arc

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/ Optional
data-string	The coordinate data string denotes the center, start and end point of an arc when the “direction” data parameter is present. 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”: center: CentrePoint start: FromPoint end: ToPoint 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 `data-string`. 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 `data-string`. 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 `demote-incomplete-geometry` data parameter is set to true. This parameter lists the xml-elliptical-arc data parameters that should be loaded into the demoted arc geometry as traits. For example, when this geometry builder fails to construct an arc and demote-incomplete-geometry is set to true and the value for this parameter is set to “radius direction”, then the builder will construct a null geometry with radius and direction traits. 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