[general]
name=OSM Quick 3D
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=One-click OpenStreetMap into native QGIS: function-styled vector layers plus flat-roof 3D building massing on a selectable study-area shape (rectangle, rounded rectangle, circle or hexagon), with optional recessed base and basemap underlay.
version=0.18.9
author=Yusuf Eminoglu
email=yusuf.eminoglu@deu.edu.tr

about=OSM Quick 3D is a fast, native companion to the browser-based 3D OSM Model plugin. Pick the visible map area (or the extent of your selected features) and a study-area shape — rectangle, rounded rectangle, circle or hexagon — and the plugin downloads OpenStreetMap buildings, roads, cycleways, waterways, greens, trees and street furniture straight into QGIS as memory layers, already styled by function: buildings coloured by OSM use, roads by highway class and metric width, water blue, greens green. The buildings are then extruded with QGIS's own 3D symbology into a clean flat-roof massing model whose height comes from OSM (tagged height, else floor count, else a sensible default), so it shows directly in a QGIS 3D Map View with no browser and no web server. Building colours are selectable and applied identically in 2D and 3D: by OSM function, or a soft height-graduated tint (gray, warm, teal, salmon, purple or sand), with multiple map themes for different cartographic looks. An optional height-exaggeration factor makes low-rise districts read in the 3D view, and trees get a matching 3D pass as simple green canopies. The city stands on an optional recessed ground base (the study area buffered outward by 5 m, extruded as a plinth from 2 m below up to ground level), tinted to harmonise with the chosen building colours. Every downloaded layer lands inside one tidy layer-tree group, an optional basemap layer is moved under the city to act as the ground, and the whole result can optionally be saved to a single GeoPackage so it survives a project reload instead of vanishing as a memory layer. The Theme & Style dock controls the native 3D scene, including per-layer visibility in 3D without hiding those layers from the 2D map. Buildings and roads can optionally be labelled by their OSM name with a white halo. Each building also carries a computed footprint area and an estimated gross floor area (footprint times floors) as real columns, and the run reports the area totals, so the output is ready for quick planning quantities. Overpass responses are cached on disk for a week, so re-running on the same area opens instantly without hitting the rate-limited public API again. Because the output is plain native layers, it scales to far larger areas than a web 3D scene; the practical limit is the public Overpass API. Built at Dokuz Eylul University, Department of City and Regional Planning.

tracker=https://github.com/YusufEminoglu/osm_quick_3d/issues
repository=https://github.com/YusufEminoglu/osm_quick_3d
homepage=https://github.com/YusufEminoglu/osm_quick_3d

category=Vector
tags=osm,openstreetmap,3d,massing,extrusion,overpass,urban planning,vector,qgis
icon=icons/icon.png

experimental=False
deprecated=False
hasProcessingProvider=no
license=MIT

