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#示例代码下载