|
NERTC VirtualBackground Windows&macOS SDK
|
宏定义 | |
| #define | MATTING_SERVICE_API |
枚举 | |
| enum | MattingColorFormat { MATTING_BGR , MATTING_RGB , MATTING_I420 , MATTING_NV12 , MATTING_NV21 } |
| 背景图片格式 更多... | |
函数 | |
| MATTING_SERVICE_API void | MattingInit (const char *model_path) |
| SDK 初始化。 更多... | |
| MATTING_SERVICE_API void | MattingPredict (unsigned char *img_ptr, unsigned char *mask_ptr, int height, int width, MattingColorFormat format, int degree, bool flip_x) |
| 开始 AI 背景替换或背景虚化,并返回人像预测结果。 更多... | |
| MATTING_SERVICE_API void | MattingSetBackground (unsigned char *bg_ptr, int height, int width, MattingColorFormat format, int degree, bool flip_x) |
| 设置自定义背景。 更多... | |
| MATTING_SERVICE_API void | MattingActivateBlurMode (int alpha) |
| 激活背景虚化模式。 更多... | |
| MATTING_SERVICE_API void | MattingReset () |
| AI 虚拟背景功能状态重置。 更多... | |
| #define MATTING_SERVICE_API |
| enum MattingColorFormat |
| MATTING_SERVICE_API void MattingActivateBlurMode | ( | int | alpha | ) |
激活背景虚化模式。
| alpha | 背景虚化程度,取值范围为 [0, 100]。 建议将 alpha 设为 7,以实现一般场景下的虚化效果,您也可以根据需求动态调整。 |
| MATTING_SERVICE_API void MattingInit | ( | const char * | model_path | ) |
SDK 初始化。
该接口用于加载模型。
| model_path | 模型文件路径。对于 ncnn/mnn 模型,model_path 可设置为 nullptr。 |
| MATTING_SERVICE_API void MattingPredict | ( | unsigned char * | img_ptr, |
| unsigned char * | mask_ptr, | ||
| int | height, | ||
| int | width, | ||
| MattingColorFormat | format, | ||
| int | degree, | ||
| bool | flip_x | ||
| ) |
开始 AI 背景替换或背景虚化,并返回人像预测结果。
| img_ptr | 原始图像指针数据,背景替换结果会原地写回该指针,不改变原始图像朝向、尺寸、格式。 |
| mask_ptr | 人像预测结果,可用于后续自定义处理,例如人像替换等。
|
| height | 背景图片高度,单位为像素(px)。 |
| width | 背景图片宽度,单位为像素(px)。 |
| format | img_ptr 对应的数据格式。支持 BGR、RGB、I420、NV12、NV21 格式。 |
| degree | 屏幕旋转角度。 |
| flip_x | 是否水平翻转图像。 |
| MATTING_SERVICE_API void MattingReset | ( | ) |
AI 虚拟背景功能状态重置。
| MATTING_SERVICE_API void MattingSetBackground | ( | unsigned char * | bg_ptr, |
| int | height, | ||
| int | width, | ||
| MattingColorFormat | format, | ||
| int | degree, | ||
| bool | flip_x | ||
| ) |
设置自定义背景。
| bg_ptr | 本地背景图片路径。 |
| height | 背景图片高度,单位为像素(px)。 |
| width | 背景图片宽度,单位为像素(px)。 |
| format | 背景图片格式。支持 BGR、RGB、I420、NV12、NV21 格式。 |
| degree | 屏幕旋转角度。 |
| flip_x | 是否水平翻转图像。 |