xml-path

The xml-path geometry builder constructs linear paths.

This builder does not require any data parameters, so the only way for it to build a path geometry is from existing curve or point geometries. This means that before the xml-path builder is deactivated, other geometry builders that construct curves or points, such as xml-line, xml-arc or xml-point, should have been activated and deactivated; moreover, their constructed geometries should have been passed to it.

The xml-path geometry builder also accepts null geometries. Currently, these null geometries must have the “radius” and “direction” traits set. The null “arc” geometry in a path must be preceded and succeeded by a “curve” or “point” which correspond to the start and end point of the arc, respectively.

The xml-path geometry builder can return a polygon geometry when its convert-to-polygon data parameter is set to true. In this case, the builder sets the constructed path as the boundary of the polygon.

builder type: composite - accepts curve, point and appropriately tagged null geometries

geometry constructed: line geometry, point, or area geometry

data parameters:

Data Name

Value

Required/Optional

demote-incomplete-geometry

A path needs at least one curve segment, setting this optional parameter to true avoids empty paths to be constructed by demoting a path with zero segments into a non-geometrical object.

Range: false | true

Default: false

Optional

keep-as-path

When the value for this data parameter is set to “false” and the xml-path geometry consists solely of one feature, then a path geometry will not be constructed. A path with a one coordinate line segment is returned as a point.

Range: false | true

Default: true

Optional

demote-single-arc

When the value for this data parameter is set to “true” and the xml-path geometry consists solely of one arc feature, then a path geometry will not be constructed. If the single feature is not an arc, handling will depend on the keep-as-path parameter.

Range: false | true

Default: true

Optional

convert-to-polygon

This optional data parameter directs the xml-path geometry builder to return a polygon geometry with the constructed path set as the polygon’s boundary.

Range: false | true

Default: false

Optional

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

name

Specifies the geometry’s name.

Range: String

Optional