导航
骨骼检测(SkeletonDetect)
最近更新时间：2025.03.14 10:08:09首次发布时间：2025.03.14 10:08:09
骨骼检测可实时识别全身18关键点，支持多人检测，支持半身、侧身、背身、部分遮挡等多种复杂场景。
骨骼检测关键点索引图:
详细接口说明查看头文件：SkeletonDetect.h
1.创建骨骼检测句柄
int HeidiSkeletonCreateHandle(HeidiHandle* handle);
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的手势检测句柄 |
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h
2.骨骼检测授权
int HeidiSkeletonCheckLicense(HeidiHandle handle, const char* licensePath);
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的骨骼检测句柄 |
| licensePath | const char * | 授权文件路径 |
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h
3.设置模型文件
int HeidiSkeletonInitModel(HeidiHandle handle, const char* modelPath);
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的手势检测句柄 |
| strModelPath | const char * | 模型文件路径 |
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h
4.设置检测算法的输入尺寸
int HeidiSkeletonSetParam(HeidiHandle handle, int netInputWidth, int netInputHeight);
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的骨骼检测句柄 |
| netInputWidth | int | 宽度 |
| netInputHeight | int | 高度 |
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h
5.设置最多可检测骨骼数
int HeidiSetTargetNum(HeidiHandle handle, const int targetNum);
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的骨骼检测句柄 |
| targetNum | int | 最大检测人体数 |
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h
6.检测骨骼
int HeidiSkeletonDo( HeidiHandle handle, const ImageParams* imageParams, int* skeletonNum, HeidiSkeletonInfo** skeleInfos );
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的骨骼检测句柄 |
| imageParams | const ImageParams* | 输入图像的数据,参见ImageParams |
| skeletonNum | int* | 检测结果数量 |
| skeleInfos | bef_skeleton_info ** | 检测结果，见备注 |
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h
7.销毁骨骼检测句柄
int HediSkeletonRelease(HeidiHandle handle);
参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| handle | HeidiHandle | 创建的骨骼检测句柄 |