鸿蒙5.0&next开发【使用ImageEffect编辑图片】图片处置惩罚服务 ...

打印 上一主题 下一主题

主题 959|帖子 959|积分 2877

使用ImageEffect编辑图片

场景介绍

ImageEffect提供了一系列接口用于图像的编辑。开发者可以通过ImageEffect接口处置惩罚不同图像输入类型Pixelmap、NativeWindow、NativeBuffer或Uri,得到滤镜处置惩罚结果。 针对ImageEffect,常见的开发场景如下:


  • 通过ImageEffect提供的Native API接口添加滤镜或滤镜链,设置输入图像,最终生效滤镜结果。
  • 通过注册自定义滤镜,实现开发者的定制化滤镜结果。
  • 通过EffectFilter提供的Native API接口快速实现单个滤镜的处置惩罚结果。
接口阐明

开发步调

添加动态链接库
CMakeLists.txt中添加以下lib。
  1. target_link_libraries(entry PUBLIC
  2.     libace_ndk.z.so
  3.     libimage_effect.so
  4.     libpixelmap.so
  5.     libnative_window.so
  6.     libnative_buffer.so
  7. )
  8. txt
复制代码
根据处置惩罚的图像类型添加对应动态链接库:Pixelmap(libpixelmap.so)、NativeWindow(libnative_window.so)、NativeBuffer(libnative_buffer.so)
添加头文件
  1. #include <multimedia/image_effect/image_effect.h>
  2. #include <multimedia/image_effect/image_effect_filter.h>
  3. #include <multimedia/image_effect/image_effect_errors.h>
  4. c++
