对图像或视频进行卡通风格转换处理
API的输入、输出对象可参考VNN 数据结构
API的执行情况（是否成功、错误原因等）可参考 VNN_Result 对应的状态码表
| 指标 | 参数 |
|---|---|
| 支持图片格式 | BGRA、RGBA、RGB、NV12、NV21、YUV420 |
| 支持架构 | armeabi-v7、arm64-v8a |
| Android系统版本 | 5.0+ |
| iOS系统版本 | 9.0+ |
| 指标 | 参数 |
|---|---|
| 支持图片格式 | BGRA、RGBA、RGB、YUV420F |
| 支持架构 | x86(Win Only)、x86_64、arm64(MacOS Only) |
| Windows系统版本 | Win 7+ |
| MacOS系统版本 | 10.10+ |
vnn_general.h
vnn_kit.h
vnn_define.h
卡通风格化
stylize_cartoon[1.0.0].vnnmodel
stylize_cartoon[1.0.0]_proceess_config.json
Android/Linux
libvnn_core.so
libvnn_kit.so
libvnn_general.so
iOS
Accelerate.framework
CoreVideo.framework
Foundation.framework
vnn_core_ios.framework
vnn_kit_ios.framework
vnn_general_ios.framework
MacOS
Accelerate.framework
CoreVideo.framework
Cocoa.framework
vnn_core_osx.framework
vnn_kit_osx.framework
vnn_general_osx.framework
Windows
vnn_core.dll
vnn_kit.dll
vnn_genral.dll
Android: 链接
iOS: 链接
Windows: 链接
MaoOS: 链接
Linux: 链接
说明: 输入模型路径，完成SDK的初始化，获得用于调用后续功能的Handle
VNN_Result VNN_Create_General( VNNHandle * handle, const int argc, const void * argv[] )| 参数 | 含义 |
|---|---|
| handle | 函数调用成功后记录合法的索引，用于调用后续功能，类型为VNN_Handle*，调用成功后handle数值大于0，输出 |
| argc | 输入模型文件数，类型为const int，输入 |
| argv | 每个模型文件的具体路径，类型为const char*[ ]，输入 |
返回值: VNN_Result，具体值参见 状态码表
调用示例:
VNN_Handle _handle;
std::string model = _modelpath + "/stylize_cartoon[1.0.0].vnnmodel";
std::string cfg = _modelpath + "/stylize_cartoon[1.0.0]_proceess_config.json";
const char* argv[] = {
model.c_str(),
cfg.c_str()
};
const int argc = sizeof(argv)/sizeof(argv[0]);
VNN_Result ret = VNN_Create_General(&_handle, argc, argv);说明: 输入需要风格转换的图像，输出风格转换后的图像
VNN_Result VNN_Apply_General_CPU(VNNHandle handle, const void* in_image, const void* face_data, void* output)| 参数 | 含义 |
|---|---|
| handle | SDK实例索引，类型为VNN_Handle，输入 |
| in_image | 输入图像，类型为 VNN_Image*，输入 |
| face_data | 对于卡通图像风格化，该参数固定为NULL |
| output | 检测结果，类型为 VNN_ImageArr*，输出 |
返回值: VNN_Result，具体值参见 状态码表
调用示例:
// input：完整的图像或视频帧，类型VNN_IMAGE
// 卡通风格化的输出图像参数
#define IMG_CHANNEL (3)
#define IMG_HEIGHT (512)
#define IMG_WIDTH (512)
// 申请Buffer
if (!_imgBuffer) {
_imgBuffer = (unsigned char *) malloc(IMG_CHANNEL * IMG_HEIGHT * IMG_WIDTH);
}
// 设置用于接收输出结果的对象
VNN_ImageArr output;
output.imgsNum = 1;
output.imgsArr[0].width = IMG_WIDTH; // 输出图像的宽
output.imgsArr[0].height = IMG_HEIGHT; // 输出图像的高
output.imgsArr[0].channels = IMG_CHANNEL; // 输出图像的通道
output.imgsArr[0].pix_fmt = VNN_PIX_FMT_RGB888; // 输出图像格式为RGB,CHW
output.imgsArr[0].data = _imgBuffer;
// 对于卡通图像风格化，接口第三个参数固定为NULL
VNN_Apply_General_CPU(_handle, input, NULL, output);说明: 不再使用SDK，释放内存等资源
VNN_Result VNN_Destroy_General(VNNHandle* handle)| 参数 | 含义 |
|---|---|
| handle | SDK实例索引，成功释放资源后将被修改为0（无效值），类型为VNN_Handle*，输入&输出 |
返回值: VNN_Result，具体值参见 状态码表
调用示例:
VNN_Result ret = VNN_Destroy_General(&_handle);说明: 设定SDK实例的运行参数
VNN_Result VNN_Set_General_Attr( VNNHandle handle, const char * name, const void * value )| 参数 | 含义 |
|---|---|
| handle | SDK实例索引，类型为VNN_Handle，输入 |
| name | 属性名，类型const char*，输入 |
| value | 属性值，类型参见下表，输入 |
合法属性名和属性值
| 属性名 | 属性含义 | 属性值 | 属性值类型 |
|---|---|---|---|
| 暂时为空 |
返回值: VNN_Result，具体值参见 状态码表
调用示例:
// 暂时为空说明: 获取SDK实例的运行参数
VNN_Result VNN_Get_General_Attr( VNNHandle handle, const char * name, const void * value )| 参数 | 含义 |
|---|---|
| handle | SDK实例索引，类型为VNN_Handle，输入 |
| name | 属性名，类型const char*，输入 |
| value | 属性值，类型参见下表，输出 |
合法属性名和属性值
| 属性名 | 属性含义 | 属性值 | 属性值类型 |
|---|---|---|---|
| 暂时为空 |
返回值: 类型为VNN_Result，具体值参见 状态码表
调用示例:
// 暂时为空如果需要卡通风格转换的图像包含人脸，建议按下述步骤优化图像质量：
(1) 将 stylize_cartoon[1.0.0]_proceess_config.json复制一份并命名为stylize_cartoon[1.0.0]_face_proceess_config.json
(2) 打开stylize_cartoon[1.0.0]_face_proceess_config.json ，将其中的 netW字段和netH字段修改为256
(3) 用新的json文件初始化VNN_Create_General， 得到一个新的handle(vnnmodel文件不变)。
(4) 调用人脸关键点得到人脸框,对人脸框放大约1.3倍, 然后将人脸剪切出来。
(5) 剪切出来的图走VNN_Apply_General_CPU得到人脸部分的卡通图像效果，注意输出大小为256*256。
(6) 将原图得到的卡通图像和人脸部分的卡通图像进行融合。(注意，直接resize人脸部分图像，覆盖掉原图对应的卡通风格，会有色差，在边界处进行过度，会得到比较自然的图像)
人脸区域图像质量优化后的效果，可参考上文的例图
| 版本 | 日期 | 更新说明 |
|---|---|---|
| v1.0.0 | 2021.12.31 | 初次发布 |