智能调色--智能美化特效-火山引擎

文档中心

导航

智能调色

最近更新时间：2025.03.17 14:06:13首次发布时间：2025.03.17 14:06:13

简介

智能调色是低门槛色彩调校能力，一键帮助用户解决暗光、画面灰等一系列色彩问题，轻松获得高质感画面效果。该算法为V4.5.2新增画质算法。

技术规格

支持平台	Android、iOS
支持输入格式	RGBA8888
内存占用	<20M （测试设备小米11）
处理速度	<5ms（测试设备小米11）

C接口说明

详细接口说明查看头文件：bef_ai_image_quality_enhancement_video_hdr.h

1. 创建智能调色算法句柄

BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_lite_hdr_create(bef_image_quality_enhancement_handle* handle, const bef_ai_hdr_init_config* config);

参数说明

参数名	参数类型	参数说明
handle	bef_image_quality_enhancement_handle*	创建的增强算法句柄
config	const bef_ai_hdr_init_config*	算法初始化配置信息

bef_ai_hdr_init_config结构体的相关定义参考bef_ai_image_quality_enhancement_public_define.h
返回值
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

2. 智能调色算法处理

BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_lite_hdr_process(bef_image_quality_enhancement_handle handle, const bef_ai_hdr_lite_param* input_para, const bef_ai_hdr_lite_input* input, bef_ai_hdr_lite_output* output);

参数说明

参数名	参数类型	参数说明
handle	bef_image_quality_enhancement_handle	已创建的增强算法句柄
input_para	const bef_ai_hdr_lite_param*	输入参数
input	const bef_ai_hdr_lite_input*	输入信息
output	bef_ai_hdr_lite_output*	输出信息

bef_ai_hdr_lite_param和bef_ai_hdr_lite_input结构体的相关定义参考bef_ai_image_quality_enhancement_public_define.h
返回值
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

3. 智能调色算法授权

BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_lite_hdr_check_license(bef_image_quality_enhancement_handle handle, const char* license_path);

BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_lite_hdr_check_online_license(bef_image_quality_enhancement_handle handle, const char* license_path);

参数说明

参数名	参数类型	参数说明
handle	bef_image_quality_enhancement_handle	已创建的增强算法句柄
license_path	const char*	授权文件路径

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

4. 销毁智能调色算法句柄

BEF_SDK_API bef_effect_result_t
bef_ai_image_quality_enhancement_video_lite_hdr_destory(bef_image_quality_enhancement_handle handle);

参数说明

参数名	参数类型	参数说明
handle	bef_image_quality_enhancement_handle	已创建的增强算法句柄

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

Java 接口说明

接口说明
详细接口说明查看文件：com.effectsar.labcv.effectsdk.VideoLiteHdr.java

1.初始化智能调色算法句柄

public int init(String licensePath, String rwDir, int maxHeight, int maxWidth,
                    EffectsSDKEffectConstants.ImageQulityPowerLevel level, String lutPath, boolean onlineLicense)

参数说明

参数名	参数类型	参数说明
licensePath	String	授权文件路径
rwDir	String	可读写目录路径
maxHeight	int	可支持最大输入帧的高
maxWidth	int	可支持最大输入帧的宽
level	EffectsSDKEffectConstants.ImageQulityPowerLevel	算法功耗等级
lutPath	String	lut映射表文件路径
onlineLicense	boolean	配置在线授权或离线授权

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

2.智能调色算法处理

public BefVideoSRInfo process(int srcTextureId, int width, int height, boolean isFirstFrame, float enhanceStrength)

参数说明

参数名	参数类型	参数说明
srcTextureId	int	输入纹理id
width	int	输入图像宽度
height	int	输入图像高度
isFirstFrame	boolean	是否为视频第一帧（设置为true表示重置，清除算法缓存）
enhanceStrength	float	智能算法调节强度

返回值
返回算法结果BefVideoSRInfo对象，关于BefVideoSRInfo可参考com.effectsar.labcv.effectsdk.BefVideoSRInfo.java。

3.智能调色算法释放

public void release()

FAQ

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

答：建议首先查看以下tag输出Error类型的日志：
bef_effect_ai 和SMASH_E_LOG 以及 EffectSDK

错误码

错误码请参考错误码表