FastDeploy/docs/api/vision_results/keypointdetection_result_CN.md

中文 | [English](keypointdetection_result.md)
# KeyPointDetectionResult 目标检测结果

KeyPointDetectionResult 代码定义在`fastdeploy/vision/common/result.h`中，用于表明图像中目标行为的各个关键点坐标和置信度。

## C++ 定义

`fastdeploy::vision::KeyPointDetectionResult`

```c++
struct KeyPointDetectionResult {
  std::vector<std::array<float, 2>> keypoints;
  std::vector<float> scores;
  int num_joints = -1;
  void Clear();
  std::string Str();
};
```

- **keypoints**: 成员变量，表示识别到的目标行为的关键点坐标。
  `keypoints.size()= N * J`
    - `N`：图片中的目标数量
    - `J`：num_joints（一个目标的关键点数量）
- **scores**: 成员变量，表示识别到的目标行为的关键点坐标的置信度。
  `scores.size()= N * J`
    - `N`：图片中的目标数量
    - `J`:num_joints（一个目标的关键点数量）
- **num_joints**: 成员变量，一个目标的关键点数量
- **Clear()**: 成员函数，用于清除结构体中存储的结果
- **Str()**: 成员函数，将结构体中的信息以字符串形式输出（用于Debug）

## Python 定义

`fastdeploy.vision.KeyPointDetectionResult`

- **keypoints**(list of list(float)): 成员变量，表示识别到的目标行为的关键点坐标。
  `keypoints.size()= N * J`
  - `N`:图片中的目标数量
  - `J`:num_joints（关键点数量）
- **scores**(list of float): 成员变量，表示识别到的目标行为的关键点坐标的置信度。
  `scores.size()= N * J`
  - `N`:图片中的目标数量
  - `J`:num_joints（一个目标的关键点数量）
- **num_joints**(int): 成员变量，一个目标的关键点数量