drawing_image_filter.h
概述
声明与绘图模块中的图像滤波器对象相关的函数。
引用文件： <native_drawing/drawing_image_filter.h>
库： libnative_drawing.so
起始版本： 12
相关模块： Drawing
汇总
函数
| 名称 | 描述 |
|---|---|
| OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateBlur(float sigmaX, float sigmaY, OH_Drawing_TileMode tileMode,OH_Drawing_ImageFilter* imageFilter) | 创建具有模糊效果的图像滤波器。 |
| OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateFromColorFilter(OH_Drawing_ColorFilter* colorFilter,OH_Drawing_ImageFilter* imageFilter) | 创建具有颜色变换效果的图像滤波器。本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。colorFilter为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。 |
| OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateOffset(float x, float y, OH_Drawing_ImageFilter* imageFilter) | 创建一个偏移滤波器，将输入的滤波器按照指定向量进行平移。 |
| OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateFromShaderEffect(OH_Drawing_ShaderEffect* shaderEffct) | 基于着色器创建一个图像滤波器。 |
| void OH_Drawing_ImageFilterDestroy(OH_Drawing_ImageFilter* imageFilter) | 销毁图像滤波器对象并回收该对象占有内存。 |
函数说明
OH_Drawing_ImageFilterCreateBlur()
OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateBlur(float sigmaX, float sigmaY, OH_Drawing_TileMode tileMode,OH_Drawing_ImageFilter* imageFilter)
描述
创建具有模糊效果的图像滤波器。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| float sigmaX | 表示沿x轴方向上高斯模糊的标准差，必须大于0。 |
| float sigmaY | 表示沿y轴方向上高斯模糊的标准差，必须大于0。 |
| OH_Drawing_TileMode tileMode | 图像滤波器效果平铺模式类型，支持可选的具体模式可见OH_Drawing_TileMode枚举。 |
| OH_Drawing_ImageFilter* imageFilter | 表示将要和当前图像滤波器叠加的输入滤波器, 如果为NULL，表示直接将当前图像滤波器作用于原始图像。 |
返回：
| 类型 | 说明 |
|---|---|
| OH_Drawing_ImageFilter* | 函数会返回一个指针，指针指向创建的图像滤波器对象OH_Drawing_ImageFilter。如果对象返回NULL，表示创建失败；可能的原因是可用内存为空。 |
OH_Drawing_ImageFilterCreateFromColorFilter()
OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateFromColorFilter(OH_Drawing_ColorFilter* colorFilter,OH_Drawing_ImageFilter* imageFilter)
描述
创建具有颜色变换效果的图像滤波器。本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。colorFilter为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| OH_Drawing_ColorFilter* colorFilter | 指向具有颜色变换效果的颜色滤波器对象OH_Drawing_ColorFilter。 |
| OH_Drawing_ImageFilter* imageFilter | 表示将要和当前图像滤波器叠加的输入滤波器, 如果为NULL，表示直接将当前图像滤波器作用于原始图像。 |
返回：
| 类型 | 说明 |
|---|---|
| OH_Drawing_ImageFilter* | 函数会返回一个指针，指针指向创建的图像滤波器对象OH_Drawing_ImageFilter。如果对象返回NULL，表示创建失败；可能的原因是可用内存为空，或者是colorFilter为NULL。 |
OH_Drawing_ImageFilterCreateOffset()
OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateOffset(float x, float y, OH_Drawing_ImageFilter* imageFilter)
描述
创建一个偏移滤波器，将输入的滤波器按照指定向量进行平移。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| float x | 水平方向的平移距离。 |
| float y | 竖直方向的平移距离。 |
| OH_Drawing_ImageFilter* imageFilter | 需进行平移的滤波器，如果为空，则将无滤波效果的绘制结果进行平移。 |
返回：
| 类型 | 说明 |
|---|---|
| OH_Drawing_ImageFilter* | 函数会返回一个指针，指针指向创建的图像滤波器对象OH_Drawing_ImageFilter。如果对象返回NULL，表示创建失败，可能原因为可用内存为空。 |
OH_Drawing_ImageFilterCreateFromShaderEffect()
OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateFromShaderEffect(OH_Drawing_ShaderEffect* shaderEffct)
描述
基于着色器创建一个图像滤波器。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| OH_Drawing_ShaderEffect* shaderEffct | 表示要应用于图像的着色器效果。 |
返回：
| 类型 | 说明 |
|---|---|
| OH_Drawing_ImageFilter* | 函数会返回一个指针，指针指向创建的图像滤波器对象OH_Drawing_ImageFilter。如果结果返回NULL，表示创建失败，可能原因为可用内存为空。 |
OH_Drawing_ImageFilterDestroy()
void OH_Drawing_ImageFilterDestroy(OH_Drawing_ImageFilter* imageFilter)
描述
销毁图像滤波器对象并回收该对象占有内存。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| OH_Drawing_ImageFilter* imageFilter | 指向图像滤波器对象OH_Drawing_ImageFilter的指针。 |
你可能感兴趣的鸿蒙文章
harmony 鸿蒙ArkGraphics 2D（方舟2D图形服务）