harmony 鸿蒙image_pixel_map_napi.h

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

image_pixel_map_napi.h

概述

声明可以锁定并访问pixelmap数据的方法,声明解锁的方法。

库: libpixelmap_ndk.so

引用文件:

起始版本: 8

相关模块: Image

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |OhosPixelMapInfo|-|用于定义PixelMap的相关信息。|

枚举

|名称|描述| |–|–| |方法返回的错误码|函数方法返回值的错误码的枚举。| |像素格式|像素格式的枚举。| |anonymous enum|PixelMap缩放类型的枚举。|

函数

|名称|描述| |–|–| |int32_t OH_GetImageInfo(napi_env env, napi_value value, OhosPixelMapInfo *info)|获取PixelMap的信息,并记录信息到OhosPixelMapInfo结构中。| |int32_t OH_AccessPixels(napi_env env, napi_value value, void** addrPtr)|获取PixelMap对象数据的内存地址,并锁定该内存。
函数执行成功后,*addrPtr就是获取的待访问的内存地址。访问操作完成后,必须要使用OH_UnAccessPixels来释放锁,否则的话资源无法被释放。待解锁后,内存地址就不可以再被访问和操作。| |int32_t OH_UnAccessPixels(napi_env env, napi_value value)|释放PixelMap对象数据的内存锁,用于匹配方法OH_AccessPixels。|

枚举类型说明

方法返回的错误码

enum anonymous enum

描述

函数方法返回值的错误码的枚举。

起始版本: 8

废弃版本: 10

|枚举项|描述| |–|–| |OHOS_IMAGE_RESULT_SUCCESS = 0|成功的结果。| |OHOS_IMAGE_RESULT_BAD_PARAMETER = -1|无效值。|

像素格式

enum anonymous enum

描述

像素格式的枚举。

起始版本: 8

废弃版本: 10

|枚举项|描述| |–|–| |OHOS_PIXEL_MAP_FORMAT_NONE = 0|未知的格式。| |OHOS_PIXEL_MAP_FORMAT_RGBA_8888 = 3|RGBA_8888格式。| |OHOS_PIXEL_MAP_FORMAT_RGB_565 = 2|RGB_565格式。|

PixelMap缩放类型

enum anonymous enum

描述

PixelMap缩放类型的枚举。

起始版本: 10

|枚举项|描述| |–|–| |OHOS_PIXEL_MAP_SCALE_MODE_FIT_TARGET_SIZE = 0|适应目标图片大小的格式。| |OHOS_PIXEL_MAP_SCALE_MODE_CENTER_CROP = 1|以中心进行缩放的格式。|

函数说明

OH_GetImageInfo()

int32_t OH_GetImageInfo(napi_env env, napi_value value, OhosPixelMapInfo *info)

描述

获取PixelMap的信息,并记录信息到OhosPixelMapInfo结构中。

起始版本: 8

废弃版本: 10

参数:

|参数项|描述| |–|–| |napi_env env|napi的环境指针。| |napi_value value|应用层的PixelMap对象。| |OhosPixelMapInfo *info|用于保存信息的指针对象。|

返回:

|类型|说明| |–|–| |int32_t|错误码
OHOS_IMAGE_RESULT_SUCCESS:操作成功。
OHOS_IMAGE_RESULT_BAD_PARAMETER:操作失败。|

OH_AccessPixels()

int32_t OH_AccessPixels(napi_env env, napi_value value, void** addrPtr)

描述

获取PixelMap对象数据的内存地址,并锁定该内存。

函数执行成功后,*addrPtr就是获取的待访问的内存地址。访问操作完成后,必须要使用OH_UnAccessPixels来释放锁,否则的话资源无法被释放。待解锁后,内存地址就不可以再被访问和操作。

起始版本: 8

废弃版本: 10

参数:

|参数项|描述| |–|–| |napi_env env|napi的环境指针。| |napi_value value|应用层的PixelMap对象。| |void** addrPtr|用于指向的内存地址的双指针对象。|

返回:

|类型|说明| |–|–| |int32_t|错误码
OHOS_IMAGE_RESULT_SUCCESS:操作成功。
OHOS_IMAGE_RESULT_BAD_PARAMETER:操作失败。|

OH_UnAccessPixels()

int32_t OH_UnAccessPixels(napi_env env, napi_value value)

描述

释放PixelMap对象数据的内存锁,用于匹配方法OH_AccessPixels

起始版本: 8

废弃版本: 10

参数:

|参数项|描述| |–|–| |napi_env env|napi的环境指针。| |napi_value value|应用层的PixelMap对象。|

返回:

|类型|说明| |–|–| |int32_t|错误码
OHOS_IMAGE_RESULT_SUCCESS:操作成功。
OHOS_IMAGE_RESULT_BAD_PARAMETER:操作失败。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Image Kit(图片处理服务)

harmony 鸿蒙Interface (AuxiliaryPicture)

harmony 鸿蒙Interface (Image)

harmony 鸿蒙Interface (ImageCreator)

harmony 鸿蒙Interface (ImagePacker)

harmony 鸿蒙Interface (ImageReceiver)

harmony 鸿蒙Interface (ImageSource)

harmony 鸿蒙Interface (Metadata)

harmony 鸿蒙Interface (Picture)

harmony 鸿蒙Interface (PixelMap)

0  赞