[[TranslatedPages]]

= Urban Eye 3D – JOSM 3D Viewer Plugin =

== Overview ==
'''Urban Eye 3D''' is a JOSM plugin that provides a dedicated 3D view (dockable or floating) to visualize loaded buildings and building parts (`building=*` and `building:part=*`). The main goal of the plugin is to make the creation and editing of 3D buildings in OpenStreetMap easier by allowing mappers to preview their edits directly within JOSM before uploading them to the server.

== Key Features ==
* Support for the [https://wiki.openstreetmap.org/wiki/Simple_3D_Buildings Simple 3D Buildings] specification.
* Visualization only – no editing or export functionality.
* Intuitive navigation, similar to modern 3D editors.
* Basic color support for `building:colour` and `roof:colour` tags.
* Two display modes: ''solid'' and ''wireframe''.
* Real-time updates: Changes made in JOSM instantly reflect in the 3D view.


== How to Use ==

=== Navigation ===
* '''Orbit:''' Press and hold the left mouse button and drag the mouse.
* '''Zoom:''' Use the mouse wheel.
* '''Pan:''' Press and hold the right mouse button and drag the mouse.

=== Display Modes ===
The plugin supports two display modes:
* '''Solid:''' A view with filled polygons.
* '''Wireframe:''' A view that shows only the edges of the geometry.

To switch between modes, press the '''Z''' key. You can change this hotkey in JOSM [wikitr:/Help/Preferences/Shortcuts hotkeys preferences].

== Supported Roof Shapes (`roof:shape`) ==
See [https://github.com/Zkir/UrbanEye3D/blob/master/docs/features.md Plugin documentation] for the list of supported roof shapes.

=== Limitations ===
* Several roof shapes (`mansard`, `half-hipped`, and `cross_gabled`) are supported for quadrilateral polygons only. Support for those roof shapes on arbitrary non-convex polygons may be added in future versions.

== Community and Contributions ==
For any questions or discussions, please visit the [https://community.openstreetmap.org/t/urban-eye-3d-josm-3d-viewer-plugin/133674 official forum thread].

If you are eager to contribute to the development, you are welcome to visit our [https://github.com/Zkir/UrbanEye3D GitHub repository].

== Licensing ==
The plugin is open-source and licensed under [https://www.gnu.org/licenses/gpl-3.0.html GNU GPL v3].


----
Back to [wikitr:/Plugins#JOSMdocu Plugin Help] \\
Back to [wikitr:/Help Main Help]