跳转至

十、 图像标注

图像标注模块是 ATSVisionOps 的核心功能之一,专为工业缺陷检测设计,支持高效率、高精度的图像标注与数据管理。

picann.png picann7.png

💡: 如果上方的图片看不清楚,可以按住 Ctrl + 鼠标滚轮 进行缩放。


功能引导

首次打开图像标注页时,会显示 12 步引导。从选择图片目录、选择标签和画第一个框开始,再介绍切图、编辑、撤销、数据工具和设置。可以边看边操作,也可以跳过。需要重看时,点击左侧面板底部的「功能引导」。

1. 基础标注与模式切换

系统支持多种工业视觉主流标注格式,可通过快捷键快速切换。

  • 矩形框标注:标准的水平边界框(BBox)。可选择传统的拖拽画框,也可开启两点点击画框模式(与 LabelMe 行为一致)。
  • 多边形标注 (Polygon):
    • 自动采样:基于时间和距离双重逻辑自动加点,配合两级后处理点密度自适应。
    • 手动描点:左键点击布点,Esc 可逐点撤回未完成的多边形。
    • 吸附逻辑:仅在接近连接点时触发吸附,确保复杂边缘的标注精度。
  • OBB 旋转框:专门适配 YOLO26-OBB 架构,与常规标注共用一套逻辑,无学习成本。

快捷键

按 [Q] 键可循环切换不同的标注模式。

ESC 多级取消

按 Esc 时会按以下顺序智能取消:多边形逐点撤回 → 取消绘制 → 取消拖动 / 缩放 / 顶点编辑 → 取消图片拖动 → 取消标注选中。逐层撤销,不会"一下子清空"。


2. 更便捷的操作体验

⌨️ 快捷键速查

类别 快捷键 功能
标注模式 Q 循环切换标注模式
撤销/重做 Ctrl + Z / Ctrl + Y 撤销 / 重做(每张图片独立栈,跨图不混淆)
删除 F 删除选中标注(支持列表多选批量删)
删除 Delete 清空当前图片所有标注
切换图片 A / ← 上一张
切换图片 D / → 下一张
重叠标注 N / P 选中下一个 / 上一个重叠标注
可见性 H / Ctrl + H 一键隐藏 / 显示所有标注
撤销中状态 Esc 智能取消(见上方提示框)

