xml-triangulated-surface

The xml-triangulated-surface geometry builder builds mesh geometries.

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

builder type: composite - accepts surface and area geometries

geometry constructed: mesh

data parameters:

The following demote-incomplete-geometry and allow-empty-composite data parameters change how the geometry is handled in error conditions. If both of the data parameters are set to false, whenever the geometry builder receives no simple surfaces to create a composite surface from, it will raise an error and terminate the translation.

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 or surfaces to create a mesh from, the mesh will be downgraded to a null geometry. Range: true|false Default: false	Optional
allow-empty-mesh	This data parameter determines if incomplete geometry should be left incomplete instead of producing an error. If set to true, whenever the geometry builder receives no simple surfaces or areas to create a mesh from, the mesh will be left empty and returned. Range: true|false Default: false	Optional
optimize-mesh	Optimizes the mesh by removing all duplicate and unreferenced vertices. 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

Example: Building a composite surface

compositesurface.xml

<?xml version="1.0"?>
<compositesurface>
	<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>
		<area>
			0.0,0.0,0.0 5.0,0.0,0.0 5.0,0.0,5.0 0.0,0.0,0.0
		</area>
	</simplesurface>
</compositesurface>

compositesurface.xmp

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