wx_human_seg 3.0.0
人像抠图及证件照SDK3.0使用说明

1)SDK说明

本SDK,可以进行人像抠图,证件照制作,证件照环境检测,证件照成品检测等功能, 同时提供C++接口,标准C接口,java接口等API。 其他语言对接,可以基于C或者C++接口进行二次开发。

版本说明

SDK一共分为四个版本:
证件照桌面版,证件照服务器版,人像抠图付费版,人像抠图免费版

每个版本的功能和限制

功能和限制 证件照桌面 证件照服务端 人像抠图 人像抠图免费
抠图输出alpha 支持 支持 支持 不支持
抠图返回透明背景 支持 支持 支持 不支持
换背景 支持 支持 支持 支持
证件照制作 支持 支持 不支持 不支持
证件照环境检测 不支持 支持 不支持 不支持
证件照成品检测 不支持 支持 不支持 不支持
是否支持GPU 不支持 支持 不支持 不支持
输出图像尺寸限制 无限制 无限制 无限制 最大输出48万像素

每个版本的系统支持

系统 证件照桌面 证件照服务端 人像抠图 人像抠图免费
Windows桌面 支持 支持 支持 不支持
Windows服务器 不支持 支持 支持 不支持
ubuntu 不支持 支持 不支持 不支持
MacOS 支持 支持 支持 不支持
Android 支持 不支持 支持 支持
iOS 支持 不支持 支持 支持

2) C++ API Reference

点击查看C++ API Reference

3) C API Reference

点击查看C API Reference

4) JAVA API Reference

点击查看JAVA API Reference

5) 其他资料下载

Android对接手册下载
授权工具使用说明文档下载

6) 调用示例

以下示例代码,均为简单演示目的,不保证复制后直接编译通过,请修改后再使用。 函数使用方法,请参考文档,和SDK包中的examples代码

* 人像抠图C++示例

// 使用license初始化SDK
wonxai::WXSDKInitWithLicense("你的appKey", "你的license文件");
// 创建抠图操作对象,指定使用cpu引擎进行抠图
auto matting = std::make_shared<wonxai::WXHumanMatting>(kDeviceCPU);
// 读取待抠图图片和新的背景图片
auto inImg = wonxai::WXImage::fromFile("待处理图片.jpg");
auto bkImg = wonxai::WXImage::fromFile("背景图片.jpg");
// 抠图,并返回抠图后的结果图片
auto resImg = matting->removeBackground(inImg, bkImg);
// 将结果图片保存到文件
resImg->toFile("./res_bg.png");

* 证件照制作和环境检测C++示例

// 使用license初始化SDK
wonxai::WXSDKInitWithLicense("你的appKey", "你的license文件");
// 创建证件照操作对象,指定使用cpu引擎
auto idphoto = std::make_shared<wonxai::WXIDPhoto>(kDeviceCPU);
// 读取待处理图片
auto inImg = wonxai::WXImage::fromFile("待处理图片.jpg");
// 对图片进行环境检测
auto preDetectRes = idphoto->preDetect(inImg);
// 判断环境检测结果指标
if (preDetectRes->faceCount() != 1) {
}
// 其他指标请看文档,这里不再列出
// ...
// 设置证件照制作参数
// 将制作480x640像素的证件照
wonxai::WXIDPhotoConfig config(480, 640);
config.dpi = 350; // 分辨率为350
config.bgImage = wonxai::WXImage::fromColor(480, 640, 255, 255, 255); // 设置证件照背景为白色
// 制作证件照,并返回制作好的证件照结果图
auto resImg = idphoto->makeIDPhoto(inImg, config, preDetectRes);
// 将结果图片保存到文件
resImg->toFile("./res_idphoto.jpg");

* 证件照成品检测C++示例

// 使用license初始化SDK
wonxai::WXSDKInitWithLicense("你的appKey", "你的license文件");
// 创建证件照操作对象,指定使用gpu引擎
auto detector = std::make_shared<wonxai::WXIDPhotoDetector>(kDeviceGPU);
// 读取待处理图片
auto inImg = wonxai::WXImage::fromFile("待处理图片.jpg");
// 进行图片检测,并返回结果
auto result = detector->detect(inImg);
int faceCount = result->getInt("face_count"); // 获取人脸个数指标
int eyesClose = result->getInt("eyes_close"); // 获取闭眼指标分值
// 其他指标请看文档,这里不再列出
// ...

* C#调用示例代码

C#语言是通过SDK的C接口来调用的,下面给出了一段C#调用SDK的代码示例
C#示例代码下载