🔍 视图控制与放大

  • 鼠标位置缩放:滚动滚轮时,以鼠标当前指向为中心进行缩放。
  • 放大镜:
    • 同步主画面十字准星:开启十字辅助线后,放大镜内同步显示。
    • 像素值显示:底部信息条显示坐标、缩放倍率、辅助线状态、RGB / 灰度 / RGBA 像素值。
    • 异常回退:坐标转换异常时仍可显示图片,避免黑屏。
  • 重置视图:左键连续双击即可瞬间重置图片的缩放比例与位置。
  • 图像拖动:Ctrl + 鼠标左键拖动;按 ~ 或 ` 时禁用所有拖动和选择逻辑(防误触)。
  • 中键平移:支持鼠标中键直接抓取并移动整个标注框。

3. 标签管理与自定义

  • 预设体系:支持保存标签配置到本地 JSON,下次打开自动加载。
  • 快捷序号:标签列表显示数字序号,支持数字键 1-9 快速选定类别。
  • 颜色自定义:支持用户自定义每个标签的显示颜色,且在标注区域实时刷新。
  • 拖动排序:标签列表支持鼠标拖动重新排列,顺序自动持久化。
  • 高效编辑:
    • 就近弹出:编辑框在鼠标点击处弹出,减少视线大幅移动。
    • 记忆功能:标签修改支持手动输入并具备记忆功能。
    • 批量改标签:标注列表支持多选 → 批量修改标签名。

4. 数据辅助

  • 辅助线系统:
    • 十字准星:画框时自动显示垂直/水平坐标线。
    • 坐标显示:实时显示鼠标当前位置的物理坐标、缩放倍率、RGB / 灰度值(放大镜信息条)。
  • 图片列表智能化:
    • 状态指示:自动识别已标注 / 空标注 / 未标注三种状态:
      • ✅ 浅绿 —— 有标注
      • ⚠️ 浅黄 —— JSON / TXT 是空标注
      • ⚪ 白色 —— 无标注
    • 自然排序:img2.jpg 自动排在 img10.jpg 之前。
    • 右键重命名图片:同步重命名对应的 .json、.txt,自动更新 JSON 内 imagePath 字段。
    • 点击打开目录:列表路径高亮,点击可直接打开目录。
  • 移动图片到目标文件夹:右键菜单的「📁 移动到文件夹」,支持自定义目标文件夹(用于将 OK / NG 等样本快速分拣)。
  • 自动分类:一键按 JSON 标签把图片分到 classified_results/<label>/,多标签归入 Multi_class,无标注归入 Null_Pictures,多线程 + 进度条 + 取消支持。
  • 异常恢复:若软件非正常退出,再次打开时支持一键恢复之前的工作状态。

5. 样式与性能设置

用户在设置面板中微调标注风格,以匹配不同的显示设备:

  • 控制点:可调节矩形框四个角的控制点大小与样式。

  • 线条粗细:全局统一标注线条宽度(默认 2px),选中状态高亮为蓝紫色。

  • 灰度 UI:界面采用中性灰度渐变,极大程度缓解长时间盯着屏幕产生的视觉疲劳。


为了适配不同用户的操作习惯,ATSVisionOps 提供了自定义的设置面板。您可以通过设置调整标注手感、视觉样式及自动化程度。


设置面板总览

左侧的「标注设置」包含五个页签:缩放、其他设置、标注样式、放大镜、十字准星。画框方式和自动确认位于「其他设置」。


缩放设置 (Zoom Settings)

picann2.png

控制图片在缩放时的逻辑基准,适配不同的观察习惯。

  • 缩放中心点:
    • 图片中心:滚动滚轮时,图片始终绕其几何中心进行缩放。
    • 鼠标位置:以当前鼠标指针所指的像素点为中心进行缩放,方便直接"推进"查看特定缺陷细节。

标注样式设置 (Style Settings)

picann4.png

用户可根据缺陷的大小和背景复杂度,自由调整标注框的显示样式。

配置项 说明 可选值/范围
线条粗细 设置标注框外轮廓的像素宽度 0.1px - 10px
调节点大小 设置矩形框四周控制手柄的大小 1px - 15px
调节点样式 设置用于调整框体大小的控制点形状 圆形、方形、隐藏

辅助工具设置 (Assist Tools)

🔍 放大镜设置

picann5.png

在不改变全局缩放的情况下,通过悬浮窗口观察微小特征。

  • 放大倍数:调整放大镜内图像的放大倍率。
  • 窗口显示大小:调整放大镜悬浮窗口的直径/尺寸。

🎯 十字准星设置

picann6.png

  • 坐标显示控制:开启后,在十字准星交汇处实时显示当前的像素坐标,辅助精确对齐。

自动化与习惯设置 (Workflow)

picann3.png

记忆功能

  • 记住缩放位置:
    • 开启:切换下一张图片时,系统将自动应用上一张图片的缩放比例与位移偏置。
    • 应用场景:适用于批量的物料位置固定的缺陷检测,无需逐张调整视野。

交互优化

  • 自动确认标注:
    • 开启:标注完成后直接保存,不再弹出标签确认窗口。
    • 关闭:每次标注后弹出弹窗,方便用户核对标签类别。

标注逻辑

  • 两点点击画框模式:
    • 开启:矩形框标注逻辑和 LabelMe 相同。
    • 关闭:恢复为 ATSVisionOps 的矩形框标注逻辑。

重叠标注与多选管理

  • 重叠标注子菜单:右键点击重叠区域弹出「✏️ 编辑标注 / 🗑️ 删除标注」子菜单,每个标注按 标签 (类型) + 颜色图标区分。
  • N / P 键:在重叠标注之间快速循环切换选中项。
  • 列表多选:右侧标注列表支持 Ctrl / Shift 多选,F 键一键批量删除。

自定义目标文件夹(图片右键 → 移动到文件夹)

适用于大批量数据集的快速分拣(如 OK / NG / 返工 / 待复核):

  1. 右键任意一张图片 → 📁 移动到文件夹 → ⚙️ 管理目标文件夹。
  2. 在弹窗中新增 / 编辑 / 删除目标文件夹名称。
  3. 后续右键图片直接选目标文件夹,图片 + JSON + TXT 一并移动,同名冲突会提示覆盖确认。

配合自动分类使用

自动分类输出 classified_results/,右键移动文件夹适合人工最终审核环节,把模型难判的样本拎出来单独放。


📂 自动分类(基于 JSON 标注)

高级操作里的「📂 自动分类」按钮:

  • 在当前图片目录下创建 classified_results/ 输出目录。
  • 多线程后台执行,支持进度条和取消。
  • 分类规则:
    • 单标签 → <label>/
    • 多标签 → Multi_class/
    • 无 JSON / 空标注 → Null_Pictures/
  • 完成时弹窗统计:已分类、多类、无标注、错误、总计。
  • 支持文件数校验,确保分类前后总数一致(防丢图)。

操作不可逆

自动分类是移动而不是复制。原图的 JSON/TXT 会跟着一起进分类文件夹,分类前请确认不需要保留原始结构。


设置保存

所有设置修改后将实时生效,并自动保存到本地配置文件。下次启动软件时,系统将延续您的个性化配置,无需重复设置。

快速开始

  1. 导入单图或文件夹。
  2. 使用 Q 选择模式,鼠标绘制标注。
  3. 完成标注(如有提示则先确认)或修改已有标注后,软件会即时保存。也可按 Ctrl+S 手动保存当前图片的标注。
  4. 点击右侧工具栏进行 COCO 转换 或 缺陷分析。

模型自动标注(可选组件)

  1. 切换到 JSON 标注模式,点击左侧的「模型自动标注」。
  2. 点击「安装组件」,选择所需的完整组件 ZIP 即可自动安装。GPU 组件体积较大,可按需安装。无需安装 Trainer 或配置 Python 路径。
  3. 选择架构、任务、CPU/GPU 和本地模型,点击「加载模型」。现代架构支持 PT、ONNX;经典架构需要包含模型、参数、部署配置和类别名的完整导出目录,不能仅提供 .pdparams。
  4. 点击「识别当前图片」,完成后点击「追加并保存」。已有框保留,结果可以在画布中人工修改或撤销。关闭空闲窗口会在本次软件会话中保留模型,点击「停止」可释放模型。
  5. 「批量识别未标注图片」仅为没有 JSON/TXT 的图片生成同名 JSON。已有文件会跳过;停止或失败时保留已经保存的结果。批量结果需逐图复核,不能一次撤销整批。

组件可在 下载页 获取。加载模型后,可关闭窗口并在标图界面按 F8 直接识别、追加并保存,支持撤销。「卸载组件」可释放空间,保留模型和标注文件。

检测、分割和旋转框保存为现有标注形状;分类保存为图片级类别,不生成假框,可通过左侧的图片类别按钮修改或清除。ONNX 当前使用 CPU;经典检测的重叠阈值由导出模型决定。无目标的检测会生成空 JSON,分类没有达到置信度则跳过该图。