跳轉到

十、 影像標註

影象標註模組是 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,分類未達信賴度則略過該圖。