画质超分

超分，目前超分指在原来基础上宽和高同时扩张两倍。

详解接口文档， bef_ai_image_quality_enhancement_video_sr.h

1.创建超分句柄

/**
 * @brief Create effect handle.
 * @param handle      handle that will be created.
 * @return            If succeed return BEF_EFFECT_RESULT_SUC, other value please see bef_effect_ai_public_define.h.
 */
BEF_SDK_API bef_effect_result_t 
bef_ai_image_quality_enhancement_video_sr_create(bef_image_quality_enhancement_handle* handle, const char* dir);

参数说明

​
返回值
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

2.设置输入的属性

/**
 *  set the input property 
 * @param handle
 * @param width Input width of the  buffer or texture
 * @param height Input height of the  buffer or texture
 * @return If succeed return BEF_EFFECT_RESULT_SUC, other value please see bef_effect_ai_public_define.h.
 */
BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_sr_set_width_and_height(bef_image_quality_enhancement_handle handle, int width , int height);

参数说明

3.检测画质超分授权

/**
 * @param handle Created effect detect handle
 *                   已创建的句柄
 * @param license_path licese path under the dircetory
 *                  license 在文件系统中的绝对路径
 * @param result If succeed return BEF_EFFECT_RESULT_SUC, other value please see bef_effect_ai_public_define.h.
 *
 */
BEF_SDK_API bef_effect_result_t 
bef_ai_image_quality_enhancement_video_sr_check_license(bef_image_quality_enhancement_handle handle, const char* license_path);

参数说明

返回值
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

4.检测画质超分授权

/**
 * process the input and get the resoult
 * @param handle
 * @param input input infomation of texture or pixelbuffer 
 *              Android的输入需要为oes 纹理， 需要传入纹理的宽高，纹理需要放在input->data.texture[0]
 *              ios 目前只支持yuv420p, 420f 的pixelbuffer输入，输出为对应格式pixelbuffer 无需手动释放, pixelbuffer 放在input->data.buffer 处
 * @param output output infomation of texture or pixelbuffer
 *              Android的输出为oes 纹理，返回纹理的宽和高，纹理结果放在output->data.texture[0]
 *              ios 的输出为pixelbuffer，  pixelbuffer 放在output->data.buffer 处
 * @return If succeed return BEF_EFFECT_RESULT_SUC, other value please see bef_effect_ai_public_define.h.
 */
BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_sr_process(bef_image_quality_enhancement_handle handle, const bef_ai_video_sr_input* input, bef_ai_video_sr_output *output);

参数说明

input input infomation of texture or pixelbuffer
Android的输入需要为oes 纹理， 需要传入纹理的宽高，纹理需要放在input->data.texture[0]
ios 目前只支持yuv420p, 420f 的pixelbuffer输入， pixelbuffer 放在input->data.buffer 处
output output infomation of texture or pixelbuffer
Android的输出为oes 纹理，返回纹理的宽和高，纹理结果放在output->data.texture[0]
ios 的输出为pixelbuffer， pixelbuffer 放在output->data.buffer 处,输出为对应格式pixelbuffer 无需手动释放,拿到buffer后需要先对buffer进行retain,防止内部的内存是对pixelbuffer 进行回收

返回值
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

5.画质超分句柄的释放

/**
 * @param handle    handle that will  destroy
 */
BEF_SDK_API bef_effect_result_t 
bef_ai_image_quality_enhancement_vidoe_sr_destory(bef_image_quality_enhancement_handle handle);

参数说明

1. 创建画质超分句柄

创建画质超分的句柄

public int init(String rwDir, String licensePath){
        int ret = nativeCreate(rwDir, licensePath);
        if (ret != BytedEffectConstants.BytedResultCode.BEF_RESULT_SUC){
            mInited = false;
            return ret;
        }
        mInited = true;
        return ret;
    }

参数说明

返回值

成功返回BEF_RESULT_SUC，否则返回对应的错误码

2. 创建进行超分处理

public BefVideoSRInfo process(int srcTextureId ,int width, int height){
        if (!mInited){
            return null;
        }

        BefVideoSRInfo srInfo  =  new BefVideoSRInfo();
        int ret = nativeProcess(srcTextureId, width, height, srInfo);
        if (ret != BytedEffectConstants.BytedResultCode.BEF_RESULT_SUC) {
            Log.e(BytedEffectConstants.TAG, "nativeVideoSrProcess " + ret);
            return null;
        }
        return srInfo;
    }

参数说明

返回值

成功返回超分的结果，否则返回空

3. 释放超分的资源

public void release() {
        if (mInited){
            nativeRelease();
        }
        mInited = false;
    }

FAQ

1.如果出现任何异常，请查看是否有以下类型日志

答：建议首先查看以下tag输出Error类型的日志：

bef_effect_ai 和SMASH_E_LOG 以及 EffectSDK

2. 如果没有结果，或者结果不正确

android 下面检测OpenGL环境是否正确，且输入纹理是否正确

ios，xcode查看pixelbuffer的返回结果是否正确