# Image错误码

以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。

#### 501 无法调用接口

**错误信息**

Resource unavailable.

**错误描述**

无法调用接口。

**可能原因**

图片被跨线程传递，原对象无法调用接口。

**处理步骤**

请检查图片并按指示操作重新解码。

#### 62980096 操作失败

**错误信息**

The operation failed. Possible cause: 1.Image upload exception. 2. Decoding process exception. 3. Insufficient memory.

**错误描述**

操作失败。

**可能原因**

1.  上传图片过程中出现异常。
2.  解码过程中有其他操作。
3.  没有按指示操作进行图片解码。
4.  设备的内存不足。
5.  解码库处理失败。

**处理步骤**

请检查图片并按指示操作重新解码。

#### 62980097 pixelmap序列化传输失败

**错误信息**

IPC error. Possible cause: 1.IPC communication failed. 2. Image upload exception. 3. Decode process exception. 4. Insufficient memory.

**错误描述**

pixelmap序列化传输失败。

**可能原因**

1.  上传图片过程中出现异常。
2.  解码过程中有其他操作。
3.  没有按指示操作进行图片解码。
4.  设备的内存不足。

**处理步骤**

请检查图片并按指示操作重新解码。

#### 62980098 共享内存空间错误

**错误信息**

Shared memory does not exist.

**错误描述**

共享内存空间错误。

**可能原因**

1.  内存大小不够。
2.  越界访问共享内存。
3.  使用了无效的指针。

**处理步骤**

请检查内存使用情况或重启。

#### 62980099 共享内存数据异常

**错误信息**

The shared memory data is abnormal.

**错误描述**

共享内存数据异常。

**可能原因**

1.  读写共享内存时没有正确地进行同步操作。
2.  越界访问共享内存。
3.  使用了无效的指针。

**处理步骤**

请重新启动。

#### 62980100 图片解码错误

**错误信息**

Image decoding abnormal.

**错误描述**

图片解码错误。

**可能原因**

1.  上传图片过程中出现异常。
2.  解码过程中有其他操作。
3.  没有按指示操作进行图片解码。
4.  设备的内存不足。

**处理步骤**

请检查图片并按指示操作重新解码。

#### 62980101 图片输入数据错误

**错误信息**

The image data is abnormal.

**错误描述**

图片输入数据错误。

**可能原因**

1.  输入图片数据不对。
2.  输入的图片格式不对。
3.  输入的图片大小不对。

**处理步骤**

请重新输入正确的图片。

#### 62980102 图片分配内存错误

**错误信息**

Image malloc abnormal. This status code is thrown when an error occurs during the process of copying data.

**错误描述**

图片分配内存错误。

**可能原因**

设备内存不足或内存被占用。

**处理步骤**

清理内存后重试。

#### 62980103 图片类型不支持

**错误信息**

The image data is not supported.

**错误描述**

图片类型不支持。

**可能原因**

当前不支持所传入的图片的类型。

**处理步骤**

请更换图片类型重试。

#### 62980104 图片初始化错误

**错误信息**

Image initialization abnormal. This status code is thrown when an error occurs during the process of creating empty pixelmap.

**错误描述**

图片初始化错误。

**可能原因**

1.  图片类型不支持。
2.  图片大小不支持。
3.  初始化过程中出现错误。

**处理步骤**

请重新输入正确的参数或更换图片。

#### 62980105 图片获取数据错误

**错误信息**

Failed to get the data.

**错误描述**

图片获取数据错误。

**可能原因**

1.  设备不支持该图片类型。
2.  图片数据丢失。

**处理步骤**

请输入新的图片或检查图片数据。

#### 62980106 图片数据太大

**错误信息**

The image data is too large. This status code is thrown when an error occurs during the process of checking size.

**错误描述**

图片数据太大。

**可能原因**

图片太大。

**处理步骤**

更换较小的图片。

#### 62980107 图片转换错误

**错误信息**

Image conversion abnormal.

**错误描述**

图片转换错误。

**可能原因**

1.  图片转换过程中异常停止。
2.  编码参数设置错误。

**处理步骤**

更换图片或者设置支持的编码参数。

#### 62980108 图片颜色转换错误

