effect_filter.h
概述
声明滤镜效果的接口。
引用文件： <native_effect/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图形服务）