text: // Copyright (c) OpenMMLab. All rights reserved.
  
  /**
   * @file pose_detector.h
   * @brief Interface to MMPose task
   */
  
  #ifndef MMDEPLOY_SRC_APIS_C_POSE_DETECTOR_H_
  #define MMDEPLOY_SRC_APIS_C_POSE_DETECTOR_H_
  
  #include "common.h"
  #include "executor.h"
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  typedef struct mm_pose_detect_t {
    mm_pointf_t* point;  ///< keypoint
    float* score;        ///< keypoint score
    int length;          ///< number of keypoint
  } mm_pose_detect_t;
  
  /**
   * @brief Create a pose detector instance
   * @param[in] model an instance of mmpose model created by
   * \ref mmdeploy_model_create_by_path or \ref mmdeploy_model_create in \ref model.h
   * @param[in] device_name name of device, such as "cpu", "cuda", etc.
   * @param[in] device_id id of device.
   * @param[out] handle handle of the created pose detector, which must be destroyed
   * by \ref mmdeploy_pose_detector_destroy
   * @return status code of the operation
   */
  MMDEPLOY_API int mmdeploy_pose_detector_create(mm_model_t model, const char* device_name,
                                                 int device_id, mm_handle_t* handle);
  
  /**
   * @brief Create a pose detector instance
   * @param[in] model_path path to pose detection model
   * @param[in] device_name name of device, such as "cpu", "cuda", etc.
   * @param[in] device_id id of device.
   * @param[out] handle handle of the created pose detector, which must be destroyed
   * by \ref mmdeploy_pose_detector_destroy
   * @return status code of the operation
   */
  MMDEPLOY_API int mmdeploy_pose_detector_create_by_path(const char* model_path,
                                                         const char* device_name, int device_id,
                                                         mm_handle_t* handle);
  
  /**
   * @brief Apply pose detector to a batch of images with full image roi
   * @param[in] handle pose detector's handle created by \ref
   * mmdeploy_pose_detector_create_by_path
   * @param[in] images a batch of images
   * @param[in] count number of images in the batch
   * @param[out] results a linear buffer contains the pose result, must be release
   * by \ref mmdeploy_pose_detector_release_result
   * @return status code of the operation
   */
  MMDEPLOY_API int mmdeploy_pose_detector_apply(mm_handle_t handle, const mm_mat_t* mats,
                                                int mat_count, mm_pose_detect_t** results);
  
  /**
   * @brief Apply pose detector to a batch of images supplied with bboxes(roi)
   * @param[in] handle pose detector's handle created by \ref
   * mmdeploy_pose_detector_create_by_path
   * @param[in] images a batch of images
   * @param[in] image_count number of images in the batch
   * @param[in] bboxes bounding boxes(roi) detected by mmdet
   * @param[in] bbox_count number of bboxes of each \p images, must be same length as \p images
   * @param[out] results a linear buffer contains the pose result, which has the same length as \p
   * bboxes, must be release by \ref mmdeploy_pose_detector_release_result
   * @return status code of the operation
   */
  MMDEPLOY_API int mmdeploy_pose_detector_apply_bbox(mm_handle_t handle, const mm_mat_t* mats,
                                                     int mat_count, const mm_rect_t* bboxes,
                                                     const int* bbox_count,
                                                     mm_pose_detect_t** results);
  
  /** @brief Release result buffer returned by \ref mmdeploy_pose_detector_apply or \ref
   * mmdeploy_pose_detector_apply_bbox
   * @param[in] results result buffer by pose detector
   * @param[in] count length of \p result
   */
  MMDEPLOY_API void mmdeploy_pose_detector_release_result(mm_pose_detect_t* results, int count);
  
  /**
   * @brief destroy pose_detector
   * @param[in] handle handle of pose_detector created by \ref
   * mmdeploy_pose_detector_create_by_path or \ref mmdeploy_pose_detector_create
   */
  MMDEPLOY_API void mmdeploy_pose_detector_destroy(mm_handle_t handle);
  
  MMDEPLOY_API int mmdeploy_pose_detector_create_v2(mm_model_t model, const char* device_name,
                                                    int device_id, mmdeploy_exec_info_t exec_info,
                                                    mm_handle_t* handle);
  
  MMDEPLOY_API int mmdeploy_pose_detector_create_input(const mm_mat_t* mats, int mat_count,
                                                       const mm_rect_t* bboxes, const int* bbox_count,
                                                       mmdeploy_value_t* value);
  
  MMDEPLOY_API int mmdeploy_pose_detector_apply_v2(mm_handle_t handle, mmdeploy_value_t input,
                                                   mmdeploy_value_t* output);
  
  MMDEPLOY_API int mmdeploy_pose_detector_apply_async(mm_handle_t handle, mmdeploy_sender_t input,
                                                      mmdeploy_sender_t* output);
  
  MMDEPLOY_API int mmdeploy_pose_detector_get_result(mmdeploy_value_t output,
                                                     mm_pose_detect_t** results);
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif  // MMDEPLOY_SRC_APIS_C_POSE_DETECTOR_H_
  