影像標註

Name: Potato
Author: Potato

使用邊界框、多邊形、自由繪製和標記點標註影像。

Potato 的影像標註系統支援多種標註方法，適用於計算機視覺任務，包括目標檢測、分割和關鍵點標註。

支援的工具

工具	描述	使用場景
`bbox`	矩形邊界框	目標檢測
`polygon`	多點多邊形	實例分割
`freeform`	自由手繪	不規則形狀
`landmark`	點標記	關鍵點檢測
`fill`	畫素級填充工具	分割掩碼
`eraser`	擦除繪製區域	分割掩碼修正
`brush`	畫筆工具	精細分割

基本配置

yaml

annotation_schemes:
  - name: "objects"

配置選項

欄位	類型	預設值	描述
`name`	string	必填	標註的唯一識別符號
`description`	string	必填	顯示給標註者的說明
`annotation_type`	string	必填	必須為 `"image_annotation"`
`tools`	list	必填	啟用的標註工具（`bbox`、`polygon`、`freeform`、`landmark`、`fill`、`eraser`、`brush`）
`labels`	list	必填	標註的類別標籤
`zoom_enabled`	boolean	true	啟用縮放控制
`pan_enabled`	boolean	true	啟用拖動導航
`min_annotations`	integer	0	最少所需標註數
`max_annotations`	integer	null	最大允許標註數（null = 無限制）
`freeform_brush_size`	integer	5	自由繪製的筆刷大小
`freeform_simplify`	float	2.0	路徑簡化因子

標籤配置

標籤可以是簡單字串或詳細物件：

yaml

# Simple labels (auto-colored)
labels:
  - person
  - car
  - tree
 
# Detailed labels with custom colors and shortcuts
labels:
  - name: "person"
    color: "#FF6B6B"
    key_value: "1"
  - name: "car"
    color: "#4ECDC4"
    key_value: "2"
  - name: "bicycle"
    color: "#45B7D1"
    key_value: "3"

示例

目標檢測（邊界框）

yaml

annotation_schemes:
  - name: "detection"

實例分割（多邊形）

yaml

annotation_schemes:
  - name: "segmentation"

關鍵點標註（標記點）

yaml

annotation_schemes:
  - name: "facial_landmarks"

多工具

yaml

annotation_schemes:
  - name: "mixed_annotation"

鍵盤快捷鍵

按鍵	操作
`b`	啟用邊界框工具
`p`	啟用多邊形工具
`f`	啟用自由繪製工具
`l`	啟用標記點工具
`1-9`	選擇標籤
`Delete`	刪除選中的標註
`Ctrl+Z`	撤銷
`Ctrl+Y`	重做
`+` / `-`	放大/縮小

資料格式

輸入資料

資料檔案應包含影像路徑或 URL：

json

[
  {
    "id": "img_001",
    "image_url": "https://example.com/images/photo1.jpg"
  },
  {
    "id": "img_002",
    "image_url": "/data/images/photo2.png"
  }
]

在配置中設定影像欄位：

yaml

item_properties:
  id_key: id
  text_key: image_url

輸出格式

標註包含每個標註的幾何資料：

json

{
  "id": "img_001",
  "annotations": {
    "objects": [
      {
        "id": "ann_1",
        "type": "bbox",
        "label": "car",
        "geometry": {
          "x": 100,
          "y": 150,
          "width": 200,
          "height": 100
        }
      },
      {
        "id": "ann_2",
        "type": "polygon",
        "label": "building",
        "geometry": {
          "points": [
            [50, 50],
            [150, 50],
            [150, 200],
            [50, 200]
          ]
        }
      }
    ]
  }
}

支援的影像格式

JPEG / JPG
PNG
GIF
WebP

分割掩碼

v2.2.0 新增

fill、eraser 和 brush 工具支援畫素級分割掩碼標註。這些工具非常適合需要精確區域邊界的語義分割任務。

yaml

annotation_schemes:
  - name: "segmentation"

按鍵	操作
`i`	啟用填充工具
`e`	啟用橡皮擦工具
`r`	啟用畫筆工具

PDF/文件邊界框

v2.2.0 新增

在 PDF 頁面和文件影像上繪製邊界框。當與 instance_display 中的 pdf 顯示類型結合使用時，標註者可以在 PDF 文件的各個頁面上繪製框。

yaml

instance_display:
  fields:
    - key: pdf_url
      type: pdf
 
annotation_schemes:
  - name: "document_regions"

最佳實踐

使用合適的工具 - 快速檢測用邊界框，精確邊界用多邊形，分割用填充/畫筆
定義清晰的標籤 - 使用獨特、不重疊的類別
設定標註限制 - 使用 min_annotations 確保完整性
啟用縮放 - 對高解析度影像的詳細標註至關重要
使用鍵盤快捷鍵 - 顯著加快標註速度
提供標籤顏色 - 使視覺區分標註更容易