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

💡: 如果上方的图片看不清楚,可以按住 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)¶

控制图片在缩放时的逻辑基准,适配不同的观察习惯。
- 缩放中心点:
- 图片中心:滚动滚轮时,图片始终绕其几何中心进行缩放。
- 鼠标位置:以当前鼠标指针所指的像素点为中心进行缩放,方便直接"推进"查看特定缺陷细节。
标注样式设置 (Style Settings)¶

用户可根据缺陷的大小和背景复杂度,自由调整标注框的显示样式。
| 配置项 | 说明 | 可选值/范围 |
|---|---|---|
| 线条粗细 | 设置标注框外轮廓的像素宽度 | 0.1px - 10px |
| 调节点大小 | 设置矩形框四周控制手柄的大小 | 1px - 15px |
| 调节点样式 | 设置用于调整框体大小的控制点形状 | 圆形、方形、隐藏 |
辅助工具设置 (Assist Tools)¶
🔍 放大镜设置¶

在不改变全局缩放的情况下,通过悬浮窗口观察微小特征。
- 放大倍数:调整放大镜内图像的放大倍率。
- 窗口显示大小:调整放大镜悬浮窗口的直径/尺寸。
🎯 十字准星设置¶

- 坐标显示控制:开启后,在十字准星交汇处实时显示当前的像素坐标,辅助精确对齐。
自动化与习惯设置 (Workflow)¶

记忆功能¶
- 记住缩放位置:
- 开启:切换下一张图片时,系统将自动应用上一张图片的缩放比例与位移偏置。
- 应用场景:适用于批量的物料位置固定的缺陷检测,无需逐张调整视野。
交互优化¶
- 自动确认标注:
- 开启:标注完成后直接保存,不再弹出标签确认窗口。
- 关闭:每次标注后弹出弹窗,方便用户核对标签类别。
标注逻辑¶
- 两点点击画框模式:
- 开启:矩形框标注逻辑和 LabelMe 相同。
- 关闭:恢复为 ATSVisionOps 的矩形框标注逻辑。
重叠标注与多选管理¶
- 重叠标注子菜单:右键点击重叠区域弹出「✏️ 编辑标注 / 🗑️ 删除标注」子菜单,每个标注按
标签 (类型)+ 颜色图标区分。 - N / P 键:在重叠标注之间快速循环切换选中项。
- 列表多选:右侧标注列表支持
Ctrl / Shift多选,F 键一键批量删除。
自定义目标文件夹(图片右键 → 移动到文件夹)¶
适用于大批量数据集的快速分拣(如 OK / NG / 返工 / 待复核):
- 右键任意一张图片 → 📁 移动到文件夹 → ⚙️ 管理目标文件夹。
- 在弹窗中新增 / 编辑 / 删除目标文件夹名称。
- 后续右键图片直接选目标文件夹,图片 + JSON + TXT 一并移动,同名冲突会提示覆盖确认。
配合自动分类使用
自动分类输出 classified_results/,右键移动文件夹适合人工最终审核环节,把模型难判的样本拎出来单独放。
📂 自动分类(基于 JSON 标注)¶
高级操作里的「📂 自动分类」按钮:
- 在当前图片目录下创建
classified_results/输出目录。 - 多线程后台执行,支持进度条和取消。
- 分类规则:
- 单标签 →
<label>/ - 多标签 →
Multi_class/ - 无 JSON / 空标注 →
Null_Pictures/
- 单标签 →
- 完成时弹窗统计:已分类、多类、无标注、错误、总计。
- 支持文件数校验,确保分类前后总数一致(防丢图)。
操作不可逆
自动分类是移动而不是复制。原图的 JSON/TXT 会跟着一起进分类文件夹,分类前请确认不需要保留原始结构。
设置保存
所有设置修改后将实时生效,并自动保存到本地配置文件。下次启动软件时,系统将延续您的个性化配置,无需重复设置。
快速开始
- 导入单图或文件夹。
- 使用
Q选择模式,鼠标绘制标注。 - 完成标注(如有提示则先确认)或修改已有标注后,软件会即时保存。也可按
Ctrl+S手动保存当前图片的标注。 - 点击右侧工具栏进行 COCO 转换 或 缺陷分析。
模型自动标注(可选组件)¶
- 切换到 JSON 标注模式,点击左侧的「模型自动标注」。
- 点击「安装组件」,选择所需的完整组件 ZIP 即可自动安装。GPU 组件体积较大,可按需安装。无需安装 Trainer 或配置 Python 路径。
- 选择架构、任务、CPU/GPU 和本地模型,点击「加载模型」。现代架构支持 PT、ONNX;经典架构需要包含模型、参数、部署配置和类别名的完整导出目录,不能仅提供
.pdparams。 - 点击「识别当前图片」,完成后点击「追加并保存」。已有框保留,结果可以在画布中人工修改或撤销。关闭空闲窗口会在本次软件会话中保留模型,点击「停止」可释放模型。
- 「批量识别未标注图片」仅为没有 JSON/TXT 的图片生成同名 JSON。已有文件会跳过;停止或失败时保留已经保存的结果。批量结果需逐图复核,不能一次撤销整批。
组件可在 下载页 获取。加载模型后,可关闭窗口并在标图界面按 F8 直接识别、追加并保存,支持撤销。「卸载组件」可释放空间,保留模型和标注文件。
检测、分割和旋转框保存为现有标注形状;分类保存为图片级类别,不生成假框,可通过左侧的图片类别按钮修改或清除。ONNX 当前使用 CPU;经典检测的重叠阈值由导出模型决定。无目标的检测会生成空 JSON,分类没有达到置信度则跳过该图。