[general]
name=02truesize - Map Truth Lab
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=Drag countries or downloaded ADM0/ADM1 administrative vectors anywhere to compare true size, grade projection honesty and explore geodesy.
version=0.3.2
author=Yusuf Eminoglu
email=yusuf.eminoglu@deu.edu.tr

about=Maps lie: every flat map must distort the globe, and the everyday web map (Mercator) inflates whatever sits far from the equator — Greenland is drawn like a continent yet Africa is about 14 times larger. 02truesize brings the much-loved thetruesize.com idea natively into QGIS and then goes further. The True Size tool lets you grab any country from the bundled offline world layer, any polygon from your own layers, or country-selected ADM0/ADM1 vectors, and drag it across the map; the outline is re-projected on the fly through an equal-area azimuthal projection centred under your cursor, so it always covers its true ground area. ADM0 comes instantly from the bundled world data; ADM1 is filtered from Natural Earth's official public-domain 10m states/provinces archive, downloaded once per panel session. Size Duel is a built-in game: two countries are drawn exactly the way a web map would draw them and you guess which one is really bigger — the plugin keeps score and confesses how much the projection lied each round. The Distortion tab grades the current project CRS with separate marks for area and shape, Tissot indicatrix circles and a live distortion readout. Truth Tools adds an antipode finder, great-circle comparison and playful measurement units. The core remains dependency-free with pure-Python geodesy and native QGIS map tools. A playful, accurate companion for teaching projections, scale and spatial reasoning. Developed with feedback from educational workflows at Dokuz Eylul University, Department of City and Regional Planning.

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

category=Vector
tags=planx,true size,mercator,projection,distortion,comparison,education,game,quiz,geodesy,area,distance,tissot,antipode,great circle,map truth,administrative boundaries,adm0,adm1,natural earth

icon=icons/icon.png

experimental=False
deprecated=False
hasProcessingProvider=no
license=GPL-3

changelog=
    0.3.2 - Removed stale geoBoundaries GitHub/LFS vector links that returned HTTP 404/500. ADM0 now comes instantly from the bundled 238-country layer; ADM1 is filtered from Natural Earth's official public-domain 10m states/provinces archive, downloaded at most once per panel session. Missing ADM1 coverage receives an ADM0 suggestion and Kosovo codes are mapped consistently.
    0.3.1 - Corrected the online data workflow: choose a country and download only ADM0 country or ADM1 first-level administrative vectors through geoBoundaries gbOpen; current-canvas Overpass queries and non-administrative polygons are removed. Source, year and license metadata are preserved on the memory layer. Selecting Built-in world countries now checks its visibility control, adds or repairs the 238-country layer and zooms to the world.
    0.3.0 - Built-in bounded OpenStreetMap polygon acquisition for the True Size workflow. Download administrative boundaries, buildings, land use, leisure, natural and water areas from the current neighbourhood-scale view through an asynchronous, cancellable Overpass request. Successful data becomes a styled memory layer and a dedicated drag source automatically. Includes hard 6 km per-side and 25 km2 request limits, response validation, rate-limit feedback, pure request tests and an OSM data-plan document.
    0.2.1 - World-layer reliability and tab-caption fixes. The bundled country layer is inserted above basemaps, zooms to a safe world extent, appears automatically when world picking starts and falls back to a raw-GeoJSON memory layer if OGR cannot open it. Qt now measures tab captions with their actual bold font; variable-width emoji moved to tooltips so labels no longer truncate.
    0.2.0 - Icon redesign and GUI overhaul. New toolbar icon in the 02-family visual language: a glowing mint outline landmass (the size the web map claims) versus its solid coral true size, crisp at small sizes. The dock now pins its own light design system so it reads identically under QGIS 3 light and QGIS 4 dark themes: header with icon and tagline, teal tab badges, white card panels with per-tool accent stripes, clearly highlighted active tool buttons, and theme-proof combos and lists. The projection report card renders its grades as coloured chips (green A plus down to red F), the Size Duel gets hover highlights, a round counter and a smarter action button, and ghost list entries carry full tooltips. No behaviour changes; verified end-to-end on QGIS 3.44 LTR and QGIS 4.
    0.1.0 - First release. True Size drag tool: pick up any country (bundled offline Natural Earth layer) or any polygon from your own layers and drag it anywhere; the ghost outline is re-centred through an equal-area azimuthal projection so it always shows its true ground size on the current project CRS, with live area label, rotation keys, multiple coloured ghosts and export-to-layer. Size Duel guessing game with Mercator-drawn silhouettes, streaks and a per-round confession of how much the projection lied. Projection honesty report card (area and shape grades plus verdict) for the current project CRS, Tissot indicatrix circle layer generator and a live distortion heads-up display on the canvas. Antipode finder with land-or-ocean verdict, great-circle versus straight-map-line comparison with wasted-kilometres readout, and fun-unit area and distance measurements (football pitches, Central Parks, Belgiums, marathons, trips to the Moon). Fully offline, no external dependencies; verified on QGIS 3.44 LTR and QGIS 4.