复制代码
通过ImageEffect提供的接口生效图像结果


  • 创建ImageEffect实例。
    1. // 创建imageEffect实例,“ImageEdit”是imageEffect实例别名。
    2. OH_ImageEffect *imageEffect = OH_ImageEffect_Create("ImageEdit");
    3. c++
    复制代码
  • 添加EffectFilter滤镜。
    1. // 添加滤镜,获取 OH_EffectFilter 实例。多次调用该接口可以添加多个滤镜,组成滤镜链。
    2. OH_EffectFilter *filter = OH_ImageEffect_AddFilter(imageEffect, OH_EFFECT_BRIGHTNESS_FILTER);
    3. CHECK_AND_RETURN_LOG(filter != nullptr, "OH_ImageEffect_AddFilter fail!");
    4. // 设置滤镜参数, 例如:滤镜强度设置为50。
    5. ImageEffect_Any value = { .dataType = ImageEffect_DataType::EFFECT_DATA_TYPE_FLOAT, .dataValue.floatValue = 50.f };
    6. ImageEffect_ErrorCode errorCode = OH_EffectFilter_SetValue(filter, OH_EFFECT_FILTER_INTENSITY_KEY, &value);
    7. c++
    复制代码
  • 设置处置惩罚数据。
    场景一:设置 OH_PixelmapNative 输入类型。
    1. // 设置输入的Pixelmap。
    2. errorCode = OH_ImageEffect_SetInputPixelmap(imageEffect, inputPixelmap);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetInputPixelmap fail!");
    4. // 设置输出的Pixelmap(可选),不调用该接口时会在输入Pixelmap上直接生效滤镜效果。
    5. errorCode = OH_ImageEffect_SetOutputPixelmap(imageEffect, outputPixelmap);
    6. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetOutputPixelmap fail!");
    7. c++
    复制代码
    场景二:设置 OH_NativeBuffer 输入类型。
    1. // 设置输入的NativeBuffer。
    2. errorCode = OH_ImageEffect_SetInputNativeBuffer(imageEffect, inputNativeBuffer);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetInputNativeBuffer fail!");
    4. // 设置输出的NativeBuffer(可选),不调用该接口时会在输入NativeBuffer上直接生效滤镜效果。
    5. errorCode = OH_ImageEffect_SetOutputNativeBuffer(imageEffect, outputNativeBuffer);
    6. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetOutputNativeBuffer fail!");
    7. c++
    复制代码
    场景三:设置 URI 输入类型。
    1. // 设置输入的URI。
    2. errorCode = OH_ImageEffect_SetInputUri(imageEffect, inputUri);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetInputUri fail!");
    4. // 设置输出的URI(可选),不调用该接口时会在输入URI上直接生效滤镜效果。
    5. errorCode = OH_ImageEffect_SetOutputUri(imageEffect, outputUri);
    6. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetOutputUri fail!");
    7. c++
    复制代码
    场景四:设置 OHNativeWindow 输入类型。
    以相机预览场景为例来阐明OHNativeWindow输入场景。XComponent组件为相机预览流提供的SurfaceId,可在native c++层将SurfaceId转换成OHNativeWindow,下面提供一份代码示例。
    (1) 在xxx.ets中添加一个XComponent组件。
    1. XComponent({
    2.     id: 'xcomponentId',
    3.     type: 'surface',
    4.     controller: this.mXComponentController,
    5.     libraryname: 'entry'
    6. })
    7. .onLoad(() => {
    8.     // 获取XComponent的SurfaceId。
    9.     this.mSurfaceId = this.mXComponentController.getXComponentSurfaceId()
    10.     // 调用native接口获取输入SurfaceId。
    11.     this.mSurfaceId = imageEffect.getSurfaceId(this.mSurfaceId)
    12.     // 调用相机接口启动预览,将获取到的输入SurfaceId传递给相机框架
    13.     // ...
    14. })
    15. .width('100%')
    16. .height('100%')
    17. ts
    复制代码
    (2) imageEffect.getSurfaceId的native c++层具体实现。
    1. // 根据SurfaceId创建NativeWindow,注意创建出来的NativeWindow在使用结束后需要主动调用OH_NativeWindow_DestoryNativeWindow进行释放。
    2. uint64_t outputSurfaceId;
    3. std::istrstream iss(outputSurfaceIdStr);
    4. issue >> outputSurfaceId;
    5. OHNativeWindow *outputNativeWindow = nullptr;
    6. int32_t res = OH_NativeWindow_CreateNativeWindowFromSurfaceId(outputSurfaceId, &outputNativeWindow);
    7. CHECK_AND_RETURN_LOG(res == 0, "OH_NativeWindow_CreateNativeWindowFromSurfaceId fail!");
    8. // 设置输出显示的Surface。
    9. ImageEffect_ErrorCode errorCode = OH_ImageEffect_SetOutputSurface(imageEffect, outputNativeWindow);
    10. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_SetOutputSurface fail!");
    11. // 获取输入的Surface。注意获取的inputNativeWindow在使用结束后需要主动调用OH_NativeWindow_DestoryNativeWindow进行释放。
    12. OHNativeWindow *inputNativeWindow = nullptr;
    13. errorCode = OH_ImageEffect_GetInputSurface(imageEffect, &inputNativeWindow);
    14. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_GetInputSurface fail!");
    15. // 从获取到输入的NativeWindow中获取SurfaceId。
    16. uint64_t inputSurfaceId = 0;
    17. res = OH_NativeWindow_GetSurfaceId(inputNativeWindow, &inputSurfaceId);
    18. CHECK_AND_RETURN_LOG(res == 0, "OH_NativeWindow_GetSurfaceId fail!");
    19. // 将SurfaceId转成字符串进行返回。
    20. std::string inputSurfaceIdStr = std::to_string(inputSurfaceId);
    21. c++
    复制代码
  • 启动结果器。
    1. // 执行生效滤镜效果。
    2. errorCode = OH_ImageEffect_Start(imageEffect);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_Start fail!");
    4. c++
    复制代码
  • 停止生效结果(可选,仅在输入Surface场景下才有效)。
    1. // 停止生效滤镜效果。
    2. errorCode = OH_ImageEffect_Stop(imageEffect);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_Stop fail!");
    4. c++
    复制代码
  • 序列化结果器(可选)。
    1. char *info = nullptr;
    2. errorCode = OH_ImageEffect_Save(imageEffect, &info);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_ImageEffect_Save fail!");
    4. c++
    复制代码
  • 销毁结果器实例。
    1. // 释放imageEffect实例资源。
    2. errorCode = OH_ImageEffect_Release(imageEffect);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, result, "OH_ImageEffect_Release fail!");
    4. c++
    复制代码
