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>