picture_native.h

概述

提供获取picture数据和信息的API。

库： libpicture.so

引用文件：<multimedia/image_framework/image/picture_native.h>

系统能力： SystemCapability.Multimedia.Image.Core

起始版本： 13

相关模块：Image_NativeModule

汇总

类型定义

名称	描述
typedef struct OH_PictureNative OH_PictureNative	Picture结构体类型，用于执行picture相关操作。
typedef struct OH_AuxiliaryPictureNative OH_AuxiliaryPictureNative	AuxiliaryPicture结构体类型，用于执行AuxiliaryPicture相关操作。
typedef struct OH_AuxiliaryPictureInfo OH_AuxiliaryPictureInfo	AuxiliaryPictureInfo结构体类型，用于执行AuxiliaryPictureInfo相关操作。

枚举

名称	描述
Image_AuxiliaryPictureType { AUXILIARY_PICTURE_TYPE_GAINMAP = 1, AUXILIARY_PICTURE_TYPE_DEPTH_MAP = 2, AUXILIARY_PICTURE_TYPE_UNREFOCUS_MAP = 3, AUXILIARY_PICTURE_TYPE_LINEAR_MAP = 4, AUXILIARY_PICTURE_TYPE_FRAGMENT_MAP = 5 }	辅助图类型。

函数

名称	描述
Image_ErrorCode OH_PictureNative_CreatePicture (OH_PixelmapNative *mainPixelmap, OH_PictureNative **picture)	创建OH_PictureNative指针。
Image_ErrorCode OH_PictureNative_GetMainPixelmap (OH_PictureNative *picture, OH_PixelmapNative **mainPixelmap)	获取主图的OH_PixelmapNative指针。
Image_ErrorCode OH_PictureNative_GetHdrComposedPixelmap (OH_PictureNative *picture, OH_PixelmapNative **hdrPixelmap)	获取hdr图的OH_PixelmapNative指针。
Image_ErrorCode OH_PictureNative_GetGainmapPixelmap (OH_PictureNative *picture, OH_PixelmapNative **gainmapPixelmap)	获取增益图的OH_PixelmapNative指针。
Image_ErrorCode OH_PictureNative_SetAuxiliaryPicture (OH_PictureNative *picture, Image_AuxiliaryPictureType type, OH_AuxiliaryPictureNative *auxiliaryPicture)	设置辅助图。
Image_ErrorCode OH_PictureNative_GetAuxiliaryPicture (OH_PictureNative *picture, Image_AuxiliaryPictureType type, OH_AuxiliaryPictureNative **auxiliaryPicture)	根据类型获取辅助图。
Image_ErrorCode OH_PictureNative_GetMetadata (OH_PictureNative *picture, Image_MetadataType metadataType, OH_PictureMetadata **metadata)	获取主图的元数据。
Image_ErrorCode OH_PictureNative_SetMetadata (OH_PictureNative *picture, Image_MetadataType metadataType, OH_PictureMetadata *metadata)	设置主图的元数据。
Image_ErrorCode OH_PictureNative_Release (OH_PictureNative *picture)	释放OH_PictureNative指针。
Image_ErrorCode OH_AuxiliaryPictureNative_Create (uint8_t *data, size_t dataLength, Image_Size *size, Image_AuxiliaryPictureType type, OH_AuxiliaryPictureNative **auxiliaryPicture)	创建OH_AuxiliaryPictureNative指针。
Image_ErrorCode OH_AuxiliaryPictureNative_WritePixels (OH_AuxiliaryPictureNative *auxiliaryPicture, uint8_t *source, size_t bufferSize)	读取缓冲区的图像像素数据，并将结果写入为辅助图中。
Image_ErrorCode OH_AuxiliaryPictureNative_ReadPixels (OH_AuxiliaryPictureNative *auxiliaryPicture, uint8_t *destination, size_t *bufferSize)	读取辅助图的像素数据，结果写入缓冲区。
Image_ErrorCode OH_AuxiliaryPictureNative_GetType (OH_AuxiliaryPictureNative *auxiliaryPicture, Image_AuxiliaryPictureType *type)	获取辅助图类型。
Image_ErrorCode OH_AuxiliaryPictureNative_GetInfo (OH_AuxiliaryPictureNative *auxiliaryPicture, OH_AuxiliaryPictureInfo **info)	获取辅助图信息。
Image_ErrorCode OH_AuxiliaryPictureNative_SetInfo (OH_AuxiliaryPictureNative *auxiliaryPicture, OH_AuxiliaryPictureInfo *info)	设置辅助图信息。
Image_ErrorCode OH_AuxiliaryPictureNative_GetMetadata (OH_AuxiliaryPictureNative *auxiliaryPicture, Image_MetadataType metadataType, OH_PictureMetadata **metadata)	获取辅助图的元数据。
Image_ErrorCode OH_AuxiliaryPictureNative_SetMetadata (OH_AuxiliaryPictureNative *auxiliaryPicture, Image_MetadataType metadataType, OH_PictureMetadata *metadata)	设置辅助图的元数据。
Image_ErrorCode OH_AuxiliaryPictureNative_Release (OH_AuxiliaryPictureNative *picture)	释放OH_AuxiliaryPictureNative指针。
Image_ErrorCode OH_AuxiliaryPictureInfo_Create (OH_AuxiliaryPictureInfo **info)	创建一个OH_AuxiliaryPictureInfo对象。
Image_ErrorCode OH_AuxiliaryPictureInfo_GetType (OH_AuxiliaryPictureInfo *info, Image_AuxiliaryPictureType *type)	获取辅助图的图片信息的辅助图类型。
Image_ErrorCode OH_AuxiliaryPictureInfo_SetType (OH_AuxiliaryPictureInfo *info, Image_AuxiliaryPictureType type)	设置辅助图的图片信息的辅助图类型。
Image_ErrorCode OH_AuxiliaryPictureInfo_GetSize (OH_AuxiliaryPictureInfo *info, Image_Size *size)	获取辅助图的图片尺寸。
Image_ErrorCode OH_AuxiliaryPictureInfo_SetSize (OH_AuxiliaryPictureInfo *info, Image_Size *size)	设置辅助图的图片尺寸。
Image_ErrorCode OH_AuxiliaryPictureInfo_GetRowStride (OH_AuxiliaryPictureInfo *info, uint32_t *rowStride)	获取辅助图的图片信息的行跨距。
Image_ErrorCode OH_AuxiliaryPictureInfo_SetRowStride (OH_AuxiliaryPictureInfo *info, uint32_t rowStride)	设置辅助图的图片信息的行跨距。
Image_ErrorCode OH_AuxiliaryPictureInfo_GetPixelFormat (OH_AuxiliaryPictureInfo *info, PIXEL_FORMAT *pixelFormat)	获取辅助图的图片信息的像素格式。
Image_ErrorCode OH_AuxiliaryPictureInfo_SetPixelFormat (OH_AuxiliaryPictureInfo *info, PIXEL_FORMAT pixelFormat)	设置辅助图的图片信息的像素格式。
Image_ErrorCode OH_AuxiliaryPictureInfo_Release (OH_AuxiliaryPictureInfo *info)	释放OH_AuxiliaryPictureInfo指针。