[general]
name=QuickFieldBrush
qgisMinimumVersion=3.16
qgisMaximumVersion=4.99
icon=icon/icon.svg
description=矢量要素右键快速赋值、属性值格式刷与要素修改历史面板。 / Rapid attribute assignment via right-click, format painter, and edit history panel for QGIS.
version=0.4.0
author=OpenQGIS
email=OpenQGIS@outlook.com
about=
  QuickFieldBrush 用于在 QGIS 中给矢量要素快速填写或批量修改属性。
  包含三个功能模块：
  1. 交互赋值：框选要素后右键选择属性值进行赋值，按图层记忆目标字段，支持频次与字母排序。
  2. 属性格式刷：支持从要素吸取值或手动选值，在地图上连续点击要素写入，支持停靠与悬浮。
  3. 历史面板：记录修改历史，支持地图单击居中高亮、双击选中要素、单步还原与导出 CSV。
  /
  QuickFieldBrush helps edit and assign vector attributes in QGIS.
  Modules:
  1. Interactive assignment: Box-select features and right-click to assign values. Remembers the target field per layer, with frequency and alphabetical sorting.
  2. Format painter: Pick an attribute value or absorb it from an existing feature, then click features on the canvas to write values continuously. Supports docked and floating modes with High-DPI hit testing.
  3. History panel: Logs edits, centers the canvas on selected records, reverts individual changes, and exports records to CSV.
category=Vector
tags=vector, attributes, assignment, format painter, brush, tagging, history, undo, osm, fast edit
homepage=https://github.com/OpenQGIS/QuickFieldBrush
tracker=https://github.com/OpenQGIS/QuickFieldBrush/issues
repository=https://github.com/OpenQGIS/QuickFieldBrush
changelog=
  Version 0.4.0:
  - 🎯 高分屏与跨平台精准识别：重构要素拾取引擎为 QgsMapToolIdentify 原生识别体系，接入 event.mapPoint() 与 TopDownAll 几何距离优选，彻底消除 Mac Retina 视网膜屏与 Windows 4K 非整数缩放下的坐标漂移及邻近线误选。 / High-DPI precision hit-testing: Refactored feature identification to QgsMapToolIdentify with native event.mapPoint() and TopDownAll distance sorting, eliminating coordinate drift on Mac Retina and Windows 4K displays.
  - 🎨 光标精准对齐：格式刷工具统一采用中心对称的十字准星（CrossCursor），实现瞄准中心即落点。 / Pixel-perfect crosshair cursor: Replaced hand cursor with CrossCursor for zero-offset alignment on fine vector lines.
  - ✨ 右键菜单新增【设为 NULL / 清空字段】快捷项，支持一键清空选中要素属性。 / Added "Set to NULL (Clear field)" in right-click menu to batch clear selected features.
  - 🧹 自动过滤与规整假空值：文本字面量 "NULL"、"null" 及空白纯空格自动排除，不再污染常规分类列表。 / Auto-cleans false null literals ("NULL", "null", blank spaces) from candidate lists.
  - 🛠️ 格式刷控制台新增【设为 NULL】操作按钮与下拉选项，支持将画笔切换为清空刷入模式或批量置空已选要素。 / Added "Set to NULL" button and option in format painter to paint NULL or clear selected features.
  - 🧭 优化操作历史面板的 NULL 值展示，规范显示为 "NULL" 并保持单步撤销与精准还原。 / Standardized NULL values display in edit history ledger with full single-step revert support.
  - ⚡ 橡皮筋几何类型自适应：点、线、面要素瞬时高亮完美贴合要素轮廓。 / Dynamic rubber band geometry adaptation for points, lines, and polygons.
  Version 0.3.0:
  - 格式刷控制台与历史面板支持 QgsDockWidget 原生停靠与悬浮切换。 / Format painter and history dialog now support QgsDockWidget native docking and floating.
  - 面板宽度调整为 310px 与 320px，置顶图钉独立为微顶栏。 / Narrowed panel widths (310px/320px) and separated stay-on-top pin into an independent top bar.
  - 工具栏图标 Tooltip 增加两行操作提示，规范术语为“赋值”。 / Enhanced toolbar tooltips with 2-line instructions and standardized terminology to assignment.
  - 兼容 QGIS 4 与 Qt6（自动桥接强类型枚举）。 / Added full compatibility for QGIS 4 and Qt6 with scoped enum bridging.
  Version 0.2.1:
  - 安全扫描与规范检查 / Security scan and standards review.
  Version 0.2.0:
  - 格式刷控制台重构为原生 4 行紧凑布局，支持字段类型图标。 / Rebuilt format painter into a compact 4-row layout with field type icons.
  - 右键赋值菜单与格式刷支持字母与频次升降序切换。 / Added dynamic flipping sort (alphabetical and frequency) to menu and format painter.
  - 格式刷支持从要素吸取属性值，支持右键直接吸取。 / Format painter supports absorbing values from canvas features directly.
  - 新增操作历史面板，支持地图定位、单步还原、撤销与 CSV 导出。 / Added edit history panel with canvas centering, single-step revert, undo, and CSV export.
  - 更新图标样式，优化置顶稳定性与多语言支持。 / Updated icons, improved window pin stability, and added multilingual support.
  Version 0.1.0:
  - 首次发布，支持右键赋值与格式刷基础功能。 / Initial release with right-click assignment and format painter.
experimental=False
deprecated=False
