This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.
Error Message
Resource unavailable.
Symptom
This error code is reported when an API fails to be called.
Possible Cause
The image is transferred across threads, and the original object cannot call the API.
Solution
Check the image and follow the instructions to decode it.
Error Message
The operation failed. Possible cause: 1.Image upload exception. 2. Decoding process exception. 3. Insufficient memory.
Symptom
This error code is reported when the operations fails.
Possible Cause
Solution
Check the image and follow the instructions to decode it.
Error Message
IPC error. Possible cause: 1.IPC communication failed. 2. Image upload exception. 3. Decode process exception. 4. Insufficient memory.
Symptom
This error code is reported when PixelMap serialization and transmission fails.
Possible Cause
Solution
Check the image and follow the instructions to decode it.
Error Message
Image decoding abnormal.
Symptom
This error code is reported when an image decoding error occurs.
Possible Cause
Solution
Check the image and follow the instructions to decode it.
Error Message
The image data is abnormal.
Symptom
This error code is reported when the input image data is incorrect.
Possible Cause
Solution
Use a valid image.
Error Message
Image malloc abnormal. This status code is thrown when an error occurs during the process of copying data.
Symptom
This error code is reported when an error occurs during image memory allocation.
Possible Cause
The device memory is insufficient or occupied.
Solution
Clear the memory and try again.
Error Message
The image data is not supported.
Symptom
The image type is not supported.
Possible Cause
The input image type is not supported.
Solution
Change the image type and try again.
Error Message
Image initialization abnormal. This status code is thrown when an error occurs during the process of creating empty pixelmap.
Symptom
This error code is reported when an image initialization error occurs.
Possible Cause
Solution
Correct the parameters or user another image.
Error Message
Failed to get the data.
Symptom
This error code is reported when the image data fails to be obtained.
Possible Cause
Solution
Correct the image data or use another image.
Error Message
The image data is too large. This status code is thrown when an error occurs during the process of checking size.
Symptom
This error code is reported when the image data is too large.
Possible Cause
The image is too large.
Solution
Use a smaller image.
Error Message
Image conversion abnormal.
Symptom
This error code is reported when an image conversion error occurs.
Possible Cause
Solution
Correct the encoding parameters or use another image.
Error Message
Failed to convert the color space.
Symptom
This error code is reported when an image color conversion error occurs.
Possible Cause
Solution
Try again or change the image type.
Error Message
Failed to crop the image.
Symptom
This error code is reported when a cropping error occurs.
Possible Cause
Solution
Correct the cropping parameters or image data.
Error Message
The image source data is incorrect.
Symptom
The image source data is incorrect.
Possible Cause
The image source data is missing or incorrect.
Solution
Check the operation procedure or use another image.
Error Message
The image source data is incomplete.
Symptom
This error code is reported when the image source data is incomplete.
Possible Cause
The image source data is missing.
Solution
Check the operation procedure or use another image.
Error Message
The image format does not match.
Symptom
This error code is reported when an image format mismatch error occurs.
Possible Cause
The image format does not match.
Solution
Use an image in a matched format.
Error Message
Unknown image format.The image data provided is not in a recognized or supported format, or it may be corrupted.
Symptom
This error code is reported when the image format is unknown.
Possible Cause
The image format is not supported.
Solution
Use another image.
Error Message
Image source not parsed.
Symptom
This error code is reported when the image source is not parsed.
Possible Cause
The image source data is incorrect.
Solution
Correct the image source data.
Error Message
Invalid image parameter.
Symptom
This error code is reported when the image parameter is invalid.
Possible Cause
An input parameter is invalid.
Solution
Correct the input parameter.
Error Message
Failed to decode the image.
Symptom
This error code is reported when decoding fails.
Possible Cause
Solution
Ensure that the image is read or use another image.
Error Message
Failed to register the plugin.
Symptom
This error code is reported when the plugin registration fails.
Possible Cause
Solution
Correct the input data or use another image.
Error Message
Failed to create the image plugin.
Symptom
This error code is reported when the plugin creation fails.
Possible Cause
Solution
Correct the input data or use another image.
Error Message
Failed to encode the image.
Symptom
This error code is reported when the image encoding fails.
Possible Cause
Solution
Correct the input data or use another image.
Error Message
Add pixelmap out of range.
Symptom
This error code is reported when pixel mapping fails to be added.
Possible Cause
Solution
Check the operation procedure or use another image.
Error Message
Image hardware decoding is not supported.
Symptom
This error code is reported when image hardware decoding is not supported.
Possible Cause
Image hardware decoding is used.
Solution
Use another decoding mode.
Error Message
Failed to decode the image header.
Symptom
This error code is reported when the image header fails to be decoded.
Possible Cause
Solution
Correct the image data or use another image.
Error Message
The image does not support EXIF decoding.
Symptom
The image does not support Exif decoding.
Possible Cause
The image does not support Exif decoding.
Solution
Use another image.
Error Message
The image property does not exist.
Symptom
This error code is reported when the image property does not exist.
Possible Cause
Solution
Use another image.
Error Message
The EXIF data is out of range.
Symptom
The value of the image property is out of range.
Possible Cause
The value of the image property is out of range.
Solution
Change the image or check the length of the image property value.
Error Message
The EXIF value is invalid.
Symptom
This error code is reported when the image property value is invalid.
Possible Cause
The image property is missing.
Solution
Correct the image data or use another image.
Error Message
Invalid media operation.
Symptom
This error code is reported when the image operation is invalid.
Possible Cause
The current image format does not support this operation.
Solution
Use another image.
Error Message
The EXIF data failed to be written to the file.
Symptom
This error code is reported when image property values fail to be written to the file.
Possible Cause
The property values of the image are abnormal.
Solution
Use another image.
Error Message
Invalid MIME type for the image source.
Symptom
This error code is reported when the image parameter is invalid.
Possible Cause
The current image format does not support this operation.
Solution
Use another image.
Error Message
Failed to encode icc.
Symptom
This error code is reported when ICC encoding fails.
Possible Cause
The image ICC information is incorrect.
Solution
Verify the image data or use another image.
Error Message
The DMA memory does not exist.
Symptom
This error code is reported when a DMA memory space error occurs.
Possible Cause
Solution
Check the memory usage or restart the device.
Error Message
The DMA memory data is abnormal.
Symptom
This error code is reported when the DMA memory data is abnormal.
Possible Cause
Solution
Restart the device.
Error Message
Abnormal API environment.
Symptom
This error code is reported when the API environment is abnormal.
Possible Cause
The environment where the API is used is incorrect.
Solution
Check the SDK version.
Error Message
Failed to create the PixelMap.
Symptom
This error code is reported when the PixelMap fails to be created.
Possible Cause
Solution
Ensure that the input parameters are correct and the instance is available.
Error Message
Abnormal buffer size.
Symptom
This error code is reported when the buffer size is abnormal.
Possible Cause
Input parameters are incorrect. For example, the region size exceeds the upper limit or an invalid value is passed in.
Solution
Check the input parameters.
Error Message
FD mapping failed.
Symptom
This error code is reported when the file descriptor fails to be mapped.
Possible Cause
The input file descriptor is incorrect.
Solution
Pass a correct file descriptor.
Error Message
Failed to read the pixel map.
Symptom
This error code is reported when the PixelMap fails to be read.
Possible Cause
Solution
Create another PixelMap or request the read permission.
Error Message
Failed to write the pixel map.
Symptom
This error code is reported when the PixelMap fails to be written.
Possible Cause
Solution
Create another PixelMap or request the read permission.
Error Message
PixelMap does not allow modification.
Symptom
This error code is reported when the PixelMap is modified, which is not allowed.
Possible Cause
Users try to modify a PixelMap.
Solution
Do not modify the PixelMap.
Error Message
Failed to create surface.
Symptom
This error code is reported when a surface fails to be created.
Possible Cause
An error occurred when requesting memory for image encoding.
Solution
Try again or use another image.
Error Message
Configuration error.
Symptom
This error code is reported when the configuration is incorrect.
Possible Cause
The configuration is incorrect.
Solution
Correct the configuration.
Error Message
The conversion failed.
Symptom
This error code is reported when image conversion fails.
Possible Cause
Solution
Correct the encoding parameters or use another image.
Error Message
The type to be converted is an unsupported target pixel format.
Symptom
This error code is reported when the image conversion target type is not supported.
Possible Cause
The conversion to the target type is not supported.
Solution
Use another image or change the target type.
Error Message
Memory format not supported.
Symptom
This error code is reported when the memory identifier fails to be set for PixelMap.
Possible Cause
Solution
Check whether the PixelMap instance has been released. Check whether the memory type matches.
Error Message
Memory copy failed.
Symptom
This error code is reported when memory copy fails.
Possible Cause
Solution
Check whether the instance to be copied has been released. Check whether the memory type matches.
Error Message
Unsupported mime type.
Symptom
This error code is reported when the MIME type is not supported.
Possible Cause
The device does not support the MIME type.
Solution
Verify the image data or use another image. You can call relevant APIs to query the codec capability range.
Error Message
Unknown mime type.
Symptom
This error is reported for an unknown MIME type.
Possible Cause
The device does not support the image type or the image is damaged.
Solution
Verify the image data or use another image.
Error Message
Too large data or image.
Symptom
This error code is reported if the data or image is too large.
Possible Cause
The image dimensions are too large.
Solution
Use a smaller image.
Error Message
Failed to get the data from Surface.
Symptom
This error code is reported when image data fails to be obtained.
Possible Cause
Solution
Verify the image data source or use new image data.
Error Message
PixelMap has been released.
Symptom
The PixelMap object has been released.
Possible Cause
The PixelMap object has been released, and its associated native object no longer exists.
Solution
Check whether the PixelMap object may be released in advance (for example, released unexpectedly in an asynchronous task or another thread). Ensure that the object is not released before it is no longer used and all asynchronous methods are executed.
Error Message
PixelMap has been passed to another thread.
Symptom
The PixelMap has been passed to another thread.
Possible Cause
The PixelMap object has been passed to another thread, and the object in the original thread cannot continue to call the API.
Solution
Do not call the API of the PixelMap object in the original thread after the object has been passed to another thread.
Error Message
DMA memory does not exist.
Symptom
This error code is reported if the DMA memory does not exist.
Possible Cause
The DMA memory is not used to decode HDR images.
Solution
Use a correct memory allocation type.
Error Message
DMA operation failed.
Symptom
This error code is reported if the operation on the DMA memory fails.
Possible Cause
The synchronization operation is not correctly performed when data is read from or written to the DMA memory.
Solution
Read and write the DMA memory in a correct way.
Error Message
Unsupported operation, e.g. on cross-platform.
Symptom
This error code is reported when the operation is not supported, for example, modifying a PixelMap whose Editable property is false.
Possible Cause
The operation is not supported. For example, modify a PixelMap whose Editable property is false.
Solution
Use a supported operation.
Error Message
Unsupported metadata. Possible causes: Unsupported metadata type.
Symptom
This error code is reported when the metadata read/write operation is not supported.
Possible Cause
The metadata read/write operation is not supported. For example, the Exif field to read or write is not supported, or users attempt to obtain specific data from an auxiliary picture of an incorrect type (for example, attempt to obtain GainmapMetadata of a depth map).
Solution
Check whether the auxiliary picture type corresponds to the metadata type, and then perform the read and write operations.
Error Message
Unsupported conversion.
Symptom
This error code is reported for unsupported conversion.
Possible Cause
The PixelMap data cannot be converted.
Solution
Use PixelMap data with a matching format.
Error Message
Invalid region.
Symptom
This error code is reported when a region is invalid.
Possible Cause
The area to crop (its position, width, or height) falls outside the dimensions of the original image.
Solution
Adjust the Region parameters so that the entire crop area falls within the dimensions of the original image.
Error Message
Unsupported memory format or pixel format.
Symptom
This error code is reported when the memory format or pixel format is not supported.
Possible Cause
The API does not support the memory format or pixel format of the PixelMap.
Solution
Check the API specifications for the list of supported formats, and convert the PixelMap to a compatible format before passing it to this API.
Error Message
Invalid parameter.
Symptom
This error code is reported when the parameter is invalid.
Possible Cause
An input parameter is invalid.
Solution
Enter correct parameters.
Error Message
Unsupported data format.
Symptom
Unsupported data format.
Possible Cause
Solution
Check the API reference and use the data format supported by the API.
Error Message
HDR image decomposition failed. Possible causes: 1. Decomposition processing is not supported. 2. Processing error occurs.
Symptom
Failed to decompose the HDR image.
Possible Cause
Solution
Check whether the pixel format of the HDR PixelMap supports decomposition, or change the image and try again.
Error Message
Memory alloc failed.
Symptom
This error code is reported when the memory allocation fails.
Possible Cause
The device memory is insufficient or occupied.
Solution
Clear the memory and try again.
Error Message
Memory copy failed.
Symptom
This error code is reported when memory copy fails.
Possible Cause
The memory to copy does not exist, or the device memory is insufficient.
Solution
Check whether the memory to copy exists. Clear the memory and try again.
Error Message
Memory lock or unlock failed.
Symptom
This error is reported if memory lock or unlock fails.
Possible Cause
The PixelMap or memory address is invalid.
Solution
Ensure that the PixelMap or memory address is valid.
Error Message
Failed to create the PixelMap.
Symptom
This error code is reported when the PixelMap fails to be created.
Possible Cause
Solution
Ensure that the input parameters are correct and the instance is available.
Error Message
Data conversion failed.
Symptom
Data conversion failed.
Possible Cause
Solution
Error Message
Unsupported allocator mode, e.g., use share memory to create a HDR image as only DMA supported hdr metadata.
Symptom
This error code is reported for unsupported allocator mode.
Possible Cause
No memory allocation type is specified, or an incorrect memory allocation type is specified. For example, an error occurs when an HDR image is decoded in shared memory mode, because only the DMA mode supports HDR metadata.
Solution
Use a correct memory allocation type.
Error Message
Unknown error.
Symptom
This error code is reported when an unknown error occurs.
Possible Cause
Errors caused by unknown reasons.
Solution
Locate the cause based on logs.
Error Message
Bad source.
Symptom
This error code is reported when the image source is abnormal.
Possible Cause
Solution
Verify the image data or use another image.
Error Message
Unsupported MIME type.
Symptom
This error code is reported when the MIME type is not supported.
Possible Cause
The device does not support the image type.
Solution
Verify the image data or use another image.
Error Message
Image too large.
Symptom
The image is too large.
Possible Cause
The image size exceeds the upper limit.
Solution
Verify the image data or use another image.
Error Message
Unsupported allocator type, e.g., use share memory to decode a HDR image as only DMA supported hdr metadata.
Symptom
This error code is reported when the memory allocator type is not supported.
Possible Cause
No memory allocation type is specified, or an incorrect memory allocation type is specified. For example, an error occurs when an HDR image is decoded in shared memory mode, because only the DMA mode supports HDR metadata.
Solution
Use a correct memory allocation type.
Error Message
Unsupported metadata.
Symptom
This error code is reported when the metadata is not supported.
Possible Cause
Solution
Check whether the metadata field is supported or whether the metadata value is valid.
Error Message
Unsupported options, e.g, cannot convert image into desired pixel format.
Symptom
This error code is reported when an option is not supported.
Possible Cause
Some parameters are incorrectly configured, or the operation required by the options is not supported.
Solution
Verify the parameter settings.
Error Message
Invalid parameter.
Symptom
This error code is reported when the parameter is invalid.
Possible Cause
An input parameter is invalid.
Solution
Enter correct parameters.
Error Message
Decode failed.
Symptom
This error code is reported when decoding fails.
Possible Cause
Solution
Verify the image data or use another image.
Error Message
Memory allocation failed.
Symptom
This error code is reported when the memory allocation fails.
Possible Cause
Solution
Check the device memory or input data.
Error Message
Image does not carry thumbnail data.
Symptom
This error is reported when the image does not contain thumbnail data.
Possible Cause
The image file does not contain thumbnail data, and the thumbnail generation function is not enabled.
Solution
Ensure that the image file contains thumbnail data and that the thumbnail generation function is enabled. Then try again.
Error Message
Thumbnail generation failed.
Symptom
This error code is reported when the thumbnail generation fails.
Possible Cause
Solution
Verify the input image data and thumbnail generation parameters, and release the system resources if necessary. Then try again.
Error Message
Failed to write image properties to the file.
Symptom
This error code is reported when the image information fails to be written into the file.
Possible Cause
Solution
Check the image data and confirm that you have the required permissions for the image file.
Error Message
Unsupported options.
Symptom
This error code is reported when an option is not supported.
Possible Cause
Some parameters are incorrectly configured, or the operation required by the options is not supported.
Solution
Verify the parameter settings.
Error Message
Invalid parameter for ImagePacker.
Symptom
This error code is reported if the encoding parameter is invalid.
Possible Cause
The encoding parameter is empty or invalid.
Solution
Verify the encoding parameter settings.