1. SDK 概述 Arcsoft Photo Styling SDK 可以将输入图像转化为具有指定风格的图像图像风格主要是指色调笔触线条等图像的特异性表现形式存储某一艺术图像风格模板的文件将按需要发布给 SDK 使用者借助 SDK 和风格模板文件, 用户可以开发图像风格化等图像美化类应用

Size: px

Start display at page:

Download "1. SDK 概述 Arcsoft Photo Styling SDK 可以将输入图像转化为具有指定风格的图像图像风格主要是指色调笔触线条等图像的特异性表现形式存储某一艺术图像风格模板的文件将按需要发布给 SDK 使用者借助 SDK 和风格模板文件, 用户可以开发图像风格化等图像美化类应用"

署藻郜
6 years ago
Views:

1 Arcsoft Photo Styling SDK 开发文档目录 Arcsoft Photo Styling SDK 开发文档 SDK 概述 SDK 运行环境及相关指标运行环境运行指标 API 说明函数... 3 APS_FSDK_Get_Version... 3 APS_FSDK_InitEngine... 3 APS_FSDK_StyleTransfer... 4 APS_FSDK_UninitEngine 类型定义... 4 APS_FSDK_DEVICE_ID... 4 APS_FSDK_ENGINE_HANDLE... 5 APS_FSDK_Version 返回码定义示例代码

1. SDK 概述 Arcsoft Photo Styling SDK 可以将输入图像转化为具有指定风格的图像图像风格主要是指色调笔触线条等图像的特异性表现形式存储某一艺术图像风格模板的文件将按需要发布给 SDK 使用者借助 SDK 和风格模板文件, 用户可以开发图像风格化等图像美化类应用 SDK 工作示意图如图 1

2 1. SDK 概述 Arcsoft Photo Styling SDK 可以将输入图像转化为具有指定风格的图像图像风格主要是指色调笔触线条等图像的特异性表现形式存储某一艺术图像风格模板的文件将按需要发布给 SDK 使用者借助 SDK 和风格模板文件, 用户可以开发图像风格化等图像美化类应用 SDK 工作示意图如图 1 所示一种艺术风格对应于一个风格模板文件, 当开发者用户需要新的风格模板时, 由 SDK 发行者提供新的风格模板文件供开发者用户使用图 1 2. SDK 运行环境及相关指标 2.1 运行环境操作系统 : Linux-x64 CPU: Intel-Haswell 以上架构 ( 要求支持 AVX2 指令集 ) RAM: 1GB 2

3 2.2 运行指标项目指标输入图像限制支持最大像素数支持最高 1440x1440(1:1),1600x1200(4:3),1920x1080(16:9) 宽高必须为 4 的整数倍输入图像格式 BGR24 RGB24 平均耗时 2s/ 百万像素 ( 随实际机器性能可能改变 ) 单个风格模型文件 ROM 占用 2.1MB ( 随模型文件更新可能改变 ) 3. API 说明 3.1 函数 APS_FSDK_Get_Version 函数声明 const APS_FSDK_Version* APS_FSDK_Get_Version(APS_FSDK_ENGINE_HANDLE hapsengine) 功能描述获取 SDK 版本信息参数 hapsengine [ 输入 ] 引擎句柄 APS_FSDK_InitEngine 函数声明 MRESULT APS_FSDK_InitEngine ( ); const char * const char * MHandle hmemmgr, AppId, SDKKey, APS_FSDK_DEVICE_ID APSDeviceID, APS_FSDK_ENGINE_HANDLE *phapsengine 功能描述初始化引擎参数 AppId [ 输入 ] 用户申请 SDK 时获取的 app id 3

4 SDKKey [ 输入 ] 用户申请 SDK 时获取的 key hmemmgr [ 输入 ] 内存管理器句柄 APSDeviceID [ 输入 ] 程序运行设备,-1 代表 CPU,0,1,2, 代表指定序号的 GPU phapsengine [ 输出 ] 指向引擎句柄的指针 APS_FSDK_StyleTransfer 函数声明 MRESULT APS_FSDK_StyleTransfer ( APS_FSDK_ENGINE_HANDLE MByte* MLong LPASVLOFFSCREEN LPASVLOFFSCREEN pbmodel, hapsengine, lmodelsize, lpimgin, lpimgout ); 功能描述根据指定风格模型进行图片风格艺术化, 保存转换输入图像风格后的输出图像数据参数 hapsengine [ 输入 ] 引擎句柄 pbmodel [ 输入 ] 风格模型数据指针 lmodelsize [ 输入 ] 风格模型数据大小 lpimgin [ 输入 ] 待进行风格学习图像 lpimgout [ 输出 ] 风格学习结果图像 APS_FSDK_UninitEngine 函数声明 MVoid APS_FSDK_UninitEngine ( APS_FSDK_ENGINE_HANDLE ); 功能描述销毁引擎参数 hapsengine [ 输入 ] 引擎句柄 hapsengine 3.2 类型定义 APS_FSDK_DEVICE_ID 描述 4

