[general]
name=Bearing Protractor
qgisMinimumVersion=3.4
qgisMaximumVersion=4.99
description=Interactive floating protractor and advanced azimuth/distance measurement tool for RF Site Audit and Network Planning.
version=3.9.4
author=Jujun Junaedi
email=jujun.junaedi@outlook.com
license=GPL-2.0-or-later
about=Bearing Protractor is an interactive floating protractor and azimuth/distance measurement tool for QGIS, designed for Telecommunications, RF Engineering, GIS planning, and site audit workflows. The protractor stays directly on the map canvas, allowing users to visualize bearings, sector beams, distances, and coverage directions without leaving the map. Key features include:
    * Visual Beam & Multiple Bearings: Create and adjust multiple sector bearings with visual beam coverage directly on the map canvas.
    * Floating Legend Summary: A freely draggable panel providing a real-time summary of active sectors, including labels, azimuths, distances, colors, and sector information.
    * Calculated Population: Estimate the population within a sector footprint by sampling data from a selected population raster layer.
    * Real-Time Distance Tracking: Calculate real-world distances in meters or kilometers dynamically using QGIS distance calculations.
    * Manual Measurement Ruler: Draw a temporary measurement line to quickly check azimuth and distance between sites or other map locations.
    * Cell Footprint Generation: Export current sector configurations as polygon vector layers directly to the QGIS map canvas.
    * Copy Data: Copy sector information such as Azimuth, Beamwidth, and Distance to the clipboard for use in spreadsheets, reports, and other workflows.
    * Sector Customization: Change individual sector labels, colors, and beamwidths directly from the bearing context menu, or remove a selected bearing when it is no longer needed.
    * Resizable Protractor: Resize the protractor directly on the map canvas using the mouse wheel. Place the cursor at the center of the protractor ring and scroll up or down to adjust its size.
    * Custom Visual Styles: Choose from different protractor styles and customize visual elements such as colors, fonts, text, ring size, and sector appearance.
    * Azimuth Gap Threshold: Set an azimuth gap threshold to help identify potential gaps or clashes between sector bearings during site audits.
    * Persistent Settings: Visual preferences and selected settings are retained across QGIS sessions.
    * Bilingual Support: Switch between English and Indonesian through the plugin interface.
    * Clean Floating Interface: The transparent, map-focused interface keeps the protractor and its tools accessible without unnecessarily blocking the QGIS map canvas.
    Whether you are checking site azimuths, measuring distances, reviewing sector configurations, or performing RF site audits, Bearing Protractor provides a practical visual workflow directly inside QGIS.

tracker=https://github.com/junethtea/bearing-protractor/issues
repository=https://github.com/junethtea/bearing-protractor
homepage=https://github.com/junethtea/bearing-protractor
tags=azimuth, bearing, protractor, rf engineer, telecommunications, site audit, cell planning, distance, measurement, tools, population, qgis
category=Vector
icon=icon.png
experimental=False
changelog=
    3.9.4 - Added an About dialog notice introducing Bearing Protractor Pro for users who need additional RF planning and site audit features.
    3.9.3 - Added Floating Legend Summary for real-time sector monitoring and clash detection. Introduced Calculated Population feature to estimate population counts within sector footprints using raster data.
    3.9.2 - Added QGIS 4.x (PyQt6) compatibility support. Introduced Export Footprint to generate polygon vector layers representing cell coverage. Added Copy Data for quick tabular export of Azimuth, Beamwidth, and Distance to the clipboard.
    3.9.1 - Added 4 new visual protractor styles (4 Markers, Spider Web, Crosshair, Radar Rings) for better adaptability to map clutter. Fixed widget dragging mechanism to prevent the protractor from getting stuck to the cursor or moving outside the map canvas bounds. Adjusted measurement text offsets to prevent cursor overlap.
    3.9.0 - Stable release. Added real-world distance tracking in meters/kilometers using QgsDistanceArea, bilingual Help menu (English/Indonesian), and dynamic label offsets.
    3.8.0 - Added persistent settings for visual customization, ring thickness, and sector beamwidth adjustments.
    3.0.0 - Initial floating widget implementation with mouse-wheel resizing and dynamic sector arms.