自定义滤镜

以下步调描述了怎样实现并注册自定义滤镜接口:

  • 定义 ImageEffect_FilterDelegate。
    1. // 图像信息结构体。
    2. struct EffectBufferInfo {
    3.     void *addr = nullptr;
    4.     int32_t width = 0;
    5.     int32_t height = 0;
    6.     int32_t rowSize = 0;
    7.     ImageEffect_Format format = ImageEffect_Format::EFFECT_PIXEL_FORMAT_UNKNOWN;
    8. };
    9. // 自定义滤镜具体实现。
    10. ImageEffect_FilterDelegate filterDelegate = {
    11.     .setValue = [](OH_EffectFilter *filter, const char *key, const ImageEffect_Any *value) {
    12.         // 参数校验,校验成功时返回true,否则返回false。
    13.         // ...
    14.         return true;
    15.     },
    16.     .render = [](OH_EffectFilter *filter, OH_EffectBufferInfo *info, OH_EffectFilterDelegate_PushData pushData) {
    17.         return Render(filter, info, pushData);
    18.     },
    19.     .save = [](OH_EffectFilter *filter, char **info) {
    20.         // 获取自定义所设置的滤镜参数,其中"Brightness"为自定义滤镜的Key,由开发者自己任意指定。
    21.         ImageEffect_Any value;
    22.         ImageEffect_ErrorCode errorCode = OH_EffectFilter_GetValue(filter, "Brightness", &value);
    23.         CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, false, "OH_EffectFilter_GetValue fail!");
    24.         
    25.         // 生成键值对信息。
    26.         json values;
    27.         values["Brightness"] = value.dataValue.floatValue;         
    28.         json root;
    29.         root["name"] = "CustomBrightness";
    30.         root["values"] = values;
    31.    
    32.        // 将json对象转成字符串infoStr
    33.         // ...
    34.         // 对*info赋值序列化字符串地址。
    35.         *info = infoStr;
    36.         return true;
    37.     },
    38.     .restore = [](const char *info) {
    39.         // 创建 OH_EffectFilter 实例,其中"CustomBrightness"为自定义滤镜的滤镜名。
    40.         OH_EffectFilter *filter = OH_EffectFilter_Create("CustomBrightness");
    41.         // 解析json字符串info获取key和value。
    42.         // ...
    43.    
    44.         // 设置滤镜参数, value为info中按json解析出来的参数。
    45.         ImageEffect_ErrorCode errorCode = OH_EffectFilter_SetValue(filter, "Brightness", &value);
    46.         
    47.         // ...
    48.         return filter;
    49.     }
    50. };
    51. c++
    复制代码
    此中Render接口的实现分两种场景。
    场景一:自定义算法可以直接修改info中的像素数据(好比:亮度调节滤镜)。
    1. bool Render(OH_EffectFilter *filter, OH_EffectBufferInfo *info, OH_EffectFilterDelegate_PushData pushData)
    2. {
    3.     // 获取图像信息具体参数。
    4.     EffectBufferInfo inputBufferInfo;
    5.     OH_EffectBufferInfo_GetAddr(info, &inputBufferInfo.addr);
    6.     OH_EffectBufferInfo_GetWidth(info, &inputBufferInfo.width);
    7.     OH_EffectBufferInfo_GetHeight(info, &inputBufferInfo.height);
    8.     OH_EffectBufferInfo_GetRowSize(info, &inputBufferInfo.rowSize);
    9.     OH_EffectBufferInfo_GetEffectFormat(info, &inputBufferInfo.format);
    10.     // 调用自定义滤镜算法。
    11.     ApplyCustomAlgo(inputBufferInfo);
    12.     // 编辑完成后调用pushData直接传递原图。
    13.     pushData(filter, info);
    14.     return true;
    15. }
    16. c++
    复制代码
    场景二:自定义算法不能直接修改info中的像素数据(好比:裁剪滤镜)。
    1. bool Render(OH_EffectFilter *filter, OH_EffectBufferInfo *info, OH_EffectFilterDelegate_PushData pushData)
    2. {
    3.     // 获取图像信息具体参数。
    4.     EffectBufferInfo inputBufferInfo;
    5.     OH_EffectBufferInfo_GetAddr(info, &inputBufferInfo.addr);
    6.     OH_EffectBufferInfo_GetWidth(info, &inputBufferInfo.width);
    7.     OH_EffectBufferInfo_GetHeight(info, &inputBufferInfo.height);
    8.     OH_EffectBufferInfo_GetRowSize(info, &inputBufferInfo.rowSize);
    9.     OH_EffectBufferInfo_GetEffectFormat(info, &inputBufferInfo.format);
    10.     // 创建输出像素信息。
    11.     EffectBufferInfo outputBufferInfo = CreateOutputBufferInfo(inputBufferInfo);
    12.     // 调用自定义滤镜算法。
    13.     ApplyCustomAlgo(inputBufferInfo, outputBufferInfo);
    14.     // 生成outputOhInfo。
    15.     OH_EffectBufferInfo *outputOhInfo = OH_EffectBufferInfo_Create();
    16.     OH_EffectBufferInfo_SetAddr(outputOhInfo, outputBufferInfo.addr);
    17.     OH_EffectBufferInfo_SetWidth(outputOhInfo, outputBufferInfo.width);
    18.     OH_EffectBufferInfo_SetHeight(outputOhInfo, outputBufferInfo.height);
    19.     OH_EffectBufferInfo_SetRowSize(outputOhInfo, outputBufferInfo.rowSize);
    20.     OH_EffectBufferInfo_SetEffectFormat(outputOhInfo, outputBufferInfo.format);
    21.     // 编辑完成后调用pushData传递outputOhInfo。
    22.     pushData(filter, outputOhInfo);
    23.     // 释放资源。
    24.     OH_EffectBufferInfo_Release(outputOhInfo);
    25.     ReleaseOutputBuffer(outputBufferInfo.addr);
    26.     return true;
    27. }
    28. c++
    复制代码
  • 生成自定义滤镜信息。
    1. // 创建 OH_EffectFilterInfo 实例。
    2. OH_EffectFilterInfo *customFilterInfo = OH_EffectFilterInfo_Create();
    3. CHECK_AND_RETURN_LOG(customFilterInfo != nullptr, "OH_EffectFilter_GetValue fail!");
    4. // 设置自定义滤镜滤镜名。
    5. OH_EffectFilterInfo_SetFilterName(customFilterInfo, "CustomBrightness");
    6. // 设置自定义滤镜所支持的内存类型。
    7. ImageEffect_BufferType bufferTypeArray[] = { ImageEffect_BufferType::EFFECT_BUFFER_TYPE_PIXEL };
    8. OH_EffectFilterInfo_SetSupportedBufferTypes(customFilterInfo, sizeof(bufferTypeArray) / sizeof(ImageEffect_BufferType), bufferTypeArray);
    9. // 设置自定义滤镜所支持的像素格式。
    10. ImageEffect_Format formatArray[] = { ImageEffect_Format::EFFECT_PIXEL_FORMAT_RGBA8888 };
    11. OH_EffectFilterInfo_SetSupportedFormats(customFilterInfo, sizeof(formatArray) / sizeof(ImageEffect_Format), formatArray);
    12. c++
    复制代码
  • 将 ImageEffect_FilterDelegate 注册到结果器。
    1. // 注册自定义滤镜。
    2. ImageEffect_ErrorCode errorCode = OH_EffectFilter_Register(customFilterInfo, &filterDelegate);
    3. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_EffectFilter_Register fail!");
    4. c++
    复制代码
