Bonus-Yolo-SDK/Readme.md

# 博诺思 YOLO SDK v2.0.0

## 简介

本SDK提供了一个使用ONNX Runtime和OpenCV进行YOLO实时目标检测的C++动态链接库。

v2.0.0版本引入了有状态的API，通过创建持久化的 `detector` 句柄，极大提升了批量处理性能并解决了线程安全问题。

## API 接口 (v2.0 - 高性能API - 推荐)

推荐用于批量处理、多线程和Web服务。模型只在创建时加载一次。

```cpp
/**
    @brief 用来接受检测后结果的结构体
*/
struct Detection { 
    int class_id;
    float score;
    int x;
    int y;
    int width;
    int height;  
};

/**
    * @brief [v2.0 新增] 创建一个检测器实例 (有状态)
    * @details 此函数加载ONNX模型并初始化Session，返回一个句柄。
    * @param model_path ONNX模型的绝对路径
    * @param input_width 模型输入宽度 (例如 640)
    * @param input_height 模型输入高度 (例如 640)
    * @return void* 指向检测器实例的句柄。如果失败则返回 nullptr。
*/
void* create_detector(
    const wchar_t* model_path,
    int input_width,
    int input_height
);

/**
    * @brief [v2.0 新增] 释放由 create_detector 创建的检测器实例
    * @param detector_handle 要释放的句柄
*/
void free_detector(void* detector_handle);

/**
    * @brief [v2.0 新增] 使用已加载的检测器执行检测 (线程安全)
    * @details 
    * @param detector_handle 由 create_detector 返回的句柄
    * @param image_bytes 指向图像数据(BGR格式)的指针
    * @param image_width 图像宽度
    * @param image_height 图像高度
    * @param out_detections [输出] Detection结构体数组指针，函数会为其分配内存
    * @param out_detections_count [输出] 检测到的物体数量
    * @param conf_threshold 置信度阈值
    * @param iou_threshold NMS的IOU阈值
    * @return int 0表示成功
*/
int perform_detection_on_session(
    void* detector_handle,
    unsigned char* image_bytes,
    int image_width,
    int image_height,
    Detection** out_detections,
    int* out_detections_count,
    float conf_threshold,
    float iou_threshold
);