Image错误码
说明：
当前为Beta阶段。
说明：
以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
501 无法调用接口
错误信息
Resource unavailable.
错误描述
无法调用接口。
可能原因
图片被跨线程传递，原对象无法调用接口。
处理步骤
请检查图片并按指示操作重新解码。
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.
错误描述
获取图像数据失败。
可能原因
- 设备不支持该图像类型。
- 图像数据损坏或丢失。
处理步骤
检查图像数据来源或使用新的图像数据。
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.
错误描述
非法参数。
可能原因
输入的参数无效。
处理步骤
检查并重新输入正确的参数。
7600301 申请内存失败
错误信息
Memory alloc failed.
错误描述
申请内存失败。
可能原因
设备内存不足或内存被占用。
处理步骤
清理内存后重试。
7600302 内存拷贝失败
错误信息
Memory copy failed.
错误描述
内存拷贝失败。
可能原因
拷贝的内存不存在，设备内存不足。
处理步骤
检查要拷贝的内存是否存在，清理内存后重试。
7600303 内存锁定或解锁失败
错误信息
Memory lock or unlock failed.
错误描述
内存锁定或解锁失败。
可能原因
PixelMap或内存地址无效。
处理步骤
检查PixelMap或内存地址是否有效。
7600305 创建PixelMap失败
错误信息
Failed to create the PixelMap.
错误描述
创建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.
错误描述
图片源存在问题。
可能原因
- 设备不支持该图片类型。
- 没有按指示操作进行图片解码。
- 图源数据不完整。从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.
错误描述
不支持的元数据。
可能原因
- 输入了不支持的元数据字段。
- 元数据字段对应的值非法。
处理步骤
检查元数据字段是否支持或检查元数据值是否合法。
7700203 不支持的选项
错误信息
Unsupported options, e.g, cannot convert image into desired pixel format.
错误描述
不支持的选项。
可能原因
部分选项参数配置存在错误，不支持该选项要求的操作。
处理步骤
检查选项参数配置。
7700204 无效参数
错误信息
Invalid parameter.
错误描述
非法参数。
可能原因
输入的参数无效。
处理步骤
检查并重新输入正确的参数。
7700301 解码失败
错误信息
Decode failed.
错误描述
解码失败。
可能原因
- 设备的内存不足。
- 设备不支持该图片类型。
- 没有按指示操作进行图片解码。
处理步骤
检查图片数据或更换图片。
7700302 内存分配失败
错误信息
Memory allocation failed.
错误描述
内存分配失败。
可能原因
- 设备的内存不足。
- 没有按指示操作进行图片解码。
处理步骤
检查设备内存或检查传入数据。
7700304 图片信息写入文件失败
错误信息
Failed to write image properties to the file.
错误描述
图片信息写入文件失败。
可能原因
- 图片数据错误。
- 没有修改图片文件的权限。
处理步骤
检查图片数据或检查图片文件权限。
7800201 不支持的选项
错误信息
Unsupported options.
错误描述
不支持的选项。
可能原因
部分选项参数配置存在错误，不支持该选项要求的操作。
处理步骤
检查选项参数配置。
7800202 ImagePacker无效参数
错误信息
Invalid parameter for ImagePacker.
错误描述
编码参数无效。
可能原因
编码参数为空或无效。
处理步骤
检查编码选项参数配置。
7800301 编码失败
错误信息
Encode failed.
错误描述
编码失败。
可能原因
- 设置的编码格式不支持。
- 传入数据不正确。
处理步骤
更换图片或检查传入数据。
7900201 无效参数
错误信息
Invalid parameter.
错误描述
非法参数。
可能原因
- 传入的参数数量、类型不正确。
- 设置的图像格式不支持。
处理步骤
检查参数配置。
62980096 操作失败
错误信息
The operation failed. Possible cause: 1.Image upload exception. 2. Decoding process exception. 3. Insufficient memory.
错误描述
操作失败。
可能原因
- 上传图片过程中出现异常。
- 解码过程中有其他操作。
- 没有按指示操作进行图片解码。
- 设备的内存不足。
- 解码库处理失败。
处理步骤
请检查图片并按指示操作重新解码。
62980097 pixelmap序列化传输失败
错误信息
IPC error. Possible cause: 1.IPC communication failed. 2. Image upload exception. 3. Decode process exception. 4. Insufficient memory.
错误描述
pixelmap序列化传输失败。
可能原因
- 上传图片过程中出现异常。
- 解码过程中有其他操作。
- 没有按指示操作进行图片解码。
- 设备的内存不足。
处理步骤
请检查图片并按指示操作重新解码。
62980098 共享内存空间错误
错误信息
Shared memory does not exist.
错误描述
共享内存空间错误。
可能原因
- 内存大小不够。
- 越界访问共享内存。
- 使用了无效的指针。
处理步骤
请检查内存使用情况或重启。
62980099 共享内存数据异常
错误信息
The shared memory data is abnormal.
错误描述
共享内存数据异常。
可能原因
- 读写共享内存时没有正确地进行同步操作。
- 越界访问共享内存。
- 使用了无效的指针。
处理步骤
请重新启动。
62980100 图片解码错误
错误信息
Image decoding abnormal.
错误描述
图片解码错误。
可能原因
- 上传图片过程中出现异常。
- 解码过程中有其他操作。
- 没有按指示操作进行图片解码。
- 设备的内存不足。
处理步骤
请检查图片并按指示操作重新解码。
62980101 图片输入数据错误
错误信息
The image data is abnormal.
错误描述
图片输入数据错误。
可能原因
- 输入图片数据不对。
- 输入的图片格式不对。
- 输入的图片大小不对。
处理步骤
请重新输入正确的图片。
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.
错误描述
图片初始化错误。
可能原因
- 图片类型不支持。
- 图片大小不支持。
- 初始化过程中出现错误。
处理步骤
请重新输入正确的参数或更换图片。
62980105 图片获取数据错误
错误信息
Failed to get the data.
错误描述
图片获取数据错误。
可能原因
- 设备不支持该图片类型。
- 图片数据丢失。
处理步骤
请输入新的图片或检查图片数据。
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.
错误描述
图片转换错误。
可能原因
- 图片转换过程中异常停止。
- 编码参数设置错误。
处理步骤
更换图片或者设置支持的编码参数。
62980108 图片颜色转换错误
错误信息
Failed to convert the color space.
错误描述
图片颜色转换错误。
可能原因
- 不支持该图片类型的颜色转换。
- 设备出现问题。
处理步骤
重试或者更换图片类型。
62980109 裁剪错误
错误信息
Failed to crop the image.
错误描述
裁剪错误。
可能原因
- 裁剪参数设置错误。
- 图片数据错误。
处理步骤
请检查图片数据或修改正确的裁剪参数。
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.
错误描述
解码失败。
可能原因
- 解码过程中异常退出。
- 图片格式不支持。
- 未读取到图片。
处理步骤
检查是否读取到图片或更换图片。
62980117 注册插件失败
错误信息
Failed to register the plugin.
错误描述
注册插件失败。
可能原因
- 未匹配到对应格式的解码或编码插件。
- 传入数据不正确。
处理步骤
更换图片或检查传入数据。
62980118 创建插件失败
错误信息
Failed to create the image plugin.
错误描述
创建插件失败。
可能原因
- 未匹配到对应格式的解码或编码插件。
- 传入数据不正确。
处理步骤
更换图片或检查传入数据。
62980119 图片编码失败
错误信息
Failed to encode the image.
错误描述
图片编码失败。
可能原因
- 设置的编码格式不支持。
- 传入数据不正确。
处理步骤
更换图片或检查传入数据。
62980120 图片添加像素映射失败
错误信息
Add pixelmap out of range.
错误描述
图片添加像素映射失败。
可能原因
- 可能不支持添加像素映射。
- 添加像素映射过程中异常中断。
处理步骤
请检查映射步骤或更换图片。
62980121 不支持图片硬解码
错误信息
Image hardware decoding is not supported.
错误描述
不支持图片硬解码。
可能原因
使用了图片硬解码。
处理步骤
使用其他方式解码。
62980122 解码图片头异常
错误信息
Failed to decode the image header.
错误描述
解码图片头异常。
可能原因
- 解码头过程中出现异常退出。
- 图片解码头不符合要求。
处理步骤
更换图片或检查图片数据。
62980123 图片不支持exif解码
错误信息
The image does not support EXIF decoding.
错误描述
图片不支持exif解码。
可能原因
图片不支持exif解码。
处理步骤
更换图片。
62980124 图片属性不存在
错误信息
The image property does not exist.
错误描述
图片属性不存在。
可能原因
- 图片属性缺失。
- 对图片进行了不合理的修改。
处理步骤
更换图片。
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内存空间错误。
可能原因
- 内存大小不够。
- 越界访问内存。
- 使用了无效的指针。
处理步骤
请检查内存使用情况或重启。
62980174 DMA内存数据异常
错误信息
The DMA memory data is abnormal.
错误描述
DMA内存数据异常。
可能原因
- 读写共享内存时没有正确地进行同步操作。
- 越界访问内存。
- 使用了无效的指针。
处理步骤
重新启动。
62980177 API环境异常
错误信息
Abnormal API environment.
错误描述
API环境异常。
可能原因
API使用环境存在问题。
处理步骤
检查SDK版本。
62980178 PixelMap创建失败
错误信息
Failed to create the PixelMap.
错误描述
PixelMap创建失败。
可能原因
- 参数错误（如区域大小超出、入参值非法等）导致的创建失败。
- 错误地提前释放，导致实例创建失败。
处理步骤
检查函数入参或检查是否提前释放实例。
62980179 缓冲区大小异常
错误信息
Abnormal buffer size.
错误描述
缓冲区大小异常。
可能原因
参数错误（如区域大小超出、入参值非法等）导致的创建失败。
处理步骤
检查函数入参。
62980180 文件描述符映射失败
错误信息
FD mapping failed.
错误描述
文件描述符映射失败。
可能原因
传入的文件描述符存在问题。
处理步骤
检查是否传入了正确的文件描述符。
62980246 读取PixelMap失败
错误信息
Failed to read the pixel map.
错误描述
读取PixelMap失败。
可能原因
- PixelMap数据错误。
- 没有读取PixelMap的权限。
处理步骤
重新建立PixelMap或更改可读权限。
62980247 写入像素映射失败
错误信息
Failed to write the pixel map.
错误描述
写入像素映射失败。
可能原因
- PixelMap数据错误。
- 没有写入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.
错误描述
图片转换失败。
可能原因
- 图片转换过程中异常停止。
- 编码参数设置错误。
处理步骤
更换图片或者设置支持的编码参数。
62980276 不支持图片转换目标类型
错误信息
The type to be converted is an unsupported target pixel format.
错误描述
不支持图片转换目标类型。
可能原因
不支持该目标类型的转换。
处理步骤
更换图片或更换转换类型。
62980286 PixelMap设置内存标识符失败
错误信息
Memory format not supported.
错误描述
PixelMap设置内存标识符失败。
可能原因
- PixelMap内存类型不匹配。
- PixelMap的fd失效。
- 未知的内核错误。
处理步骤
检查是否已释放pixelmap实例。检查内存类型是否匹配。
62980302 内存拷贝失败
错误信息
Memory copy failed.
错误描述
内存拷贝失败。
可能原因
- 内存类型不匹配。
- fd失效。
- 未知的内核错误。
处理步骤
检查是否已释放要拷贝的实例。检查内存类型是否匹配。