CartesianTiles

Loads and unloads datasets in a cartesian coordinateSystem (local or national coordinate grid)

Installing

This package will be provided through OpenUPM, to install it using the CLI you can perform the following:

$ openupm add netherlands3d.cartesiantiles

or, you have to add https://package.openupm.com as a scoped registry with, at least, the following scopes:

• eu.netherlands3d

Usage

• create an empty GameObject and add TileHandler.cs to it.
• for each dataset, add a Child-gameObject with a layerscript.
• make sure netherlands3d.coordinates is set up(possibly using the CoordinateSetup.cs in the scene).

TileHandler

Manages the loading and unloading if the tiles in the layers.

• public void AddLayer(Layer layer); add the layer to the tilehandler while it is running
• public void RemoveLayer(Layer layer); remove the layer from the tileHandler while it is running

Layer

each layerType is derived from Layer.cs through this class the following settings are available:

• bool isEnabled; if true, tiles are active and updated by the tilehandler. if false, tiles are set to Inactive and are NOT updated by the tilehander.
• bool pauseLoading; if true, Tiles remain in their current state, but are not updated by the tileHandler.
• int tileSize; the geometric size of the tiles for this layer.
• int layerPiority; the priorityLevel if this layer.
• list of Datasets.

Dataset

settings:

• string description; only for recognizability in the editor.
• string geoLOD; only for recognizability in the editor.
• strings path and pathQuery; are combined for creating the url at wich the tiledata can be found. use placeholders {x} and {y} for the X- and Y- coordinates in the url. (use file:// to load tiles from a local drive) float maximumDistance; the maximum distance from the camera where the tiles can be loaded.

you can use multiple tilesets on a layer. order them with descending MaximumDistance. the tilehandler checks the distanceFromCamera of a new Tile and uses the settings where the tile falls within the maximumDistance (checking from the end of the list to the start of the list). you can use this to load tiles at a farther distance with less detail.

BinaryMeshLayer

settings for a collection of tiles, created with https://github.com/Amsterdam/CityDataToBinaryModel settings: DefaultMaterialList; list of materials to be added to each submesh of the newly loaded tile. createMeshcollider(bool); if true, adds meshcollider to the tile when it is loaded. tileShadowCastingMode; should the tiles cast shadows. HasMetaData (only if using netherlands3d.subobject); if true, tries to read the metadata containing the mapping of vertices to identifiers. functions:

• public void AddMeshColliders(Vector3 onlyTileUnderPosition = default), Add meshcollider to all tiles. if a Vector3 is given, only the tile at that position (in X and Z direction) will have a meshcollider added.
• public void EnableShadows(bool enabled), enable or disable shadowcasting on the tiles.

GeoJSONTextLayer

layer placing texts in the game, using data from a wfs. settings:

• use only 1 Dataset for this layer, the path and pathQuery values are NOT used.
• Text Prefab; the prefab containing a TextMeshPro-component that is to be placed at the location of a text.
• Geo Json Url; the url for the wfs-query, ending with bbox. the correct boundingbox-values will be added when a tile is ready to be loaded.
• Max Spawns per Frame; maximum number of text to spawn in a single frame, to prevent the frame from taking to long.
• Texts And Sizes (list); multiple entries are possible.
  • Text Propert Name; name of the property whose values you want.
  • Draw With Size; the size the text has to be drawn.
  • Offset; the offset with wich the text has to be placed. offset is relative to Unity Y=0;
• Position Source Type; indicate wether the wfs return points or MultiPolygons. When the wfs return MultiPloygons, the text will be placed at its centroid.
• Auto Orientation Mode; None = place static. Face Camera = text allways rotates to the camera, Auto-Flip = text doesn't rotate but flips when text looks up-side-down in the camera view.
• Draw Geometry; when the wfs returns MultiPolygons, these can be drawn using LineRenderers.
• Line Renderer Material; the material used for drawing geometry.
• Line Color; the color for the drawn geometry;
• Line Width; the with of the drawn geometry; optional settings:
• read Angle From Property; try to find an angle for the text in the properties and apply this to the text.
• the name of the property in wich the rotation of the text should be.
• Filter Unique Names; if true, a text will only be placed once, even if there are multiple instances of the text in de dataset.