xml-face

The xml-face geometry builder builds simple surface geometries.

This builder does not require any data parameters, and will construct the simple surface geometry from existing area geometries. Thus, before the xml-face geometry builder is deactivated, other geometry builders should have been activated, passing their constructed areas to the xml-face geometry builder.

Each of the areas passed to the xml-face geometry builder should share a common plane. The first area accepted forms the outer boundary, and subsequent areas accepted form inner gaps.

builder type: composite - accepts area geometries

geometry constructed: simple surface

data parameters:

Data Name

Value

Required/Optional

demote-incomplete-geometry

This Boolean parameter determines if an incomplete geometry should be demoted instead of producing an error. If set to true, whenever the geometry builder receives no areas to create a simple surface from, the simple surface will be downgraded to a null geometry. If set to false, whenever the geometry builder receives no areas to create a simple surface from, it will raise an error and terminate the translation.

Range: true|false

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

create-empty-geom-placeholder

This Boolean parameter determines if an empty face should be created in the absence of areas. If set to true, whenever the geometry builder receives no areas from which to create a simple surface, a surface with no coordinates is created regardless of the value set in demote-incomplete-geometry. If set to false, this parameter has no effect.

Range: true|false

Default: false

Optional

Example: Building a simple surface

simplesurface.xml

<?xml version="1.0"?>
<simplesurface>
	<area>
		0.0,0.0,0.0 5.0,0.0,5.0 5.0,5.0,10.0 0.0,5.0,5.0 0.0,0.0,0.0
	</area>
	<area>
		2.0,2.0,4.0 3.0,2.0,5.0 3.0,3.0,6.0 2.0,3.0,5.0 2.0,2.0,4.0
	</area>
</simplesurface>

simplesurface.xmp

<?xml version="1.0"?>
<xfMap>
	<feature-map>
		<mapping match="simplesurface">
			<feature-type> <literal expr="simplesurface" /> </feature-type>
			<geometry activate="xml-face" />
		</mapping>
	</feature-map>
	<feature-content-map>
		<mapping match="area">
			<geometry activate="xml-area">
				<data name="data-string"> <extract expr="." /> </data>
			</geometry>
		</mapping>
	</feature-content-map>
</xfMap>