关键点标注使用说明

关键点标注其实就是“在图上标关键位置”：在目标的关键部位（如眼睛、鼻子、耳朵）逐一点选，并给每个点对应一个名称。和只画一个外框的目标检测、或覆盖整片区域的分割相比，关键点标注更关注各个关键部位之间的位置关系。它常用于人脸五官、人体姿态、动物特征点、工业零件结构点等场景，广泛应用于姿态估计、视觉跟踪、目标检测和精细化识别任务。

标注核心作用#

1. 为姿态与部位检测提供训练数据：逐点标记关键部位位置，并绑定关键点名称，为关键点检测类模型提供监督信号；
2. 支持多目标、多关键点标注：同一图像可为多个目标分别标注，关键点列表可包含多种部位名称；
3. 兼顾标注效率与细粒度表达：在不需要轮廓级精度的情况下，通过关键点坐标实现较高的结构化信息输出。

基础操作步骤#

1. 在底部标签栏选择要标注的关键点标签
2. 在图像上依次点击关键点位置（例如眼睛、鼻子、耳朵）
3. 根据需要继续为同一目标或其他目标添加关键点

说明：可使用右侧工具栏放大或缩小图片，便于进行精准点击标注。

注意事项#

• 关键点应尽量落在关键部位的中心或特征点位置，避免偏移导致模型学习误差；
• 同一关键点类别需保持一致的标注位置定义（例如“眼睛”是瞳孔中心还是眼角中心）；
• 标注过程中可随时撤销、修改或删除已绘制的关键点。

模板预览#

模板配置#

完整代码块#

<View>
    <Image name="image" value="$image_path" zoom="true"/>
    <KeyPointLabels name="kp-1" toName="image">
      <Label value="眼睛" background="red" />
      <Label value="鼻子" background="green" />
      <Label value="耳朵" background="blue" />
    </KeyPointLabels>
</View>

关键点标注配置代码说明#

以下代码用于实现关键点标注功能，可直接复制使用，关键部分可根据实际关键点需求修改。

1、图片加载组件：加载需要标注的图片，zoom=“true” 表示支持图片缩放，无需修改。

<Image name="image" value="$image_path" zoom="true"/>

2、关键点标注核心配置

• KeyPointLabels 是关键点标注组件，用于绑定关键点集合并关联图片组件；
• value 表示关键点名称（本示例包含“眼睛/鼻子/耳朵”，可按业务修改为任意关键点名称）；
• background 控制关键点在界面中的显示颜色，可使用常见颜色名或颜色值。

<KeyPointLabels name="kp-1" toName="image">
  <Label value="眼睛" background="red" />
  <Label value="鼻子" background="green" />
  <Label value="耳朵" background="blue" />
</KeyPointLabels>

说明

• 代码可直接复制到标注配置文件中使用
• 只需修改关键点名称和颜色即可适配不同场景
• 若需增加更多关键点，直接复制 Label 行并修改 value/background