**错误信息**

Failed to convert the color space.

**错误描述**

图片颜色转换错误。

**可能原因**

1.  不支持该图片类型的颜色转换。
2.  设备出现问题。

**处理步骤**

重试或者更换图片类型。

#### 62980109 裁剪错误

**错误信息**

Failed to crop the image.

**错误描述**

裁剪错误。

**可能原因**

1.  裁剪参数设置错误。
2.  图片数据错误。

**处理步骤**

请检查图片数据或修改正确的裁剪参数。

#### 62980110 图片源数据错误

**错误信息**

The image source data is incorrect.

**错误描述**

图片源数据错误。

**可能原因**

图片数据源缺失或错乱。

**处理步骤**

检查操作步骤或更换图片。

#### 62980111 图片源数据不完整

**错误信息**

The image source data is incomplete.

**错误描述**

图片源数据不完整。

**可能原因**

图片源数据缺失。

**处理步骤**

检查操作步骤或更换图片。

#### 62980112 图片格式不匹配

**错误信息**

The image format does not match.

**错误描述**

图片格式不匹配。

**可能原因**

该图片的格式不匹配。

**处理步骤**

更换匹配类型的图片。

#### 62980113 图片未知格式

**错误信息**

Unknown image format.The image data provided is not in a recognized or supported format, or it may be corrupted.

**错误描述**

图片未知格式。

**可能原因**

该图片的格式不支持。

**处理步骤**

更换图片。

#### 62980114 图片源未解析

**错误信息**

Image source not parsed.

**错误描述**

图片源未解析。

**可能原因**

图片源数据错误。

**处理步骤**

检查图片源数据。

#### 62980115 图片无效参数

**错误信息**

Invalid image parameter.

**错误描述**

图片无效参数。

**可能原因**

输入的参数无效。

**处理步骤**

重新输入正确的参数。

#### 62980116 解码失败

**错误信息**

Failed to decode the image.

**错误描述**

解码失败。

**可能原因**

1.  解码过程中异常退出。
2.  图片格式不支持。
3.  未读取到图片。

**处理步骤**

检查是否读取到图片或更换图片。

#### 62980117 注册插件失败

**错误信息**

Failed to register the plugin.

**错误描述**

注册插件失败。

**可能原因**

1.  未匹配到对应格式的解码或编码插件。
2.  传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

#### 62980118 创建插件失败

**错误信息**

Failed to create the image plugin.

**错误描述**

创建插件失败。

**可能原因**

1.  未匹配到对应格式的解码或编码插件。
2.  传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

#### 62980119 图片编码失败

**错误信息**

Failed to encode the image.

**错误描述**

图片编码失败。

**可能原因**

1.  设置的编码格式不支持。
2.  传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

#### 62980120 图片添加像素映射失败

**错误信息**

Add pixelmap out of range.

**错误描述**

图片添加像素映射失败。

**可能原因**

1.  可能不支持添加像素映射。
2.  添加像素映射过程中异常中断。

**处理步骤**

请检查映射步骤或更换图片。

#### 62980121 不支持图片硬解码

**错误信息**

Image hardware decoding is not supported.

**错误描述**

不支持图片硬解码。

**可能原因**

使用了图片硬解码。

**处理步骤**

使用其他方式解码。

#### 62980122 解码图片头异常

**错误信息**

Failed to decode the image header.

**错误描述**

解码图片头异常。

**可能原因**

1.  解码头过程中出现异常退出。
2.  图片解码头不符合要求。

**处理步骤**

更换图片或检查图片数据。

#### 62980123 图片不支持exif解码

**错误信息**

The image does not support EXIF decoding.

**错误描述**

图片不支持exif解码。

**可能原因**

图片不支持exif解码。

**处理步骤**

更换图片。

#### 62980124 图片属性不存在

**错误信息**

The image property does not exist.

**错误描述**

图片属性不存在。

**可能原因**

1.  图片属性缺失。
2.  对图片进行了不合理的修改。

**处理步骤**

更换图片。

#### 62980133 图片属性赋值超出范围

**错误信息**

The EXIF data is out of range.

**错误描述**

图片属性赋值超出范围。

**可能原因**

图片属性赋值超出范围。

