[general]
name=3D City Studio
qgisMinimumVersion=3.28
description=Turn QGIS layers into an interactive 3D city in your browser: massing typologies, facade and roof library, sun, shadow, wind and view studies, guided tours, CityJSON, 3D Tiles and glTF export.
version=2.2.2
author=Geophilo
email=yusuf.eminoglu@deu.edu.tr
about=3D City Studio turns QGIS vector and raster layers into a Three.js city you can walk through, measure and present. Start with buildings alone, or add terrain, plan textures, aerial imagery, blocks, parcels, roads, trees and street furniture.
    Massing: podium and tower, stepped high-rise, courtyard block, pilotis and penthouse typologies, set globally, by zoning function or from QGIS styles. Materials: procedural and photographic facades from Anatolian brick to curtain wall, with regional roof presets. Analysis: interactive sun clock with shadows and daily sun hours, sky view factor, 360° viewsheds and pedestrian wind screening. Presentation: keyframed camera tours, 8K snapshots, MP4 video, and export to CityJSON, 3D Tiles, glTF/GLB or an offline HTML package. Selection syncs both ways between the browser and the QGIS canvas.
    The viewer runs on a local server at 127.0.0.1; your data stays on your computer. QGIS 3.28 to QGIS 4.
    Manual: https://geophilo.com/planx_3d_city/manual.html