changelog=
    OSM Quick 3D 0.14.0
        - Two-Layer Basemap Clipping: splits base into 2D mask layer (draped on terrain) and 3D plinth walls layer, ensuring basemap is cleanly clipped in 3D Map View.
        - Color Classifications: choose Continuous, Discrete steps, or Quantiles for height-graduated building colors.
        - View Stacking: programmatically stacks the 3D Map View dock widget directly above the plugin styling dock panel.
        - Cast-Safe expressions: explicit conversions (to_real/to_int) prevent evaluation errors on text-stored height fields.
    OSM Quick 3D 0.12.0
        - Scrollable UI panels: wrapped dialog and dock settings in resizable scroll areas for smaller monitors.
        - Compact design: reduced padding, margins, and font sizes to 11px to make UI compact and highly professional.
        - Z-Fighting fix: set default ground base slab top_z to -0.1 to avoid overlapping with draped basemaps.
        - Solid base capping: enabled back-faces rendering to ensure the ground base plinth is solid and filled.
    OSM Quick 3D 0.11.0
        - Live 3D Controller Dock: introduced an interactive sidebar panel to adjust building height exaggeration, color modes, labels, and base slab depth dynamically without re-downloading.
    OSM Quick 3D 0.10.1
        - Cartographic elevation: styled car parks and paved plazas with category-specific dark neutral outlines instead of green outlines.
    OSM Quick 3D 0.10.0
        - Relation (multipolygon) support: handles complex building footprints and green/water relations with courtyards and holes correctly.
        - OSM Water areas layer: a new MultiPolygon layer that downloads and styles lakes, ponds, reservoirs, and riverbanks.
        - Procedural tree scattering: deterministically plants and scatters trees in wooded areas, parks, and forests.
        - Parking lots and plazas: downloads and categorizes paved plazas and car parks, styling them as paved stone and asphalt gray in the greens layer.
    OSM Quick 3D 0.9.0
        - Optional name labels for buildings and roads: a "Show name labels" toggle labels each by its OSM name (non-empty only) with a white halo. Degrades gracefully where labeling is unavailable.
    OSM Quick 3D 0.8.4
        - A "Clear OSM cache" button in the dialog deletes all cached Overpass responses from disk and reports how many were removed.
    OSM Quick 3D 0.8.3
        - The ground base is tinted to harmonise with the chosen building colours (a darkened tone of the tint for the 3D plinth, a light tint for the 2D fill); neutral slate for By function / By height.
    OSM Quick 3D 0.8.2
        - The dialog shows a live gradient preview swatch under the building-colour selector, updating as you change the mode, so you see the look before running.
    OSM Quick 3D 0.8.1
        - Three more soft building-colour tints: Soft salmon, Soft purple and Soft sand, alongside gray, warm and teal (and By function / By height).
    OSM Quick 3D 0.8.0
        - Selectable building colours, identical in 2D and 3D: by OSM function, or a soft height-graduated tint (By height, Soft tinted gray, Soft tinted warm, Soft teal); the tint modes drive both the 2D fill and the 3D diffuse from one color_rgb ramp by height.
        - Elite-soft dialog: rounded white group cards, gradient header, soft focus accents and a teal primary button.
    OSM Quick 3D 0.7.1
        - Security/quality fixes to clear the QGIS Plugin Hub scan that blocked 0.7.0: the Overpass cache filename uses SHA-256 instead of SHA-1 (only ever a filename digest, never security), plus two Flake8 nits. No functional change.
    OSM Quick 3D 0.7.0
        - Selectable study-area shape: rectangle, rounded rectangle, circle or hexagon; OSM features are clipped to the chosen shape (circle/hexagon inscribed in the shorter side).
        - Optional ground base: the study area buffered outward by 5 m, extruded in 3D as a recessed plinth from -5 m up to ground level, under the city.
        - Fully English UI; redesigned grouped dialog with a header; new isometric plugin icon.
    OSM Quick 3D 0.6.1
        - Fix: polygon/line layers created as Multi* so a feature split into several parts by boundary-clipping is no longer silently dropped (matters most on larger areas). Adds a headless test harness for the pure-Python logic.
    OSM Quick 3D 0.6.0
        - Buildings carry a computed footprint_m2 (polygon area in the metric CRS) and an estimated gfa_m2 (footprint x floors) column, in both the memory and GeoPackage outputs, ready to label/sum/analyse.
        - The run summary reports the total building footprint and estimated gross floor area.
    OSM Quick 3D 0.5.0
        - Tree points get a matching 3D pass (green sphere canopies on the terrain) whenever 3D extrusion is on; degrades to 2D markers where no 3D point symbol is available.
        - README refreshed for the function-coloured massing, height exaggeration, layer group, GeoPackage save and Overpass cache.
    OSM Quick 3D 0.4.0
        - Overpass responses cached on disk for a week, keyed by the exact query: re-running on the same area opens instantly without hitting the rate-limited public API again. New "use cache when possible" toggle (on by default).
    OSM Quick 3D 0.3.0
        - Optional "Save to GeoPackage": every downloaded layer is written into one .gpkg and reloaded from it, so the result survives a project reload instead of vanishing as a memory layer. Failed writes fall back to a memory layer with a warning.
    OSM Quick 3D 0.2.0
        - 3D massing coloured by OSM function in the same palette as the 2D legend (data-defined diffuse colour), not one flat grey.
        - Height-exaggeration factor (0.5x-5.0x) so low-rise districts read in the 3D Map View; 1.0x keeps true OSM heights.
        - All downloaded layers grouped under one tidy layer-tree group, keeping the legend clean on larger areas.
    OSM Quick 3D 0.1.0 - Initial release.
        - One-click OpenStreetMap download for the visible map area or the extent of selected features.
        - Layers arrive as native QGIS memory layers, styled by function: buildings by OSM use, roads by highway class and width, water blue, greens green.
        - Buildings are extruded into a flat-roof 3D massing model using native QGIS 3D symbology; height is read from OSM (height, then floor count, then a default).
        - Optional basemap layer is moved underneath to act as the ground in 2D and in the 3D Map View.
        - Built for larger areas than a web 3D scene; the practical limit is the public Overpass API.