**处理步骤**

更换图片或检查所设置图片属性值的长度。

#### 62980135 图片属性值无效

**错误信息**

The EXIF value is invalid.

**错误描述**

图片属性值无效。

**可能原因**

图片属性缺失。

**处理步骤**

更换图片或检查图片数据。

#### 62980137 图片操作无效

**错误信息**

Invalid media operation.

**错误描述**

图片操作无效。

**可能原因**

当前图片格式不支持该操作。

**处理步骤**

更换图片。

#### 62980146 图片属性值写入文件失败

**错误信息**

The EXIF data failed to be written to the file.

**错误描述**

图片属性值写入文件失败。

**可能原因**

图片属性值有异常。

**处理步骤**

更换图片。

#### 62980149 图片参数无效

**错误信息**

Invalid MIME type for the image source.

**错误描述**

图片参数无效。

**可能原因**

当前图片格式不支持该操作。

**处理步骤**

更换图片。

#### 62980172 编码ICC失败

**错误信息**

Failed to encode icc.

**错误描述**

编码ICC失败。

**可能原因**

图片ICC信息存在问题。

**处理步骤**

检查图片数据或更换图片。

#### 62980173 DMA内存空间错误

**错误信息**

The DMA memory does not exist.

**错误描述**

DMA内存空间错误。

**可能原因**

1.  内存大小不够。
2.  越界访问内存。
3.  使用了无效的指针。

**处理步骤**

请检查内存使用情况或重启。

#### 62980174 DMA内存数据异常

**错误信息**

The DMA memory data is abnormal.

**错误描述**

DMA内存数据异常。

**可能原因**

1.  读写共享内存时没有正确地进行同步操作。
2.  越界访问内存。
3.  使用了无效的指针。

**处理步骤**

重新启动。

#### 62980177 API环境异常

**错误信息**

Abnormal API environment.

**错误描述**

API环境异常。

**可能原因**

API使用环境存在问题。

**处理步骤**

检查SDK版本。

#### 62980178 PixelMap创建失败

**错误信息**

Failed to create the PixelMap.

**错误描述**

PixelMap创建失败。

**可能原因**

1.  参数错误（如区域大小超出、入参值非法等）导致的创建失败。
2.  错误地提前释放，导致实例创建失败。

**处理步骤**

检查函数入参或检查是否提前释放实例。

#### 62980179 缓冲区大小异常

**错误信息**

Abnormal buffer size.

**错误描述**

缓冲区大小异常。

**可能原因**

参数错误（如区域大小超出、入参值非法等）导致的创建失败。

**处理步骤**

检查函数入参。

#### 62980180 文件描述符映射失败

**错误信息**

FD mapping failed.

**错误描述**

文件描述符映射失败。

**可能原因**

传入的文件描述符存在问题。

**处理步骤**

检查是否传入了正确的文件描述符。

#### 62980246 读取PixelMap失败

**错误信息**

Failed to read the pixel map.

**错误描述**

读取PixelMap失败。

**可能原因**

1.  PixelMap数据错误。
2.  没有读取PixelMap的权限。

**处理步骤**

重新建立PixelMap或更改可读权限。

#### 62980247 写入像素映射失败

**错误信息**

Failed to write the pixel map.

**错误描述**

写入像素映射失败。

**可能原因**

1.  PixelMap数据错误。
2.  没有写入PixelMap的权限。

**处理步骤**

重新建立PixelMap或更改可读权限。

#### 62980248 PixelMap不允许修改

**错误信息**

PixelMap does not allow modification.

**错误描述**

PixelMap不允许修改。

**可能原因**

对PixelMap进行了修改。

**处理步骤**

停止对PixelMap的修改。

#### 62980252 创建surface失败

**错误信息**

Failed to create surface.

**错误描述**

创建surface失败。

**可能原因**

图片编码申请内存出错。

**处理步骤**

重试或者更换图片。

#### 62980259 配置错误

**错误信息**

Configuration error.

**错误描述**

配置错误。

**可能原因**

配置出现错误。

**处理步骤**

重新进行正确配置。

#### 62980274 图片转换失败

**错误信息**

The conversion failed.

**错误描述**

图片转换失败。