5 程序运行设备,-1 代表 CPU,0,1,2, 等代表指定序号的 GPU 当前仅支持 -1 (CPU 设备 ) 定义 typedef MInt32 APS_FSDK_DEVICE_ID; APS_FSDK_ENGINE_HANDLE 描述风格学习引擎句柄定义 typedef MHandle APS_FSDK_ENGINE_HANDLE; APS_FSDK_Version 描述 SDK 版本信息定义 typedef struct { MLong lcodebase; MLong lmajor; MLong lminor MLong lbuild; MTChar* Version; MTChar* BuildDate; MTChar* CopyRight; APS_FSDK_Version; 成员变量 lcodebase 代码库版本号 lmajor lminor lbuild Version BuildDate CopyRight 主版本号次版本号编译版本号, 递增字符串形式的版本号编译日期 3.3 返回码定义 Copyright 信息定义值说明 MOK 0x00000 成功 MERR_UNKNOWN 0x00001 其他内部错误 MERR_NO_MEMORY 0x00004 内存不足 MERR_FSDK_INVALID_APP_ID 0x07001 非法的 APPID 5

6 MERR_FSDK_INVALID_SDK_ID 0x07002 非法的 SDKKEY MERR_FSDK_INVALID_ID_PAIR 0x07003 SDKKEY 不是于当前 APPID 名下的 MERR_FSDK_MISMATCH_ID_AND_SDK 0x07004 SDKKEY 不是当前 SDK 所支持的 MERR_FSDK_LICENCE_EXPIRED 0x07006 SDK 过期 MERR_FSDK_APS_ENGINE_HANDLE 0x11001 引擎句柄非法 MERR_FSDK_APS_MEMMGR_HANDLE 0x11002 内存管理器句柄非法 MERR_FSDK_APS_DEVICEID_INVALID 0x11003 DEVICEID 非法 MERR_FSDK_APS_DEVICEID_UNSUPPORTED 0x11004 DEVICEID 不支持 MERR_FSDK_APS_MODEL_HANDLE 0x11005 模板数据指针非法 MERR_FSDK_APS_MODEL_SIZE 0x11006 模板长度非法 MERR_FSDK_APS_IMAGE_HANDLE 0x11007 图像结构体指针非法 MERR_FSDK_APS_IMAGE_FORMAT_UNSUPPORTED 0x11008 图像格式不支持 MERR_FSDK_APS_IMAGE_PARAM 0x11009 图像 Width,Height,Pitch 错误 MERR_FSDK_APS_IMAGE_SIZE 0x1100A 图像尺寸大小超出支持范围 4. 示例代码!!!! 注意, 使用时请替换申请的 APPID SDKKEY, 并设置好文件路径!!!! #include <stdlib.h> #include <stdio.h> #include <string.h> #include <errno.h> #include <assert.h> #include <chrono> #include "arcsoft_fsdk_photo_styling.h" //#define APPID //#define SDKKEY "your appid" "your sdkkey" #define STYLE_MODEL_PATH "CHINESEART-001.tmpl" #define INPUT_IMAGE_PATH "your_input_image.bmp" #define OUTPUT_IMAGE_PATH "your_output_image.bmp" #define IMAGE_WIDTH (1920) #define IMAGE_HEIGHT (1080) #define WORKBUF_SIZE (256 * 1024 * 1024) #pragma pack(push,1) typedef struct tag_bmp46_header { 6

7 uint16_t bftype; int32_t bfsize; uint16_t bfreserved1; uint16_t bfreserved2; int32_t bfoffbits; int32_t bisize; int32_t biwidth; int32_t biheight; int16_t biplanes; int16_t bibitcount; int32_t bicompression; int32_t bisizeimage; int32_t bixpelspermeter; int32_t biypelspermeter; int32_t biclrused; int32_t biclrimportant; BMP46_Header; #pragma pack(pop) int fu_readbmpfile(const char* path, uint8_t **raw_data, size_t* psize) { assert(sizeof(bmp46_header) == 54); int res = 0; FILE *fp = 0; uint8_t *data_file = 0; size_t size = 0; fp = fopen(path, "rb"); if (fp == nullptr) { res = -1; fseek(fp, 0, SEEK_END); size = ftell(fp); fseek(fp, sizeof(bmp46_header), SEEK_SET); data_file = (uint8_t *)malloc(size - sizeof(bmp46_header)); if (data_file == nullptr) { res = -2; if ((size - sizeof(bmp46_header))!= fread(data_file, sizeof(uint8_t), size - sizeof(bmp46_header), fp)) { res = -3; 7

8 *raw_data = data_file; data_file = nullptr; exit: if (fp!= nullptr) { fclose(fp); if (data_file!= nullptr) { free(data_file); if (nullptr!= psize) { *psize = size - sizeof(bmp46_header); return res; int fu_savebmpfile(const char *path, uint8_t *raw_data, int width, int height) { FILE* fp = fopen(path, "wb+"); if (fp!= nullptr) { BMP46_Header header = { 0 ; header.bftype = 'MB'; header.bfsize = width*height * 3 + sizeof(bmp46_header); header.bfoffbits = sizeof(bmp46_header); header.bisize = 40; header.biwidth = width; header.biheight = height; header.biplanes = 1; header.bibitcount = 24; header.bisizeimage = width*height * 3; header.bixpelspermeter = 0xEC4; header.biypelspermeter = 0xEC4; fwrite(&header, sizeof(bmp46_header), 1, fp); fwrite(raw_data, width*height * 3, 1, fp); fclose(fp); return 0; return -1; 8

9 int fu_readfile(const char* path, uint8_t **raw_data, size_t* psize) { int res = 0; FILE *fp = 0; uint8_t *data_file = 0; size_t size = 0; fp = fopen(path, "rb"); if (fp == nullptr) { res = -1; fseek(fp, 0, SEEK_END); size = ftell(fp); fseek(fp, 0, SEEK_SET); data_file = (uint8_t *)malloc(sizeof(uint8_t)* size); if (data_file == nullptr) { res = -2; if (size!= fread(data_file, sizeof(uint8_t), size, fp)) { res = -3; *raw_data = data_file; data_file = nullptr; exit: if (fp!= nullptr) { fclose(fp); if (data_file!= nullptr) { free(data_file); if (nullptr!= psize) { *psize = size; return res; 9

10 int main(int argc, char* argv[]) { void *pworkmem = malloc(workbuf_size); void *hmgr = MMemMgrCreate(pWorkMem, WORKBUF_SIZE); uint8_t *prawmodel = nullptr; size_t modelength; fu_readfile(style_model_path, (uint8_t**)&prawmodel, &modelength); if (!prawmodel) { fprintf(stderr, "fail to fu_readfile(%s): %s\r\n", STYLE_MODEL_PATH, strerror(errno)); free(pworkmem); exit(0); auto ts_start = std::chrono::high_resolution_clock::now(); void *hengine = nullptr; int32_t device = -1; int ret = APS_FSDK_InitEngine(APPID, SDKKEY, hmgr, device, &hengine); if (ret!= 0) { fprintf(stderr, "fail to call FreeSDK_APS_InitEngine(): 0x%x\r\n", ret); free(prawmodel); free(pworkmem); exit(0); const APS_FSDK_Version*pVersionInfo = APS_FSDK_Get_Version(hEngine); printf("%ld %ld %ld %ld\r\n", pversioninfo->lcodebase, pversioninfo->lmajor, pversioninfo->lminor, pversioninfo->lbuild); printf("%s\r\n", pversioninfo->version); printf("%s\r\n", pversioninfo->builddate); printf("%s\r\n", pversioninfo->copyright); ASVLOFFSCREEN inputimg = { 0 ; inputimg.u32pixelarrayformat = ASVL_PAF_RGB24_B8G8R8; inputimg.i32width = IMAGE_WIDTH; inputimg.i32height = IMAGE_HEIGHT; inputimg.pi32pitch[0] = inputimg.i32width * 3; inputimg.ppu8plane[0] = nullptr; fu_readbmpfile(input_image_path, (uint8_t**)&inputimg.ppu8plane[0], nullptr); if (!inputimg.ppu8plane[0]) { fprintf(stderr, "fail to fu_readfile(%s): %s\r\n", INPUT_IMAGE_PATH, strerror(errno)); 10

11 APS_FSDK_UninitEngine(hEngine); free(prawmodel); free(pworkmem); exit(0); ASVLOFFSCREEN outputimg = { 0 ; outputimg.u32pixelarrayformat = ASVL_PAF_RGB24_B8G8R8; outputimg.i32width = IMAGE_WIDTH; outputimg.i32height = IMAGE_HEIGHT; outputimg.pi32pitch[0] = outputimg.i32width * 3; outputimg.ppu8plane[0] = (uint8_t*)malloc(outputimg.pi32pitch[0] * outputimg.i32height); ret = APS_FSDK_StyleTransfer(hEngine, prawmodel, modelength, &inputimg, &outputimg); if (ret!= 0) { fprintf(stderr, "fail to call FreeSDK_APS_StyleTransfer(): 0x%x\r\n", ret); APS_FSDK_UninitEngine(hEngine); free(inputimg.ppu8plane[0]); free(outputimg.ppu8plane[0]); free(prawmodel); free(pworkmem); exit(0); APS_FSDK_UninitEngine(hEngine); auto ts_end = std::chrono::high_resolution_clock::now(); printf("cost %ld ms\r\n", std::chrono::duration_cast<std::chrono::milliseconds>(ts_end - ts_start).count()); fu_savebmpfile(output_image_path, (uint8_t*)outputimg.ppu8plane[0], outputimg.i32width, outputimg.i32height); free(inputimg.ppu8plane[0]); free(outputimg.ppu8plane[0]); free(prawmodel); free(pworkmem); return 0; 11

新・明解Ｃ言語入門編『索引』

新・明解Ｃ言語入門編『索引』 !... 75!=... 48 "... 234 " "... 9, 84, 240 #define... 118, 213 #include... 148 %... 23 %... 23, 24 %%... 23 %d... 4 %f... 29 %ld... 177 %lf... 31 %lu... 177 %o... 196 %p... 262 %s... 242, 244 %u... 177