In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Attributes), this format adds the format-specific attributes and attribute types described in this section.
CityGML Attribute Types
CityGML provides the usual assortment of attribute types, usually prefixed with either citygml_ or xml_. One type that is particularly interesting to users of the CityGML Writer is the xml_xml type.
A string attribute that is set to this type will not be encoded when written into the XML document. One place that this is very useful is when writing elements of type xalAddress or other places where you wish to provide a back door into the document and insert an xml fragment directly into the document.
XML Type
The geometry of the CityGML feature may be identified by its xml_type attribute. The valid values for this attribute are:
|
xml_type |
Description |
|---|---|
|
xml_no_geom |
FME Feature with no geometry. |
|
xml_point |
Point feature. |
|
xml_line |
Linear feature. |
|
xml_surface |
Surface feature, may contain gaps. |
|
xml_solid |
Solid feature, may contain voids. |
|
xml_aggregate |
A possibly heterogeneous collection of geometries. |
No Geometry
xml_type: xml_no_geom
Features having their xml_type set to xml_no_geom do not contain any geometry data.
Point
xml_type: xml_point
Features having their xml_type set to xml_point are single coordinate features or aggregates of single coordinate features.
Line
xml_type: xml_line
Features having their xml_type set to xml_line are polyline features and have at least two coordinates or aggregates of polyline features.
Surface
xml_type: xml_surface
Features having their xml_type set to xml_surface are surfaces. They may be simple, topologically contiguous surfaces or aggregates of surface features.
Collection
xml_type: xml_aggregate
Features having their xml_type set to xml_aggregate are complex geometries. Each component of an aggregate may be any of the types listed in this section, including xml_aggregate (i.e. an aggregate may contain aggregate components).
CityGML-Specific Attributes
Other attributes depend on the feature type. Common and feature-specific attributes are as follows.
Common Attributes
|
Attribute Name |
Contents |
|
gml_id |
The unique identifier for each feature. This attribute must be unique in the dataset scope. |
|
gml_parent_id |
The unique identifier representing the feature’s parent in the hierarchy. This must reference another feature in the dataset. |
|
citygml_level_of_detail{} |
The level of detail of the geometry/geometries. Range: 0...4 |
|
citygml_lod_name |
Provides the specific name of the level of detail element that this feature is enclosed. The Range is (in pseudo-regular expression syntax) lod[0-4](Network|(Multi)?(Surface|Solid). Examples: lod0Network, lod3Solid, etc. Not all combinations are legal, and not all CityGML feature types support all options. |
|
citygml_library_object |
The target URI for the implicit geometry. |
|
citygml_mime_type |
The mime type of the library object. |
|
citygml_transformation_matrix |
A 4x4 matrix describing the translation of the implicit geometry. Elements are space-delimited. |
Appearance Attributes:
|
Attribute Name |
Contents |
|
citygml_theme |
The name of the themed appearance. |
X3DMaterial Attributes:
|
Attribute Name |
Contents |
|
citygml_is_front |
A boolean describing whether the material should be applied to the front or the back of the target surface. Range: true|false|1|0 |
|
citygml_ambient_intensity |
A real number describing the ambient intensity. Range: 0...1 |
|
citygml_diffuse_color |
A list of three real numbers describing diffuse color. Elements are space-delimited and must conform to the following range. Range: 0...1 |
|
citygml_emissive_color |
A list of three real numbers describing emissive color. Elements are space-delimited and must conform to the following range. Range: 0...1 |
|
citygml_specular_color |
A list of three real numbers describing specular color. Elements are space-delimited and must conform to the following range. Range: 0...1 |
|
citygml_shininess |
A real number describing the shininess. Range: 0...1 |
|
citygml_transparency |
A real number describing the transparency. Range: 0...1 |
|
citygml_is_smooth |
A Boolean denoting if the surface is smooth or not. Range: true|false|1|0 |
|
citygml_target |
Targets to apply the material to. |
GeoreferencedTexture Attributes:
| Attribute Name |
Contents |
|---|---|
| citygml_is_front |
A boolean describing whether the material should be applied to the front or the back of the target surface. Range: true|false|1|0 |
| citygml_image_uri |
The target uri that the texture is located at. |
| citygml_mime_type |
The mime type of the texture. |
| citygml_texture_type |
The texture type. Range: specific|typical|unknown |
| citygml_wrap_mode |
The type of wrapping to apply. Range: none|wrap|mirror|clamp|border |
| citygml_border_color |
A list of three to four real numbers describing the border color and opacity. Elements are space-delimited and must conform to the following range. Range: 0...1 |
| citygml_prefer_world_file |
A boolean denoting if a world file should be sought and used when possible instead of the included georeferenced texture data. Range: true|false|1|0 |
| citygml_orientation_matrix |
A 2x2 matrix describing the rotation and scaling of the texture. Elements are space-delimited. |
| citygml_target |
Targets to apply the texture to. |
ParameterizedTexture Attributes:
| Attribute Name |
Contents |
|---|---|
| citygml_is_front |
A Boolean describing whether the material should be applied to the front or the back of the target surface. Range: true|false|1|0 |
| citygml_image_uri |
The target uri that the texture is located at. |
| citygml_mime_type |
The mime type of the texture. |
| citygml_texture_type |
The texture type. Range: specific|typical|unknown |
| citygml_wrap_mode |
The type of wrapping to apply. Range: none|wrap|mirror|clamp|border |
| citygml_border_color |
A list of three to four real numbers describing the border color and opacity. Elements are space-delimited and must conform to the following range. Range: 0...1 |
| citygml_target{}.uri |
The location of the surface to which the texture applies. |
| citygmal_target{}.coordinate_list{}.ring |
The named ring of the surface that the texture applies to. |
| citygml_target{}.coordinate_list{}.coordinates |
A list of real numbers describing the coordinates on the ring that the texture applies to. Elements are space-delimited. |
| citygml_target{}.coordinate_list{}.world_to_texture_matrix |
A 3x4 matrix describing the linear translation and spatial location of the texture to be mapped. Elements are space-delimited. |