# 3DAmsterdam 3D Amsterdam is a platform ( available at 3d.amsterdam.nl ) where the city of Amsterdam can be experienced interactively in 3D. The main goals are: - providing information about the city; - making communication and participation more accessible through visuals; - viewing and sharing 3D models. More and more information and data is embedded, allowing future features like running simulations, visualization of solar and wind studies and showing impact of spatial urban changes. It will improve public insight in decision making processes. ## Unity 2021.3 (LTS) The project is using the latest LTS (long-term support) release of Unity: 2021.3.*
We will upgrade the minor updates for the same LTS often due to stability improvements of the WebGL platform. ## WebGL/Universal Render Pipeline Currently the main target platform is a WebGL(2.0) application.
The project is set up to use the [Universal Render Pipeline](https://unity.com/srp/universal-render-pipeline), focussing on high performance for lower end machines. Please note that shaders/materials have specific requirements in order to work in this render pipeline. ## Code convention All the project code and comments should be written in English. Content text is written in Dutch.
For C#/.NET coding conventions please refer to the Microsoft conventions:
[https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions)
For variable naming please refer to:
[https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/general-naming-conventions](https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/general-naming-conventions)
## Project Setup The files structure of the project looks like this. ``` 3DAmsterdam ├── README.md ├── .gitattributes ├── .gitignore ├── docs | ├── gettingstarted.md #Getting started with a new manucipality | ├── assetgeneration.md #How to generate assets for the 3D layers | └── faq.md #Frequently asked questions ├── 3DAmsterdam #Main Unity project folder | └──Assets | ├──3DAmsterdam #Amsterdam specific config, scenes and assets | ├──Netherlands3D #Shared assets used by 3DUtrecht and 3DAmsterdam that may be moved to the Netherlands3D package | └──WebGLTemplates #Special Unity folder containing our Netherlands3D fullscreen WebGL template ``` To set-up a project for a new municipality or city, please refer to the [Netherlands3D](https://github.com/Amsterdam/Netherlands3D) repository. ## Unity Input System The project uses the new Unity input system called Input Action Assets. The input mappings are defined in `\Assets\Netherlands3D\Input\3DNetherlands.inputactions` This will then generate a c# class that will be used in `\Assets\Netherlands3D\Input\ActionHandler.cs` ## Tile System The platform uses a tile based system consisting of 1km by 1km tiles. The handling of the tiles is initiated by the TileHandler which resides under the /Layers in the scene and needs to be configured with the active Layers that implement the Layer baseclass. We currently have 4 implemented Layers which are - Buildings - Trees - Sewerage - Terrain Each Layer script needs implement the HandleLayer method. This function receives a TileChange variable that provides the [RD](https://nl.wikipedia.org/wiki/Rijksdriehoeksco%C3%B6rdinaten) X and Y coordinate and an action. The available actions are - Create (create the tile) - Upgrade (the Level of detail increases) - Downgrade (the Level of detail decreases) - Remove (remove the tile) ## Generating Tile System tiles The 3D tiles used by the Tile System can be generated by the TileBakeTool. You can find this tool in its own repository: https://github.com/Amsterdam/CityDataToBinaryModel ## Contributing If you like to contribute to 3DAmsterdam we encourage you to do so via the open source Netherlands3D repository; a modular Unity package containing functionalities independant of 3DAmsterdam that are useful for other municipalities: https://github.com/Amsterdam/Netherlands3D ## Copyright and License ``` Copyright (C) X Gemeente X Amsterdam X Economic Services Departments Licensed under the EUPL, Version 1.2 or later (the "License"); You may not use this work except in compliance with the License. You may obtain a copy of the License at: https://github.com/Amsterdam/3DAmsterdam/blob/master/LICENSE.txt Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ``` ## Third parties and licenses DXF export library - [Lesser General Public Licence](https://github.com/Amsterdam/3DAmsterdam/blob/master/3DAmsterdam/Assets/Netherlands3D/Plugins/netDxf/README.md)
Sun Script - Credits to [Paul Hayes](https://gist.github.com/paulhayes)
3D BAG - [CC-BY licentie (TU Delft)](https://docs.3dbag.nl/en/copyright/)
BruTile (only used for its Extent struct) - [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)

Simple SJON - [MIT License](https://github.com/simplejson/simplejson/raw/master/LICENSE.txt)
Mesh Simplifier - MIT License
Clipping Triangles - MIT License
scripts/extentions/ListExtensions.cs - MIT License
Scripts/RuntimeHandle derivative work - MIT License
quantized mesh tiles (no longer used) - MIT License
JSZip - MIT License