[general]
name=PlanX 3D City Viewer
qgisMinimumVersion=3.28
description=Interactive 3D city cockpit and urban analysis studio: volumetric massing typologies, architectural facades and roofs, solar and shadow studies, wind and viewshed screening, narrative tours, and CityJSON/3D Tiles export.
version=2.1.3
author=Yusuf Eminoglu
email=yusuf.eminoglu@deu.edu.tr
about=
    PlanX 3D City Viewer transforms QGIS vector and raster layers into an interactive, browser-based 3D city cockpit powered by Three.js and WebGL. Designed for urban planners, architects, and spatial analysts, it bridges 2D GIS datasets with tangible 3D urban morphology and environmental screening.
    
    KEY CAPABILITIES:
    - Volumetric 3D Massing: Automatic smart massing, podium and tower combinations, stepped high-rises, perimeter courtyard blocks, cantilevers with pilotis, and recessed penthouse crowns configured globally, by zoning function, or via QGIS quick styles.
    - Architectural Facade and Roof Library: High-resolution procedural and photographic facade textures (Residential A-F, Urban F, Curtain Wall, Nordic Timber, Anatolian Brick, Heritage Stone, Industrial Loft, Brutalist Concrete) paired with regional roof presets (Turkish Tile, Copper Patina, Gravel Ballast, Lead Mansard, Flat Terrace).
    - Unified Layer Workflows: Flexible multi-layer staging supporting DEM elevation surfaces, raster plan textures, aerial basemaps, buildings, zoning blocks, cadastral parcels, road networks, tree canopies, and urban street furniture. No mandatory layers required.
    - In-Browser Spatial Analytics: Real-time solar shadow studies with interactive sun clock, daily sun exposure, Sky View Factor (SVF), interactive 360-degree viewsheds, pedestrian wind impact screening, and hypsometric terrain tinting.
    - Presentation and Export Studio: Narrative camera tours with keyframe animation, high-resolution snapshot capture (up to 8K), MP4 cinematic video recording, CityJSON, 3D Tiles, GLTF/GLB models, and standalone offline 3D HTML export packages.
    - Bidirectional QGIS Integration: Live two-way selection synchronization between the browser viewport and the QGIS map canvas, accompanied by attribute inspection and district-scale density statistics.
    
    Runs locally via an embedded lightweight web server (127.0.0.1); no external cloud dependencies or third-party data uploads required. Compatible with QGIS 3.28 through QGIS 4.x. Developed with direct feedback from educational workflows and design studios at Dokuz Eylul University, Department of City and Regional Planning.
    
    Online Documentation and Reference Manual: https://geophilo.com/planx_3d_city/
    Source code and issue tracker: https://github.com/YusufEminoglu/planx_3d_city
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,QGIS
icon=icons/icon.png
qgisMaximumVersion=4.99
experimental=False
deprecated=False
hasProcessingProvider=no
plugin_dependencies=
license=MIT
changelog=
    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.
