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 中修复。如果你在更早的版本上做过图像研究，尤其值得复查训练阶段的部分。

相关内容