# OH_AuxiliaryPictureNative

```
typedef struct OH_AuxiliaryPictureNative OH_AuxiliaryPictureNative
```

#### 概述

AuxiliaryPicture结构体类型，用于执行AuxiliaryPicture相关操作。

使用OH\_AuxiliaryPictureNative\_Create函数创建OH\_AuxiliaryPictureNative对象。

使用OH\_PictureNative\_GetAuxiliaryPicture函数从OH\_PictureNative对象中按辅助图类型获取OH\_AuxiliaryPictureNative对象。

使用OH\_AuxiliaryPictureNative\_Release函数释放OH\_AuxiliaryPictureNative对象。

使用约束：使用OH\_AuxiliaryPictureNative对象前，需先创建或获取对象；使用完成后，应调用OH\_AuxiliaryPictureNative\_Release释放对象。通过OH\_AuxiliaryPictureNative\_Create创建对象时，data、size和auxiliaryPicture均不能为空指针，dataLength必须大于0，type必须为当前支持的Image\_AuxiliaryPictureType。

资源管理：释放OH\_PictureNative对象不会自动释放已经获取出的OH\_AuxiliaryPictureNative对象；释放OH\_AuxiliaryPictureNative对象也不会从OH\_PictureNative对象中移除对应辅助图。通过OH\_AuxiliaryPictureNative\_GetInfo获取到的OH\_AuxiliaryPictureInfo对象由调用方管理，使用完成后应调用OH\_AuxiliaryPictureInfo\_Release释放。通过OH\_AuxiliaryPictureNative\_GetMetadata获取到的OH\_PictureMetadata对象由调用方管理，使用完成后应调用OH\_PictureMetadata\_Release释放。接口返回失败时，输出参数的内容不能在后续流程中继续使用。

OH\_AuxiliaryPictureNative结构体内容和操作方式如下：

| 字段类型 | 字段名称 | 字段描述 | 操作函数 | 函数描述 |
| --- | --- | --- | --- | --- |
| uint8_t | pixels | 辅助图像素数据。 | OH_AuxiliaryPictureNative_ReadPixels | 读取辅助图的像素数据。 |
| uint8_t | pixels | 辅助图像素数据。 | OH_AuxiliaryPictureNative_WritePixels | 写入辅助图的像素数据。 |
| Image_AuxiliaryPictureType | type | 辅助图类型。 | OH_AuxiliaryPictureNative_GetType | 获取辅助图类型。 |
| OH_AuxiliaryPictureInfo | info | 辅助图信息。 | OH_AuxiliaryPictureNative_GetInfo | 获取辅助图信息。 |
| OH_AuxiliaryPictureInfo | info | 辅助图信息。 | OH_AuxiliaryPictureNative_SetInfo | 设置辅助图信息。 |
| OH_PictureMetadata | metadata | 辅助图元数据。 | OH_AuxiliaryPictureNative_GetMetadata | 获取辅助图的元数据。 |
| OH_PictureMetadata | metadata | 辅助图元数据。 | OH_AuxiliaryPictureNative_SetMetadata | 设置辅助图的元数据。 |

**起始版本：** 13

**相关模块：** Image\_NativeModule

**所在头文件：** picture\_native.h

**相关开发指导：** 使用Image\_NativeModule完成多图对象解码