tracker=https://github.com/YusufEminoglu/planx_3d_city/issues
repository=https://github.com/YusufEminoglu/planx_3d_city
category=Web
homepage=https://geophilo.com/planx_3d_city/
tags=planx,3d city,urban planning,three.js,geojson,geotiff,dem,raster texture,mobility,wind,narrative,keyframe,3d tiles,cityjson,sun hours,viewshed,zoning,webxr,massing,gltf,geophilo
icon=icons/icon.png
qgisMaximumVersion=4.99
experimental=False
deprecated=False
hasProcessingProvider=no
plugin_dependencies=
license=MIT
changelog=
    2.2.2 - Help opens the online guide on geophilo.com instead of a copy bundled in the plugin package; the plugin no longer ships documentation HTML.
    2.2.1 - Hub listing text rewritten; author Geophilo; university affiliation removed; documentation links use the standard geophilo.com pages (manual.html, guide/); manual HTML no longer ships in the plugin package.
    2.2.0 - Realistic streets and street life, dynamic facades, one English material catalogue.
        - Roads: asphalt with aggregate and cracks, lane, edge and centre lines, stop lines and zebra crossings painted in the shader at every junction, all roads in one draw call; honours oneway and lanes. Sidewalks with pavers and a raised curb that open where side streets join.
        - Street life: instanced cars, vans, taxis and buses drive in their lanes, keep their distance and turn at junctions, with headlights at night; instanced pedestrians walk the sidewalks and paths. Only those near the camera and in view are drawn.
        - Buildings: floor slabs follow the volume they belong to, flat roofs carry parapets and rooftop plant, a stone plinth at street level, contact shadows and window blinds by day. New Style toggle: Parapets, Plinths and Rooftop Plant.
        - Dynamic facades (new default, Style > Facades): window bays and floors laid out per wall, never cut by a corner, in six styles chosen from the building's function and height; a planx_facade attribute still wins.
        - One material catalogue for facades, roofs and surfaces, shared with 3D OSM Model, English names only; older names in saved settings, themes and attributes still load.
        - English only: Turkish keyword matching is gone from the building code, and the roadmap and reference manual are in English.
        - Fixed: lit windows stayed dark at night when the time came from a view link, bookmark or time preset.
        - Benchmark city: draw calls with traffic and people 2268 to 205, a quarter fewer triangles, the scene ready 39 percent sooner.
    2.1.3 - Official academic reference manual and real-world 30-board Konak digital twin atlas.
        - Built comprehensive academic reference manual featuring 30 publication-grade 4-panel comparison boards and 42 raw feature screenshots rendered with real Konak test data (2,367 building footprints and Copernicus 30m DEM).
        - Replaced conceptual mockups in the 4-step workflow guide with dual-panel side-by-side comparisons of actual QGIS Publisher dialogs and real 3D WebGL scenes.
        - Guarded raster layer extent updates in exporter.py against non-vector layer types.
    2.1.2 - Comprehensive metadata documentation and capability profile.
        - Updated metadata description and about documentation to reflect volumetric massing, architectural facades, and unified raster/vector workflows.
    2.1.1 - Qt6 static enum compatibility and clean ZIP file permissions.
        - Scoped QgsMapLayerProxyModel.Filter and QgsVectorFileWriter/QgsRasterFileWriter.WriterError enum references for zero static Qt6 analyzer warnings while keeping QGIS 3 and QGIS 4 runtime behavior identical.
        - Normalized archive entry permissions to 0644 (non-executable) for all Python and asset files.
    2.1.0 - Unified raster/vector workflows, volumetric 3D massing modes, and expanded architectural facade and roof catalogue.
        - Building models and facades: added ResidentialA-F photo facades, UrbanF, CurtainWall, NordicTimber, HeritageStone, AnatolianBrick, IndustrialLoft, BrutalistConcrete, plus TurkishTile, CopperPatina, GravelBallast, and LeadMansard roof presets and the Modern Turkish theme.
        - Volumetric 3D massing: Auto Smart Massing (default), Podium + tower, Stepped tower, Courtyard block, Cantilever / pilotis, and Penthouse crown modes selectable globally, per function, or via QGIS Quick Style.
        - Unified raster/vector workflow: removed the separate Publish mode toggle and mandatory layer requirements so any combination of raster or vector layers exports and supports solar, SVF, viewshed, wind, and elevation/slope tint analyses.
        - Layer selection ergonomics: all layer combo boxes start empty unless strictly matched by geometry type and name, with a one-click Clear all layers button.
    2.0.1 - The repository and issue tracker moved to GitHub (github.com/YusufEminoglu/planx_3d_city).
    2.0.0 - Faster viewer, planning tools and exchange formats.
        - Performance: merged building tiles (10k buildings: 44,249 -> 447 draw calls), worker-built geometry, on-demand rendering, BVH picking; 50k-building scenes load about twice as fast.
        - Visual quality: physical sky and sky lighting, 4x MSAA and GTAO, lit windows at night, straight-skeleton hip and gable roofs, glossy glass, optional depth of field and tree wind.
        - Planning tools: GPU sun hours, sky view factor and viewshed; zoning what-if scenarios with existing | A and B | A split views.
        - Exchange and output: 3D Tiles 1.1 and CityJSON 2.0 export, view links, screenshots up to 8K, MP4 tour videos, WebXR, portable packages ready for GitHub/GitLab Pages and Netlify.
        - QGIS: a 3D preview panel with two-way building selection.
        - Exporter: DEM cropped to the scene (tiled DEFLATE GeoTIFF), lighter GeoJSON, unchanged layers kept on re-export.
        - Fix: the sun stood on the opposite side of the sky; zoning envelopes were never drawn.
        - Breaking: English-only UI and attribute names (map Turkish column names in the field mapping); exported data moved to web/data/vector, so re-export existing projects.
    1.0.3 - Redesign plugin icon to high-end 3D tactile brand design with circular teal pedestal, zero margin, and refreshed documentation links.
    PlanX 3D City Viewer 1.0.0 - Flagship Official Release.
        - Includes 1-click OSM Urban Harvester expansion, Atmosphere & Lighting Studio, Visual Readiness Gauge, WebGL Performance Tier Estimator, Volumetric GFA Calculator, GeoTIFF Edge Blending, and Keyboard Shortcuts HUD.
        - Added dynamic 0-100 percent Scene Readiness Score and Pre-Flight WebGL Performance Tier predictor (Ultra 60+ FPS, High Performance, Heavy Urban Scene) to quality report.
    PlanX 3D City Viewer 0.8.66 - Atmosphere & Lighting Studio presets.
        - Added 5 visual lighting presets (Midday Sunlight Clean, Golden Hour Architectural, Overcast Soft Studio, Night Lights & Glow, Morning Mist) to QGIS publisher.
    PlanX 3D City Viewer 0.8.65 - Full 1-click OSM urban harvester expansion.
        - Expanded Overpass harvester to fetch waterlines, streetlights, benches, bus stops, and trash bins in 1 click alongside buildings, roads, greens, and trees.
    PlanX 3D City Viewer 0.8.64 - Nav tab visual icons and geographic CRS reprojection advice.
        - Added visual tab icons (0 Guide, 1 Data, 2 Check, 3 Style, 4 Publish) and automatic UTM reprojection guidance to quality report.
    PlanX 3D City Viewer 0.8.63 - Master AI audit fixes.
        - Cleaned Bandit B110 try/except pass occurrences, added vector layer commitChanges on attribute edits, and preserved road access keywords in presets.
    PlanX 3D City Viewer 0.8.62 - Mapped attribute fields summary in quality report.
        - Quality report displays active attribute column mappings (floors, population, road width, tree height, function).
    PlanX 3D City Viewer 0.8.61 - Auto-detect attributes button.
        - Added a 1-click Auto-detect attributes button to re-scan smart column aliases.
    PlanX 3D City Viewer 0.8.60 - Auto QGIS map canvas extent zoom.
        - QGIS map canvas auto-zooms to imported sample dataset or harvested OSM boundary.
    PlanX 3D City Viewer 0.8.59 - Smart attribute field auto-detection.
        - Automatic pairing for katadedi, nufus, floors, genislik, and function columns.
    PlanX 3D City Viewer 0.8.58 - Hero header quick export button and unneeded root file cleanup.
        - 1-click Export & Open 3D Viewer button in dialog hero header and cleaned residual root files.