**可能原因**

1.  图片转换过程中异常停止。
2.  编码参数设置错误。

**处理步骤**

更换图片或者设置支持的编码参数。

#### 62980276 不支持图片转换目标类型

**错误信息**

The type to be converted is an unsupported target pixel format.

**错误描述**

不支持图片转换目标类型。

**可能原因**

不支持该目标类型的转换。

**处理步骤**

更换图片或更换转换类型。

#### 62980286 PixelMap设置内存标识符失败

**错误信息**

Memory format not supported.

**错误描述**

PixelMap设置内存标识符失败。

**可能原因**

1.  PixelMap内存类型不匹配。
2.  PixelMap的fd失效。
3.  未知的内核错误。

**处理步骤**

检查是否已释放pixelmap实例。检查内存类型是否匹配。

#### 62980302 内存拷贝失败

**错误信息**

Memory copy failed.

**错误描述**

内存拷贝失败。

**可能原因**

1.  内存类型不匹配。
2.  fd失效。
3.  未知的内核错误。

**处理步骤**

检查是否已释放要拷贝的实例。检查内存类型是否匹配。

#### 7600101 不支持的MIME类型

**错误信息**

Unsupported mime type.

**错误描述**

不支持的MIME类型。

**可能原因**

设备不支持该MIME类型。

**处理步骤**

检查图片数据或更换图片，可使用相关接口查询编解码能力范围。

#### 7600102 未知MIME类型

**错误信息**

Unknown mime type.

**错误描述**

未知的MIME类型。

**可能原因**

设备不支持该图像类型或图片损坏。

**处理步骤**

检查图片数据或更换图片。

#### 7600103 数据或图片太大

**错误信息**

Too large data or image.

**错误描述**

数据或图片太大。

**可能原因**

图片尺寸太大。

**处理步骤**

更换较小的图片。

#### 7600104 获取图像数据失败

**错误信息**

Failed to get the data from Surface.

**错误描述**

获取图像数据失败。

**可能原因**

1.  设备不支持该图像类型。
2.  图像数据损坏或丢失。

**处理步骤**

检查图像数据来源或使用新的图像数据。

#### 7600105 PixelMap已被释放

**错误信息**

PixelMap has been released.

**错误描述**

PixelMap已被释放。

**可能原因**

PixelMap对象已被释放，其关联的native对象已不存在。

**处理步骤**

检查该PixelMap对象是否存在被提前释放的风险（例如，在异步任务或另一个线程中意外释放），需确保该对象在使用结束前及所有异步方法执行完成前不被释放。

#### 7600106 PixelMap已被传递至另一个线程

**错误信息**

PixelMap has been passed to another thread.

**错误描述**

PixelMap已被传递至另一个线程。

**可能原因**

PixelMap对象已被传递至另一个线程。

**处理步骤**

不要在PixelMap对象被传递到另一个线程后仍在当前线程调用该对象的方法。

#### 7600173 DMA内存不存在

**错误信息**

DMA memory does not exist.

**错误描述**

DMA内存不存在。

**可能原因**

没有使用DMA内存解码HDR图片。

**处理步骤**

使用正确的内存分配类型。

#### 7600174 DMA操作失败

**错误信息**

DMA operation failed.

**错误描述**

DMA内存操作失败。

**可能原因**

读写DMA内存时没有正确地进行同步操作。

**处理步骤**

使用正确的方式读写DMA内存。

#### 7600201 不支持的操作

**错误信息**

Unsupported operation, e.g. on cross-platform.

**错误描述**

不支持的操作。如：修改一个Editable属性为false的PixelMap等。

**可能原因**

不支持的操作。如：修改一个Editable属性为false的PixelMap等。

**处理步骤**

使用支持的操作。

#### 7600202 不支持的元数据读写

**错误信息**

Unsupported metadata. Possible causes: Unsupported metadata type.

**错误描述**

不支持的元数据读写。

**可能原因**

不支持的元数据读写，如不支持的Exif字段，对类型不符的辅助图，获取特定辅助图元数据，如对深度图获取GainmapMetadata。

**处理步骤**

重新确定辅助图类型和元数据类型是否对应，再进行读写操作。

#### 7600203 不支持的转换

