文档中心

OH_PixelmapNative

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

更新时间: 2026-08-29 09:41

复制页面

收起
自动换行
深色代码主题
复制
struct OH_PixelmapNative

概述

OH_PixelmapNative是Native层封装的图像解码后无压缩的位图格式结构体，支持像素数据读写、不透明度设置、缩放、平移、旋转、翻转、裁剪等操作，适用于需要在Native层对Pixelmap进行像素级处理与变换的场景。

创建OH_PixelmapNative需要使用OH_PixelmapNative_CreatePixelmap系列函数，该函数在未指定源像素格式时，会默认按BGRA_8888格式解析源像素数据。使用完毕后，必须调用OH_PixelmapNative_Release函数释放资源，两者需配对使用，否则会导致内存泄漏。

OH_PixelmapNative结构体的部分相关函数和操作方式如下：

展开

字段类型	字段名称	字段描述	操作函数	函数描述
uint8_t	data	图像像素数据，当未指定源像素格式时，默认按BGRA_8888格式解析。	OH_PixelmapNative_ReadPixels	读取Pixelmap的像素数据，结果写入缓冲区中。
uint8_t	data	图像像素数据，当未指定源像素格式时，默认按BGRA_8888格式解析。	OH_PixelmapNative_WritePixels	将缓冲区中的像素数据写入Pixelmap。
OH_Pixelmap_ImageInfo	imageInfo	图像像素信息。	OH_PixelmapNative_GetImageInfo	获取图像像素信息。
float	alphaRate	不透明度，取值范围(0.0, 1.0]，1.0表示完全不透明。	OH_PixelmapNative_Opacity	设置不透明度，使Pixelmap达到对应的不透明效果。
float, float	scaleX, scaleY	scaleX为沿X轴的缩放比例、scaleY为沿Y轴的缩放比例，取值范围(0, +∞)，1.0表示不缩放。	OH_PixelmapNative_Scale	根据输入的缩放比例对图像进行缩放。
float, float	x, y	x平移量、y平移量，单位：像素（px）。正值x表示向右平移，负值x表示向左平移；正值y表示向下平移，负值y表示向上平移。	OH_PixelmapNative_Translate	根据输入的平移距离对图片进行位置变换。
float	angle	旋转角度，单位：角度（°），正值表示顺时针方向旋转，负值表示逆时针方向旋转。	OH_PixelmapNative_Rotate	根据输入的角度对图片进行旋转。
bool, bool	shouldFlipHorizontally, shouldFlipVertically	是否水平翻转图像、是否垂直翻转图像。true表示翻转，false表示不翻转。	OH_PixelmapNative_Flip	根据输入的水平/垂直翻转标志对图片进行翻转。
Image_Region	region	裁剪区间，包含起始坐标(x,y)和宽高，宽高需为正值且裁剪区域需在图像范围内，参考Image_Region。	OH_PixelmapNative_Crop	根据输入的区域信息对图片进行裁剪。

起始版本： 12

相关模块： Image_NativeModule

所在头文件： pixelmap_native.h