XPlan Plugin - Configuration

This section describes the configuration of the XPlan Plugin. In the finished app, the plugin is available via the button icon xplan Browse B-Plans in the Tools & Extensions section. The functionality of the XPlan Plugin in the app is described here.

The plugin supports web services from XPlanung version 5 onwards.

Clicking on icon edit opens the configuration window, where all available settings can be configured.

Figure 1. Menu for configuring the XPlan plugin

The following settings are possible:

General settings

Option Description

Backend

Defines which platform is used to publish XPlan data as web services and integrate it into the XPlan plugin.

Currently, only the platform XPlanBox is supported. An extension to additional platforms is potentially possible.

Back end version

Defines the version of the back end that is used. This determines which web service layers and field mappings are requested by the XPlan plugin.

Base URL

Root of the web address on which all other paths and parameters are based in order to reach specific service endpoints of the XPlanBox.

Example:

https://subdomain.yourdomain.de/optional-subtopic/

Displayed services

Defines which service endpoints are requested by the XPlan plugin and displayed in the list view.

List attribute

Attribute from the plan metadata (object type xplan:BP_Plan) that determines the display name of a plan in the results list. The default value is ‘name’.

This attribute is also used for direct searches in the search bar to quickly find a known plan.

Filter active on startup

Determines whether the filter window appears automatically when the main window of the plugin is opened for the first time.

Coordinate reference system of the backend

Option Description

Option	Description
Code	The code of the coordinate reference system (CRS) of the backend, e.g. 'EPSG:25832'. Syntax: `{System}:\{numerical identifier}`
Proj4	The Proj4 definition associated with the code. Can be automatically retrieved from the server (https://epsg.io) by clicking on the adjacent icon.

Code

The code of the coordinate reference system (CRS) of the backend, e.g. 'EPSG:25832'. Syntax: {System}:\{numerical identifier}

Proj4

The Proj4 definition associated with the code. Can be automatically retrieved from the server (https://epsg.io) by clicking on the adjacent icon.

3D settings

Option

Description

Additional 3D styles

Selection of additional layer styles from the app configuration for visualizing the 3D cubes.

Default 3D style

Selection of the style in which objects are displayed when activated, if no other style has been set manually.

Default storey height

Height of full storeys for generating 3D cubes based on storey information if no explicit height information is available.

Existing height information is evaluated first. In this case, the height of a full storey is calculated from the height information and the number of full storeys.

Terrain level method

Method for calculating the reference height from the terrain to determine the zero level of the 3D cube, if not explicitly specified via the attribute xplan:hoehenangabe.

Minimum: The Z-values are extracted from the terrain for all vertices of the XPlan object. The minimum of all Z-values is used as the height of the zero level of the 3D cube.
Average: The Z-values are extracted from the terrain for all vertices of the XPlan object. The average of all Z-values is used as the height of the zero level of the 3D cube. This is the default value.
Maximum: The Z-values are extracted from the terrain for all vertices of the XPlan object. The maximum of all Z-values is used as the height of the zero level of the 3D cube.

3D Vegetation Settings

This section configures 3D vegetation objects that are created from BP_AnpflanzungBindungErhaltung features. Each entry maps a combination of vegetation type (Gegenstand) and legal status (Rechtsstand) to a 3D model file. Only features with point geometry are supported.

Click icon plus to open the add dialog. Existing entries can be edited with icon edit or deleted with icon delete . The same Rechtsstand value cannot be assigned to the same Gegenstand more than once — already-assigned values are filtered out of the selection.

Option Description

Option	Description
Gegenstand	Vegetation type for which a 3D model is configured. Required. Only point geometry types are supported: Bäume Kopfbäume Sträucher
Legal status	One or more Rechtsstand (legal status) values for which this model is displayed. Required. Only values not yet assigned to the selected Gegenstand are available: Planned Existing Discontinued
Use default model	Only visible when Gegenstand is set to Bäume. When checked, a default tree model is used.
Model URL	URL to the `.glb` 3D model file used for this entry. Required. Hidden when Use default model is active. Example: `https://example.com/models/my-tree.glb`

Gegenstand

Vegetation type for which a 3D model is configured. Required. Only point geometry types are supported:

Bäume
Kopfbäume
Sträucher

Legal status

One or more Rechtsstand (legal status) values for which this model is displayed. Required. Only values not yet assigned to the selected Gegenstand are available:

Planned
Existing
Discontinued

Use default model

Only visible when Gegenstand is set to Bäume. When checked, a default tree model is used.

Model URL

URL to the .glb 3D model file used for this entry. Required. Hidden when Use default model is active.

Example:

https://example.com/models/my-tree.glb

Extended 3D settings

The extended 3D settings define priorities for the extrusion of 3D cubes based on attribute values of the XPlan objects. Object types considered in the spatial evaluation: xplan:BP_UeberbaubareGrundstuecks-Flaeche, xplan:BP_BaugebietsTeilFlaeche and xplan:BP_HoehenMass. The relevant attributes of height and number of stories are transferred from the specified object types to the cube. In the event of conflicts due to double assignment of the same attribute, the value from xplan:BP_UeberbaubareGrundstuecksFlaeche is always preferred. The object xplan:BP_HoehenMass is only evaluated if no height information is available from other object types.

The order can be adjusted using drag & drop. icon return resets the order to the default settings. If a reference point or attribute is not to be used for the 3D representation, it can be removed from the list using icon delete . Removed entries can again be added at any time using icon plus .

The base area of a cube usually corresponds to the geometry of xplan:BP_UeberbaubareGrundstuecksFlaeche. If this is missing, the geometry of the building zone (Baugebietsteilfläche) is used.

Option

Description

Height attribute priority

Interpretation order of height attributes for the 3D representation of the building site (if there is more than one height attribute on the cube). The height attribute with the highest priority is applied. Additional attributes are listed in the feature information.

Reference point priority

Interpretation order of reference points for the 3D representation of the building site (if there is more than one height attribute on the cube). The height attribute with the highest priority reference point is applied. Additional attributes are listed in the feature information.

Each reference point is assigned a type for 3D interpretation, which defines whether the reference point determines the height, zero level, or terrain reference of the cube. This assignment is predefined by default, but can be customized using the drop-down menu if necessary.

The display priority only applies within the same type (i.e., elevation, zero level, or terrain). Height attributes with reference points of different types are applied to the object regardless of their order, as they do not conflict.

Storey attribute priority

Interpretation order of storey attributes for the 3D representation of the building site (if there is more than one storey attribute on the cube). The storey attribute with the highest priority is applied. Additional attributes are listed in the feature information.