harmony 鸿蒙effect_filter.h

  • 2025-06-12
  • 浏览 (3)

effect_filter.h

概述

声明滤镜效果的接口。

引用文件:

库: libnative_effect.so

系统能力: SystemCapability.Multimedia.Image.Core

起始版本: 12

相关模块: effectKit

汇总

函数

|名称|描述| |–|–| |EffectErrorCode OH_Filter_CreateEffect(OH_PixelmapNative* pixelmap, OH_Filter** filter)|创建一个OH_Filter对象。| |EffectErrorCode OH_Filter_Release(OH_Filter* filter)|释放OH_Filter对象。| |EffectErrorCode OH_Filter_Blur(OH_Filter* filter, float radius)|创建一个毛玻璃滤镜效果,然后添加到滤镜里面。| |EffectErrorCode OH_Filter_BlurWithTileMode(OH_Filter* filter, float radius, EffectTileMode tileMode)|创建一个毛玻璃滤镜效果,然后添加到滤镜里面。| |EffectErrorCode OH_Filter_Brighten(OH_Filter* filter, float brightness)|创建一个提亮效果并且添加到滤镜中。| |EffectErrorCode OH_Filter_GrayScale(OH_Filter* filter)|创建一个灰度效果并且添加到滤镜中。| |EffectErrorCode OH_Filter_Invert(OH_Filter* filter)|创建一个反色效果并且添加到滤镜中。| |EffectErrorCode OH_Filter_SetColorMatrix(OH_Filter* filter, OH_Filter_ColorMatrix* matrix)|通过矩阵创建一个自定义的效果并且添加到滤镜中。| |EffectErrorCode OH_Filter_GetEffectPixelMap(OH_Filter* filter, OH_PixelmapNative** pixelmap)|获取滤镜生成的位图。|

函数说明

OH_Filter_CreateEffect()

EffectErrorCode OH_Filter_CreateEffect(OH_PixelmapNative* pixelmap, OH_Filter** filter)

描述

创建一个OH_Filter对象。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_PixelmapNative* pixelmap|创建滤镜的位图。| |OH_Filter** filter|用来接收滤镜的二级指针。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_Release()

EffectErrorCode OH_Filter_Release(OH_Filter* filter)

描述

释放OH_Filter对象。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|被释放的对象指针。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_Blur()

EffectErrorCode OH_Filter_Blur(OH_Filter* filter, float radius)

描述

创建一个毛玻璃滤镜效果,然后添加到滤镜里面。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|滤镜指针。| |float radius|毛玻璃效果的模糊半径,单位为像素。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_BlurWithTileMode()

EffectErrorCode OH_Filter_BlurWithTileMode(OH_Filter* filter, float radius, EffectTileMode tileMode)

描述

创建一个毛玻璃滤镜效果,然后添加到滤镜里面。

起始版本: 14

参数:

|参数项|描述| |–|–| |OH_Filter* filter|滤镜指针。| |float radius|毛玻璃效果的模糊半径,单位为像素。| |EffectTileMode tileMode|着色器效果平铺模式,支持可选的具体模式可见EffectTileMode枚举。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode
操作成功则返回EFFECT_SUCCESS。
无效参数则返回EFFECT_BAD_PARAMETER。|

OH_Filter_Brighten()

EffectErrorCode OH_Filter_Brighten(OH_Filter* filter, float brightness)

描述

创建一个提亮效果并且添加到滤镜中。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|滤镜指针。| |float brightness|提亮效果的亮度值,取值范围在0-1之间,取值为0时图像保持不变。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_GrayScale()

EffectErrorCode OH_Filter_GrayScale(OH_Filter* filter)

描述

创建一个灰度效果并且添加到滤镜中。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|滤镜指针。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_Invert()

EffectErrorCode OH_Filter_Invert(OH_Filter* filter)

描述

创建一个反色效果并且添加到滤镜中。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|滤镜指针。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_SetColorMatrix()

EffectErrorCode OH_Filter_SetColorMatrix(OH_Filter* filter, OH_Filter_ColorMatrix* matrix)

描述

通过矩阵创建一个自定义的效果并且添加到滤镜中。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|滤镜指针。| |OH_Filter_ColorMatrix* matrix|用来创建滤镜的自定义矩阵OH_Filter_ColorMatrix。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

OH_Filter_GetEffectPixelMap()

EffectErrorCode OH_Filter_GetEffectPixelMap(OH_Filter* filter, OH_PixelmapNative** pixelmap)

描述

获取滤镜生成的位图。

起始版本: 12

参数:

|参数项|描述| |–|–| |OH_Filter* filter|用来创建位图的滤镜指针。| |OH_PixelmapNative** pixelmap|用来接收位图的二级指针。|

返回:

|类型|说明| |–|–| |EffectErrorCode|返回结果参见状态码EffectErrorCode。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 2D(方舟2D图形服务)

harmony 鸿蒙buffer_common.h

harmony 鸿蒙buffer_handle.h

harmony 鸿蒙BufferHandle

harmony 鸿蒙ColorSpacePrimaries

harmony 鸿蒙DisplaySoloist_ExpectedRateRange

harmony 鸿蒙drawing_bitmap.h

harmony 鸿蒙drawing_brush.h

harmony 鸿蒙drawing_canvas.h

harmony 鸿蒙drawing_color_filter.h

0  赞