**错误信息**

Unsupported conversion.

**错误描述**

不支持的转换。

**可能原因**

PixelMap的格式不支持转换。

**处理步骤**

检查并更换格式匹配的PixelMap数据。

#### 7600204 无效的区域

**错误信息**

Invalid region.

**错误描述**

无效的区域。

**可能原因**

Region中设置的顶点位置、宽度或高度超出图片尺寸范围。

**处理步骤**

检查Region中设置的顶点位置、宽度或高度，确保在图片尺寸范围之内。

#### 7600205 不支持的内存格式或像素格式

**错误信息**

Unsupported memory format or pixel format.

**错误描述**

不支持的内存格式或像素格式。

**可能原因**

接口不支持当前PixelMap的内存格式或像素格式。

**处理步骤**

查看接口的规格限制，并检查PixelMap的内存格式或像素格式，使用格式支持的PixelMap调用接口。

#### 7600206 无效参数

**错误信息**

Invalid parameter.

**错误描述**

非法参数。

**可能原因**

输入的参数无效。

**处理步骤**

检查并重新输入正确的参数。

#### 7600207 不支持的数据格式

**错误信息**

Unsupported data format.

**错误描述**

不支持的数据格式。

**可能原因**

1.  接口不支持传入的像素数据格式。
2.  对象中的数据格式不支持特定的操作。

**处理步骤**

查看接口文档并使用接口支持的数据格式。

#### 7600301 申请内存失败

**错误信息**

Memory alloc failed.

**错误描述**

申请内存失败。

**可能原因**

设备内存不足或内存被占用。

**处理步骤**

清理内存后重试。

#### 7600302 内存拷贝失败

**错误信息**

Memory copy failed.

**错误描述**

内存拷贝失败。

**可能原因**

拷贝的内存不存在，设备内存不足。

**处理步骤**

检查要拷贝的内存是否存在，清理内存后重试。

#### 7600303 内存锁定或解锁失败

**错误信息**

Memory lock or unlock failed.

**错误描述**

内存锁定或解锁失败。

**可能原因**

PixelMap或内存地址无效。

**处理步骤**

检查PixelMap或内存地址是否有效。

#### 7600305 创建PixelMap失败

**错误信息**

Failed to create the PixelMap.

**错误描述**

创建PixelMap失败。

**可能原因**

1.  参数错误（如区域范围超出、入参值非法等）导致的创建失败。
2.  错误地提前释放实例，导致实例创建失败。

**处理步骤**

检查函数入参或检查是否提前释放了实例。

#### 7600306 数据转换失败

**错误信息**

Data conversion failed.

**错误描述**

数据转换失败。

**可能原因**

1.  传入的像素数据缓冲区的大小不符合预期。
2.  PixelMap内部的像素数据损坏。

**处理步骤**

1.  如果传入了一个缓冲区，检查缓冲区的大小是否符合预期。
2.  检查PixelMap的像素数据和元数据是否正常。

#### 7600501 不支持的分配器模式

**错误信息**

Unsupported allocator mode, e.g., use share memory to create a HDR image as only DMA supported hdr metadata.

**错误描述**

不支持的分配器模式。

**可能原因**

没有指定内存分配类型，或指定了错误的内存分配类型。例如：使用共享内存方式解码HDR图片就会出错，因为只有DMA方式才支持HDR元数据。

**处理步骤**

使用正确的内存分配类型。

#### 7600901 未知错误

**错误信息**

Unknown error.

**错误描述**

未知错误。

**可能原因**

未知原因引起的错误。

**处理步骤**

通过日志查找原因。

#### 7700101 图片源存在问题

**错误信息**

Bad source.

**错误描述**

图片源存在问题。

**可能原因**

1.  设备不支持该图片类型。
2.  没有按指示操作进行图片解码。
3.  图源数据不完整。从API version 17开始，系统底层经过优化，当遇到不完整数据时，系统将尝试部分解码，尽可能输出已解析的有效像素数据。但是如果图源数据文件头信息（如图像尺寸、颜色配置等）不完整，或图片像素数据块缺失严重，则仍会导致系统无法正常解码，最终返回解码失败。当前仅支持jpeg、png、bmp格式图片的不完整解码。

