Skip to content

幾何圖元

框、多邊形、折線、橢圓、二維立方體、帶骨架的關鍵點集，以及按實例分離的畫筆掩碼；採用 V7 風格的鍵位約定，並提供舊版鍵位配置。

Potato 的影像標註涵蓋邊界框、多邊形、折線、橢圓、二維立方體、帶骨架拓撲的關鍵點集，以及按實例分離的畫筆掩碼。 它們全部通過 image_annotation 的 tools 列表來配置。

yaml
annotation_schemes:
  - annotation_type: image_annotation
    name: objects
    description: "Outline everything you find."
    source_field: image
    tools: [bbox, polygon, polyline, ellipse, cuboid_2d, keypoint_set, brush, eraser, sam]
    labels:
      - {name: vehicle, color: "#FF6B6B", key_value: "1"}
      - {name: person, color: "#4ECDC4", key_value: "2"}

可執行示例：examples/image/geometry-primitives/。

各類工具

工具形狀典型用途
bbox矩形目標檢測
polygon閉合多點形狀實例分割
polyline開放路徑車道線、裂縫、線纜
ellipse橢圓細胞、孔徑、圓形物體
cuboid_2d投影的三維框單目相機視角下的車輛
keypoint_set具名點加骨架連邊姿態、人臉、解剖標誌點
brush / eraser繪製的掩碼精細分割
fill識別顏色的漫水填充大片均勻區域
sam點選即分割參見互動式分割

關鍵點集帶有 COCO 可見性標誌與骨架拓撲，因此一個姿態匯出後仍是姿態，而不是一堆散點。

2.8 中變更的鍵位約定

預設鍵位現已遵循 V7 與 CVAT 的約定：

按鍵工具
v選擇
r矩形
b畫筆
f填充
k關鍵點
[ / ]減小 / 增大尺寸

這是一處變更：b 過去是邊界框，f 過去是自由繪製。已經在進行中的研究可以保留舊鍵位：

yaml
    keybinding_profile: legacy

標註者會看到一次性的變更提示，而不是靠畫錯形狀才發現。

提速技巧

  • 按類別顯示與隱藏，快捷鍵 h 與 Shift+H，該狀態在整個項目內保持，而不是每張圖片都重置。
  • 從上一張圖片複製標註，快捷鍵 Ctrl/Cmd+D，或設定 carry_over 讓它自動進行。對於高度相似的幀很有用。
  • 雙指平移與捏合縮放，適用於平板與手寫筆操作。

值得明說的修復

有幾項影像功能在更早的版本中雖已釋出卻並不工作，把這一點說清楚，比悄悄改掉更有用：

  • 接受 AI 檢測結果時呼叫了一個並不存在的方法，因此實際上是無聲的空操作。
  • 自由繪製工具畫出的路徑從未被儲存。
  • 畫筆筆跡會在實例之間串色，源於三個各自獨立的實例切換缺陷。
  • 在訓練階段中，影像標註完全無響應。

以上均已在 2.8 中修復。如果你在更早的版本上做過影像研究，尤其值得複查訓練階段的部分。

相關內容