EffectFilter快速实现单个滤镜的处置惩罚结果


  • 创建滤镜。
    1. // 创建滤镜。比如:创建对比度效果器。
    2. OH_EffectFilter *filter = OH_EffectFilter_Create(OH_EFFECT_CONTRAST_FILTER);
    3. c++
    复制代码
  • 设置滤镜参数。
    1. // 设置滤镜参数, 滤镜强度设置为50。
    2. ImageEffect_Any value = {.dataType = ImageEffect_DataType::EFFECT_DATA_TYPE_FLOAT, .dataValue.floatValue = 50.f};
    3. ImageEffect_ErrorCode errorCode = OH_EffectFilter_SetValue(filter, OH_EFFECT_FILTER_INTENSITY_KEY, &value);
    4. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_EffectFilter_SetValue fail!");
    5. c++
    复制代码
  • 生效滤镜。
    1. // 生效滤镜效果。
    2. errorCode = OH_EffectFilter_Render(filter, inputPixelmap, outputPixelmap);
    3. c++
    复制代码
  • 销毁滤镜实例。
    1. // 销毁滤镜实例。
    2. errorCode = OH_EffectFilter_Release(filter);
    3. c++
    复制代码
查询能力



  • 根据滤镜名查询滤镜信息。
    1. // 创建 OH_EffectFilterInfo 实例。
    2. OH_EffectFilterInfo *filterInfo = OH_EffectFilterInfo_Create();
    3. CHECK_AND_RETURN_LOG(filterInfo != nullptr, "OH_EffectFilterInfo_Create fail!");
    4. // 根据滤镜名查询滤镜能力信息。
    5. ImageEffect_ErrorCode errorCode = OH_EffectFilter_LookupFilterInfo(OH_EFFECT_BRIGHTNESS_FILTER, filterInfo);
    6. CHECK_AND_RETURN_LOG(errorCode == ImageEffect_ErrorCode::EFFECT_SUCCESS, "OH_EffectFilter_LookupFilterInfo fail!");
    7. // 从滤镜能力信息中获取滤镜名。
    8. char *name = nullptr;
    9. OH_EffectFilterInfo_GetFilterName(filterInfo, &name);
    10. // 获取支持的内存类型。
    11. uint32_t supportedBufferTypesCnt = 0;
    12. ImageEffect_BufferType *bufferTypeArray = nullptr;
    13. OH_EffectFilterInfo_GetSupportedBufferTypes(filterInfo, &supportedBufferTypesCnt, &bufferTypeArray);
    14. // 获取支持的像素类型信息。
    15. uint32_t supportedFormatsCnt = 0;
    16. ImageEffect_Format *formatArray = nullptr;
    17. OH_EffectFilterInfo_GetSupportedFormats(filterInfo, supportedFormatsCnt, &formatArray);
    18. // 销毁 OH_EffectFilterInfo 实例。
    19. OH_EffectFilterInfo_Release(filterInfo);
    20. c++
    复制代码
  • 根据条件查询满足条件的滤镜。
    1. // 查询所有的Filter,需要主动进行资源释放。
    2. ImageEffect_FilterNames *filterNames = OH_EffectFilter_LookupFilters("Default");
    3. // ...
    4. // 释放FilterNames虚拟内存资源。
    5. OH_EffectFilter_ReleaseFilterNames();
    复制代码

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

惊落一身雪

金牌会员
这个人很懒什么都没写!
快速回复 返回顶部 返回列表