**处理步骤**

检查图片数据或更换图片。

#### 7700102 不支持的MIME类型

**错误信息**

Unsupported MIME type.

**错误描述**

不支持的MIME类型。

**可能原因**

设备不支持该图片类型。

**处理步骤**

检查图片数据或更换图片。

#### 7700103 图片太大

**错误信息**

Image too large.

**错误描述**

图片太大。

**可能原因**

图片大小超出限制。

**处理步骤**

检查图片数据或更换图片。

#### 7700201 不支持的内存分配类型

**错误信息**

Unsupported allocator type, e.g., use share memory to decode a HDR image as only DMA supported hdr metadata.

**错误描述**

不支持的内存分配类型。

**可能原因**

没有指定内存分配类型，或指定了错误的内存分配类型。例如：使用共享内存方式解码HDR图片就会出错，因为只有DMA方式才支持HDR元数据。

**处理步骤**

使用正确的内存分配类型。

#### 7700202 不支持的元数据

**错误信息**

Unsupported metadata.

**错误描述**

不支持的元数据。

**可能原因**

1.  输入了不支持的元数据字段。
2.  元数据字段对应的值非法。

**处理步骤**

检查元数据字段是否支持或检查元数据值是否合法。

#### 7700203 不支持的选项

**错误信息**

Unsupported options, e.g, cannot convert image into desired pixel format.

**错误描述**

不支持的选项。

**可能原因**

部分选项参数配置存在错误，不支持该选项要求的操作。

**处理步骤**

检查选项参数配置。

#### 7700204 无效参数

**错误信息**

Invalid parameter.

**错误描述**

非法参数。

**可能原因**

输入的参数无效。

**处理步骤**

检查并重新输入正确的参数。

#### 7700301 解码失败

**错误信息**

Decode failed.

**错误描述**

解码失败。

**可能原因**

1.  设备的内存不足。
2.  设备不支持该图片类型。
3.  没有按指示操作进行图片解码。

**处理步骤**

检查图片数据或更换图片。

#### 7700302 内存分配失败

**错误信息**

Memory allocation failed.

**错误描述**

内存分配失败。

**可能原因**

1.  设备的内存不足。
2.  没有按指示操作进行图片解码。

**处理步骤**

检查设备内存或检查传入数据。

#### 7700303 图片不包含缩略图数据

**错误信息**

Image does not carry thumbnail data.

**错误描述**

图片不包含缩略图数据。

**可能原因**

图片文件中不包含缩略图数据，且未开启缩略图生成功能。

**处理步骤**

检查图片文件是否包含缩略图数据，或开启缩略图生成功能后重试。

#### 7700305 缩略图生成失败

**错误信息**

Thumbnail generation failed.

**错误描述**

缩略图生成失败。

**可能原因**

1.  输入图片数据异常。
2.  缩略图生成参数不合理。
3.  设备资源不足。

**处理步骤**

检查输入图片数据和缩略图生成参数，必要时释放系统资源后重试。

#### 7700304 图片信息写入文件失败

**错误信息**

Failed to write image properties to the file.

**错误描述**

图片信息写入文件失败。

**可能原因**

1.  图片数据错误。
2.  没有修改图片文件的权限。

**处理步骤**

检查图片数据或检查图片文件权限。

#### 7800201 不支持的选项

**错误信息**

Unsupported options.

**错误描述**

不支持的选项。

**可能原因**

部分选项参数配置存在错误，不支持该选项要求的操作。

**处理步骤**

检查选项参数配置。

#### 7800202 ImagePacker无效参数

**错误信息**

Invalid parameter for ImagePacker.

**错误描述**

编码参数无效。

**可能原因**

编码参数为空或无效。

**处理步骤**

检查编码选项参数配置。

#### 7800301 编码失败

**错误信息**

Encode failed.

**错误描述**

编码失败。

**可能原因**

1.  设置的编码格式不支持。
2.  传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

#### 7900201 无效参数

**错误信息**

Invalid parameter.

**错误描述**

非法参数。

**可能原因**

1.  传入的参数数量、类型不正确。
2.  设置的图像格式不支持。

**处理步骤**

检查参数配置。