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