[general]
name=02UrbanPortrait - City as a Face
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=Draw a portrait with a city's own streets and buildings: line weights and colours follow a photo's light and dark, live on the map, exported to PNG, PDF or SVG for print.
version=0.5.1
author=Geophilo
email=yusuf.eminoglu@deu.edu.tr

about=02UrbanPortrait turns a street network into a picture. Load a photo, place it over an area, and roads, buildings and points take their stroke width, size or colour from the brightness beneath them; from a distance the city becomes a face, a landmark or a logo. Your source geometry and attributes are never changed.
    Download streets and buildings for the area in one step or use project layers. Choose engraving, halftone (square or hex) or mask styles, start from ten colourways or your own JSON preset, and see the portrait update as you pan and zoom. The portrait is saved with the project and exports as PNG, PDF or SVG for posters and print.
    Manual: https://geophilo.com/zero2urbanportrait/manual.html

tracker=https://gitlab.com/geophilo1/zero2urbanportrait/-/issues
repository=https://gitlab.com/geophilo1/zero2urbanportrait
homepage=https://geophilo.com/zero2urbanportrait/

category=Vector
tags=portrait,osm,optical illusion,luminance,cartography,roads,buildings,generative art,halftone,stippling,engraving,map art,poster,geophilo
icon=icons/icon.png

experimental=False
deprecated=False
hasProcessingProvider=no
license=GPL-3.0-or-later
changelog=
    0.5.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.
    0.5.0 - Reliable portraits, true halftone, preset paper:
        Fixed: Halftone dots all had one size (the size expression named a field that does not exist); invert and gamma were applied twice to the halftone.
        Fixed: Saved projects reopened with blank portrait layers, exported QML only worked in the session that wrote it, and Restore failed after reopening.
        Fixed: Preset background colours were never applied, so dark presets drew and exported on white; export kept the canvas ratio only up to 2:1.
        Changed: Self-contained categorized renderer on feature ids, no Python callback per feature: native render speed, saved projects work without the plugin.
        Changed: Halftone dot area follows darkness, cells stay square on any frame, dots use the preset ink; new square or hex pattern.
        Added: Preset paper colour on the map and in exports (reversible), preset colour swatch, reconnection of saved portrait layers.
        Changed: New icon, the portrait relief on a transparent background without margin.
    0.4.2 - Upgraded official plugin icon to high-end tactile 3D brand identity with circular teal pedestal; synchronized documentation, repository and issue tracker endpoints to GeoPhilo and GitLab.
    0.4.0 - Reliable Studio Workflow & Safe Palettes:
        Fixed: Restore original styles now restores every portrait-styled source layer as its label promises.
        Fixed: Artwork export temporarily hides the frame without changing the user's frame visibility preference.
        Added: Step navigation readiness, halftone-only export support, clean OSM result selection, and completed-export feedback.
        Added: Strict palette JSON validation, size and count limits, normalized-name collision checks, and atomic file saves.
        Improved: Live refresh only runs for an active portrait; invalid stipple geometry and rendering values are rejected early.
        Added: GUI smoke coverage on QGIS 3.44 LTR and QGIS 4.x.
    0.3.2 - Enhanced OSM Acquisition & High-Visibility UI:
        Added: High-visibility '🗺️ Add OSM Basemap' and '⬇️ Download This View (OSM)' action buttons with custom theme styling and tooltips.
        Added: Live canvas extent safety badge pill with real-time metric indicators and readiness feedback.
        Added: Polished export panel with format clarification and prominent artwork export action.
    0.3.1 - Visual Workflow Stepper & Circular Step Nodes:
        Added: Interactive 3-stage visual workflow stepper with numbered circular badge nodes (❶ Set up ➔ ❷ Shape ➔ ❸ Export) and live action guide banner.
        Added: Numbered circular step badges across all group box sections for clear sequential progress tracking.
        Added: Direct 'Proceed to Next Step' navigation buttons in Set up and Shape tabs.
    0.3.0 - Major feature update:
        Added: Algorithmic Halftone & Vector Stippling Engraving Generator with variable-radius luminance modulation and memory layer creation.
        Added: 5 new master colorways (Cyberpunk 2077, Vintage Engraving, Thermal Heatmap, Emerald Eco-Map, Nordic Slate).
        Added: JSON Palette Preset Import and Export system for custom colorway sharing.
    0.2.3 - Palette-aware adaptive theme.
        Changed: replace the hardcoded stylesheet with palette-derived colour tokens so the dock stays readable under QGIS light, dark and high-contrast themes. The hero card keeps its intentional dark branding; all other surfaces follow the active Qt palette. The dock now listens for PaletteChange and re-applies the theme automatically.
    0.2.2 - Studio rebuild with integrated data-source and export panels; frame map-tool for drawing the geographic mask; project-state restoration.
    0.2.1 - Fix portrait aspect-ratio lock: enforce the precise image ratio instead of the approximate bounding-box fit.
    0.2.0 - Built-in OSM acquisition, safer line weights, optional frame overlay, light icon, and PNG/PDF/SVG export.
    0.1.0 - Initial release with live luminance sampling, smart masks, five artistic presets, reversible renderers, and viewport-aware updates.
