harmony 鸿蒙drawing_image.h

2025-06-12
浏览 (3)

drawing_image.h

概述

文件中定义了与图片相关的功能函数。

引用文件：

库： libnative_drawing.so

起始版本： 12

相关模块： Drawing

汇总

函数

|名称|描述| |–|–| |OH_Drawing_Image* OH_Drawing_ImageCreate(void)|创建一个图片对象，描述了要绘制的二维像素数组。| |void OH_Drawing_ImageDestroy(OH_Drawing_Image* image)|销毁图片对象并回收该对象占有内存。| |bool OH_Drawing_ImageBuildFromBitmap(OH_Drawing_Image* image, OH_Drawing_Bitmap* bitmap)|从位图构造图片对象内容，共享或复制位图像素。如果位图被标记为不可变状态，像素内存是共享的，不是复制。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image、bitmap任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |int32_t OH_Drawing_ImageGetWidth(OH_Drawing_Image* image)|获取图片宽度，即每行的像素个数。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |int32_t OH_Drawing_ImageGetHeight(OH_Drawing_Image* image)|获取图片高度，即像素行数。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |void OH_Drawing_ImageGetImageInfo(OH_Drawing_Image* image, OH_Drawing_Image_Info* imageInfo)|获取图片信息。调用该接口后，传入的图片信息对象被填充。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image、imageInfo任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。|

函数说明

OH_Drawing_ImageCreate()

OH_Drawing_Image* OH_Drawing_ImageCreate(void)

描述

创建一个图片对象，描述了要绘制的二维像素数组。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

返回：

|类型|说明| |–|–| |OH_Drawing_Image*|函数返回一个指针，指针指向创建的图片对象OH_Drawing_Image。|

OH_Drawing_ImageDestroy()

void OH_Drawing_ImageDestroy(OH_Drawing_Image* image)

描述

销毁图片对象并回收该对象占有内存。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Image* image|指向图片对象OH_Drawing_Image的指针。|

OH_Drawing_ImageBuildFromBitmap()

bool OH_Drawing_ImageBuildFromBitmap(OH_Drawing_Image* image, OH_Drawing_Bitmap* bitmap)

描述

从位图构造图片对象内容，共享或复制位图像素。如果位图被标记为不可变状态，像素内存是共享的，不是复制。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image、bitmap任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Image* image|指向图片对象OH_Drawing_Image的指针。| |OH_Drawing_Bitmap* bitmap|指向位图对象OH_Drawing_Bitmap的指针。|

返回：

|类型|说明| |–|–| |bool|函数返回true表示构造图片内容成功，函数返回false表示构建图片内容失败。|

OH_Drawing_ImageGetWidth()

int32_t OH_Drawing_ImageGetWidth(OH_Drawing_Image* image)

描述

获取图片宽度，即每行的像素个数。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Image* image|指向图片对象OH_Drawing_Image的指针。|

返回：

|类型|说明| |–|–| |int32_t|函数返回图片宽度。|

OH_Drawing_ImageGetHeight()

int32_t OH_Drawing_ImageGetHeight(OH_Drawing_Image* image)

描述

获取图片高度，即像素行数。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Image* image|指向图片对象OH_Drawing_Image的指针。|

返回：

|类型|说明| |–|–| |int32_t|函数返回图片高度。|

OH_Drawing_ImageGetImageInfo()

void OH_Drawing_ImageGetImageInfo(OH_Drawing_Image* image, OH_Drawing_Image_Info* imageInfo)

描述

获取图片信息。调用该接口后，传入的图片信息对象被填充。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
image、imageInfo任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Image* image|指向图片对象OH_Drawing_Image的指针。| |OH_Drawing_Image_Info* imageInfo|指向图片信息对象OH_Drawing_Image_Info的指针，开发者可调用OH_Drawing_Image_Info创建。|